ControlMove

Verschiebt ein Steuerelement oder ändert dessen Größe.

ControlMove X, Y, Breite, Höhe, Steuerelement, FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

Parameter

X, Y

Typ: Integer

Wenn einer der Parameter weggelassen wird, bleibt die Position des Steuerelements in dieser Dimension unverändert. Andernfalls geben Sie die X- und Y-Koordinate (in Pixel) der oberen linken Ecke der neuen Position des Steuerelements an. Die Koordinaten sind relativ zur oberen linken Ecke des Clientbereichs des Zielfensters und können mit ControlGetPos ermittelt werden.

Breite, Höhe

Typ: Integer

Wenn einer der Parameter weggelassen wird, bleibt die Größe des Steuerelements in dieser Dimension unverändert. Andernfalls geben Sie die neue Breite und Höhe des Steuerelements (in Pixel) an.

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.

Es wird ein OSError ausgelöst, wenn die aktuelle Position des Steuerelements nicht ermittelt werden konnte.

Bemerkungen

Um die Zuverlässigkeit zu erhöhen, erfolgt jedes Mal, nachdem diese Funktion verwendet wurde, automatisch eine Verzögerung. Diese Verzögerung kann mit SetControlDelay oder durch Zuweisung eines Wertes an A_ControlDelay geändert werden. Weitere Informationen finden Sie unter SetControlDelay-Bemerkungen.

ControlGetPos, WinMove, SetControlDelay, Control-Funktionen

Beispiele

Zeigt, wie die OK-Schaltfläche eines Eingabefensters manipuliert werden kann, während das Skript auf eine Benutzereingabe wartet.

SetTimer ControlMoveTimer
IB := InputBox(, "Mein Eingabefenster")

ControlMoveTimer()
{
    if !WinExist("Mein Eingabefenster")
        return
    ; Andernfalls gilt das "zuletzt gefundene" Fenster von oben:
    SetTimer , 0
    WinActivate
    ControlMove 10,, 200,, "OK"  ; Verschiebt die OK-Schaltfläche nach links und macht sie breiter.
}