4D v14.3

ST Get plain text

Home

 
4D v14.3
ST Get plain text

ST Get plain text 


 

ST Get plain text ( {* ;} Objekt {; RefModus} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
Operator in Mit Stern: Objekt ist ein Objektname (String)
Ohne Stern: Objekt ist Variable oder Feld
Objekt  Formularobjekt in Objektname (mit *) oder Feld bzw. Variable (ohne *)
RefModus  Lange Ganzzahl in Modus zur Handhabe der im Text gefundenen Referenzen
Funktionsergebnis  Text in Text ohne Tags

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.

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@")

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"

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.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Mehrfachstil Text
Nummer: 1092

Dieser Befehl ändert die Systemvariable OK

 
GESCHICHTE 

New
Erstellt: 4D v12
Geändert: 4D v12.1
Geändert: 4D v14
Umbenannt: 4D v14

 
SIEHE AUCH 

ST Get text
ST SET PLAIN TEXT
ST SET TEXT
TEXT TO ARRAY

 
SCHLÜSSELWÖRTER 

multi-style, multistyle, multi style

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)

Geerbt von : OBJECT Get plain text ( 4D v12.4)