Funktionreferenz


WinSetTitle

Beschreibung anzeigen in

Ändert den Titel eines Fensters.

WinSetTitle ( "title", "text", "newtitle" )

Parameter

title Der Titel/Fenster-Handle(hWnd)/Klassenname(class) des Fensters, der geändert werden soll. Siehe Erweiterte Fenstertiteldefinition.
text Der Text des Fensters, das geändert werden soll. Siehe Erweiterte Fenstertextdefinition.
newtitle Der neue Titel, den das Fenster erhalten soll.

Rückgabewert

Erfolg: 1.
Fehler: 0 wenn das Fenster nicht gefunden wurde.

Bemerkungen

Falls mehrere Fenster das Kriterium erfüllen, wird das zuletzt aktive Fenster verwendet.

ACHTUNG: Ab Windows Version 19H1 wird der Titel von "notepad.exe" wieder zum Original, wenn das Fenster den Fokus erhält !!!

Verwandte Funktionen

AutoItWinSetTitle, WinGetHandle, WinGetTitle, WinTitleMatchMode (Option)

Beispiel

Example()

Func Example()
    ; Startet WordPad
    Run("Write.exe")

    ; Wartet maximal 10 Sekunden bis das WordPad-Fenster erscheint.
    Local $hWnd = WinWait("[CLASS:WordPadClass]", "", 10)

    ; Setzt den Titel des WordPad-Fensters durch die Verwendung des von WinWait zurückgegebenen Handles.
    WinSetTitle($hWnd, "", "Neuer Wordpadtitel - AutoIt")

    ; Wartet 2 Sekunden um das WordPad-Fenster mit dem neuen Titel darzustellen.
    Sleep(2000)

    ; Schließt das WordPad-Fenster durch die Verwendung des von WinWait zurückgegebenen Handles.
    WinClose($hWnd)
EndFunc   ;==>Example