CaretGetPos

Ruft die aktuelle Position der Einfügemarke ab.

MarkeGefunden := CaretGetPos(&AusgabeVarX, &AusgabeVarY)

Parameter

&AusgabeVarX, &AusgabeVarY

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 gespeichert werden sollen. Standardmäßig sind die abgerufenen Koordinaten relativ zum Clientbereich des aktiven Fensters, was aber mit CoordMode oder A_CoordModeCaret geändert werden kann.

Rückgabewert

Typ: Integer (boolesch)

Wenn kein Fenster aktiv ist oder die Position der Einfügemarke nicht ermittelt werden kann, gibt die Funktion 0 (false) zurück und die Ausgabevariablen werden leer gemacht. Die Funktion gibt 1 (true) zurück, wenn das System eine Einfügemarke-Position zurückgegeben hat, was aber nicht unbedingt bedeutet, dass eine Einfügemarke sichtbar ist.

Bemerkungen

Wenn bestimmte Informationen nicht benötigt werden, können die entsprechenden Ausgabevariablen weggelassen werden.

Beachten Sie, dass einige Fenster (z.B. bestimmte Versionen von MS Word) immer die gleichen Positionsdaten melden, egal wo sich die Einfügemarke gerade befindet.

CoordMode, A_CoordModeCaret

Beispiele

Das folgende Skript zeigt die aktuellen Positionsdaten einer Einfügemarke in einem sich selbst aktualisierenden Tooltip an.

SetTimer MarkeAbfragen, 100
MarkeAbfragen() {
    if CaretGetPos(&x, &y)
        ToolTip "X" x " Y" y, x, y - 20
    else
        ToolTip "Keine Einfügemarke vorhanden"
}