ST INSERT EXPRESSION

Home

4D v20 R7


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. Der Ausdruck muss in Anführungszeichen ("") stehen.
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, ein spezifischer 4D Write Pro Ausdruck (siehe Formeln verwalten), o.ä. sein.

Hinweise:

Das Einfügen von Bildausdrücken (z.B. Variablen vom Typ Bild) wird in 4D Write Pro Bereichen unterstützt (siehe Bildausdrücke), aber nicht in Textbereichen mit Mehrfachstil.
Dieser Befehl erwartet "reale" Namen für Felder und Tabellen, selbst wenn über die Befehle SET TABLE TITLES und SET FIELD TITLES eine "virtuelle" Struktur definiert wurde.

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 nur StartAusw, wird das Ergebnis von Ausdruck an der angegebenen Position eingefügt.
Lassen Sie StartAusw und EndeAusw weg, wird das Ergebnis von Ausdruck an der Cursor-Position eingefügt.
Übergeben Sie StartAusw und EndeAusw, ersetzt ST INSERT EXPRESSION den Text innerhalb dieser Auswahl mit dem Ergebnis von Ausdruck. Ist der Wert von EndeAusw größer als die Gesamtanzahl der Zeichen im Objekt, werden alle Zeichen zwischen StartAusw und dem Textende durch das Ergebnis von Ausdruck ersetzt.

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	Kommentar
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)

Siehe auch

ST COMPUTE EXPRESSIONS
ST FREEZE EXPRESSIONS
ST Get expression
ST INSERT URL