diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-F9C12192-EDA8-4220-87DF-E7F1EA50CDEF.dita --- a/Symbian3/SDK/Source/GUID-F9C12192-EDA8-4220-87DF-E7F1EA50CDEF.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-F9C12192-EDA8-4220-87DF-E7F1EA50CDEF.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,662 +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:

- -
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.

+ + + + + +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, +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.

 \ No newline at end of file