SetGadgetItemState()

Syntax

SetGadgetItemState(#Gadget, Item, State)
Description
Changes the item state of the specified gadget.

Parameters

#Gadget The gadget to use.
Item The item to use. The first item in the gadget has index 0.
State The new state for the item. See below for the meaning of this parameter.

Return value

None.

Remarks

This is a universal function which works for almost all gadgets which handle several items. 'State' can take the following values:
- CalendarGadget(): #PB_Calendar_Bold to make a date appear bold, #PB_Calendar_Normal otherwise.
- ListViewGadget(): 1 if the item should be selected, 0 otherwise.
- ListIconGadget(): Combination of the following values:
  #PB_ListIcon_Selected : The item should be selected.
  #PB_ListIcon_Checked  : The item should have its checkbox checked (#PB_ListIcon_CheckBoxes flag).
- TreeGadget(): Combination of the following values:
  #PB_Tree_Selected : The item should be selected.
  #PB_Tree_Expanded : The item should be expanded.
  #PB_Tree_Collapsed: The item should be collapsed. If neither #PB_Tree_Expanded nor #PB_Tree_Collapsed is set, this state will not be changed.
  #PB_Tree_Checked  : The items checkbox should be checked.
  SetGadgetItemState(0, 1, #PB_Tree_Expanded | #PB_Tree_Selected) ; The 2nd item is selected and expanded.

See Also

GetGadgetItemState(), GetGadgetState(), SetGadgetState()
<- SetGadgetItemImage() - Gadget Index - SetGadgetItemText() ->