Sendet einen Mausklick oder eine Mausradaktion an ein Steuerelement.
ControlClick Steuerelement-oder-Pos, FensterTitel, FensterText, WelcheTaste, KlicksAnzahl, Optionen, AusnahmeTitel, AusnahmeText
Typ: Zeichenkette, Integer oder Objekt
Wenn weggelassen, wird das Zielfenster selbst angeklickt. Andernfalls verwenden Sie einen der folgenden Modi.
Modus 1 (Position): Geben Sie die X- und Y-Koordinate relativ zur oberen linken Ecke des Clientbereichs des Zielfensters an. Die X-Koordinate muss vor der Y-Koordinate stehen und beide müssen durch mindestens ein Leer- oder Tabulatorzeichen voneinander getrennt sein. Zum Beispiel: "X55 Y33". Befindet sich auf den angegebenen Koordinaten ein Steuerelement, wird das Klickereignis an dieses Steuerelement weitergeleitet. Wenn dort kein Steuerelement ist, wird das Klickereignis an das Zielfenster selbst gesendet (was je nach Art des Fensters keinen Effekt haben könnte).
Hinweis: Im Modus 1 werden die Optionsbuchstaben X und Y in Optionen ignoriert.
Modus 2 (Steuerelement): Geben Sie die ClassNN-Bezeichnung, den Text oder die HWND-Nummer des Steuerelements an, oder ein Objekt mit einer Hwnd-Eigenschaft. Einzelheiten finden Sie unter Der Steuerelement-Parameter.
Standardmäßig hat Modus 2 eine höhere Priorität als Modus 1. Sollte zum Beispiel der seltene Fall eintreten, dass ein Steuerelement einen Text oder eine ClassNN-Bezeichnung im Format "Xnnn Ynnn" aufweist, würde Modus 2 in Kraft treten. Um dieses Problem zu umgehen und Modus 1 zu erzwingen, geben Sie wie folgt das Wort Pos in den Optionen an: ControlClick "x255 y152", FensterTitel,,,, "Pos".
Typ: Zeichenkette, Integer oder Objekt
Wenn jeder dieser Parameter leer ist oder weggelassen wird, wird das Zuletzt Gefundene Fenster verwendet. Andernfalls geben Sie für FensterTitel einen Fenstertitel oder andere Kriterien zur Identifizierung des Zielfensters und/oder für FensterText eine Teilzeichenkette aus einem Textelement des Zielfensters an (Textelemente können mit dem internen Tool "Window Spy" in Erfahrung gebracht werden).
AusnahmeTitel und AusnahmeText können verwendet werden, um ein oder mehrere Fenster anhand ihres Titels oder Textes auszuschließen. Ihre Angabe ähnelt der von FensterTitel und FensterText, außer dass AusnahmeTitel keine anderen Kriterien als den Fenstertitel erkennt.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Standardmäßig werden versteckte Fenster nicht erkannt und versteckte Textelemente erkannt, was mit DetectHiddenWindows und DetectHiddenText geändert werden kann. Standardmäßig kann ein Fenstertitel den angegebenen FensterTitel oder AusnahmeTitel an beliebiger Stelle enthalten, um eine Übereinstimmung zu sein, was mit SetTitleMatchMode geändert werden kann.
Typ: Zeichenkette
Wenn leer oder weggelassen, wird standardmäßig Left verwendet (die linke Maustaste). Andernfalls geben Sie die zu klickende Taste oder die Dreh-/Kipprichtung des Mausrads an.
Taste: Left, Right, Middle (oder jeweils nur der erste Buchstabe) oder X1 (vierte Maustaste) oder X2 (fünfte Maustaste).
Mausrad: Geben Sie WheelUp oder WU an, um das Mausrad nach oben zu drehen (von Ihnen weg); geben Sie WheelDown oder WD an, um es nach unten zu drehen (zu Ihnen hin). Geben Sie WheelLeft (oder WL) oder WheelRight (oder WR) an, um das Mausrad nach links bzw. rechts zu kippen. KlicksAnzahl ist die Anzahl der Schritte, um die das Mausrad gedreht werden soll.
Typ: Integer
Wenn weggelassen, wird standardmäßig 1 verwendet. Andernfalls geben Sie an, wie oft die Maustaste geklickt oder das Mausrad gedreht werden soll.
Typ: Zeichenkette
Wenn leer oder weggelassen, besteht jeder Klick aus einem Down- und Up-Ereignis, das in der Mitte des Steuerelements erfolgt (sofern Modus 2 verwendet wird). Andernfalls geben Sie eine Zeichenkette an, die aus einer oder mehreren der folgenden Optionen besteht: Zum Beispiel: "d x50 y25".
NA: Kann die Zuverlässigkeit erhöhen. Siehe Zuverlässigkeit weiter unten.
D: Drückt die Maustaste nach unten, ohne sie wieder loszulassen (also ein Down-Ereignis). Fehlt sowohl die D- als auch U-Option, wird ein vollständiger Mausklick gesendet (also ein Down- und Up-Ereignis).
U: Lässt die Maustaste los (also ein Up-Ereignis). Diese Option sollte nicht verwendet werden, wenn die D-Option bereits vorhanden ist (und umgekehrt).
Pos: Geben Sie das Wort Pos in Optionen an, um den X/Y-Positioniermodus zu erzwingen, wie oben im Steuerelement-oder-Pos-Parameter beschrieben.
Xn: Geben Sie für n die X-Position an, auf der geklickt werden soll, relativ zur oberen linken Ecke des Steuerelements. Wenn weggelassen, erfolgt der Mausklick in der horizontalen Mitte des Steuerelements.
Yn: Geben Sie für n die Y-Position an, auf der geklickt werden soll, relativ zur oberen linken Ecke des Steuerelements. Wenn weggelassen, erfolgt der Mausklick in der vertikalen Mitte des Steuerelements.
Verwenden Sie dezimale (nicht hexadezimale) Zahlen für die Optionen X und Y.
Es wird in folgenden Fällen eine Ausnahme ausgelöst:
Um die Zuverlässigkeit zu erhöhen - insbesondere dann, wenn der Benutzer die Maus während eines ControlClicks physisch bewegt - kann eine oder beide der folgenden Maßnahmen helfen:
1) Verwenden Sie SetControlDelay -1 vor ControlClick. Dadurch wird verhindert, dass die Maustaste während des Klicks gedrückt gehalten wird, was wiederum Störungen durch physische Mausbewegungen reduziert.
2) Geben Sie die Zeichenkette NA im sechsten Parameter (Optionen) wie unten gezeigt an:
SetControlDelay -1 ControlClick "Toolbar321", FensterTitel,,,, "NA"
Die NA-Option verhindert einerseits, dass das Zielfenster als aktiv markiert wird, und andererseits, dass die Eingabeverarbeitung des Fensters und des Skripts vermischt werden, was eventuelle Störungen durch physische Mausbewegungen unterdrückt (aber normalerweise nur, wenn das Zielfenster nicht aktiv ist). Diese Methode funktioniert möglicherweise nicht für alle Arten von Fenstern und Steuerelementen.
Einige Anwendungen ignorieren eine KlicksAnzahl höher als 1 beim Drehen des Mausrads. Für solche Anwendungen können Sie eine Schleife nutzen, um das Mausrad mehr als einen Schritt zu drehen. Das folgende Beispiel dreht das Mausrad fünf Schritte:
Loop 5
ControlClick Steuerelement, FensterTitel, FensterText, "WheelUp"
SetControlDelay, Control-Funktionen, Click