4D v12.4
OBJECT SET PLAIN TEXT
- 4D - Programmiersprache
-
- Objekte
-
- Objekteigenschaften
- DISABLE BUTTON
- ENABLE BUTTON
- OBJECT DUPLICATENew
- OBJECT Get alignment
- OBJECT GET BEST SIZE
- OBJECT Get choice list nameNew
- OBJECT GET COORDINATES
- OBJECT Get enabledNew
- OBJECT Get enterableNew
- OBJECT Get filterNew
- OBJECT Get font sizeNew
- OBJECT Get font styleNew
- OBJECT Get fontNew
- OBJECT Get format
- OBJECT Get plain textNew
- OBJECT GET RGB COLORSNew
- OBJECT GET SCROLL POSITIONNew
- OBJECT GET SCROLLBARNew
- OBJECT GET STYLED TEXT ATTRIBUTESNew
- OBJECT Get styled textNew
- OBJECT Get titleNew
- OBJECT Get visibleNew
- OBJECT MOVE
- OBJECT SET ALIGNMENT
- OBJECT SET CHOICE LIST NAME
- OBJECT SET COLOR
- OBJECT SET ENABLEDNew
- OBJECT SET ENTERABLE
- OBJECT SET FILTER
- OBJECT SET FONT
- OBJECT SET FONT SIZE
- OBJECT SET FONT STYLE
- OBJECT SET FORMATUpd
- OBJECT SET PLAIN TEXTNew
- OBJECT SET RGB COLORS
- OBJECT SET SCROLL POSITIONUpd
- OBJECT SET SCROLLBAR
- OBJECT SET STYLED TEXT ATTRIBUTESNew
- OBJECT SET STYLED TEXTNew
- OBJECT SET TITLE
- OBJECT SET VISIBLE
OBJECT SET PLAIN TEXT
| OBJECT SET PLAIN TEXT ( {* ;} Objekt ; NeuerText {; StartAusw {; EndeAusw}} ) | ||||||||
| Parameter | Typ | Beschreibung | ||||||
| * | Operator |
|
Mit Stern: Objekt ist ein Objektname (String) ohne Stern: Objekt ist Variable oder Feld |
|||||
| Objekt | Formularobjekt |
|
Objektname (mit *), Variable oder Feld (ohne *) | |||||
| NeuerText | Text |
|
einzufügender Text | |||||
| StartAusw | Lange Ganzzahl |
|
Beginn der Auswahl | |||||
| EndeAusw | Lange Ganzzahl |
|
Ende der Auswahl | |||||
Der Befehl OBJECT SET PLAIN TEXT fügt den Text, der im Parameter NeuerText übergeben wurde, in das Textfeld oder die Variable mit Stil ein, definiert im Parameter Objekt . Dieser Befehl gilt nur für den reinen Text (Plain Text) des Parameters Objekt, ohne Ändern der darin enthaltenen Stil Tags.
Im Gegensatz zum Befehl OBJECT SET STYLED TEXT fügt OBJECT SET PLAIN TEXT nur Plain Text ein. NeuerText darf keine Stil Tags enthalten. Enthält er die Zeichen <, > oder &, werden sie als Standardzeichen gewertet und in HTML Einheiten konvertiert:
- '&' wird konvertiert in &
- '<' wird konvertiert in <
- '>' wird konvertiert in >
Mit dem optionalen Parameter * geben Sie an, dass der Parameter Objekt ein Objektname (String) ist. 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.
In NeuerText übergeben Sie den einzufügenden Volltext.
Über die optionalen Parameter StartAusw und EndeAusw können Sie in Objekt eine Textauswahl angeben. Die Werte StartAusw und EndeAusw geben eine Position im Plain Text, ohne im Text gefundene Stil Tags zu berücksichtigen. Die Aktion des Befehls variiert je nach den optionalen Parametern StartAusw und EndeAusw:
- Lassen Sie StartAusw und EndeAusw weg, ersetzt OBJECT SET PLAIN TEXT den gesamten Text von Objekt durch NeuerText,
- Übergeben Sie nur StartAusw oder sind die Werte von StartAusw und EndeAusw gleich, fügt OBJECT SET PLAIN TEXT den Text in NeuerText in Objekt ein, beginnend bei StartAusw,
- Übergeben Sie StartAusw und EndeAusw, ersetzt OBJECT SET PLAIN TEXT den Plain Text, der durch diese Elemente begrenzt wird, durch den Text in NeuerText.
Der Stil des ersten ersetzten Zeichens wird für den gesamten Text in NeuerText verwendet.
Ist StartAusw größer als EndeAusw, wird der Text nicht geändert und die Systemvariable OK wird auf 0 gesetzt.
Nehmen wir z.B. folgende Rich Text (multi-style) Variable:
Sie wollen Firmennamen einfügen, die in einem Textfeld gespeichert sind. Diese Namen können z.B. das Zeichen "&" enthalten. In diesem Fall müssen Sie den Befehl OBJECT SET PLAIN TEXT verwenden:
OBJECT SET PLAIN TEXT(myStyledTex;[Company]Name;33;34)Hier ist das Ergebnis:
Hier ist der Plain Text in der Variablen:
Sie können sehen, dass der eingefügte Text innerhalb einem zusätzlichen Paar von Stil Tags steht. Diese Tags entsprechen dem Stil der Zeichen, bevor sie eingefügt wurden. Auf diese Weise können Sie die korrekte Anzeige von Feldern mit Rich Text in allen Fällen sicherstellen.
Hinweis: Verwenden Sie für diesen Fall den Befehl OBJECT SET STYLED TEXT, wird 4D nichts einfügen, da das nicht-codierte Zeichen "&" die Interpretation von Stil Tags in der Variablen verhindert. Weitere Informationen dazu finden in der Beschreibung zu diesem Befehl.
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: Objekte
Nummer:
1136
Erstellt: 4D v12.1
OBJECT Get plain text
OBJECT SET STYLED TEXT
