Sendet einen Befehl an ein Control.
ControlCommand ( "title", "text", controlID, "command" [, "option"] )
Parameter
| title | Der Titel des Fensters, auf das zugegriffen werden soll. |
| text | Der Text des Fensters, auf das zugegriffen werden soll. |
| ControlID | Die ID des Controls, das beeinflusst werden soll. Siehe Controls. |
| command | Der Befehl, der gesendet werden soll. |
| option | [optional] Einige Befehle erfordern zusätzliche Parameter. |
Rückgabewert
Ist abhängig vom Befehl wie in der nachfolgenden Tabelle dargestellt. Im Falle eines Fehlers (wie ein ungültiger Befehl oder eine ungültige ID) wird @error=1 gesetzt.| Befehl, Option | Rückgabewert |
| "IsVisible", "" | Gibt 1 zurück, wenn das Control sichtbar (visible) ist, ansonsten 0. |
| "IsEnabled", "" | Gibt 1 zurück, wenn das Control freigegeben (enabled) ist, ansonsten 0. |
| "ShowDropDown", "" | Zeigt die Einzelitems einer ComboBox. |
| "HideDropDown", "" | Versteckt die Einzelitems einer ComboBox. |
| "AddString", 'string' | Fügt einen String an das Ende einer ListBox oder einer ComboBox hinzu. |
| "DelString", occurrence | Entfernt einen String entsprechend des Auftretens (occurrence) in einer ListBox oder einer ComboBox. |
| "FindString", 'string' | Gibt die Referenz des Auftretens in einer ListBox oder einer ComboBox gefundenen Strings zurück. |
| "SetCurrentSelection", occurrence | Wählt in einer ListBox oder einer ComboBox ein Element, entsprechend der occurence-Referenz aus. |
| "SelectString", 'string' | Wählt in einer ListBox oder einer ComboBox ein Element aus, das dem String 'string' entspricht. |
| "IsChecked", "" | Gibt 1 zurück, wenn die Befehlsfläche ausgewählt ist, ansonsten 0. |
| "Check", "" | Aktiviert einen Radiobutton oder eine Checkbox |
| "UnCheck", "" | Deaktiviert einen Radiobutton oder eine Checkbox. |
| "GetCurrentLine", "" | Gibt die Zeilennummer zurück, in der der Cursor in einem Edit-Control steht. |
| "GetCurrentCol", "" | Gibt die Spaltennummer zurück, in der der Cursor in einem Edit-Control steht. |
| "GetCurrentSelection", "" | Gibt den Namen des augenblicklich gewählten Elements in einer ListBox oder einer ComboBox zurück. |
| "GetLineCount", "" | Gibt die Anzahl der Zeilen eines Edit-Controls zurück. |
| "GetLine", Zeile# | Gibt den Text der angegebenen Zeile eines Edit-Controls zurück. |
| "GetSelected", "" | Gibt den ausgewählten Text eines Edit-Controls zurück. |
| "EditPaste", 'string' | Fügt den String 'string' an der Cursorposition in ein Edit-Control ein. |
| "CurrentTab", "" | Rückgabe des aktuellen Tabs eines SysTabControl32-Control |
| "TabRight", "" | Geht zum nächsten rechten Tab eines SysTabControl32-Controls |
| "TabLeft", "" | Geht zum nächsten linken Tab eines SysTabControl32-Controls |
| "SendCommandID", Command ID | Simuliert die WM_COMMAND Nachricht. Üblicherweise für ToolbarWindow32-Controls genutzt - um die Command-ID zu erhalten, wählt man die Registerkarte "Toolbar" im Au3Info-Tool. |
Bemerkungen
Einige Controls sind immun gegen Automatisierung, solange sie nicht zum aktiven Fenster gehören. Es ist die WinActivate() Funktion zu benutzen, um diese Fenster zu aktivieren, bevor die ControlCommand() Funktion auf diese Controls angewendet wird.
Verwandte Funktionen
ControlClick, ControlDisable, ControlEnable, ControlFocus, ControlGetPos, ControlGetText, ControlHide, ControlMove, ControlSetText, ControlShow, StatusbarGetText, WinActivate, WinMenuSelectItem, WinGetClassList, ControlGetFocus, ControlListView, ControlSend, ControlTreeView
Beispiel
Run("notepad.exe")
WinWait("[CLASS:Notepad]", "")
$a = ControlCommand("[CLASS:Notepad]", "", "Edit1", "GetLineCount", "")
MsgBox(8256,'Information', 'Editorfenster enthält ' & $a & ' Textzeile.')