4D Doc Center : ST COMPUTE EXPRESSIONS

Home

4D v14.3

ST COMPUTE EXPRESSIONS


ST COMPUTE EXPRESSIONS ( {* ;} Objekt {; StartAusw {; EndeAusw}} )

Parameter	Typ	Beschreibung
*	Operator	Mit Stern: Objekt ist Objektname (String) Ohne Stern: Objekt ist Feld oder Variable
Objekt	Formularobjekt	Objektname (mit ) oder Feld oder Variable (ohne )
StartAusw	Lange Ganzzahl	Start der Auswahl
EndeAusw	Lange Ganzzahl	Ende der Auswahl

Beschreibung

Der Befehl ST COMPUTE EXPRESSIONS aktualisiert die dynamischen 4D Ausdrücke im Feld, definiert im Parameter Objekt und vom Typ formatierter Text oder Variable.

Weitere Informationen zu 4D Ausdrücken in formatierten Textbereichen finden Sie unter dem Befehl ST INSERT EXPRESSION.

Der Befehl bewertet das Ergebnis von Ausdrücken in Objekt gemäß dem aktuellen Kontext neu und zeigt den resultierenden Wert an. Gibt es z.B. einen Ausdruck mit der Uhrzeit, wird der Wert bei jedem Aufruf von ST COMPUTE EXPRESSIONS geändert. Ausdrücke werden auch in folgenden Situationen neu berechnet:

Beim Einfügen
Beim Laden
Beim "Einfrieren" mit dem Befehl ST FREEZE EXPRESSIONS, wenn der zweite Parameter * übergeben ist.

ST COMPUTE EXPRESSIONS ändert nicht formatierten Text, d.h. mit span Tags, sondern nur Plain Text in Objekt. Im formatierten Text werden nicht die berechneten Werte, sondern nur ihre Referenzen gespeichert.
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).

Das Objekt muss nicht zwingend den Fokus haben; es muss aber in einem Formular liegen, sonst hat der Befehl ST COMPUTE EXPRESSIONS keine Auswirkung.

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 oder Referenzen zu berücksichtigen. Beachten Sie, dass eine Referenz einem einzelnen Zeichen entspricht.

Mit StartAusw und EndeAusw aktualisiert ST COMPUTE EXPRESSIONS nur die Ausdrücke innerhalb dieser Auswahl.
Übergeben Sie nur StartAusw oder ist der Wert von EndeAusw größer als die Gesamtanzahl der Zeichen in Objekt, werden alle Ausdrücke zwischen StartAusw und dem Textende berechnet.
Lassen Sie StartAusw und EndeAusw weg, werden alle Ausdrücke innerhalb der Benutzerauswahl von Objekt berechnet.

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, führt der Befehl nichts aus und die Variable OK wird auf 0 gesetzt.

Beispiel

Die Referenzen innerhalb einer Textauswahl aktualisieren:

ST COMPUTE EXPRESSIONS(*;"myText";ST Start highlight;ST End highlight)