ControlClick
Sendet einen Mausklick-Befehl an das angegebene Control.
ControlClick ( "title", "text", controlID [, button = "left" [, clicks = 1 [, x [, y]]]] )
Parameter
| title | Der Titel/hWnd/Klasse des Fensters, auf das zugegriffen werden soll. Siehe Erweiterte Fenstertiteldefinition. |
| text | Der Text des Fensters, auf das zugegriffen werden soll. Siehe Erweiterte Fenstertextdefinition. |
| ControlID | Die ID des Controls, das beeinflusst werden soll. Siehe Controls. |
| button | [optional] Die zu drückende Taste, "left", "right", "middle", "menu", "primary", "secondary". Standard ist "left". |
| clicks | [optional] Die Anzahl der Mausklicks. Standard ist 1. |
| x | [optional] Die x-Position innerhalb des Controls, die geklickt werden soll. Standard ist die Mitte |
| y | [optional] Die y-Position innerhalb des Controls, die geklickt werden soll. Standard ist die Mitte |
Rückgabewert
| Erfolg: | 1. |
| Fehler: | 0. |
Bemerkungen
Einige Controls in inaktiven Fenstern widerstehen Klicks, bis das Fenster das aktive Fenster ist. Hierzu ist zuerst die WinActivate()-Funktion zu benutzen, um das Fenster in den Vordergrund zu zwingen bevor man ControlClick() benutzen kann.
Die Benutzung von 2 Klicks führt einen Doppelklick in dem Control durch. Dies kann auch verwendet werden, um ein Programm aus dem Explorer heraus zu starten!
Falls der Benutzer die linke und rechte Maustaste in der Systemsteuerung vertauscht hat, dann ist das Verhalten der Button-Parameter unterschiedlich.
"Left" und "right" simulieren immer einen Klick auf die jeweilige Taste, egal ob die Tasten vertauscht sind oder nicht.
Die Button-Parameter "primary" oder "main" lösen immer den Hauptklick aus (der normalerweise "Linksklick" genannt wird), egal ob die Tasten vertauscht wurden oder nicht.
Die Parameter "secondary" oder "menu" lassen für gewöhnlich das Kontextmenü erscheinen, egal ob die Tasten vertauscht wurden oder nicht.
| Parameter | Klick (normal) | Klick (getauscht) |
|---|---|---|
| "" | links | links |
| "left" | links | links |
| "middle" | Mitte | Mitte |
| "right" | rechts | rechts |
| "primary" | links | rechts |
| "main" | links | rechts |
| "secondary" | rechts | links |
| "menu" | rechts | links |
Verwandte Funktionen
ControlCommand, MouseClick, WinActivate
Beispiel
Example()
Func Example()
; Startet den Editor
Run("notepad.exe")
; Wartet maximal 10 Sekunden bis das Editorfenster erscheint.
Local $hWnd = WinWait("[CLASS:Notepad]", "", 10)
; Sendet einen Mausklick an das Edit-Control des Editor. Dabei wird das von WinWait zurückgegebenen Handle verwendet.
ControlClick($hWnd, "", "Edit1")
; Wartet 2 Sekunden.
Sleep(2000)
; Schließt das Editorfenster durch die Verwendung des Klassennamens (classname) vom Editor.
WinClose($hWnd)
EndFunc ;==>Example