ControlGetFocus

Ermittelt, welches Steuerelement des Zielfensters den Eingabefokus hat, falls vorhanden.

ControlGetFocus, AusgabeVar , Fenstertitel, Fenstertext, Titelausnahme, Textausnahme

Parameter

AusgabeVar

Name der Variable, in der der Identifikator des Steuerelements gespeichert werden soll. Der Identifikator selbst besteht aus den Klassennamen des Steuerelements, gefolgt von einer laufenden Nummer innerhalb des übergeordneten Fensters, z. B. Button12.

Fenstertitel

Der Titel oder andere Möglichkeiten zum Identifizieren des Zielfensters. Weitere Informationen finden Sie auf der Seite Fenstertitel-Parameter & Zuletzt Gefundenes Fenster.

Fenstertext

Eine Zeichenkette, die in einem der Textelemente des Zielfensters enthalten ist (eventuell vorhandene Textelemente können mit dem internen Tool Window Spy aufgedeckt werden). Versteckte Textelemente werden nur erkannt, wenn DetectHiddenText eingeschaltet ist.

Titelausnahme

Ignoriert Fenster, deren Titel diesen Wert enthalten.

Textausnahme

Ignoriert Fenster, deren Textelemente diesen Wert enthalten.

ErrorLevel

[v1.1.04+]: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter Laufzeitfehler.

ErrorLevel wird auf 0 gesetzt, wenn das Steuerelement mit dem Eingabefokus erfolgreich abgerufen werden konnte. Ansonsten (z. B. wenn das Fenster nicht existiert oder kein einziges Steuerelement den Eingabefokus hat) wird ErrorLevel auf 1 gesetzt.

Bemerkungen

Das abgerufene Steuerelement ist auch das Steuerelement, das den Tastaturfokus hat; solche Steuerelemente sind die Anlaufstelle für jegliche Tastatureingaben des Benutzers.

Das Fenster muss aktiv sein, damit ein Steuerelement fokussiert sein kann. Ist das Fenster nicht aktiv, wird AusgabeVar leer gemacht.

Vor [v1.1.19.03] war es so, dass wenn ControlGetFocus mehrmals schnell ausgeführt wurde (also alle 500 ms oder schneller), der Benutzer keinen Doppelklick machen konnte. Diese Problematik wurde behoben.

Fenstertitel und -texte unterscheiden zwischen Groß- und Kleinschreibung. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.

Siehe auch

ControlFocus, ControlMove, ControlClick, ControlGetText, ControlSetText, ControlSend

Beispiel

ControlGetFocus, AusgabeVar, Unbenannt - Editor
if ErrorLevel
    MsgBox, Das Zielfenster existiert nicht oder hat keine Steuerelemente mit Eingabefokus.
else
    MsgBox, Steuerelement mit Eingabefokus = %AusgabeVar%