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

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

The size of a Grid List Box 3D node determines the number of rows and columns: a Grid List Box 3D 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 3D internally uses ScrollView3D. To make the input work:

• Position the Grid List Box 3D in front of the camera oriented so that the scroll plane is perpendicular to the camera view ray.
• Set the size of the Grid List Box 3D. The scroll view uses that area to collect input.

To configure the scroll view, Kanzi internally binds the properties that you set in the Grid List Box 3D to the corresponding properties in the scroll view. You can send to a Grid List Box 3D node ScrollViewConcept messages, such as ScrollViewConcept::ScrollDownMessage, ScrollViewConcept::ScrollHomeMessage, and ScrollViewConcept::ScrollPageDownMessage.

Use a Grid List Box 3D to create a scrollable list of content arranged in a grid.

Inherits properties and message types from GridListBox3DMetadata.

GridListBox3D.GridListBox3D:create(name) ¶

Creates a Grid List Box 3D node.

Parameters

name

(string)

The name of the node.