4D v14.3

ST INSERT EXPRESSION

Home

 
4D v14.3
ST INSERT EXPRESSION

ST INSERT EXPRESSION 


 

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

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.

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

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

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Mehrfachstil Text
Nummer: 1281

Dieser Befehl ändert die Systemvariable OK

 
GESCHICHTE 

New
Erstellt: 4D v14

 
SIEHE AUCH 

ST FREEZE EXPRESSIONS
ST Get expression
ST INSERT URL

 
ARTIKELVERWENDUNG

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