Functions > Window > Controls >


ControlCommand

Envoie une commande � un contr�le.

ControlCommand ( "title", "text", controlID, "command" [, "option"] )

Param�tres

title Le titre/handle/class de la fen�tre � atteindre. Consultez Titre Special Definition.
text Le texte de la fen�tre � atteindre. Consultez Text special d�finition.
controlID Le contr�le avec lequel interagir. Consultez Controls.
command La commande � envoyer au contr�le.
option [optionnel] Param�tres additionnels requis par certaines commandes.

Valeur de retour

La valeur retourn�e d�pend de la commande comme le montre le tableau ci-dessous. En cas d'erreur (telle qu'une commande ou fen�tre/contr�le invalide) @error=1.
Commande, Option Valeur de retour
"IsVisible", "" Retourne 1 si le contr�le est visible, sinon 0
"IsEnabled", "" Retourne 1 si le contr�le est actif, sinon 0
"ShowDropDown", "" D�plie un contr�le type ComboBox
"HideDropDown", "" Replie un contr�le type ComboBox
"AddString", 'string' Ajoute la cha�ne 'string' � la fin d'un contr�le type ListBox ou ComboBox
"DelString", occurrence Efface une cha�ne suivant son occurrence dans un contr�le type ListBox ou ComboBox
"FindString", 'string' Retourne la position de la chaine 'string' d'un contr�le type ListBox ou ComboBox
"SetCurrentSelection", occurrence S�lectionne une chaine en fonction de sont occurrence dans un contr�le type ListBox ou ComboBox
"SelectString", 'string' S�lectionne la chaine 'string' dans un contr�le type ListBox ou ComboBox
"IsChecked", "" Retourne 1 si le contr�le est coch�, sinon 0
"Check", "" Coche le contr�le type CheckBox ou RadioBox
"UnCheck", "" D�coche le contr�le type CheckBox ou RadioBox
"GetCurrentLine", "" Retourne le num�ro de la ligne positionn�e sous le curseur, dans un contr�le type Edit
"GetCurrentCol", "" Retourne le num�ro de la colonne positionn�e sous le curseur, dans un contr�le type Edit
"GetCurrentSelection", "" Retourne le nom de l'�l�ment s�lectionn� dans un contr�le type ListBox ou ComboBox
"GetLineCount", "" Retourne le nombre de lignes dans un contr�le type Edit
"GetLine", line# Retourne le texte d'une ligne d'un contr�le de type Edit
"GetSelected", "" Retourne le texte s�lectionn� d'un contr�le de type Edit
"EditPaste", 'string' Ajoute la chaine 'string' � la position du curseur dans un contr�le de type Edit
"CurrentTab", "" Retourne l'onglet s�lectionn� dans un contr�le type SysTabControl32
"TabRight", "" Passe � l'onglet suivant vers la droite dans un contr�le type SysTabControl32
"TabLeft", "" Passe � l'onglet suivant vers la gauche dans un contr�le type SysTabControl32
"SendCommandID", Command ID Simule l'envoi du message WM_COMMAND. Habituellement utilis� pour les contr�les type ToolbarWindow32 - Utilisez l'onglet 'ToolBar' de Au3Info pour avoir l'ID d'une commande.

Remarques

Certains contr�les peuvent r�sister � l'automation tant qu'ils ne sont pas dans la fen�tre active. Utilisez la fonction WinActivate() pour mettre la fen�tre des contr�les au premier plan avant d'utiliser ControlCommand().

Certaines commandes fonctionnant pour un contr�le type ComboBox ou ListBox, peuvent ne pas fonctionner pour des contr�les type "ComboLBox".

En relation

ControlClick, ControlDisable, ControlEnable, ControlFocus, ControlGetFocus, ControlGetPos, ControlGetText, ControlHide, ControlListView, ControlMove, ControlSend, ControlSetText, ControlShow, ControlTreeView, StatusbarGetText, WinActivate, WinGetClassList, WinMenuSelectItem

Exemple

#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)

    ; Envoie une commande au contr�le d'�dition de Bloc-notes pour trouver le nombre de lignes. Le handle renvoy� par WinWait est utilis� pour le param�tre "titre" de ControlCommand.
    Local $iCount = ControlCommand($hWnd, "", "Edit1", "GetLineCount", "")

    ; Affiche le nombre de lignes.
    MsgBox($MB_SYSTEMMODAL, "", "Le nombre de lignes dans Notepad est: " & $iCount)

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