List +item types

diff -r 43e37759235e -r 51a74ef9ed63 Symbian3/SDK/Source/GUID-F9C12192-EDA8-4220-87DF-E7F1EA50CDEF.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-F9C12192-EDA8-4220-87DF-E7F1EA50CDEF.dita Wed Mar 31 11:11:55 2010 +0100 @@ -0,0 +1,662 @@ + + + + + +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.

+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 +e.g. 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 e.g. 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 C++ applications

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

+ \ No newline at end of file