3.14 Textformatierungscodes

Widgets vom Typ Textview-Klasse (Textanzeige) und Texteditor-Klasse unterstützen die Textformatierung, wenn das Attribut Styled dieser Klassen auf True gesetzt ist. RapaGUI unterstützt die Textformatierung durch spezielle Steuercodes, die in diesem Abschnitt beschrieben werden.

Formatierungscodes beginnen immer mit einem Escape-Zeichen, gefolgt von einer Zeichenfolge, die den Formatierungscode beschreibt. In der Dezimalschreibweise entspricht das Escape-Zeichen dem ASCII-Code 27, der in Oktalzahl 33 und in Hexadezimalschreibweise $1B ist. Bei der Verwendung von Formatierungscodes ist Vorsicht geboten, da sie in XML-Dateien und Hollywood-Quelldateien unterschiedlich verwendet werden. In XML-Dateien wird die Oktalnotation verwendet, d.h. sie starten eine Escape-Sequenz mit einem Backslash und der Oktalzahl 33 ('\33'). In Hollywood-Quellcodes werden Oktalzahlen nach einem umgekehrten Schrägstrich jedoch nicht unterstützt. Hollywood erwartet immer nach einem umgekehrten Schrägstrich den ASCII-Code in Dezimalschreibweise. Deshalb müssen Sie '\27' verwenden, um eine Escape-Sequenz im Hollywood-Code zu initiieren.

Um diesen Unterschied etwas besser zu verdeutlichen, lassen Sie uns zwei Beispiele anschauen. Hier ist ein Beispiel für die Erstellung eines fettgedruckten Textobjekts in einer XML-Datei. Fettgedruckter Text wird aktiviert, indem nach dem Escape-Zeichen das Zeichen 'b' verwendet wird:

<textview styled="true" id="mytext">\33bBold text</textview>

Sie sehen, dass hier die Oktalschreibweise verwendet wird, da XML-Dateien nach einem umgekehrten Schrägstrich eine Oktalzahl erwarten. In Hollywood ist das anders, denn Hollywood erwartet ein Dezimalzeichen nach einem umgekehrten Schrägstrich. Beim nächsten Beispiel sehen Sie, wie Sie Escape-Codes angeben müssen, wenn Sie sie aus einer Hollywood-Quelldatei verwenden:

moai.Set("mytext", "text", "\27bBold text")

Sie können sehen, dass der Code derselbe ist, außer dass wir \27b anstelle von \33b verwenden, da Hollywood nach einem umgekehrten Schrägstrich immer Dezimalzahlen anstelle von Oktalzahlen verwendet.

Die folgenden Formatierungscodes werden derzeit unterstützt:

\33u

Setzt den Textstil auf Unterstrichen.

\33b

Setzt den Textstil auf Fett.

\33i

Setzt den Textstil auf Kursiv.

\33n

Setzt den Textstil zurück auf Normal.

\33P[RRGGBB]

Ändern Sie die Frontfarbe in die angegebene RGB-Farbe. Die RGB-Farbe muss in Form von sechs Hexadezimalziffern RRGGBB angegeben werden. Auf AmigaOS und Kompatible erfordert dies MUI 4.0.