WinEditorGetSelection
obj -> WinEditorGetSelection(int1[, int2]) : point
Selektionsbereich im CodeEdit -Objekt ermitteln
Details
- obj: Deskriptor des CodeEdit -Objektes
- int1:
- int2: View-Nummer (optional)
- Resultat:
pointErmittelte Koordinate / Länge - Siehe: Verwandte Befehle ,
WinEditorSetSelection (),WinEditorGetSelectedText (),WinEditorReplaceSelectedText ()
Mit dieser Funktion werden im CodeEdit -Objekt (obj) Informationen über den selektierten Bereich ermittelt.
Diese Methode kann frühestens im EvtCreated des Elternfensters verwendet werden.
Mit dem Argument (int1) wird der zu ermittelnde Wert angegeben. Folgende Konstanten können angegeben werden:
_WinEditorSelGetCaretPos: Cursorposition ermitteln_WinEditorSelGetAnchorPos: Ankerposition ermitteln_WinEditorSelGetRange: Selektionslänge ermitteln
In (int2) kann optional die Nummer des Views angegeben werden, in dem der Selektionsbereich ermittelt werden soll. Die Views können mit den Nummern 1 bis 4 angesprochen werden. View-Nummer 0 (oder nicht angegeben) ist gleichbedeutend mit 1. Die Anzahl der Views kann mit $CodeEdit-> WinInfo ( _WinCount ) ermittelt werden.
Resultat
Als Resultat wird eine Koordinate im Text zurückgegeben. Bei den Positionsangaben bestimmt die :x-Koordinate die Zeile und die :y-Koordinate die Spalte. Das erste Zeichen hat die Koordinate 1,1. Bei der Option _WinEditorSelGetRange bestimmt die :x-Koordinate die Länge des selektierten Textes. Die :y-Koordinate ist 0.
Beispiel:
// Selektionsanfang und -Ende ermitteln
tCaret # $CodeEdit->WinEditorGetSelection(_WinEditorSelGetCaretPos);
tAnchor # $CodeEdit->WinEditorGetSelection(_WinEditorSelGetAnchorPos);
// Selektionslänge im zweiten View ermitteln
tPoint # $CodeEdit->WinEditorGetSelection(_WinEditorSelGetRange, 2);
tSelLen # tPoint:x;
Mögliche Laufzeitfehler:
_ErrHdlInvalid: Der Deskriptor des CodeEdit (obj) ist ungültig._ErrValueInvalid: Ungültige oder nicht existierende View-Nummer (int2) angegeben.