List item types

The appearance of list items can be chosen from the following types. The examples are from lists displayed in the main pane; for most item types a similar component for use in pop-up windows is possible.

Table 1. List item types
Item	Description
Single-line item	ABC	Main text	Primary font
[list_single_pane]	D	Item status graphics	Single color
	Menu lists Selection lists Markable lists Note: Item status graphics in column D may be empty; they indicate, for example, temporary item states.
Single-line item with a number	A	Ordinal number	Primary font small
[list_single_number_pane]	BC	Main text	Primary font
	D	Item status graphics	Single color
	Menu lists Selection lists Markable lists Note: Numbered lists should only be used when numbering offers some added value.
Single-line item with a graphic	A	Item property graphic	Color
[list_single_graphic_pane]	BC	Main text	Primary font
	D	Item status graphics	Single color
	Menu lists Selection lists Multi-selection lists Markable lists
Single-line item with a heading	AB	Heading	Secondary font
[list_single_heading_pane]	C	Main text	Primary font
	D	Item status graphics	Single color
	Menu lists Selection lists Markable lists
Single-line item with a number and a heading	A	Ordinal number	Secondary font
[list_single_number_heading_pane]	B	Heading	Secondary font
	C	Main text	Primary font
	D	Item status graphics	Single color
	Menu lists Selection lists Markable lists
Single-line item with a graphic and a heading	A	Item property graphic	Color
[list_single_graphic_heading_pane]	B	Heading	Secondary font
	C	Main text	Primary font
	D	Item status graphics	Single color
	Menu lists Selection lists Multi-selection lists Markable lists
Single-line item with a large graphic	AB	Large graphic	Color
[list_single_large_graphic_pane]	C	Main text	Primary font
	D	Item status graphics	Single color
	Menu lists Selection lists Markable lists Note: A large graphic may be , for example, an image or indicate item property.
Two-line item	ABC (line 1)	Main text	Primary font
[list_double_pane]	ABC (line 2)	Additional text	Secondary font
	D (line1)	Item status graphics	Single color
	Menu lists Selection lists Markable lists Note: The second line may be empty.
Two-line item with a number	A	Ordinal number	Primary font small
[list_double_number_pane]	BC (line 1)	Main text	Primary font
	BC (line 2)	Additional text	Secondary font
	D (line1)	Item status graphics	Single color
	Menu lists Selection lists Markable lists
Two-line item with a graphic	A	Item property graphic	Color
[list_double_graphic_pane]	BC (line 1)	Main text	Primary font
	BC (line 2)	Additional text	Secondary font
	D	Item status graphics	Single color
	Menu lists Selection lists Markable lists
Two-line item with a heading	ABC (line1)	Heading	Secondary font
[list_double_heading_pane]	ABC (line 2)	Main text	Primary font
	D (line 1)	Item status graphics	Single color
	Menu lists Selection lists Markable lists
Two-line item with a large graphic	AB	Large graphic	Color
[list_double_large_graphic_pane]	C (line 1)	Main text	Primary font
	C (line 2)	Additional text	Secondary font
	D (line 1)	Item status graphics
	Menu lists Selection lists Markable lists
Two-line item with a graphic and a heading	A	Item property graphic	Color
[list_double_graphic_heading_pane]	BC (line 1)	Heading	Secondary font
	BC (line 2)	Main text	Primary font
	D (line 1)	Two additional graphics possible	Single color
	Menu lists Selection lists Markable lists
Two-line item with time	AB	Time	Digital font
[list_double_time_pane]	C (line 1)	Main text	Primary font
	C (line 2)	Additional text	Secondary font
	D (line 1)	Item status graphics	Single color
	Clock alarm lists
Two-line item, style 2	ABC (line 1)	Main text	Primary font
[list_double2_pane]	ABC (line 2)	Main text continues	Primary font
	D (line1)	Item status graphics	Single color
	Menu lists Selection lists Markable lists Note: One text item that can extend to a second line.
Two-line item with a graphic, style 2	A	Item property graphic	Color
[list_double2_graphic_pane]	BC (line 1)	Main text	Primary font
	BC (line 2)	Main text (continued)	Primary font
	D	Item status graphics	Single color
	Menu lists Selection lists Markable lists
Two-line item with a large graphic, style 2	AB	Large graphic	Color
[list_double2_large_graphic_pane]	C (line 1)	Main text	Primary font
	C (line 2)	Main text (continued)	Primary font
	D	Item status graphics	Single color
	Menu lists Selection lists Markable lists
Settings item	ABC (line 1)	Setting item text	Primary font
[list_setting_pane]	ABC (line 2)	Value item status	Primary font small
	D (line1)	Item status graphics	Single color
	Setting lists Note: The value item may be omitted in order to create a regular selection item within a setting list.
Setting item with a number	A	Ordinal number	Primary font small
[list_setting_number_pane]	BC (line 1)	Setting item text	Primary font
	BC (line 2)	Value item status	Primary font small
	D (line1)	Item status graphics	Single color
	Setting lists Note: The value item may be omitted in order to create a regular selection item within a setting list.
Single-line item with two graphics	A	Item selection graphic	Single color
[list_single_2graphic_pane]	B	Item property graphic	Color
	C	Main text	Primary font
	D	Item status graphics	Single color
	Menu lists Selection lists Multi-selection lists Markable lists
Two-line item with a graphic and a large graphic, style 2	A	Item selection graphic	Single color
[list_double_graphic_large_graphic_pane]	B	Large graphic	Color
	C	Main text	Primary font
	D	Item status graphics	Single color
	Menu lists Selection lists Multi-selection lists Markable lists

There is a corresponding pop-up window list item for the following components:

single-line item
single-line item with a number
single-line item with a graphic
single-line item with a heading
single-line item with a number and a heading
single-line item with a graphic and a heading
single-line item with a large graphic
single-line item with two graphics
two-line item
two-line item with a number
two-line item with a graphic
two-line item with a heading
two-line item with a large graphic
two-line item, style 2
two-line item with a graphic, style 2
two line item with a large graphic, style 2

Using list item types in applications

For the C++ classes used for the different list item types, see List box item layouts in the Lists API documentation.

Parent topic: List layouts