diff -r 43e37759235e -r 51a74ef9ed63 Symbian3/SDK/Source/GUID-1955F591-2D2C-42EE-AF03-7BBBEE1A4005.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-1955F591-2D2C-42EE-AF03-7BBBEE1A4005.dita Wed Mar 31 11:11:55 2010 +0100 @@ -0,0 +1,135 @@ + + + + + +Grid +types +

Grids are in many ways analogous to lists. However, there are some things +worth noticing:

+ +

The following grid types can be used, and they are analogous to the corresponding +list types:

+Grid types + + + +Grid +Description + + + + +

Menu grid

+

For selecting one item; no Options menu.

+
+ +

Selection grid

+

Permanent state; can be left pending, the Options menu is available.

+
+ +

Markable grid

+

A selection grid with the marking function.

+
+ + +
+

There are no grid types corresponding to a multi-selection list, a setting +list or a form.

+Default touch +events in grids. + + + +

User action

+

State change

+

Feedback

+
+ + + +

Touch down

+

No effect

+

Highlight is shown.

Tactile: Basic list effect and audio feedback +is provided with touch down event.

+
+ +

Touch release

+

Item is activated

+

Highlight disappears.

Tactile: Basic list effect is provided +with touch release event.

+
+ +

Touch down and move outside the grid without releasing the touch +down.

+

Refer to Dragging +and flicking events

+

Tactile: Refer to Dragging +and flicking events.

+
+ +

Touch down, move outside and back.

+

Refer to Dragging +and flicking events

+

Tactile: Refer to Dragging +and flicking events.

+
+ +

Touch down and move vertically

+

Refer to Dragging +and flicking events

+

Tactile: Refer to Dragging +and flicking events.

+
+ +

Touch down and move horizontally

+

Refer to Dragging +and flicking events

+Highlight stays on the item while it is touched and disappears when +moving outside of it.

Tactile: Refer to Dragging +and flicking events.

+
+ + +
+
Using +grids in C++ applications

The APIs to use for grids are the Grids API and the Lists API. For implementation information, see Using the Grids API and Using the Lists API.

The CAknGrid class is used to set up the basic parameters of +a layout in terms of number of columns and rows, cell size, and orientation. +After this, AknListBoxLayouts is +used to set up detailed parameters for graphics and text in the cell. The +following cell parameters can be set:

    +
  • Location and size of bitmaps

  • +
  • Location and size of text string

  • +
  • Font and its color

  • +
  • Text align in the allocated space

  • +

Bitmaps are loaded manually, as an icon array.

Other parameters +of visual elements (for example, highlighted text color) are used from the +Symbian Developer Platform standard look and feel module; these should not +be overridden unless you've instantiated your own class.

Several specialized grid classes can be found in AVKON.

Use +the class CAknCaleMonthStyleGrid to show a month view. The first row shows the day and the first column shows +the week number. The following data can be set for an item:

    +
  • Outlined icon to show border, dimension 21 x 9 pixels

  • +
  • Marking icon in the bottom right corner of a cell, dimension 5 x 5 +pixels

  • +
  • Two-digit number

  • +

Use the class CAknPinbStyleGrid to show application shortcuts in a 5 x 5 cells grid. For every item, an +icon is specified that is displayed in the center of a cell. In addition, +two small icons, 13 x 13 pixels, can be specified. The first one is displayed +in the top-right corner for marking. The second one is displayed in the bottom-left +corner to show the target application.

+
\ No newline at end of file