WinEditorSearch
obj -> WinEditorSearch(alpha1[, int2[, point3[, alpha4[, int5]]]]) : rect
Text im CodeEdit -Objekt suchen und ersetzen
Details
- obj: Deskriptor des CodeEdit -Objektes
- alpha1: Suchbegriff
- int2:
- point3: Startposition (optional)
- alpha4: Ersetzungsbegriff (optional)
- int5: View-Nummer (optional)
- Resultat:
rectPosition des Suchtreffers - Siehe: Verwandte Befehle ,
WinEditorGetSelection ()
Mit dieser Funktion wird der Inhalt des CodeEdit -Objektes (obj) nach der Zeichenfolge (alpha1) durchsucht.
Diese Methode kann frühestens im EvtCreated des Elternfensters verwendet werden.
Als Suchoption (int2) können optional folgende Konstanten können angegeben werden:
_WinEditorSearchRev: Rückwärts suchen_WinEditorSearchInSel: Im selektierten Bereich suchen_WinEditorSearchGoTo: Zu Suchtreffer springen_WinEditorSearchRegExp: Regulären Ausdruck suchen_WinEditorSearchWholeWord: Ganzes Wort suchen_WinEditorSearchCI: Groß-/Kleinschreibung ignorieren_WinEditorSearchHighlightWord: Aktuellen Suchtreffer hervorheben_WinEditorSearchHighlightOccurences: Andere Suchtreffer hervorheben_WinEditorSearchReplace: Aktuellen Suchtreffer ersetzen_WinEditorSearchReplaceAll: Alle Suchtreffer ersetzen
Die Optionen können miteinander kombiniert werden.
Mit den Optionen _WinEditorSearchReplace und _WinEditorSearchReplaceAll werden die Suchtreffer durch den Ersetzungsbegriff (alpha4) ersetzt. Ist dieser leer, werden die Suchtreffer entfernt.
Die Startposition kann optional mit (point3) definiert werden.
Bei den Positionsangaben bestimmt die :x -Koordinate die Zeile und die :y -Koordinate die Spalte. Das erste Zeichen hat die Koordinate 1 , 1 . Wird der Punkt - 1 , - 1 angegeben, wird die Positionsangabe ignoriert. Abhängig davon, ob die Suchoption _WinEditorSearchRev angegeben ist, wird vom Anfang oder vom Ende des Textes gesucht.
In (int5) kann optional die Nummer des Views angegeben werden, in dem gesucht 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 die Position des Suchtreffers zurückgegeben. Hierbei bestimmt die :left-Koordinate die Anfangszeile, die :top-Koordinate die Anfangsspalte, die :right-Koordinate die Endzeile und die :bottom-Koordinate die Endspalte des Treffers.
Beispiel:
// Wort suchen ohne Markierung
tRect # $CodeEdit->WinEditorSearch('Hallo');
// Wort ab bestimmter Position suchen und alle Vorkommen hervorheben
$CodeEdit->WinEditorSearch('Hallo', _WinEditorSearchGoTo | _WinEditorSearchHighlightWord | _WinEditorSearchHighlightOccurences, PointMake(42, 15));
// Wort suchen und ersetzen
$CodeEdit->WinEditorSearch('Hallo', _WinEditorSearchReplace, NULL, 'World');
Mögliche Laufzeitfehler:
_ErrHdlInvalid: Der Deskriptor des CodeEdit (obj) ist ungültig._ErrValueInvalid: Ungültige Option (int2) oder ungültige oder nicht existierende View-Nummer (int5) angegeben.