4D Doc Center : OBJECT Get plain text

4D v13.4

OBJECT Get plain text


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

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist ein Objektname (String) Ohne Stern: Objekt ist Variable oder Feld
Objekt	Formularobjekt	Mit : Objektname, ohne : Feld oder Variable
Funktionsergebnis	Text	Text ohne Tags

Beschreibung

Die Funktion OBJECT 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.

Beispiel

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];OBJECT 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@")

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.