Functions > Window >

WinGetState

Obtient l'�tat d'une fen�tre.

WinGetState ( "title" [, "text"] )

Param�tres

title Le titre/hWnd/class de la fen�tre � traiter. Consultez D�finition sp�ciale de titre.
text [optionnel] Le texte de la fen�tre � traiter. La valeur par d�faut est une cha�ne vide. Consultez D�finition sp�ciale de texte.

Valeur de retour

Succ�s: Retourne une valeur indiquant l'�tat de la fen�tre. Plusieurs valeurs peuvent �tre additionn�es, donc utilisez BitAND() pour examiner la partie qui vous int�resse:
    $WIN_STATE_EXISTS (1) = La fen�tre existe
    $WIN_STATE_VISIBLE (2) = La fen�tre est visible
    $WIN_STATE_ENABLED (4) = La fen�tre est install�e
    $WIN_STATE_ACTIVE (8) = La fen�tre est active
    $WIN_STATE_MINIMIZED (16) = La fen�tre est r�duite
    $WIN_STATE_MAXIMIZED (32) = La fen�tre est agrandie
�chec: Retourne 0 et d�finit @error <> 0 si la fen�tre n'est pas trouv�e.

Les constantes sont d�finies dans "AutoItConstants.au3".

En relation

BitAND, WinGetPos, WinSetState

Exemple

#include <AutoItConstants.au3>
#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Ex�cute le Bloc-notes
    Run("notepad.exe")

    ; Attend 10 secondes pour que la fen�tre du bloc-notes apparaisse.
    Local $hWnd = WinWait("[CLASS:Notepad]", "", 10)

    ; R�cup�re l'�tat de la fen�tre du Bloc-notes en utilisant le handle retourn� par WinWait.
    Local $iState = WinGetState($hWnd)

    ; Teste si la fen�tre du Bloc-notes est minimis�e et affiche la bo�te de message appropri�e.
    If BitAND($iState, $WIN_STATE_MINIMIZED) Then
        MsgBox($MB_SYSTEMMODAL, "", "Notepad est minimis� et l'�tat retourn� par WinGetState est - " & $iState)
    Else
        MsgBox($MB_SYSTEMMODAL, "", "Notepad n'est pas minimis� et l'�tat retourn� par WinGetState est - " & $iState)
    EndIf

    ; Ferme la fen�tre du Bloc-notes en utilisant le handle retourn� par WinWait.
    WinClose($hWnd)
EndFunc   ;==>Example