Primary text

Display of a text in a list entry.

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

The main text is displayed in a main text display ("PrimaryText" element).

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

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

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

PrimaryText

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

LocalizablePrimaryText

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 "LocalisablePrimaryText" property has priority over the "PrimaryText" property.

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

PrimaryTextHeight

Defines the height of the main text display.

PrimaryTextMargin

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

PrimaryTextWidth

Defines the widthof the main text display.

The following properties are available for displaying the main text:

ShowPrimaryText

Determines whether the main text should be displayed.

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

PrimaryTextAlignment

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

PrimaryTextLineHeight

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

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

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

PrimaryTextContrast

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

PrimaryTextFontClass

Defines the font class of the main 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.

PrimaryTextFontSize

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

PrimaryTextFontWeight

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