2.16 :findtext()

integer :findtext
(
      string  Text  input
  { , integer Start := 1  input,
      integer End   := -1 input }
  { , boolean CaseSensitive := true input }
)

Parameter

string Text input

In diesem Parameter wird der String übergeben, nach dem der Inhalt (.content) des Edittextes durchsucht werden soll.

Ein leerer Text wird sofort gefunden. Der Rückgabewert von :findtext() ist dann Start, wenn ein Bereich angegeben wurde, und die Cursorposition bzw. die Endposition der Selektion, wenn kein Bereich angegeben wurde.

Der zu suchende Text ist beim RTF-Edittext (.options[opt_rtf] = true) als reiner Text ohne Formatierungsanweisungen („Plain Text“) zu übergeben.

integer Start := 1 input
integer End := 1 input

Mit diesen optionalen Parametern wird der Bereich definiert, in dem nach dem angegebenen String gesucht werden soll. Wird kein Bereich angegeben, beginnt die Suche an der Cursorposition bzw. hinter der Selektion und geht bis zum Ende des Textes.

Der Wertebereich von Start und End geht von 0 bis zur Anzahl der Zeichen im angezeigten Text, wobei jedes Zeichen zählt, das in eine Selektion eingeschlossen werden kann. Zeilenumbruch-Zeichen zählen daher mit.

Für End kann -1 angegeben werden, um den Inhalt des Edittextes bis zu seinem Ende zu durchsuchen.

Beim RTF-Edittext (.options[opt_rtf] = true) beziehen sich Start und End – analog zu .startsel und .endsel – auf Positionen im formatierten Text. Aus ihnen kann nicht auf Positionen im Content-String des RTF-Edittextes geschlossen werden, da dieser zusätzlich Formatierungsanweisungen enthält. Sind die Parameter Start oder End größer als die Textlänge, dann wird beim RTF-Edittext die Textlänge verwendet.

boolean CaseSensitive := true input

Dieser optionale Parameter legt fest, ob die Groß- und Kleinschreibung bei der Suche berücksichtigt werden soll.

true

Groß- und Kleinschreibung der gefundenen Texte muss mit dem angegebenen String übereinstimmen.

false

Groß- und Kleinschreibung der gefundenen Texte kann vom angegebenen String abweichen.

Rückgabewert

-1

Angegebener String wurde nicht gefunden.

>= 0

Anfangsposition der ersten Fundstelle des angegebenen Strings im Text.

Objekte mit dieser Methode

edittext