Secondary text

Display of a text in a list entry in addition to the main text.

The secondary text can be displayed in a list entry to describe the list entry in addition to the main text. The text can be defined as a constant in the control element or obtained from the language switch from »EASY UI Designer«.

The secondary text is displayed in a secondary text display ("SecondaryText" element).

The "SecondaryText" element is contained in the "ListItem" element of a ListBox, for example.

The source, layout, display, paragraph and font of the secondary text can be configured via the properties of the "SecondaryText" category of the control, the colours of the text via the properties of the "Colors" category.

The secondary text is not displayed by default. If you want to display the secondary text in the control element, activate the "ShowSecondaryText" property.

The following properties define the text itself or the text source:

SecondaryText

Use this property if the text is language-independent, e.g. a name or a short description.

LocalisableSecondaryText

If the text is to be language-dependent, the text selection dialogue can be opened here via the button. This establishes the connection to an EASY UI Designer text definition. The property then saves the full name of the text definition.

The "LocalisableSecondaryText" property has priority over the "SecondaryText" property.

The layout of the secondary text display can be configured using the following properties:

SecondaryTextHeight

Defines the height of the secondary text display.

SecondaryTextMargin

Defines the outer spacing of the secondary text display, i.e. between the edge of the secondary text display and its parent or neighbouring element.

SecondaryTextWidth

Defines the widthof the secondary text display.

The following properties are available for displaying the secondary text:

ShowSecondaryText

Determines whether the secondary text should be displayed.

Line breaks, line height and text alignment of the secondary text display are configured using the following properties:

SecondaryTextAlignment

Defines the horizontal alignment of the secondary text within the secondary text display. See also CSS reference: text-align

SecondaryTextLineHeight

Defines the height of the text line of the secondary text display. See also CSS reference: line-height

The secondary text is displayed on a single line. Excess text is abbreviated by an ellipsis.

The font of the secondary text is configured using the following properties:

SecondaryTextContrast

Determines how light the font of the secondary text should be displayed, from 1 (opaque, default setting) to 0.5 (semi-transparent) to 0 (completely transparent). See also CSS reference: opacity

SecondaryTextFontClass

Defines the font class of the secondary text.

The property contains a list of font classes from which one can be selected. The settings are obtained from a CSS file (fontclasses.css), which can be found in the resourcesWtypography folder in the client project directory.

SecondaryTextFontSize

Defines the font size of the secondary text. See also CSS reference: font-size

SecondaryTextFontWeight

Determines how thick or thin the letters of the secondary text should be displayed. See also CSS reference: font-weight