4D Doc Center : ST SET ATTRIBUTES

Home

4D v14.3

ST SET ATTRIBUTES


ST SET ATTRIBUTES ( {* ;} Objekt ; StartAusw ; EndeAusw ; attrName ; attrWert {; attrName2 ; attrWert2 ; ... ; attrNameN ; attrWertN} )

Parameter	Typ	Beschreibung
*	Operator	Mit Stern ist Objekt ein Objektname (String), Ohne Stern ist Objekt eine Variable oder ein Feld
Objekt	Formularobjekt	Objektname (mit ) oder Variable bzw. Feld (ohne )
StartAusw	Lange Ganzzahl	Start der neuen Textauswahl
EndeAusw	Lange Ganzzahl	Ende der neuen Textauswahl
attrName	String	Zu setzendes Attribut
attrWert	String, Lange Ganzzahl	Neuer Wert des Attributs

Beschreibung

Der Befehl ST SET ATTRIBUTES verändert eine oder mehrere Stilattribute in den Formularobjekten, definiert durch Objekt.

Mit dem optionalen Parameter * geben Sie an, dass der Parameter Objekt ein Objektname (String) ist. Hat das Objekt während der Ausführung den Fokus, gilt der Befehl nur für das Objekt in Bearbeitung und nicht seine Datenquelle (Feld oder Variable). Die Änderungen werden nur auf die Quelle (sowie alle anderen Objekte, die dieselbe Datenquelle nutzen) übertragen, wenn das Objekt in Bearbeitung entweder durch Verlieren des Fokus oder mit der Eingabetaste bestätigt wird. Hat das Objekt keinen Fokus, wird der Befehl direkt auf die Datenquelle und die Änderungen werden sofort an alle anderen Objekte mit derselben Datenquelle übertragen.

Ohne * geben Sie an, dass der Parameter Objekt ein Feld oder eine Variable ist. In diesem Fall übergeben Sie eine Feld- oder Variablenreferenz anstatt eines String. Der Befehl wird direkt auf das Feld oder die Variable angewandt. Änderungen werden sofort auf alle Objekte übertragen, die diese Datenquelle nutzen, inkl. das Objekt mit Fokus.

Hinweis: Stilattribute können Sie nur mit Feldern vom Typ Text verwenden. Da alphanumerische Felder eine vordefinierte Länge haben, würde das Hinzufügen von Stil Tags zu Datenverlust führen.

Die Definition eines Attributs erfolgt durch Einfügen oder Ändern der HTML Stil Tags im Text. Weitere Informationen dazu finden Sie im Handbuch 4D Designmodus. Beachten Sie, dass der Befehl ST SET ATTRIBUTES in allen Fällen Stil Tags einfügt, selbst wenn Objekt Textobjekte ohne die Eigenschaft Mehrfachstil angibt.

Mit den Parametern StartAusw und EndeAusw können Sie die Textauswahl festlegen, für welche die Stiländerungen in Objekt gelten sollen. In StartAusw übergeben Sie die Position des ersten zu ändernden Zeichens, in EndeAusw die Position des letzten zu ändernden Zeichens + 1 (das letzte übergebene Zeichen ist in der Auswahl nicht enthalten). Sie können in EndeAusw 0 übergeben, um automatisch das letzte Zeichen des Textes anzugeben (Übergeben Sie 1 in StartAusw, um das erste Zeichen im Text anzugeben.)

Ist der Wert von EndeAusw größer als die Anzahl Zeichen in Objekt, werden alle Zeichen zwischen StartAusw und dem Textende geändert. Ist StartAusw größer als EndeAusw (außer der Wert von EndeAusw ist 0, siehe oben), führt der Befehl nichts aus und die Variable OK wird auf 0 (Null) gesetzt.

Die Werte StartAusw und EndeAusw berücksichtigen nicht bereits vorhandene Stil Tags im Bereich. Sie werden vielmehr auf Basis von Rohtext bewertet, d.h. Text, aus dem Stil Tag herausgefiltert wurden.

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

(*) Für diese Konstante müssen Sie in Objekt einen Objektnamen übergeben. Übergeben Sie eine Referenz auf ein Feld oder eine Variable, wird die Funktion auf den gesamten Text des Objekts angewandt.

In attrName und attrWert übergeben Sie jeweils Name und Wert des zu ändernden Attributs. Sie können beliebig viele Paare Attribut/Wert übergeben. Für den Parameter attrName übergeben Sie vordefinierte Konstanten unter dem Thema Mehrfachstil Textattribute. Der in attrWert übergebene Parameter richtet sich nach dem Parameter attrName:

Konstante	Typ	Wert	Meldung
Attribute background color	Lange Ganzzahl	8	(nur Windows) Hexadezimale Werte oder HTML Farbnamen
Attribute bold style	Lange Ganzzahl	1	attrWert=0: Attribut fett aus Auswahl entfernen attrWert=1: Attribut fett auf Auswahl anwenden
Attribute font name	Lange Ganzzahl	5	attrWert=Schriftfamilienname (String)
Attribute italic style	Lange Ganzzahl	2	attrWert=0: Attribut kursiv aus Auswahl entfernen attrWert=1: Attribut kursiv auf Auswahl anwenden
Attribute strikethrough style	Lange Ganzzahl	3	attrWert=0: Attribut durchgestrichen aus Auswahl entfernen attrWert=1: Attribut durchgestrichen auf Auswahl anwenden
Attribute text color	Lange Ganzzahl	7	Hexadezimale Werte oder Konstanten mit hexadezimalen Werten
Attribute text size	Lange Ganzzahl	6	attrWert=Anzahl Punkte (Zahl)
Attribute underline style	Lange Ganzzahl	4	attrWert=0: Attribut unterstrichen aus Auswahl entfernen attrWert=1: Attribut unterstrichen auf Auswahl anwenden

Farben
Übergeben Sie im Parameter attrName Attribute text color oder Attribute background color, müssen Sie in attrWert einen String übergeben, der entweder einen HTML Farbnamen oder einen hexadezimalen Farbwert enthält:

HTML Farbname	Hexadezimaler Wert
Aqua	#00FFFF
Black	#000000
Blue	#0000FF
Fushia	#FF00FF
Gray	#808080
Green	#008000
Lime	#00FF00
Maroon	#800000
Navy	#000080
Olive	#808000
Purple	#800080
Red	#FF0000
Silver	#C0C0C0
Teal	#008080
White	#FFFFFF
Yellow	#FFFF00

Beispiel

In diesem Beispiel ändern wir Größe und Farbe des Textes, sowie die Attribute fett und unterstrichen der Zeichen 2 bis 4 des Feldes:

 OBJECT SET STYLED TEXT ATTRIBUTES([MyTable]MyField;2;5;Attribute font name;"Arial";Attribute text size;10;Attribute underline style;1;Attribute bold style;1;Attribute text color;"Blue")

Systemvariablen und Mengen

Nach Ausführen dieses Befehls wird die Variable OK auf 1 gesetzt, wenn kein Fehler aufgetreten ist; andernfalls wird sie auf 0 gesetzt. Das ist insbesondere der Fall, wenn Stil Tags nicht korrekt gewertet werden (inkorrekte oder fehlende Tags).

Bei einem Fehler wird die Variable nicht geändert. Tritt ein Fehler in einer Variablen auf, während der Text gewertet wird, wandelt 4D den Text in Plain Text um; als Ergebnis werden die Zeichen <, > und & in HTML Einheiten umgewandelt.