Functions > Window > Controls >

ControlGetHandle

Obtient le handle interne d'un contrôle.

ControlGetHandle ( "title", "text", controlID )

Paramètres

title Le titre/hWnd/class de la fenêtre à atteindre. Consultez Définition spéciale de titre.
text Le texte de la fenêtre à atteindre. Consultez Définition spéciale de texte.
controlID Le contrôle avec lequel interagir. Consultez Contrôles.

Valeur de retour

Succès: Retourne la référence interne au contrôle (handle).
Échec: Retourne "" (chaine vide) et @error = 1 si aucune fenêtre correspondant au critère n'est trouvée.

Remarque

Cette fonction retourne une valeur de type HWND/Handle.

Exemple

#include <MsgBoxConstants.au3>

Example()

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

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

    ; Obtient le handle du contrôle d'édition du Bloc-notes. Le handle retourné par WinWait est utilisé pour le paramètre "titre" de ControlGetHandle.
    Local $hControl = ControlGetHandle($hWnd, "", "Edit1")

    ; Affiche Le handle du contrôle d'édition.
    MsgBox($MB_SYSTEMMODAL, "", "Le handle de Edit1 est: " & $hControl)

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