4D v14.3

ST SET PLAIN TEXT

Home

 
4D v14.3
ST SET PLAIN TEXT

ST SET PLAIN TEXT 


 

ST SET PLAIN TEXT ( {* ;} Objekt ; NeuerText {; StartAusw {; EndeAusw}} ) 
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 *)
NeuerText  Text in einzufügender Text
StartAusw  Lange Ganzzahl in Beginn der Auswahl
EndeAusw  Lange Ganzzahl in Ende der Auswahl

Der Befehl ST SET PLAIN TEXT fügt den Text, der im Parameter NeuerText übergeben wurde, in das Textfeld oder die Variable mit Stil ein, definiert im Parameter Objekt . Dieser Befehl gilt nur für den reinen Text (Plain Text) des Parameters Objekt, ohne Ändern der darin enthaltenen Stil Tags.

Im Gegensatz zum Befehl ST SET TEXT fügt ST SET PLAIN TEXT nur Plain Text ein. NeuerText darf keine Stil Tags enthalten. Enthält er die Zeichen <, > oder &, werden sie als Standardzeichen gewertet und in HTML Einheiten konvertiert:

  • '&' wird konvertiert in &amp;
  • '<' wird konvertiert in &lt;
  • '>' wird konvertiert in &gt;
 

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, gilt der Befehl nur für das Objekt in Bearbeitung und nicht seine Datenquelle (Feld oder Variable). Die Änderungen werden nur auf die Quelle (sowie alle anderen Objekte, die dieselbe Datenquelle nutzen) übertragen, wenn das Objekt in Bearbeitung entweder durch Verlieren des Fokus oder mit der Eingabetaste bestätigt wird. Hat das Objekt keinen Fokus, wird der Befehl direkt auf die Datenquelle  und die Änderungen werden sofort an alle anderen Objekte mit derselben Datenquelle übertragen.

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. Der Befehl wird direkt auf das Feld oder die Variable angewandt. Änderungen werden sofort auf alle Objekte übertragen, die diese Datenquelle nutzen, inkl. das Objekt mit Fokus.

 

In NeuerText übergeben Sie den einzufügenden Volltext.

Über die optionalen Parameter StartAusw und EndeAusw können Sie in Objekt eine Textauswahl angeben. Die Werte StartAusw und EndeAusw geben eine Auswahl im Plain Text, ohne im Text gefundene Stil Tags zu berücksichtigen. Die Aktion des Befehls variiert je nach den optionalen Parametern StartAusw und EndeAusw:

4D bietet vordefinierte Konstanten, so dass Sie die Auswahlgrenzen in den Parametern StartAusw und EndeAusw automatisch setzen können. Diese Konstanten finden Sie unter dem Thema Mehrfachstil Text

Konstante Typ Wert Meldung
ST End highlight Lange Ganzzahl -1001 Bestimmt das letzte Zeichen der aktuellen Textauswahl in Objekt (*)
ST End text Lange Ganzzahl 0 Bestimmt das letzte Zeichen des Textes in Objekt
ST Start highlight Lange Ganzzahl -1000 Bestimmt das erste Zeichen der aktuellen Textauswahl in Objekt (*)
ST Start text Lange Ganzzahl 1 Bestimmt das erste Zeichen des Textes in Objekt

(*) Um diese Konstante zu nutzen, müssen Sie in Objekt einen Objektnamen verwenden. Übergeben Sie eine Referenz auf ein Feld oder eine Variable, wird der Befehl auf den gesamten Text des Objekts angewendet.

Der Stil des ersten ersetzten Zeichens wird für den gesamten Text in NeuerText verwendet.

Ist StartAusw größer als EndeAusw (außer der Wert von EndeAusw ist 0, siehe oben), wird der Text nicht geändert und die Systemvariable OK wird auf 0 gesetzt.

Nehmen wir z.B. folgende Rich Text (multi-style) Variable:

Sie wollen Firmennamen einfügen, die in einem Textfeld gespeichert sind. Diese Namen können z.B. das Zeichen "&" enthalten. In diesem Fall müssen Sie den Befehl ST SET PLAIN TEXT verwenden:

 ST SET PLAIN TEXT(myStyledTex;[Company]Name;33;34)

Hier ist das Ergebnis:

Hier ist der Plain Text in der Variablen:

Sie können sehen, dass der eingefügte Text innerhalb zusätzlicher Stil Tags steht. Diese Tags entsprechen dem Stil der Zeichen, bevor sie eingefügt wurden. Auf diese Weise können Sie die korrekte Anzeige von Feldern mit Rich Text in allen Fällen sicherstellen.

Hinweis: Würden Sie hier den Befehl ST SET TEXT verwenden, würde 4D nichts einfügen, da das nicht-codierte Zeichen "&" die Interpretation von Stil Tags in der Variablen verhindert. Weitere Informationen dazu finden in der Beschreibung zu diesem Befehl.

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: 1136

Dieser Befehl ändert die Systemvariable OK

 
GESCHICHTE 

New
Erstellt: 4D v12.1
Umbenannt: 4D v14

 
SIEHE AUCH 

ST Get plain text
ST SET TEXT

 
SCHLÜSSELWÖRTER 

multi-style, multi style, multistyle

 
ARTIKELVERWENDUNG

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

Geerbt von : OBJECT SET PLAIN TEXT ( 4D v13.5)