CaretGetPos

Ruft die aktuelle Position des Textcursors (Texteinfügemarke) ab.

TextcursorGefunden := 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 des Textcursors 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 Textcursor-Position zurückgegeben hat, was aber nicht unbedingt bedeutet, dass ein Textcursor 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 der Textcursor gerade befindet.

CoordMode, A_CoordModeCaret

Beispiele

Das folgende Skript zeigt die aktuellen Positionsdaten eines Textcursors in einem sich selbst aktualisierenden Tooltip an.

SetTimer TextcursorAbfragen, 100
TextcursorAbfragen() {
    if CaretGetPos(&x, &y)
        ToolTip "X" x " Y" y, x, y - 20
    else
        ToolTip "Kein Textcursor vorhanden"
}