Untertitel

Darstellung eines zusätzlichen Textes unterhalb der Überschrift in einem Steuerelement.

Der Untertitel wird innerhalb der grafischen Darstellung des Steuerelementes unterhalb der Überschrift angezeigt, falls diese angezeigt wird, sonst anstelle der Überschrift. Der Text kann als Konstante im Steuerelement definiert werden oder aus der Sprachumschaltung von EASY UI Designer bezogen werden.

Der Untertitel wird in einer Untertitelanzeige (Element "Subtitle") dargestellt.

Das Element "Subtitle" ist zum Beispiel im Steuerelement "Group" enthalten.

Die Quelle, das Layout, die Darstellung, der Absatz und die Schrift des Untertitels können über die Eigenschaften der Kategorie "Subtitle" des Steuerelements konfiguriert werden, die Farben des Untertitels über die Eigenschaften der Kategorie "Colors".

• Standardmäßig wird der Untertitel nicht angezeigt. Wenn Sie den Untertitel im Steuerelement anzeigen wollen, aktivieren Sie die Eigenschaft "ShowSubtitle".

Quelle

Folgende Eigenschaften legen den Untertiteltext bzw. die Quelle des Untertiteltextes fest:

SubtitleText

Verwenden Sie diese Eigenschaft, wenn der Untertiteltext sprachunabhängig ist, z. B. ein Name oder eine Kurzbezeichnung.

LocalizableSubtitleText

Soll der Untertiteltext sprachabhängig sein, kann hier über die Schaltfläche der Textauswahldialog geöffnet werden. Hierdurch wird die Verbindung zu einer EASY UI Designer Textdefinition hergestellt. Die Eigenschaft speichert dann den vollständigen Namen der Textdefinition.

• Die Eigenschaft "LocalizableSubtitleText" hat gegenüber der Eigenschaft "SubtitleText" Priorität.

Layout

Das Layout der Untertitelanzeige kann über folgende Eigenschaften konfiguriert werden:

SubtitleHeight

Legt die Höhe der Untertitelanzeige fest.

SubtitleMargin

Legt die äußeren Abstände des Untertitelanzeige fest, d. h. zwischen dem Rand der Untertitelanzeige und ihrem übergeordneten oder benachbarten Element.

SubtitlePadding

Legt die inneren Abstände des Untertitelanzeige fest, d. h. zwischen dem Rand der Untertitelanzeige und ihrem Inhalt, also dem eigentlichen Untertiteltext.

SubtitleWidth

Legt die Breite der Untertitelanzeige fest.

Darstellung

Für die Darstellung des Untertitels stehen folgende Eigenschaften zur Verfügung:

ShowSubtitle

Legt fest, ob der Untertitel angezeigt werden soll.

Absatz

Zeilenumbrüche, Zeilenhöhe und Textausrichtung des Untertitels werden über folgende Eigenschaften konfiguriert:

SubtitleLineClamp

Gibt die Anzahl der Zeilen für den Untertitel an, falls der Untertiteltext länger ist als die Untertitelanzeige breit (SubtitleWidth). Die Eigenschaft hat nur eine Wirkung, wenn die Eigenschaft "SubtitleTextWrapping" auf "WrapWithLineClamp" eingestellt ist. Zeilenumbrüche werden anstelle von Leerzeichen im Untertiteltext eingefügt, d. h. innerhalb eines Wortes wird nicht umgebrochen.

SubtitleLineHeight

Legt die Höhe der Textzeile(n) fest. Siehe auch CSS-Referenz: line-height

SubtitleTextAlignment

Legt die horizontale Ausrichtung des Untertiteltextes innerhalb der Untertitelanzeige fest. Siehe auch CSS-Referenz: text-align

SubtitleTextTrimming

Legt fest, wie der Untertiteltext gekürzt wird, wenn er länger ist als die Untertitelanzeige breit.

• Clip

• Der überschüssige Text wird abgeschnitten.

• Ellipsis

• Der überschüssige Text wird durch eine Ellipse (…) abgekürzt (Standardeinstellung).

• Overflow

• Der Text wird angezeigt und ragt eventuell über den Rand des Steuerelements hinaus.

SubtitleTextWrapping

Legt fest, ob und wie der Untertiteltext umgebrochen wird.

• NoWrap

  Kein Zeilenumbruch, der Untertiteltext wird in einer Zeile dargestellt. Ist der Untertiteltext länger als die Breite des Steuerelements, dann wird der überschüssige Text je nach Einstellung in der Eigenschaft "SubtitleTextTrimming" entweder abgeschnitten, durch eine Ellipse abgekürzt oder ragt über den Rand des Steuerelements hinaus.

• Wrap

  Ist der Untertiteltext länger als das Steuerelement breit, dann wird der Text mehrzeilig dargestellt. Zeilenumbrüche werden am jeweiligen Zeilenende nach einem Leerzeichen oder einem Bindestrich automatisch eingefügt.

  • Ist die Breite des Steuerelements (Eigenschaft "Width") auf "auto" eingestellt, dann passt sich die Breite des Steuerelements der Textlänge so lange an, bis seine Breite durch die Breite des übergeordneten Containers begrenzt wird.

  • Ist die Höhe des Steuerelements kleiner als die Gesamthöhe der Zeilen, ragen Zeilen eventuell über die untere Grenze des Steuerelements hinaus. Das Abschneiden der Zeilen wird im Steuerelement RadioButtonGroup dadurch verhindert, dass die Eigenschaft "Height" standardmäßig auf "auto" eingestellt ist. In der Group hingegen ist die Breite standardmäßig auf 200 px eingestellt. Stellen Sie in der Group die Eigenschaft "Height" bei Bedarf manuell auf "auto" ein.

• WrapWithLineClamp

  Ist der Text länger als das Steuerelement breit, dann wird der Text mehrzeilig dargestellt. Dabei wird der Text maximal so viele Zeilen enthalten wie in "SubtitleLineClamp" angegeben ist. Zeilenumbrüche werden am jeweiligen Zeilenende nach einem Leerzeichen oder einem Bindestrich automatisch eingefügt. Ist überschüssiger Text vorhanden, dann wird am Ende der letzten Zeile eine Ellipse automatisch eingefügt. Die Ellipse wird unabhängig von der Einstellung in "SubtitleTextTrimming" eingefügt.

  • Die Anmerkungen für "Wrap" gelten entsprechend für "WrapWithLineClamp".

• WrapWithWordBreak

  Ist der Text länger als das Steuerelement breit, dann wird der Text mehrzeilig dargestellt. Bei dieser Einstellung ist der Textumbruch auch innerhalb der Wörter erlaubt.

  • Die Anmerkungen für "Wrap" gelten entsprechend für "WrapWithWordBreak".

Schrift

Die Schrift des Untertiteltextes wird über folgende Eigenschaften konfiguriert:

SubtitleFontClass

Legt die Schriftklasse des Untertiteltextes fest.

• Die Eigenschaft enthält eine Liste von Schriftklassen, aus denen eine ausgewählt werden kann. Die Einstellungen werden aus einer CSS-Datei bezogen (fontclasses.css), die im Ordner resourcesWtypography im Client-Projektverzeichnis zu finden ist.

SubtitleFontSize

Legt die Schriftgröße des Untertiteltextes fest. Siehe auch CSS-Referenz: font-size

SubtitleFontWeight

Legt fest, wie dick oder dünn die Buchstaben des Untertiteltextes dargestellt werden sollen. Siehe auch CSS-Referenz: font-weight

SubtitleTextContrast

Legt fest, wie hell der Untertiteltext dargestellt werden soll, von 1 (undurchsichtig, Standardeinstellung) über 0,5 (halb durchsichtig) bis 0 (komplett durchsichtig). Siehe auch CSS-Referenz: opacity

SubtitleUppercase

Legt fest, dass der Untertiteltext in Großbuchstaben dargestellt wird. Siehe auch CSS-Referenz: text-transform

Verwandte Themen:

• Das Systemmodul Sprachumschaltung

Betrifft diese Steuerelemente:

CardHeader, Group, RadioButtonGroup