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 Eintrag in einem Listenfeld, Kombinationsfeld oder einer Dropdownliste hinzu. |
| ControlChooseIndex | Selektiert per Positionsnummer einen Eintrag in einem Listenfeld, Kombinationsfeld oder einer Dropdownliste, oder eine Registerkarte in einem Registerkarten-Steuerelement. |
| ControlChooseString | Selektiert per Zeichenkette einen Eintrag in einem Listenfeld, Kombinationsfeld oder einer Dropdownliste, oder eine Registerkarte in einem Registerkarten-Steuerelement. |
| ControlClick | Sendet einen Mausklick oder eine Mausradaktion an ein Fenster oder Steuerelement. |
| ControlDeleteItem | Löscht per Positionsnummer einen Eintrag aus einem Listenfeld, Kombinationsfeld oder einer Dropdownliste. |
| ControlFindItem | Sucht per Zeichenkette einen Eintrag in einem Listenfeld, Kombinationsfeld oder einer Dropdownliste und gibt seine Positionsnummer zurück. |
| ControlFocus | Setzt den Tastaturfokus auf ein Steuerelement. |
| ControlGetChecked | Gibt 1 zurück, wenn ein Kontrollkästchen oder Optionsfeld markiert ist, oder 0, wenn unmarkiert. |
| ControlGetChoice | Gibt den Text des aktuell ausgewählten Eintrags in einem Listenfeld, Kombinationsfeld oder einer Dropdownliste zurück. |
| ControlGetClassNN | Gibt die ClassNN (Klassenname und Sequenznummer) eines Steuerelements zurück. |
| ControlGetEnabled | Gibt 1 zurück, wenn die Interaktion mit einem Steuerelement erlaubt ist, oder 0, wenn verboten. |
| ControlGetFocus | Ermittelt, welches Steuerelement im Zielfenster den Tastaturfokus hat, sofern vorhanden. |
| ControlGetHwnd | Gibt das Fensterhandle (HWND) eines Steuerelements zurück. |
| ControlGetIndex | Gibt die Positionsnummer des aktuell ausgewählten Eintrags in einem Listenfeld, Kombinationsfeld oder einer Dropdownliste zurück. Kann auch die Positionsnummer der aktuell aktiven Registerkarte in einem Registerkarten-Steuerelement zurückgeben. |
| ControlGetItems | Gibt ein Array aller Einträge in einem Listenfeld, Kombinationsfeld oder einer Dropdownliste zurück. |
| ControlGetPos | Liefert die Position und Größe eines Steuerelements. |
| ControlGetStyle ControlGetExStyle |
Gibt einen Integer zurück, der den Style oder erweiterten Style eines Steuerelements repräsentiert. |
| ControlGetText | Liefert den Text eines Steuerelements. |
| ControlGetVisible | Gibt 1 zurück, wenn ein Steuerelement sichtbar ist, oder 0, wenn versteckt. |
| ControlHide | Versteckt ein Steuerelement. |
| ControlHideDropDown | Schließt die aufklappbare Liste eines Kombinationsfelds oder einer Dropdownliste. |
| ControlMove | Verschiebt ein Steuerelement und/oder ändert dessen Größe. |
| ControlSend ControlSendText |
Sendet simulierte Tastendrücke oder Text an ein Fenster oder Steuerelement. |
| ControlSetChecked | Markiert oder entmarkiert ein Kontrollkästchen oder Optionsfeld. |
| ControlSetEnabled | Erlaubt oder verbietet die Interaktion mit einem Steuerelement. |
| ControlSetStyle ControlSetExStyle |
Ändert den Style oder erweiterten Style eines Steuerelements. |
| ControlSetText | Ändert den Text eines Steuerelements. |
| ControlShow | Zeigt ein Steuerelement, falls es zuvor versteckt wurde. |
| ControlShowDropDown | Öffnet die aufklappbare Liste eines Kombinationsfelds oder einer Dropdownliste. |
| EditGetCurrentCol | Gibt die Spaltennummer in einem Eingabefeld zurück, auf der sich die Einfügemarke befindet. |
| EditGetCurrentLine | Gibt die Zeilennummer in einem Eingabefeld zurück, auf der sich die Einfügemarke befindet. |
| EditGetLine | Gibt den Text einer Zeile in einem Eingabefeld per Zeilennummer zurück. |
| EditGetLineCount | Gibt die Anzahl der Zeilen in einem Eingabefeld zurück. |
| EditGetSelectedText | Gibt den markierten Text in einem Eingabefeld zurück. |
| EditPaste | Fügt eine Zeichenkette bei der Einfügemarke in einem Eingabefeld ein. |
| ListViewGetContent | Gibt Inhaltsdaten von einem ListView-Steuerelement zurück, z.B. Zeilen, Spalten oder Zählwerte. |
Bei Misserfolg wird typischerweise einer der folgenden Fehler ausgelöst:
Die meisten hier gelisteten Funktionen sind für die Verwendung mit Steuerelementen in einem Nicht-GUI-Fenster vorgesehen, also einem Fenster, das nicht mit der Gui-Funktion erstellt wurde. Sie funktionieren am besten mit den gängigen oder vordefinierten Steuerelementen von Microsoft. Einige Anwendungen verwenden jedoch benutzerdefinierte oder modifizierte Steuerelemente – in diesem Fall funktionieren die Funktionen möglicherweise nicht wie erwartet. Für GUI-Steuerelemente ist es in der Regel sinnvoller, ihr GuiControl-Objekt zu verwenden, sofern es ein entsprechendes Gegenstück gibt.
Funktionen, die mit einzelnen Steuerelementen arbeiten, haben einen Parameter namens StrlmntID, der einige verschiedene Möglichkeiten zur Identifizierung des Steuerelements unterstützt. Weitere Informationen finden Sie unter Steuerelementidentifikatoren.
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 oder das HWND 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)