Rich Text

www.altova.com Alle erweitern/reduzieren Dieses Kapitel drucken Vorherige Seite Eine Ebene nach oben Nächste Seite

Startseite >  Steuerelemente und Steuerelementereignisse > Steuerelemente >

Rich Text

Mit Hilfe des Rich Text-Steuerelements kann Text aus Seitenquellen, in denen der Text mit Formatierungen (Stilen) versehen ist, mit Formatierungen angezeigt werden. Außerdem kann Text auf Web- und Windows PC Clients bearbeitet und formatiert und wieder in der Seitenquelle gespeichert werden. Die Grundzüge der Richt Text-Funktion sind im Abschnitt Designobjekte/Funktionen | Rich Text beschrieben.

 

Click to expand/collapseAnmerkungen
Um einen Stil oder eine Eigenschaft (im Fenster "Stile & Eigenschaften") zurückzusetzen, wählen Sie die Eigenschaft aus und klicken Sie in der Symbolleiste des Fensters auf Zurücksetzen.
Um den XPath-Ausdruck eines Stils oder einer Eigenschaft zu bearbeiten, wählen Sie den Stil bzw. die Eigenschaft (im Fenster "Stile & Eigenschaften") aus und klicken Sie in der Symbolleiste des Fensters auf XPath bearbeiten.
Um ein Steuerelement an eine andere Stelle im Design zu kopieren, halten Sie die Strg-Taste gedrückt, während Sie das Steuerelement an die gewünschte Stelle ziehen.

 

Rich Text-Ereignisse

Es steht das Ereignis "BeimBeendenDerBearbeitung" zur Verfügung. Eine Beschreibung der Aktionen, die für dieses Ereignis definiert werden können, finden Sie im Abschnitt Aktionen.

 

Rich Text-Eigenschaften

Die Eigenschaften eines Steuerelements stehen im Fenster "Stile & Eigenschaften" zur Verfügung und werden unten in der Reihenfolge, in der sie angezeigt werden, aufgelistet.

 

Click to expand/collapseName

Über seinen Namen wird das Steuerelement von anderen Stellen auf der Seite oder im Projekt aus referenziert. Doppelklicken Sie in das Wertefeld, um es zu bearbeiten.

 

Click to expand/collapseText

Die Eigenschaft "Text" erhält ihren Wert auf eine der folgenden Arten:

 

aus einem Textstring mit einem festgelegten Wert, der im Steuerelement angezeigt wird
aus einem XPath-Ausdruck, der Daten aus einem Node in einer Seitenquelle abruft und diese Daten im Steuerelement anzeigt

 

Doppelklicken Sie in das Wertfeld, um es zu bearbeiten oder klicken Sie auf die Symbolleisten-Schaltfläche XPath und geben Sie einen XPath-Ausdruck zur Generierung des gewünschten Texts ein. Rechtsklicken Sie alternativ dazu auf die Eigenschaft und wählen Sie die gewünschte Eingabemethode aus dem Kontextmenü aus (festgelegter Wert oder XPath).

 

Anmerkung:  Sie können für das Rich Text-Steuerelement einen XPath-Ausdruck eingeben, der ein HTML-kodierter String ist. Wenn im aktiven Rich Text-Stylesheet Stile für HTML-Elemente definiert sind, wird der Textwert dieser Eigenschaft mit der entsprechenden Formatierung angezeigt. Nähere Informationen dazu finden Sie im Abschnitt Rich Text.

 

Anmerkung:  Die Variable $MTControlValue steht für die Generierung des Werts der Eigenschaft Text  nicht zur Verfügung. Falls sie verwendet wird, führt dies zu einem Validierungsfehler.

 

 

Click to expand/collapseSichtbar

Ein XPath-Ausdruck, dessen Ergebnis true() oder false() sein sollte. Wenn das Ergebnis des Ausdrucks false() ist, - und nur dann - ist das Steuerelement nicht sichtbar. Ist das Ergebnis des Ausdrucks true() oder wird ein anderer Wert zurückgegeben, so bleibt das Steuerelement sichtbar. Der Standardwert ist true(). Doppelklicken Sie in das Wertfeld oder klicken Sie auf die Schaltfläche XPath, um einen XPath-Ausdruck zu bearbeiten. Mit Hilfe der Eigenschaft Sichtbar kann ein Objekt sichtbar oder unsichtbar gemacht werden, je nachdem, welches Ergebnis der XPath-Ausdruck hat. Dadurch kann die Anzeige eines Objektsd dynamisch vom Inhalt oder der Struktur von Daten abhängig gemacht werden.

 

Anmerkung:  Informationen zur Sichtbarkeit von Spalten-/Zeilenbereichen finden Sie unter Tabelleneigenschaften.

 

Anmerkung:  Die Variable $MTControlValue steht für die Generierung des Werts der Eigenschaft Sichtbar nicht zur Verfügung. Falls sie verwendet wird, führt dies zu einem Validierungsfehler.

 

Click to expand/collapseAktiviert/Editierbar

Je nachdem, ob der Wert der Eigenschaft true (aktiviert) oder false (deaktiviert) ist, ist das Steuerelement entweder aktiviert oder deaktiviert. Der Wert kann direkt eingegeben werden (durch Auswahl des Werts in der Auswahlliste oder durch Doppelklick in das Wertfeld und Eingabe des gewünschten Werts). Der Wert kann auch als XPath-Ausdruck, dessen Ergebnis der Boolesche Wert true oder false ist, eingegeben werden. Der Standardwert ist true. Normalerweise überprüft der XPath-Ausdruck der Eigenschaft Aktiviert/Editierbar eines Steuerelements, ob ein Node bzw. ein bestimmter Node-Wert vorhanden ist. Wenn das Ergebnis des XPath-Ausdrucks true ist, wird das Steuerelement aktiviert.

 

Click to expand/collapseTipp

Stellt einen Texttipp für den Endbenutzer zur Verfügung, z.B. einen Tipp zu einer Aktion, die der Endbenutzer mit Hilfe dieses Steuerelements durchführen muss. Doppelklicken Sie in das Wertfeld der Eigenschaft, um den Texttipp zu bearbeiten oder klicken Sie auf die Symbolleisten-Schaltfläche XPath und geben Sie einen XPath-Ausdruck zur Generierung des gewünschten Texts ein.

 

Click to expand/collapseTipp-Textfarbe

Definiert die Textfarbe des Tipps für das Steuerelement. Diese Textfarbe ist die Farbe, in der der für die Eigenschaft "Tipp" definierte Text angezeigt wird (siehe oben). Zur Auswahl der Farbe haben Sie folgende Möglichkeiten:

 

Klicken Sie auf die Farbpalette, um eine Hintergrundfarbe auszuwählen.
Wählen Sie aus der Dropdown-Liste der Auswahlliste eine Farbe aus.
Doppelklicken Sie in das Wertefeld, um einen Farbcode (z.B. #FF0000) auszuwählen oder klicken Sie auf die Symbolleisten-Schaltfläche XPath und geben Sie einen XPath-Ausdruck zur Generierung des gewünschten Texts ein.

 

Click to expand/collapseRich Text Stylesheet

Definiert, welches der Rich Text Stylesheets des Designs für das Text-Layout im Steuerelement "Rich Text" verwendet werden soll. In der Dropdown-Liste der Auswahlliste der Eigenschaft werden alle Rich Text Stylesheets des Projekts (die über das Dialogfeld Rich Text Stylesheets erstellt wurden) angezeigt.

 

Click to expand/collapseHorizontale Ausrichtung

Setzt die horizontale Ausrichtung auf left, center oder right. Die Standardeinstellung ist center. Der Wert kann auch über einen XPath-Ausdruck definiert werden (Auf diese Art kann der Wert dynamisch generiert werden).

 

Click to expand/collapseBreite des Steuerelements

Definiert die Breite des Steuerelements. Wählen Sie über die Auswahlliste der Eigenschaft einen Wert aus. Es stehen die folgenden Werte zur Verfügung:

 

Parent_ausfüllen: Die Breite des Steuerelements wird an die des übergeordneten Elements, z.B. einer Tabellenzelle oder der Seite angepasst.
Inhalt_umbrechen: Das Steuerelement wird nur so breit gemacht, dass der Inhalt des Steuerelements Platz hat. Wenn dieser Wert ausgewählt ist, wird die Eigenschaft Maximale Steuerelementbreite verfügbar.
Prozentwert: ein Prozentwert der Seitenbreite; wählen Sie einen Wert aus der Dropdown-Liste aus oder geben Sie den Wert direkt ein.
Pixelwert: Wählen Sie einen Pixelwert aus der Dropdown-Liste aus oder geben Sie direkt einen Wert ein.

 

Mit Parent_ausfüllen wird somit eine maximale Breite definiert, während mit Inhalt_umbrechen eine minimale Breite festgelegt wird.

 

Der Standardwert für alle Steuerelemente mit Ausnahme der folgenden ist Parent_ausfüllen.

 

Bild und Diagramm: Für diese ist der Standardwert Inhalt_umbrechen.
Geolocation-Karte: Der Standardwert ist der kleinere der beiden Werte $MT_CanvasX und $MT_CanvasY. Mit diesen beiden dynamischen Variablen wird die Breite bzw. Höhe des Anzeigebereichs des Geräts angegeben. Da die Standardwerte von Höhe des Steuerelements and Breite des Steuerelements die gleichen sind (in beiden Fällen jeweils der kleinere Wert von $MT_CanvasX und $MT_CanvasY), bildet die Standardform und -größe des Anzeigebereichs im Steuerelement immer ein Quadrat, das gleich min($MT_CanvasX, $MT_CanvasY) ist.

 

Click to expand/collapsePunkte oder Pixel auf iOS-Geräten

Wenn Sie Pixelwerte für Eigenschaften, mit denen eine Länge definiert ist, eingeben, so werden diese Werte bei Darstellung auf iOS-Geräten als Punkte im Anzeigebereichkoordinatenraum gelesen. Der Anzeigebereichkoordinatenraum ist der Bildschirmbereich, auf dem die Designkomponenten abgebildet werden und ein Punkt ist die Längeneinheit in diesem Raum, d.h. es handelt sich hierbei nicht um die typografische Einheit, die 1/72 Zoll beträgt. Das iOS-Gerät ordnet die Punkte des Anzeigebereichkoordinatenraums automatisch Pixeln im Gerätekoordinatenraum zu. Dadurch, dass die Werte auf diese Art (Anzeigebereichswerte zu Gerätewerte) zugeordnet werden, wird sichergestellt, dass bei Designkomponenten unabhängig von der Auflösung des iOS-Geräts oder den verwendeten Maßeinheiten das richtige Größenverhältnis in Bezug auf den Bildschirm und auf die Komponenten zueinander beibehalten wird.

 

Sie können in MobileTogether Designer mit Hilfe der dynamischen Variablen $MT_CanvasX und $MT_CanvasY die Größe des aktuellen Anzeigebereichs (Bildschirms) und somit Längenwerte im Verhältnis zu dieser Größe ermitteln. Für iOS-Geräte werden die von diesen Variablen zurückgegebenen Werte folgendermaßen berechnet: Die Pixel-Dimensionen des aktuellen Gerätekoordinatenraums werden (mit Hilfe des entsprechenden Konvertierungsfaktors) in Punktwerte im Anzeigebereichkoordinatenraum konvertiert. Diese Punktwerte (Zahlenwerte) werden von den beiden Variablen für die Verwendung im Design als Pixel zurückgegeben. Wenn ein Bild z.B. die halbe Breite des Anzeigebereichs einnehmen soll, definieren Sie dafür eine Pixelbreite die gleich $MT_CanvasX * 0.5 ist. Der XPath-Ausdruck für diese Bildbreite wäre folgender: concat($MT_CanvasX * 0.5, 'px').

 

Click to expand/collapseMaximale Steuerelementbreite

Diese Eigenschaft steht nur zur Verfügung, wenn die Eigenschaft Steuerelementbreite des Steuerelements auf Inhalt_umbrechen gesetzt wurde. Mit der Eigenschaft Maximale Steuerelementbreite wird die maximale Breite des Steuerelements definiert. Wählen Sie einen Wert aus der Auswahlliste der Eigenschaft aus. Die folgenden Werte stehen zur Verfügung:

 

Prozentwert: ein Prozentwert der Seitenbreite; wählen Sie einen Wert aus der Dropdown-Liste aus oder geben Sie einen Wert direkt ein.
Pixelwert: Wählen Sie einen Pixelwert aus der Dropdown-Liste aus oder geben Sie einen Wert direkt ein.

 

Click to expand/collapseRich Text-Höhe

Definiert die Höhe des Rich Text-Steuerelements. Bei der Standardeinstellung wächst die Höhe des Steuerelements mit dem Inhalt bis zu einem Maximum der Bildschirmhöhe. Bei Erreichen der Maximalhöhe wird im Inhaltsteil des Steuerelements eine Bildlaufleiste angezeigt. Die Symbolleiste wird immer am oberen Rand des Steuerelements angezeigt. Alternativ dazu können Sie für das Steuerelement eine fixe Höhe (in Pixel) definieren.

 

Click to expand/collapseRand

Definiert den Randabstand des Steuerelements zu umgebenden Objekten oder zu den Rändern des enthaltenden Objekts. Wählen Sie in der Dropdown-Liste der Auswahlliste einen Wert in Pixel aus oder doppelklicken Sie in das Wertfeld, um eine Pixellänge einzugeben. Der definierte Randabstand wird auf allen vier Seiten des Steuerelements erstellt. Wenn Sie für eine der vier Seiten einen anderen Rand definieren möchten, erweitern Sie die Eigenschaft Rand, um die einzelnen Randeigenschaften (links, rechts, oben und unten) anzuzeigen und definieren Sie einen anderen Wert dafür. Wenn Sie z.B. Rand auf 6px und Unterer Rand auf 12px setzen, so erhalten der obere, linke und rechte Rand eine Breite von 6px und der untere Rand eine von 12px.

 

Click to expand/collapsePunkte oder Pixel auf iOS-Geräten

Wenn Sie Pixelwerte für Eigenschaften, mit denen eine Länge definiert ist, eingeben, so werden diese Werte bei Darstellung auf iOS-Geräten als Punkte im Anzeigebereichkoordinatenraum gelesen. Der Anzeigebereichkoordinatenraum ist der Bildschirmbereich, auf dem die Designkomponenten abgebildet werden und ein Punkt ist die Längeneinheit in diesem Raum, d.h. es handelt sich hierbei nicht um die typografische Einheit, die 1/72 Zoll beträgt. Das iOS-Gerät ordnet die Punkte des Anzeigebereichkoordinatenraums automatisch Pixeln im Gerätekoordinatenraum zu. Dadurch, dass die Werte auf diese Art (Anzeigebereichswerte zu Gerätewerte) zugeordnet werden, wird sichergestellt, dass bei Designkomponenten unabhängig von der Auflösung des iOS-Geräts oder den verwendeten Maßeinheiten das richtige Größenverhältnis in Bezug auf den Bildschirm und auf die Komponenten zueinander beibehalten wird.

 

Sie können in MobileTogether Designer mit Hilfe der dynamischen Variablen $MT_CanvasX und $MT_CanvasY die Größe des aktuellen Anzeigebereichs (Bildschirms) und somit Längenwerte im Verhältnis zu dieser Größe ermitteln. Für iOS-Geräte werden die von diesen Variablen zurückgegebenen Werte folgendermaßen berechnet: Die Pixel-Dimensionen des aktuellen Gerätekoordinatenraums werden (mit Hilfe des entsprechenden Konvertierungsfaktors) in Punktwerte im Anzeigebereichkoordinatenraum konvertiert. Diese Punktwerte (Zahlenwerte) werden von den beiden Variablen für die Verwendung im Design als Pixel zurückgegeben. Wenn ein Bild z.B. die halbe Breite des Anzeigebereichs einnehmen soll, definieren Sie dafür eine Pixelbreite die gleich $MT_CanvasX * 0.5 ist. Der XPath-Ausdruck für diese Bildbreite wäre folgender: concat($MT_CanvasX * 0.5, 'px').

 

Click to expand/collapseAktivierreihenfolge

Die Eigenschaft Aktivierreihenfolge erhält als Wert eine Ganzzahl oder eine XPath-Erweiterung, deren Ergebnis eine Ganzzahl ist. Diese Ganzzahl gibt die Position des Steuerelements in der Aktivierreihenfolge an.

 

Die Aktivierreihenfolge ist die Reihenfolge, in der Steuerelemente den Fokus erhalten, wenn der Benutzer auf dem Client-Gerät die Tabulatortaste drückt. Die gesamte Aktivierreihenfolge kann mit dem Befehl Seite | Aktivierreihenfolge anzeigen/definieren schnell und im visuellen Kontext aller Steuerelemente der Seite definiert werden. Die Eigenschaft Aktivierreihenfolge einzelner Steuerelemente gibt die Reihenfolgeposition nur dieses Steuerelements an.

 

Anmerkung:    Die Funktion "Aktivierreihenfolge" steht nur auf Web und Windows Clients zur Verfügung.

 

 

Click to expand/collapseStylesheet

Mit der Eigenschaft Stylesheet wird definiert, welches Stylesheet für das Steuerelement verwendet werden soll. In der Dropdown-Liste der Auswahlliste der Eigenschaft Stylesheet werden alle benutzerdefinierten Stylesheets, die im Projekt definiert wurden, angezeigt. Wählen Sie das gewünschte Stylesheet für das Steuerelement aus. Alternativ dazu können Sie einen XPath-Ausdruck auswählen, um das gewünschte Stylesheet auszuwählen; dies hat den Vorteil, dass Sie der Auswahl des Stylesheet eine Bedingung zugrunde legen können (siehe Anwenden benutzerdefinierter Stylesheets). Nähere Informationen dazu finden Sie im Abschnitt Stylesheets.

 

Click to expand/collapseBrowser-CSS-Klasse

Der Name einer oder mehrerer CSS-Klassen, die mit diesem Steuerelement verknüpft werden sollen. Verwenden Sie ein Leerzeichen, um mehrere Klassen zuzuweisen: LabelClassOne LabelClassTwo. Diese Klassen können anschließend in einer (im Dialogfeld "Browser-Einstellungen") definierten) CSS-Datei verwendet werden, um diesem Steuerelement Eigenschaften zuzuweisen. Der Name/Die Namen der Klasse(n) kann/können auch mit Hilfe eines XPath-Ausdrucks generiert oder abgerufen werden.

 


© 2019 Altova GmbH