int SetActiveTreeItem (int panelHandle, int controlID, int itemIndex, int selectionEffect);
Sets the active item of a tree control. If the tree is in multiple selection mode, the effect on the selection is determined by the selectionEffect parameter.
Input | ||||
Name | Type | Description | ||
panelHandle | integer | Specifier for a particular panel that is currently in memory. You obtain this handle from LoadPanel, NewPanel, or DuplicatePanel. | ||
controlID | integer | The defined constant, located in the .uir header file, that you assigned to the control in the User Interface Editor, or the ID returned by NewCtrl or DuplicateCtrl. | ||
itemIndex | integer | Zero-based index of the tree item. | ||
selectionEffect | integer |
Defines the effect on the selection state of the tree items.
VAL_NO_SELECTION_EFFECTno selection change. VAL_TOGGLE_SELECTION_OF_ITEMtoggle the selection of the new active item. VAL_ADD_ITEM_TO_SELECTIONselect the new active item. VAL_ADD_INTERVAL_TO_SELECTIONselect all items between the old active item and the new active item. VAL_REPLACE_SELECTION_WITH_ITEMdeselect all items and leave only the new active item selected. |
Name | Type | Description | ||||
status | integer | Return value indicating whether the function was successful. A negative number indicates that an error occurred.
|