4D v14.3ST GET ATTRIBUTES |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v14.3
ST GET ATTRIBUTES
|
ST GET ATTRIBUTES ( {* ;} Objekt ; StartAusw ; EndeAusw ; attrName ; attrWert {; attrName2 ; attrWert2 ; ... ; attrNameN ; attrWertN} ) | ||||||||
Parameter | Typ | Beschreibung | ||||||
* | Operator |
![]() |
Mit Stern: Objekt ist ein Objektname (String), Ohne Stern: Objekt ist Variable oder Feld |
|||||
Objekt | Formularobjekt |
![]() |
Mit *: Objektname, ohne *: Feld oder Variable | |||||
StartAusw | Lange Ganzzahl |
![]() |
Start der Textauswahl | |||||
EndeAusw | Lange Ganzzahl |
![]() |
Ende der Textauswahl | |||||
attrName | Lange Ganzzahl |
![]() |
Zu erhaltendes Attribut | |||||
attrWert | Variable |
![]() |
Aktueller Wert des Attributs | |||||
Mit dem Befehl ST GET ATTRIBUTES können Sie den aktuellen Wert eines Stilattributs in einer Textauswahl des Formularobjekts, definiert durch Objekt, herausfinden.
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, gibt die Funktion Information über das Objekt in Bearbeitung zurück; hat das Objekt keinen Fokus, gibt die Funktion Information über die Datenquelle (Feld oder Variable) des Objekts zurück.
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. Die Funktion gibt während der Ausführung Information über dieses Feld oder diese Variable zurück.
Mit den Parametern StartAusw und EndeAusw können Sie die Textauswahl von Objekt festlegen, dessen Stilattribut gelesen werden soll. In StartAusw übergeben Sie die Position des ersten Zeichens, in EndeAusw die Position des letzten 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.) Sind die Werte StartAusw und EndeAusw gleich oder ist StartAusw größer als EndeAusw (außer der Wert von EndeAusw ist 0, siehe oben), wird ein Fehler zurückgegeben.
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.
Im Parameter attrName übergeben Sie den Namen des zu lesenden Attributs. Im Parameter attrWert übergeben Sie eine Variable, die den aktuellen Wert des Attributs wiedergibt.
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 |
Ist der Wert von attrName für die gesamte Auswahl gleich, wird er in attrWert zurückgegeben. Ist er unterschiedlich oder enthält Objekt keine SPAN Tags, werden folgende Werte zurückgegeben:
attrName | attrWert, wenn Attribut in Auswahl unterschiedlich oder ohne SPAN Tags |
Attribute background color | FFFFFFFF |
Attribute bold style | 2 |
Attribute font name | "" (empty string) |
Attribute italic style | 2 |
Attribute strikethrough style | 2 |
Attribute text color | FFFFFFFF |
Attribute text size | -1 |
Attribute underline style | 2 |
Wir nehmen das Feld [Table_1]StyledText aus einem Formular. Das Objekt hat die Eigenschaft Mehrfachstil und den Namen "StyledText_t". Sie wollen den markierten Text und den Status von Attribute bold style erhalten. Es gibt zwei unterschiedliche Vorgehensweisen, je nachdem, ob Sie den Objektnamen oder die Referenz auf das Feld verwenden.
$text:=ST Get text(*;"StyledText_t";ST Start highlight;ST End highlight)
ST GET ATTRIBUTES(*;"StyledText_t";ST Start highlight;ST End highlight;Attribute bold style;$bold)
GET HIGHLIGHT([Table_1]StyledText;$Begin_l;$End_l)
$text:=ST Get text([Table_1]StyledText;$Begin_l;$End_l)
ST GET ATTRIBUTES([Table_1]StyledText;$Begin_l;$End_l;Attribute bold style;$bold)
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.
Produkt: 4D
Thema: Mehrfachstil Text
Nummer:
1094
Erstellt: 4D v12
Geändert: 4D v12.1
Umbenannt: 4D v14
multi-style, multistyle, multi style
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)
Geerbt von : OBJECT GET STYLED TEXT ATTRIBUTES ( 4D v13.5)