Funktionreferenz

WinSetState

Beschreibung anzeigen in

Zeigt, versteckt, minimiert, maximiert oder stellt ein Fenster wieder her.

WinSetState ( "title", "text", flag )

Parameter

title Der Titel/Fenster-Handle(hWnd)/Klassenname(class) des Fensters, dessen Status verändert werden soll. Siehe Erweiterte Fenstertiteldefinition.
text Der Text des Fensters, dessen Status verändert werden soll. Siehe Erweiterte Fenstertextdefinition.
flag Der "show" Flag des ausgeführten Programms:
    @SW_HIDE = Versteckt das Fenster.
    @SW_SHOW = Zeigt ein vorher verstecktes Fenster.
    @SW_MINIMIZE = Minimiert das Fenster.
    @SW_MAXIMIZE = Maximiert das Fenster.
    @SW_RESTORE = Macht eine Fensterminimierung oder -maximierung rückgängig.
    @SW_DISABLE = Deaktiviert ein Fenster.
    @SW_ENABLE = Aktiviert ein Fenster.

Rückgabewert

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

Bemerkungen

Falls mehrere Fenster das Kriterium erfüllen, wird das zuletzt aktive Fensters genommen.
@SW_MINIMIZE und @SW_MAXIMIZE arbeiten auch mit modalen Dialogfenstern.

Verwandte Funktionen

ControlHide, WinActivate, WinClose, WinFlash, WinGetState, WinKill, WinMinimizeAll, WinMinimizeAllUndo, WinMove, WinSetOnTop

Beispiel

Example()

Func Example()
    ; Startet den Editor
    Run("notepad.exe")

    ; Wartet maximal 10 Sekunden bis das Editorfenster erscheint.
    Local $hWnd = WinWait("[CLASS:Notepad]", "", 10)

    ; Setzt den Status des Editorfenster auf "versteckt".
    WinSetState($hWnd, "", @SW_HIDE)

    ; Wartet 2 Sekunden.
    Sleep(2000)

    ; Setzt den Status des Editorfenster auf "zeigen".
    WinSetState($hWnd, "", @SW_SHOW)

    ; Wartet 2 Sekunden.
    Sleep(2000)

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