4D Doc Center : ST SET TEXT

Home

4D v14.3

ST SET TEXT


ST SET TEXT ( {* ;} Objekt ; NeuerText {; StartAusw {; EndeAusw}} )

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist ein Objektname (String), Ohne Stern: Objekt ist Variable oder Feld
Objekt	Formularobjekt	Mit : Objektname, ohne : Textfeld oder Variable
NeuerText	Text	Einzufügender Text
StartAusw	Lange Ganzzahl	Start der Auswahl
EndeAusw	Lange Ganzzahl	Ende der Auswahl

Beschreibung

Der Befehl ST SET TEXT fügt den Text im Parameter NeuerText in das formatierte Textfeld oder die Variable ein, die im Parameter Objekt übergeben ist. Dieser Befehl wird nur auf Plain Text in Objekt angewandt, ohne darin enthaltene Stil Tags zu verändern. Damit können Sie per Programmierung auf dem Bildschirm angezeigten formatierten Text ändern.

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 Text. Der Befehl ST SET TEXT dient zum Arbeiten mit Rich Text (multistyle) mit Tags vom Typ <span>. In allen anderen Fällen, insbesondere beim Arbeiten mit Plain Text, der die Zeichen <, > oder & enthält, müssen Sie den Befehl ST SET PLAIN TEXT verwenden. Übergeben Sie Plain Text mit den Zeichen <, > oder & im Befehl ST SET TEXT, führt er nichts aus. Das muss so sein, denn wenn Sie einen String wie "a<b" direkt in Rich Text einfügen, würde er die interne Analyse der <span> Tags beeinträchtigen. In diesem Fall müssen "<" Zeichen zuvor als "<" codiert werden. Das ist mit dem Befehl ST SET PLAIN TEXT möglich (siehe auch dazugehöriges Beispiel).

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

Lassen Sie StartAusw und EndeAusw weg, ersetzt ST SET TEXT den gesamten Text von Objekt durch NeuerText,
Übergeben Sie nur StartAusw oder sind die Werte von StartAusw und EndeAusw gleich, fügt ST SET TEXT den Text NeuerText in Objekt ein, beginnend bei StartAusw,
Übergeben Sie StartAusw und EndeAusw, ersetzt ST SET TEXT den Plain Text, der durch diese Elemente begrenzt wird, durch den Text in NeuerText.
Sie können in EndeAusw 0 übergeben, um automatisch das letzte Zeichen des Textes anzugeben. (Übergeben Sie 1 in StartAusw, um das erste Zeichen im Text anzugeben.)

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

(*) Beachten Sie, dass diese Konstanten nur funktionieren, wenn Sie in Objekt einen Objektnamen übergeben. Übergeben Sie eine Referenz auf ein Feld oder eine Variable, wird die Funktion auf den gesamten Text im Objekt angewandt.

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

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.

Beispiel 1

Sie wollen den vom Benutzer ausgewählten Text mit Formatierung durch den Inhalt einer Variablen ersetzen.

Hier ist der ausgewählte Text:

Der nachfolgende Inhalt wird im Feld gespeichert:

Nach Ausführen des Code:

 vtempo:="Demonstration"

 GET HIGHLIGHT([Products]Notes;vStart;vEnd)

 ST SET TEXT([Products]Notes;vtemp;vStart;vEnd)

sehen Feld und Feldinhalt wie folgt aus:

Beispiel 2

Siehe Beispiel zum Befehl ST SET PLAIN TEXT.