4D Doc Center : ST Get plain text

Home

4D v14.3

ST Get plain text


ST Get plain text ( {* ;} Objekt {; RefModus} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist ein Objektname (String) Ohne Stern: Objekt ist Variable oder Feld
Objekt	Formularobjekt	Objektname (mit ) oder Feld bzw. Variable (ohne )
RefModus	Lange Ganzzahl	Modus zur Handhabe der im Text gefundenen Referenzen
Funktionsergebnis	Text	Text ohne Tags

Beschreibung

Die Funktion ST Get plain text entfernt alle Stil Tags aus der Textvariablen oder dem Feld, definiert in den Parametern * und Objekt und gibt den Plain Text zurück.

Mit dem optionalen Parameter * geben Sie an, dass der Parameter Objekt ein Objektname (String) ist. Hat das Objekt während der Ausführung den Fokus, gibt die Funktion Information über das Objekt in Bearbeitung zurück; hat das Objekt keinen Fokus, gibt die Funktion Information über die Datenquelle (Feld oder Variable) des Objekts zurück.

Ohne * geben Sie an, dass der Parameter Objekt ein Feld oder eine Variable ist. In diesem Fall übergeben Sie eine Feld- oder Variablenreferenz anstatt eines String. Die Funktion gibt während der Ausführung Information über dieses Feld oder diese Variable zurück.

Der optionale Parameter RefModus gibt an, wie in Objekt gefundene Referenzen zurückgegeben werden sollen. In RefModus übergeben Sie eine der folgenden Konstanten unter dem Thema Mehrfachstil Text (Sie können eine einzelne Konstante oder mehrere kombiniert übergeben):

Konstante	Typ	Wert	Meldung
ST 4D Expressions as sources	Lange Ganzzahl	2	Der ursprüngliche String der Referenzen auf 4D Ausdrücke wird zurückgegeben
ST 4D Expressions as values	Lange Ganzzahl	1	Referenzen auf 4D Ausdrücke werden in interpretierter Form zurückgegeben (standardmäßige Funktionsweise in Formularen)
ST References as spaces	Lange Ganzzahl	0	Jede Referenz wird in Form geschützter Leerzeichen zurückgegeben (Standardoperation, wird von den anderen Befehlen verwendet)
ST Tags as plain text	Lange Ganzzahl	64	Die Bezeichnung des Tag wird in Plain Text zurückgegeben. Beispiel: Für das Tag '<img src="test.jpg" alt="picture">my picture</img>', ist Plain Text "my picture" (standardmäßige Funktionsweise in Formularen)
ST Tags as XML code	Lange Ganzzahl	128	Der XML Code des Tag wird in Plain Text zurückgegeben. Beispiel: Für das Tag '<img src="test.jpg" alt="picture">my picture</img>', ist der Plain Text '<img src="test.jpg" alt="picture">my picture</img>
ST Text displayed with 4D Expression sources	Lange Ganzzahl	86	Gibt den Text so zurück, wie er im Formular angezeigt wird, mit den ursprünglichen Strings der 4D Ausdrücke. Entspricht einer vordefinierten Kombination der Konstanten 2+4+16+64
ST Text displayed with 4D Expression values	Lange Ganzzahl	85	Gibt den Text so zurück, wie er im Formular angezeigt wird, mit interpretierten 4D Ausdrücken. Entspricht einer vordefinierten Kombination der Konstanten 1+4+16+64
ST URL as labels	Lange Ganzzahl	4	Die sichtbare Bezeichnung von URLs wird zurückgegeben, z.B. "Besuchen Sie unsere Web Site" (standardmäßige Funktionsweise in Formularen)
ST URL as links	Lange Ganzzahl	8	Der Link wird zurückgegeben, z.B. "http://www.4d.com"
ST User links as labels	Lange Ganzzahl	16	Die sichtbare Bezeichnung des Benutzer-Links wird zurückgegeben (standardmäßige Funktionsweise in Formularen)
ST User links as links	Lange Ganzzahl	32	Der Inhalt des Benutzer-Links wird zurückgegeben

Hinweis: Da Plain Text gleich bleibt, unabhängig von den Werten im Parameter RefModus, ist dieser optionale Parameter nur für Text mit Referenzen sinnvoll.

Beispiel 1

Sie suchen unter den Werten eines Textfeldes mit Mehrfachstil nach dem Text "sehr schön". Der Wert wurde in folgender Form gespeichert: "Das Wetter ist sehr schön heute".

QUERY BY FORMULA([Comments];ST Get plain text([Comments]Weather)="@very nice@")

Hinweis: In diesem Kontext gibt nachfolgende Anweisung nicht das gewünschte Ergebnis zurück, weil der Text mit Stil Tags gesichert wird:

QUERY([Comments];[Comments]Weather="@sehr schön@")

Beispiel 2

Nehmen wir folgenden Text im Bereich mit Mehrfachstil mit Namen "meineZone"

<span>Es ist jetzt <span style="-d4-ref:'Current time:C178'"> </span> <a href="http://www.4d.com">Gehen Sie zur 4D Seite</a> oder <span style="-d4-ref-user:'openW'">Öffnen ein Fenster</span></span>

Dieser Text erscheint wie folgt:

Führen Sie dazu folgenden Code aus:

 $txt :=ST Get plain text(*;"meineZone";ST References as spaces)

  // $txt = "Es ist jetzt    oder " (Abstände)

 $txt :=ST Get plain text(*;"meineZone";ST 4D Expressions as values)

  // $txt = "Es ist jetzt 15:48:19  oder  "

 $txt :=ST Get plain text(*;"meineZone";ST 4D Expressions as sources)

  // $txt = "Es ist jetzt Current time  oder  "

 $txt :=ST Get plain text(*;"meineZone";ST URL as links)

  //$txt = "Es ist jetzt   http://www.4d.com or  "

 $txt :=ST Get plain text(*;"meineZone";ST Text displayed with 4D Expression values)

  //$txt = "Es ist jetzt 15:48:19 Gehen Sie zur 4D Seite oder Öffnen ein Fenster"

 $txt :=ST Get plain text(*;"meineZone";ST Text displayed with 4D Expression sources)

  //$txt = "Es ist jetzt Current time Gehen Sie zur 4D Seite oder Öffnen ein Fenster"

 $txt :=ST Get plain text(*;"meineZone";ST User links as labels)

  //$txt = "Es ist jetzt    oder Öffnen ein Fenster"

 $txt :=ST Get plain text(*;"meineZone";ST User links as links)

  //$txt = "Es ist jetzt    oder openW"

Systemvariablen und Mengen

Nach Ausführen dieses Befehls wird die Variable OK auf 1 gesetzt, wenn kein Fehler aufgetreten ist; andernfalls wird sie auf 0 gesetzt. Das ist insbesondere der Fall, wenn Stil Tags nicht korrekt gewertet werden (inkorrekte oder fehlende Tags).

Bei einem Fehler wird die Variable nicht geändert. Tritt ein Fehler in einer Variablen auf, während der Text gewertet wird, wandelt 4D den Text in Plain Text um; als Ergebnis werden die Zeichen <, > und & in HTML Einheiten umgewandelt.