ControlGetPos

Ruft die Position und Größe eines Steuerelements ab.

ControlGetPos &AusX, &AusY, &AusBreite, &AusHöhe, Steuerelement, FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

Parameter

&AusX, &AusY

Typ: VarRef

Wenn weggelassen, wird der zugehörige Wert nicht gespeichert. Andernfalls geben Sie Referenzen an, die auf Ausgabevariablen verweisen, in denen die X- und Y-Koordinate (in Pixel) der oberen linken Ecke des Steuerelements gespeichert werden sollen. Diese Koordinaten sind relativ zur oberen linken Ecke des Clientbereichs des Zielfensters und daher identisch mit denen, die von ControlMove verwendet werden.

&AusBreite, &AusHöhe

Typ: VarRef

Wenn weggelassen, wird der zugehörige Wert nicht gespeichert. Andernfalls geben Sie Referenzen an, die auf Ausgabevariablen verweisen, in denen die Breite und Höhe (in Pixel) des Steuerelements gespeichert werden sollen.

Steuerelement

Typ: Zeichenkette, Integer oder Objekt

ClassNN-Bezeichnung, Text oder HWND-Nummer des Steuerelements, oder ein Objekt mit einer Hwnd-Eigenschaft. Einzelheiten finden Sie unter Der Steuerelement-Parameter.

FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

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.

Fehlerbehandlung

Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte.

Bemerkungen

Im Gegensatz zu Funktionen, die ein Steuerelement ändern, erfolgt nach ControlGetPos keine automatische Verzögerung, d.h. SetControlDelay hat keinen Einfluss auf ControlGetPos.

ControlMove, WinGetPos, Control-Funktionen

Beispiele

Aktualisiert und zeigt kontinuierlich den Namen und die Position des Steuerelements, das sich gerade unter dem Mauszeiger befindet.

Loop
{
    Sleep 100
    MouseGetPos ,, &WelchesFenster, &WelchesSteuerelement
    try ControlGetPos &x, &y, &w, &h, WelchesSteuerelement, WelchesFenster
    ToolTip WelchesSteuerelement "`nX" X "`tY" Y "`nW" W "`t" H
}