WP Get text

Home

4D v20 R7

WP Get text


WP Get text ( targetObj {; expressions} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
targetObj	Objekt	Range, Element oder 4D Write Pro Dokument
expressions	Zahl	Anweisung zum Bewerten der Ausdrücke
Funktionsergebnis	Text	Text von targetObj

Beschreibung

Der Befehl WP Get text ruft Textinhalte aus einem 4D Write Pro Dokument im angegebenen Parameter targetObj ab.

WP Get text gibt nur reinen Text zurück. Alle angewandten Stile (fett, kursiv, etc.) werden ignoriert.

Im Parameter targetObj übergeben Sie:

Range oder
Element (Tabelle, Zeile, Absatz, Kopf-, Haupt-, Fußteil, Abschnitt, Unterabschnitt) oder
4D Write Pro Dokument

Hinweise:

Übergeben Sie in targetObj ein 4D Write Pro Dokument, gibt der Befehl nur den Text vom Hauptteil des Dokuments zurück.
Übergeben Sie in targetObj einen Unterabschnitt, gibt der Befehl den Text des übergeordneten Abschnitts zurück.

Der optionale Parameter expressions liefert Anweisungen für die Auswertung von 4D Ausdrücken in targetObj (weitere Informationen dazu finden Sie auf der Seite Formeln verwalten). Die Optionen sind:

Konstante	Kommentar
wk expressions as source	Der ursprüngliche String der Referenz auf 4D Ausdrücke wird zurückgegeben.
wk expressions as space	Jede Referenz wird als nicht-umbrechendes Leerzeichen zurückgegeben.
wk expressions as value	Referenzen auf 4D Ausdrücke werden in ihrer ausgewerteten Form zurückgegeben. (Standard, wenn die Option nicht übergeben ist).

Wichtig: Nur reiner Text mit wk expressions as space ist konsistent mit Indices zu Text-Ranges, die WP oder ST Befehle verwenden, da WP und ST Befehle immer annehmen, dass die Größe des Ausdrucks = 1 Zeichen ist.

Hinweise:

Wenn targetObj Bilder enthält, werden die Bilder ignoriert und als Leerzeichen (" ") zurückgegeben.
Wenn targetObj Tabellen enthält, wird der Inhalt jeder Zelle als einzelne Absätze behandelt und als Text zurückgegeben, der durch Tabulatoren getrennt ist. Zeilen werden durch Zeilenumbrüche getrennt.

Beispiel

Um den Text in diesem Dokument abzurufen:

können Sie schreiben:

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

 vText:=WP Get text($range;wk expressions as value) //ergibt "Hello world! Today is: 06/03/18."

 vText2:=WP Get text($range;wk expressions as source) //ergibt "Hello world! Today is: Current date."

 vText3:=WP Get text($range;wk expressions as space) //ergibt "Hello world! Today is:  ."

Siehe auch

Formeln verwalten
WP SET TEXT