Funktionen zum Abrufen von Informationen über ein Steuerelement oder zum Ausführen verschiedener Operationen an einem Steuerelement. Klicken Sie auf einen Funktionsnamen, um mehr zu erfahren.
| Funktion | Beschreibung |
|---|---|
| ControlAddItem | Fügt einen neuen Listeneintrag zu einer ListBox oder ComboBox hinzu. |
| ControlChooseIndex | Setzt die Auswahl in einem ListBox-, ComboBox- oder Tab-Steuerelement auf den N-ten Listeneintrag/Tab. |
| ControlChooseString | Setzt die Auswahl in einer ListBox oder ComboBox auf den ersten Listeneintrag, der mit einer bestimmten Zeichenkette beginnt. |
| ControlClick | Sendet einen Mausklick oder eine Mausradaktion an ein Steuerelement. |
| ControlDeleteItem | Löscht den N-ten Listeneintrag aus einer ListBox oder ComboBox. |
| ControlFindItem | Gibt die Nummer des ListBox- oder ComboBox-Eintrags zurück, der exakt mit einer Zeichenkette übereinstimmt. |
| ControlFocus | Setzt den Eingabefokus auf ein bestimmtes Steuerelement innerhalb eines Fensters. |
| ControlGetChecked | Gibt einen Wert ungleich 0 zurück, wenn das CheckBox- oder Radio-Steuerelement eingeschaltet ist. |
| ControlGetChoice | Gibt den Namen des aktuell ausgewählten ListBox- oder ComboBox-Eintrags zurück. |
| ControlGetClassNN | Gibt die ClassNN-Bezeichnung (Klassenname und Sequenznummer) eines bestimmten Steuerelements zurück. |
| ControlGetEnabled | Gibt einen Wert ungleich 0 zurück, wenn die Interaktion mit einem bestimmten Steuerelement erlaubt ist. |
| ControlGetFocus | Ermittelt, welches Steuerelement im Zielfenster den Tastaturfokus hat, falls vorhanden. |
| ControlGetHwnd | Gibt die eindeutige ID-Nummer eines bestimmten Steuerelements zurück. |
| ControlGetIndex | Gibt die Indexnummer des aktuell ausgewählten Listeneintrags/Tabs im ListBox-, ComboBox- oder Tab-Steuerelement zurück. |
| ControlGetItems | Gibt ein Array aller Einträge/Zeilen in einer ListBox, ComboBox oder DropDownList zurück. |
| ControlGetPos | Ruft die Position und Größe eines Steuerelements ab. |
| ControlGetStyle ControlGetExStyle |
Gibt einen Integer zurück, der den Style oder erweiterten Style eines bestimmten Steuerelements repräsentiert. |
| ControlGetText | Ruft den Text eines Steuerelements ab. |
| ControlGetVisible | Gibt einen Wert ungleich 0 zurück, wenn ein bestimmtes Steuerelement sichtbar ist. |
| ControlHide | Versteckt ein bestimmtes Steuerelement. |
| ControlHideDropDown | Versteckt die Auswahlliste einer ComboBox. |
| ControlMove | Verschiebt ein Steuerelement oder ändert dessen Größe. |
| ControlSend ControlSendText |
Sendet simulierte Tastendrücke oder Text an ein Fenster oder Steuerelement. |
| ControlSetChecked | Schaltet ein CheckBox- oder Radio-Steuerelement ein oder aus. |
| ControlSetEnabled | Erlaubt oder verbietet die Interaktion mit einem bestimmten Steuerelement. |
| ControlSetStyle ControlSetExStyle |
Ändert den Style oder erweiterten Style eines bestimmten Steuerelements. |
| ControlSetText | Ändert den Text eines Steuerelements. |
| ControlShow | Macht ein zuvor verstecktes Steuerelement wieder sichtbar. |
| ControlShowDropDown | Macht die Auswahlliste einer ComboBox sichtbar. |
| EditGetCurrentCol | Gibt die Nummer der Spalte in einem Edit-Steuerelement zurück, auf der sich der Textcursor (Einfügemarke) aktuell befindet. |
| EditGetCurrentLine | Gibt die Nummer der Zeile in einem Edit-Steuerelement zurück, auf der sich der Textcursor (Einfügemarke) aktuell befindet. |
| EditGetLine | Gibt den Text auf einer bestimmten Zeile in einem Edit-Steuerelement zurück. |
| EditGetLineCount | Gibt die Anzahl der Zeilen in einem Edit-Steuerelement zurück. |
| EditGetSelectedText | Gibt den markierten Text in einem Edit-Steuerelement zurück. |
| EditPaste | Fügt eine bestimmte Zeichenkette am Textcursor (Einfügemarke) in einem Edit-Steuerelement ein. |
| ListViewGetContent | Gibt eine Liste bestimmter oder aller Elemente/Zeilen in einer ListView zurück. |
Funktionen, die mit einzelnen Steuerelementen arbeiten, haben einen Parameter namens Steuerelement, der einige verschiedene Möglichkeiten zur Identifizierung des Steuerelements unterstützt. Für den Steuerelement-Parameter kann Folgendes angegeben werden:
ClassNN (Zeichenkette): Die ClassNN-Bezeichnung (Klassenname und Instanznummer) des Steuerelements, die mit dem internen Tool "Window Spy" ermittelt werden kann. Zum Beispiel ist "Edit1" das erste Steuerelement mit dem Klassennamen "Edit".
Text (Zeichenkette): Der Text des Steuerelements. Das Übereinstimmungsverhalten ist abhängig von SetTitleMatchMode.
HWND (Integer): Die HWND-Nummer (eindeutige ID) des Steuerelements, die üblicherweise via ControlGetHwnd, MouseGetPos oder DllCall abgerufen werden kann. Dies funktioniert auch mit versteckten Steuerelementen, selbst wenn DetectHiddenWindows ausgeschaltet ist. Alle nachfolgenden Fensterparameter werden ignoriert.
Objekt: Ein beliebiges Objekt mit einer Hwnd-Eigenschaft, wie z.B. ein GuiControl. Es wird ein PropertyError ausgelöst, wenn das Objekt keine Hwnd-Eigenschaft hat, oder ein TypeError, wenn es keinen reinen Integer zurückgibt. Alle nachfolgenden Fensterparameter werden ignoriert.
Weggelassen: Einige Funktionen können entweder mit einem Steuerelement oder einem Top-Level-Fenster arbeiten. Wenn der Steuerelement-Parameter weggelassen wird, verwendet die Funktion das Zielfenster (angegeben via FensterTitel), anstatt eines seiner Steuerelemente. Zum Beispiel kann ControlSend Tastendrücke direkt an das Fenster senden.
Bei Misserfolg wird typischerweise einer der folgenden Fehler ausgelöst:
Um die Zuverlässigkeit zu erhöhen, erfolgt jedes Mal, nachdem eine steuerelementmodifizierende Funktion verwendet wurde, automatisch eine Verzögerung (außer bei ControlSetStyle und ControlSetExStyle). Diese Verzögerung kann mit SetControlDelay oder durch Zuweisung eines Wertes an A_ControlDelay geändert werden. Weitere Informationen finden Sie unter SetControlDelay-Bemerkungen.
Mit MouseGetPos kann die ClassNN-Bezeichnung oder HWND-Nummer (eindeutige ID) des Steuerelements unter dem Mauszeiger abgerufen werden.
Mit WinGetControls oder WinGetControlsHwnd kann ein Array von Steuerelementen in einem Fenster abgerufen werden.
SetControlDelay, Win-Funktionen, GuiControl-Objekt (für via Skript erstellte Steuerelemente)