Blitz3D+ Command Reference

ClearGadgetItems gadget

Parameters

gadget - combo box, list box or tabber to empty

Description

Removes every item from a combo box, list box or tabber.

Requires Extended language mode.

Empties an item-based gadget in one call - much tidier than looping RemoveGadgetItem. The usual pattern is clear-then-refill: the user opens a different folder or level, so you ClearGadgetItems on the asset list and AddGadgetItem the new contents. In a tabber this removes every tab.

Like the other item commands, clearing from code is silent: no gadget-action events ($401) are posted, so rebuilding a list will not trip your event loop.

The world editor shell sample shows the kind of editor lists this manages.

See also: AddGadgetItem, RemoveGadgetItem, CountGadgetItems, CreateListBox, CreateComboBox.

Index