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.
- ExplorerListGadget(): with the following value:
  #PB_Explorer_Selected : The item should be selected.
- 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).
  #PB_ListIcon_Inbetween: The item should have its checkbox in the in between state (#PB_ListIcon_ThreeState 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.
  #PB_Tree_Inbetween: The items checkbox should be in the in between state.
  SetGadgetItemState(0, 1, #PB_Tree_Expanded | #PB_Tree_Selected) ; The 2nd item is selected and expanded.

See Also

GetGadgetItemState(), GetGadgetState(), SetGadgetState()

Supported OS

All

<- SetGadgetItemImage() - Gadget Index - SetGadgetItemText() ->