2.34 :replacetext()

boolean :replacetext
(
  { integer Start := 1  input,
    integer End   := -1 input, }
  { enum    Type  := content_plain input, }
    string  Text  input
)

Parameter

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

Mit diesen optionalen Parametern wird der Bereich definiert, der durch den angegebenen String ersetzt werden soll. Wenn kein Bereich angegeben ist, wird die Selektion, also der Bereich von .startsel bis .endsel, durch den angegebenen String ersetzt. .startsel und .endsel werden ans Ende dieses Textes gesetzt, das heißt der Cursor befindet sich nach der Ersetzung hinter dem eingefügten Text. Wird ein Bereich angegeben, behalten .startsel und .endsel ihre Werte, sofern das durch die Ersetzung nicht unmöglich wird.

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. Zeilen- und Absatzumbrüche zählen daher auch als Zeichen.

Für End kann -1 angegeben werden, um den restlichen Text ab der Startposition zu ersetzen.

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.

enum Type := content_plain input

Mit diesem optionalen Parameter wird beim RTF-Edittext angegeben, ob der einzufügende String reinen, unformatierten Text („Plain Text“) oder RTF-Text enthält.

Wertebereich

content_plain

String enthält reinen, unformatierten Text.

content_rtf

String enthält RTF-Text.

Nur verwendbar bei .options[opt_rtf] = true.

string Text input

In diesem Parameter wird der String übergeben, der Text im RTF-Edittext ersetzen soll.

Rückgabewert

true

Textbereich im Edittext wurde durch den angegebenen String ersetzt.

false

Fehler: Es hat keine Ersetzung stattgefunden.

Objekte mit dieser Methode

edittext