Class TrajectoryListBox3D

Class Hierarchy
  • KanziObject
  •  └─ Node
  •        └─ Node3D
  •              └─ TrajectoryListBox3D

Use the Trajectory List Box 3D node to create scrollable lists of items arranged along a Trajectory.

Trajectory List Box 3D measures the width of its items and shows those items that fit on the trajectory. To add space between the list items use the SpacingProperty or make the list items artificially wider. If the list is looping and all items fit on the trajectory, Kanzi increases the spacing automatically to distribute the items evenly on the trajectory.

Trajectory List Box 3D has a \em cursor that is by default positioned in the middle of the trajectory. To move the cursor, use the CursorOffsetProperty. When the user is not giving input to the Trajectory List Box 3D and the scrolling has slowed down, the Trajectory List Box 3D selects the nearest item and snaps it to the cursor.

To handle input, the Trajectory List Box 3D internally uses ScrollView3D. To make the input work:

  • Position the Trajectory 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 Trajectory List Box 3D. The scroll view uses that area to collect input.

To configure the scroll view, Kanzi forwards to the scroll view those scroll view properties that you set in the Trajectory List Box 3D.

See also

Use a Trajectory List Box 3D to create a scrollable list of content arranged along a trajectory.

Inherits properties and message types from TrajectoryListBox3DMetadata.

Synopsis

Methods
create()

Creates a TrajectoryListBox3D node

TrajectoryListBox3D.TrajectoryListBox3D:create(name)

Creates a TrajectoryListBox3D node.

Parameters
name (string)

The name of the node.