4D Doc Center : ST INSERT EXPRESSION

Home

4D v14.3

ST INSERT EXPRESSION


ST INSERT EXPRESSION ( {* ;} Objekt ; Ausdruck {; StartAusw {; EndeAusw}} )

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist Objektname (String) Ohne Stern: Objekt ist Feld oder Variable
Objekt	Objekt	Objektname (mit ) oder Feld bzw. Variable (ohne )
Ausdruck	Text	Ausdruck und (optional) Format zum Einfügen
StartAusw	Lange Ganzzahl	Start der Auswahl
EndeAusw	Lange Ganzzahl	Ende der Auswahl

Beschreibung

Der Befehl ST INSERT EXPRESSION fügt eine Referenz von Ausdruck in das Feld ein, definiert im Parameter Objekt und vom Typ formatierter Text oder Variable.

Mit dem optionalen Parameter * geben Sie an, dass der Parameter Objekt ein Objektname (String) ist. Ohne diesen Parameter ist Objekt ein Feld oder eine Variable. In diesem Fall übergeben Sie eine Feld- oder Variablenreferenz anstelle eines String (nur Feld oder Variablenobjekt).

Im Parameter Ausdruck übergeben Sie den 4D Ausdruck, den Sie in Objekt bewerten wollen. Ein gültiger 4D Ausdruck ist ein String, der einen Wert zurückgibt. Ausdruck kann ein Feld, eine Variable, ein 4D Befehl, eine Anweisung, die einen Wert zurückgibt, eine Projektmethode, o.ä. sein.

Der Ausdruck muss in Anführungszeichen ("") stehen.

Hinweis: Ausdruck kann keine Variable vom Typ Bild sein.

Gibt Ausdruck einen Wert mit Zeilenschaltung und Tabulatoren zurück, formatiert 4D den Text gemäß dem Objekt, das den Ausdruck hostet; Zeilenschaltungen werden als Zeilenvorschub interpretiert.

Sie können den Inhalt von Ausdruck auch formatieren. Dann muss er folgende Form haben:

"String(value;format)"

... wobei Wert den Ausdruck selbst enthält und Format das anzuwendende Format:

Für Zahlen: jedes Anzeigeformat für Zahlen (vorhanden oder nicht), zum Beispiel "###,##".
Für Datum: Einen Wert für ein vorhandenes Datumsformat, z.B. 1 für die Konstante System date short
Für Zeit: Einen Wert für ein vorhandenes Zeitformat, z.B. 9 für die Konstante System time short

Zum Beispiel:

"String([Table_1]Field_1;1)" // 1 ist der Wert der Konstante System date short

Der Ausdruck mit Werten zeigt standardmäßig Textbereich mit Mehrfachstil an. Sie können die Anzeige mit Referenzen erzwingen, wenn Sie stattdessen den Befehl ST SET OPTIONS verwenden.

Die optionalen Parameter StartAusw und EndeAusw definieren eine Textauswahl in Objekt. Die Werte StartAusw und EndeAusw geben eine Auswahl im Plain Text, ohne evtl. vorhandene Stil Tags zu berücksichtigen.

Übergeben Sie StartAusw und EndeAusw, ersetzt ST INSERT EXPRESSION den Text innerhalb dieser Auswahl mit dem Ergebnis von Ausdruck.
Übergeben Sie nur StartAusw oder ist der Wert von EndeAusw größer als die Gesamtanzahl der Zeichen in Objekt, werden alle Zeichen zwischen StartAusw und dem Textende durch das Ergebnis von Ausdruck ersetzt.
Lassen Sie StartAusw und EndeAusw weg, ersetzt das Ergebnis von Ausdruck die aktuelle Textauswahl in Objekt oder wird an der Cursor-Position eingefügt.

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.

Hinweis: Ist StartAusw größer als EndeAusw (außer EndeAusw ist 0), führt der Befehl nichts aus und die Variable OK wird auf 0 gesetzt.

Beispiel

Den ausgewählten Text mit dem Ergebnis einer Projektmethode ersetzen:

ST INSERT EXPRESSION(*;"myText";"MyMethod";ST Start highlight;ST End highlight)