4D Doc Center : ST FREEZE EXPRESSIONS

Home

4D v14.3

ST FREEZE EXPRESSIONS


ST FREEZE 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 bzw. Variable (ohne )
StartAusw	Lange Ganzzahl	Start der Auswahl
EndeAusw	Lange Ganzzahl	Ende der Auswahl
*	Operator	Mit *: Ausdrücke vor dem Einfrieren aktualisieren

Beschreibung

Der Befehl ST FREEZE EXPRESSIONS friert den Inhalt der Ausdrücke im Feld ein, definiert im Parameter Objekt und vom Typ formatierter Text oder Variable. Diese Aktion konvertiert dynamische Ausdrücke in statischen Text und entfernt zugeordnete Referenzen aus Objekt.

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

Der Befehl ST FREEZE EXPRESSIONS speichert die berechneten Werte eines Ausdrucks zu einer bestimmten Zeit. Diese Operation ist insbesondere vor dem Verwenden von Objekt außerhalb eines Bereichs mit Mehrfachstil notwendig (Export, Speichern in einer Datei auf der Festplatte, Drucken, etc.) da nur die Referenz des Ausdrucks im Bereich selbst beibehalten wird.

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

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.

Übergeben Sie StartAusw und EndeAusw, friert ST FREEZE EXPRESSIONS nur die Ausdrücke innerhalb dieser Auswahl ein.
Ü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 eingefroren
Lassen Sie StartAusw und EndeAusw weg, werden alle Ausdrücke innerhalb der Benutzerauswahl von Objekt eingefroren

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.

Standardmäßig werden Ausdrücke vor dem Einfrieren nicht neu berechnet. Übergeben Sie den zweiten Parameter *, wenn der Ausdruck erst neu berechnet und dann eingefroren werden soll.

Beispiel

Die aktuelle Zeit am Textanfang einfügen und dann vor Sichern des Datensatzes einfrieren:

  //Die Uhrzeit am Textanfang einfügen

 ST INSERT EXPRESSION(*;StyledText_t;"Current time";1)

  //Dann Ausdruck einfrieren

 ST FREEZE EXPRESSIONS(*;"StyledText_t";1)