Programmierhinweise

Home

4D v20 R7

Programmierhinweise

Befehle zum Verwalten von Textobjekten

Befehle, die zum Verwalten von Textobjekten per Programmierung dienen, berücksichtigen keine im Text integrierten Stil Tags. Sie verfahren mit angezeigtem Text wie in bisherigen Versionen von 4D. Das gilt für folgende Befehle:

Beachten Sie, dass Sie bei Verwendung dieser Befehle mit Befehlen zum Verwalten von Zeichenketten die Formatierungszeichen mit denen der 4D Funktion ST Get plain text filtern müssen:

HIGHLIGHT TEXT([Products]Notes;1;Length(ST Get plain text([Products]Notes))+1)

Kapitel Objekte (Formulare)
Die Befehle zum Verändern des Stils von Objekten (z.B. 4D Befehl OBJECT SET FONT) gelten für das gesamte Objekt und nicht nur für die Auswahl. Beachten Sie, dass bei der Ausführung des Befehls bei einem Objekt, das keinen Fokus hat, die Änderung gleichzeitig auf das Objekt, d.h. den Textbereich, und seine zugeordnete Variable angewandt wird. Hat das Objekt den Fokus, wird die Änderung für das Objekt, jedoch nicht für die zugeordnete Variable ausgeführt. Die Änderung wird nur auf die Variable angewandt, wenn das Objekt den Fokus verliert. Berücksichtigen Sie dieses Prinzip beim Programmieren von Textbereichen.

Ist die Option "Mit Standard Stil Tags speichern" für das Objekt markiert, wird beim Verwenden dieser Befehle eine Änderung der Tags mit jedem Objekt gesichert.

Generische Befehle in Bereichen mit Mehrfachstil

Ab 4D v14 hat sich die Interaktion zwischen generischen Befehlen wie OBJECT SET RGB COLORS oder OBJECT SET FONT STYLE und Textbereichen mit Mehrfachstil geändert.

In bisherigen 4D Versionen hat das Ausführen solcher Befehle den Inhalt eigener Stilelemente im Bereich verändert. Jetzt werden nur standardmäßige Eigenschaften und über standardmäßige Tags gesicherte Eigenschaften durch diese Befehle beeinflusst. Eigene Stilelemente bleiben unverändert erhalten.

Nehmen wir z.B. einen Bereich mit Mehrfachstil, in dem Standard Tags gesichert wurden:

Die Textformatierung dafür lautet:

<span  style="text-align:left;font-family:'Segoe  UI';font-size:9pt;color:#009900">Dies ist das Wort <span  style="color:#D81E05">rot</span></span>

Führen Sie folgenden Code aus:

OBJECT SET COLOR(*;"myArea";-(Blue+(256*Yellow)))

bleibt in 4D v14 und neueren Versionen die rote Farbe erhalten:

4D v14	bisherige Versionen

`<span style="text-align:left;font-family:'Segoe UI';font-size:9pt;color:#0000FF">Dies ist das Wort <span style="color:#D81E05">rot</span></span>`	`<span style="font-family:'Segoe UI';font-size:9pt;text-align:left;font-weight:normal;font-style:normal;text-decoration:none;color:#0000FF;"><span style="background-color:#FFFFFF">Dies ist das Wort rot</span></span>`

Das gilt für folgende generische Befehle:

OBJECT SET RGB COLORS
_o_OBJECT SET COLOR
OBJECT SET FONT
OBJECT SET FONT STYLE
OBJECT SET FONT SIZE

Für Bereiche mit Mehrfachstil sollten generische Befehle nur zum Setzen von Standard Stilarten verwendet werden. Zum Verwalten von Stilarten während der Ausführung der Datenbank empfehlen wir, die o.a. Befehle zu verwenden (siehe Mehrfachstil Text).

Funktion Get edited text

Beim Verwenden mit einem "Rich Text" Bereich gibt die Funktion Get edited text aus dem Kapitel Formularereignisse den Text des aktuellen Bereichs mit allen darin enthaltenen Stil Tags zurück.

Um bearbeiteten reinen Text, d.h. Text ohne Tags wiederzufinden, müssen Sie die 4D Funktion ST Get plain text verwenden:

ST Get plain text(Get edited text)

Such- und Sortierbefehle

Such- und Sortierläufe in Objekten mit Mehrfachstil berücksichtigen alle im Objekt gesicherten Stil Tags. Wurde der Stil innerhalb eines Wortes verändert, ist die Suche nach diesem Wort nicht erfolgreich.
Zum Ausführen gültiger Such- und Sortierläufe müssen Sie die Funktion ST Get plain text verwenden. Zum Beispiel:

QUERY BY FORMULA([MyTable];ST Get plain text([MyTable]MyFieldStyle)="very well")

Automatische Vereinheitlichung von Zeilenenden

Damit bei Texten in Datenbanken größere Kompatibilität mit anderen Plattformen gegeben ist, vereinheitlicht 4D ab Version 14 automatisch Zeilenenden mit dem Zeichen ’\r’. Das gilt für Formularobjekte (Variablen oder Felder) in Plain Text oder Text mit Mehrfachstil. Zeilenenden, die nicht nativ sind bzw. eine Mischung aus mehreren Zeichen (z.B. ’\r\n’) werden als ein einzelnes ’\r’. gewertet.

Beachten Sie, dass in Übereinstimmung mit XML Standards (Mehrfachstil Textformat) Befehle für Texte mit Mehrfachstil ebenfalls Zeilenenden für Textvariablen, die keinen Objekten zugeordnet sind, vereinheitlichen. Das ist die Funktionsweise wie in früheren 4D Versionen.

Das vereinfacht die plattformübergreifende Verwendung von Befehlen für Text mit Mehrfachstil oder Befehle wie HIGHLIGHT TEXT. Das müssen Sie jedoch in Ihren Abläufen berücksichtigen, wenn Sie mit Texten aus heterogenen Quellen arbeiten.

Siehe auch

_o_OBJECT SET COLOR
OBJECT SET FONT
OBJECT SET FONT SIZE
OBJECT SET FONT STYLE
OBJECT SET RGB COLORS