Functions > Window >

WinActivate

Active (donne le focus) � une fen�tre.

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

Param�tres

title Le titre/hWnd/class de la fen�tre � activer. Consultez D�finition sp�ciale de titre.
text [optionnel] Le texte de la fen�tre � activer. Par d�faut, c'est une cha�ne vide. Consultez D�finition sp�ciale de texte.

Valeur de retour

Succ�s: Retourne le handle de la fen�tre.
�chec: Retourne 0 si la fen�tre n'est pas trouv�e ou ne peut pas �tre activ�e.

Remarques

Vous pouvez utiliser la fonction WinActive() pour v�rifier si WinActivate() a r�ussi. Si plusieurs fen�tres correspondent aux crit�res, la fen�tre la plus r�cente sera activ�e. WinActivate() fonctionne sur les fen�tres r�duites. Toutefois, une fen�tre qui est "Always On Top" peut encore couvrir une fen�tre que vous avez activ�e.

Apr�s une activation r�ussie, @extended contient 1 si la fen�tre �tait d�j� active, 2 sinon.

En relation

WinClose, WinKill, WinMove, WinSetState, WinTitleMatchMode (Option)

Exemple

#include <MsgBoxConstants.au3>

Example()

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

    ; Teste si la fen�tre est activ�e et affiche le r�sultat.
    If WinActivate("[CLASS:Notepad]", "") Then
        MsgBox($MB_SYSTEMMODAL + $MB_ICONWARNING, "Avertissement", "Fen�tre activ�e" & @CRLF & @CRLF & "Peut �tre que votre syst�me est assez rapide.")
    Else
        ; Le bloc-notes s'affichera lorsque MsgBox aura �coul� un d�lai et l'autorisera.
        MsgBox($MB_SYSTEMMODAL, "", "Fen�tre non activ�e" & @CRLF & @CRLF & "Mais le bloc-notes est en arri�re-plan � cause de MsgBox.", 5)
    EndIf

    ; Teste de nouveau si la fen�tre est maintenant activ�e et affiche le r�sultat.
    If WinActivate("[CLASS:Notepad]", "") Then
        MsgBox($MB_SYSTEMMODAL, "", "Fen�tre maintenant activ�e")
    Else
        MsgBox($MB_SYSTEMMODAL + $MB_ICONERROR, "Erreur", "Fen�tre non activ�e")
    EndIf

    ; Ferme la fen�tre du Bloc-notes en utilisant le handle retourn� par WinWait.
    WinClose("[CLASS:Notepad]", "")
EndFunc   ;==>Example