ListViewGadget3D()

Syntax

Result = ListViewGadget3D(#Gadget3D, x, y, Width, Height)

Creates a ListView gadget in the current GadgetList. Once a ListView is created, its list of items is empty.

Parameters

#Gadget3D	A number to identify the new 3D gadget. #PB_Any can be used to auto-generate this number.
x, y, Width, Height	The position and dimensions of the new gadget.

Return value

Nonzero on success, zero otherwise. If #PB_Any was used as the #Gadget3D parameter then the return-value is the auto-generated gadget number on success.

Remarks

To add a 'mini help' to this gadget, use GadgetToolTip3D().

The following functions can be used to act on the list content:

- AddGadgetItem3D(): Add an item.
- RemoveGadgetItem3D(): Remove an item.
- ClearGadgetItems3D(): Remove all the items
- CountGadgetItems3D(): Returns the number of items currently in the #Gadget3D.

- GetGadgetItemData3D(): Get the value that was stored with the gadget item.
- GetGadgetItemState3D(): Returns nonzero if the item is selected, zero otherwise.
- GetGadgetItemText3D(): Get the content of the given item.
- GetGadgetState3D(): Get the index of the selected item or -1 if there is no selected item.
- GetGadgetText3D(): Get the content of the selected item.
- SetGadgetItemData3D(): store a value with the given item.
- SetGadgetItemState3D(): Selects or deselects the given item.
- SetGadgetItemText3D(): Set the text of the given item.
- SetGadgetState3D(): Change the selected item. If -1 is specified, the selection will be removed.
- SetGadgetText3D(): Selects the item with the given text (the text must match exactly).

Supported OS

All