4D v14.3

ST SET ATTRIBUTES

Home

 
4D v14.3
ST SET ATTRIBUTES

ST SET ATTRIBUTES 


 

ST SET ATTRIBUTES ( {* ;} Objekt ; StartAusw ; EndeAusw ; attrName ; attrWert {; attrName2 ; attrWert2 ; ... ; attrNameN ; attrWertN} ) 
Parameter Typ   Beschreibung
Operator in Mit Stern ist Objekt ein Objektname (String),
Ohne Stern ist Objekt eine Variable oder ein Feld
Objekt  Formularobjekt in Objektname (mit *) oder Variable bzw. Feld (ohne *)
StartAusw  Lange Ganzzahl in Start der neuen Textauswahl
EndeAusw  Lange Ganzzahl in Ende der neuen Textauswahl
attrName  String in Zu setzendes Attribut
attrWert  String, Lange Ganzzahl in Neuer Wert des Attributs

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 FarbnameHexadezimaler 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

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

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.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Mehrfachstil Text
Nummer: 1093

Dieser Befehl ändert die Systemvariable OK

 
GESCHICHTE 

New
Erstellt: 4D v12
Geändert: 4D v12.1
Umbenannt: 4D v14

 
SIEHE AUCH 

FONT LIST
ST GET ATTRIBUTES

 
SCHLÜSSELWÖRTER 

multistyle, multi-style, multi style

 
ARTIKELVERWENDUNG

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

Geerbt von : OBJECT SET STYLED TEXT ATTRIBUTES ( 4D v13.5)