ControlFocus

Setzt den Tastaturfokus auf ein Steuerelement.

ControlFocus , StrlmntID, FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

Parameter

StrlmntID

Wenn leer oder weggelassen, wird das oberste Steuerelement des Zielfensters verwendet. Andernfalls geben Sie die ClassNN oder den Text des Steuerelements an, oder lassen Sie den Parameter leer und geben Sie ahk_id %StrlmntHwnd% im FensterTitel-Parameter an, um mit dem HWND des Steuerelements zu arbeiten. Einzelheiten finden Sie unter Steuerelementidentifikatoren.

FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

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 (wie von Window Spy angezeigt).

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 bzw. DetectHiddenText geändert werden kann. Standardmäßig muss ein Fenstertitel mit dem angegebenen FensterTitel oder AusnahmeTitel beginnen, um eine Übereinstimmung zu sein, was mit SetTitleMatchMode geändert werden kann.

Fehlerbehandlung

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

ErrorLevel wird bei Misserfolg auf 1 und bei Erfolg auf 0 gesetzt.

Bemerkungen

Dieser Befehl ist für die Verwendung mit Steuerelementen in einem Nicht-GUI-Fenster vorgesehen, also einem Fenster, das nicht mit dem Gui-Befehl erstellt wurde. Er funktioniert am besten mit den gängigen oder vordefinierten Steuerelementen von Microsoft. Einige Anwendungen verwenden jedoch benutzerdefinierte oder modifizierte Steuerelemente – in diesem Fall funktioniert der Befehl möglicherweise nicht wie erwartet. Für GUI-Steuerelemente ist es in der Regel sinnvoller, GuiControl Focus zu verwenden.

Um den gewünschten Effekt zu erzielen, darf das Fenster des Steuerelements weder minimiert noch versteckt sein.

Um die Zuverlässigkeit zu erhöhen, erfolgt jedes Mal, nachdem dieser Befehl ausgeführt wurde, automatisch eine Verzögerung. Diese Verzögerung kann via SetControlDelay geändert werden.

Mit MouseGetPos kann die ClassNN oder das HWND des Steuerelements unter dem Mauszeiger abgerufen werden.

Wenn ein Steuerelement durch eine Benutzereingabe fokussiert wird, z.B. durch Drücken von Tab, werden zusätzliche Effekte unabhängig vom fokussierten Steuerelement angewendet. Diese Effekte werden nicht von ControlFocus angewendet, daher gelten die folgenden Einschränkungen:

• Beim Fokussieren einer Schaltfläche wird diese nicht automatisch zur Standardschaltfläche gemacht (normalerweise geschieht das nur, wenn eine Schaltfläche durch eine Benutzereingabe fokussiert wird). Die Standardschaltfläche kann üblicherweise durch Drücken von Enter aktiviert werden.
• Wenn eine Benutzereingabe zuvor eine kurzzeitige Änderung der Standardschaltfläche bewirkt hat, wird beim Fokussieren eines Steuerelements, das keine Schaltfläche ist, die Standardhervorhebung nicht automatisch auf die eigentliche Standardschaltfläche zurückgesetzt. Drückt man dann Enter, kann es passieren, dass die Standardschaltfläche aktiviert wird, obwohl sie nicht hervorgehoben ist.
• Beim Fokussieren eines Eingabefelds wird dessen Text nicht automatisch markiert. Stattdessen wird die Einfügemarke in der Regel an der Stelle positioniert, an der sie sich befand, als das Steuerelement zuletzt den Fokus hatte.

Die WM_NEXTDLGCTL-Meldung kann verwendet werden, um das Steuerelement zu fokussieren und diese zusätzlichen Effekte anzuwenden. Zum Beispiel:

WinExist("A") ; Macht das aktive Fenster zum zuletzt gefundenen Fenster.
ControlGet, StrlmntHwnd, Hwnd,, Button1  ; Holt HWND der ersten Schaltfläche.
SendMessage, 0x0028, StrlmntHwnd, True  ; 0x0028 ist WM_NEXTDLGCTL.

Siehe auch

SetControlDelay, ControlGetFocus, GuiControl Focus, Control, ControlGet, ControlMove, ControlGetPos, ControlClick, ControlGetText, ControlSetText, ControlSend

Beispiele

ControlFocus, OK, Beliebiger Fenstertitel