Use the Grid List Box 2D node to create scrollable lists of 2D items arranged in a grid.

To set the size of the grid cells, use the CellWidthProperty and CellHeightProperty properties in the Grid List Box 2D node. All cells in a Grid List Box 2D node are of the same size.

The size of a Grid List Box 2D node determines the number of rows and columns: a Grid List Box 2D node shows as many cells as fit within its area. Kanzi hides the list items that are in cells that do not fit in the list box area. The user can scroll the list box to see more items. The user can temporarily drag list items out of the grid, but when the user is not providing input, the list box scrolls the items back to the grid area.

To handle input, the Grid List Box 2D internally uses ScrollView2D, which uses the list box area to collect input. To configure the scroll view, Kanzi internally binds the properties that you set in the Grid List Box 2D to the corresponding properties in the scroll view. You can send to a Grid List Box 2D node ScrollViewConcept messages, such as ScrollViewConcept::ScrollDownMessage, ScrollViewConcept::ScrollHomeMessage, and ScrollViewConcept::ScrollPageDownMessage.

Inherits properties and message types from GridListBox2DMetadata.

GridListBox2D.GridListBox2D:create(name) ¶

Creates a Grid List Box 2D node.

Parameters

name

(string)

The name of the node.