ComboBoxGadget3D()

Syntax

Result = ComboBoxGadget3D(#Gadget3D, x, y, Width, Height [, Flags])

Create a ComboBox gadget in the current GadgetList. If #PB_Any is used as '#Gadget3D' parameter, the new gadget number will be returned as 'Result'. #Gadget3D will be the number returned by EventGadget3D() function. Once a ComboBox is created, its list of items is empty. The 'Height' parameter has no effect on the real height of the gadget, which is determined automatically by the font.

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

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

- AddGadgetItem3D(): Add an item.
- GetGadgetItemText3D(): Returns the gadget item text.
- CountGadgetItems3D(): Count the items in the current combobox.
- ClearGadgetItems3D(): Remove all the items.
- RemoveGadgetItem3D(): Remove an item.
- SetGadgetItemText3D(): Changes the gadget item text.

- GetGadgetState3D(): Get the index (starting from 0) of the current element.
- GetGadgetText3D(): Get the (text) content of the current element.
- SetGadgetState3D(): Change the selected element.
- SetGadgetText3D(): Set the displayed text. If the ComboBoxGadget is not editable, the text must be in the dropdown list.

'Flags' are always optional and can be composed (using the '|' operator) of one of the following constants:

  #PB_ComboBox3D_Editable  : Makes the ComboBox editable

Supported OS

All