WP SET TEXT

Home

4D v20 R7

WP SET TEXT


WP SET TEXT ( targetObj ; newText ; textPosition {; rangeUpdate} )

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element oder 4D Write Pro Dokument
newText	Text	Text zum Einfügen
textPosition	Zahl	Einfügestelle (ersetzen, davor, danach)
rangeUpdate	Zahl	Der eingefügte Inhalt ist im Range enthalten oder nicht

Beschreibung

Der Befehl WP SET TEXT fügt den im Parameter newText übergebenen Text als reinen Text in targetObj an einer bestimmten Position ein, definert durch den Parameter textPosition.

Im Parameter targetObj übergeben Sie ein Objekt, um die Position zu bestimmen, an der Text eingefügt werden soll. Das kann eine explizite Position im 4D Write Pro Dokument sein oder auf der Auswahl eines Benutzers basieren. Sie übergeben:

Range
Element (Tabelle / Zeile / Absatz / Haupt- / Kopf- /Fußteil / Bild im Textfluß / Abschnitt / Unterabschnitt) oder
4D Write Pro Dokument.

Der Parameter newText enthält den Text zum Einfügen in targetObj. WP SET TEXT fügt nur reinen Text ein und zwar genau so, wie er geschrieben wurde, aber ohne Style-Tags.

Im Parameter textPosition lässt sich die Position des eingefügten Textes über einen der folgenden Selektoren festlegen:

Konstante	Kommentar
wk append	Fügt Inhalt am Ende des Ziels ein
wk prepend	Fügt Inhalt am Anfang des Elements ein
wk replace	Ersetzt Inhalt in Ziel

Ist targetObj ein Range, können Sie im optionalen Parameter rangeUpdate eine der folgenden Konstanten für den Einfügemodus übergeben:

Konstante	Kommentar
wk exclude from range	Eingefügter Inhalt ist nicht im aktualisierten Range enthalten
wk include in range	Eingefügter Inhalt ist im aktualisierten Range enthalten (Standard)

Ohne den Parameter rangeUpdate wird der eingefügte Inhalt standardmäßig in den aktualisierten Range übernommen.

Ist targetObj kein Range, wird rangeUpdate ignoriert.

Beispiel

Sie möchten in diesem Dokument Text hinzufügen:

targetObj ist ein 4D Write Pro Dokument:

 WP SET TEXT(myDoc;"Hello world";wk append)</p><p> //schreibt "The quick brown fox jumps over the lazy dog. Hello world!"

targetObj ist ein Range:

Vor dem vorhandenen Text:

 $range:=WP Text range(myDoc;wk start text;wk end text)

 WP SET TEXT($range;" Hello world!";wk prepend)

  //schreibt " Hello world! The quick brown fox jumps over the lazy dog."

Nach dem vorhandenen Text:

 $range:=WP Text range(myDoc;wk start text;wk end text)

 WP SET TEXT($range;" Hello world!";wk append)

  //schreibt "The quick brown fox jumps over the lazy dog. Hello world!"

Den vorhandenen Text ersetzen:

 $range:=WP Text range(myDoc;wk start text;wk end text)

 WP SET TEXT($range;" Hello world!";wk replace)

  //schreibt " Hello world!"

Siehe auch

WP Get text