WinSetTitle

Ändert den Titel eines bestimmten Fensters.

WinSetTitle NeuerTitel , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

Parameter

NeuerTitel

Typ: Zeichenkette

Der neue Titel des Fensters. Wenn nur dieser Parameter vorhanden ist, wird das Zuletzt Gefundene Fenster verwendet.

FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

Typ: Zeichenkette, Integer oder Objekt

Wenn jeder dieser Parameter leer ist oder weggelassen wird, wird das Zuletzt Gefundene Fenster verwendet. Andernfalls geben Sie für FensterTitel einen Fenstertitel oder andere Kriterien zur Identifizierung des Zielfensters und/oder für FensterText eine Teilzeichenkette aus einem Textelement des Zielfensters an (Textelemente können mit dem internen Tool "Window Spy" in Erfahrung gebracht werden).

AusnahmeTitel und AusnahmeText können verwendet werden, um ein oder mehrere Fenster anhand ihres Titels oder Textes auszuschließen. Ihre Angabe ähnelt der von FensterTitel und FensterText, außer dass AusnahmeTitel keine anderen Kriterien als den Fenstertitel erkennt.

Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Standardmäßig werden versteckte Fenster nicht erkannt und versteckte Textelemente erkannt, was mit DetectHiddenWindows und DetectHiddenText geändert werden kann. Standardmäßig kann ein Fenstertitel den angegebenen FensterTitel oder AusnahmeTitel an beliebiger Stelle enthalten, um eine Übereinstimmung zu sein, was mit SetTitleMatchMode geändert werden kann.

Fehlerbehandlung

Es wird ein TargetError ausgelöst, wenn das Fenster nicht gefunden werden konnte.

Es wird ein OSError ausgelöst, wenn die Änderung nicht angewendet werden konnte.

Bemerkungen

Eine Änderung des Fenstertitels kann nur temporär sein, wenn die Anwendung, der das Fenster gehört, den Titel häufig ändert.

WinMove, WinGetTitle, WinGetText, ControlGetText, WinGetPos, Win-Funktionen

Beispiele

Ändert den Titel von Notepad. Dieses Beispiel kann unter Windows 11 oder höher fehlschlagen, da es die klassische Version von Notepad erfordert.

WinSetTitle("Ein neuer Titel", "Unbenannt - Editor")

Öffnet Notepad, wartet bis es aktiv ist und ändert dessen Titel. Dieses Beispiel kann unter Windows 11 oder höher fehlschlagen, da es die klassische Version von Notepad erfordert.

Run "notepad.exe"
WinWaitActive "Unbenannt - Editor"
WinSetTitle "Ein neuer Titel" ; Verwendet das von WinWaitActive gefundene Fenster.

Öffnet das Hauptfenster, wartet bis es aktiv ist und ändert dessen Titel.

ListVars
WinWaitActive "ahk_class AutoHotkey"
WinSetTitle "Ein neuer Titel" ; Verwendet das von WinWaitActive gefundene Fenster.