hiTreeTableSelectItems
hiTreeTableSelectItems(
g_treeField
l_items
[ g_notify ]
)
=> t / nil
Description
Selects items in a tree table field. This function also executes the callback of the tree table field if you specify t as the value of the g_notify argument.
This function is the programmatic equivalent of selecting items with the mouse or keyboard keys.
To select more than one item, use hiTreeTableSelectItems. To select all items in a field, use hiTreeTableSelectAllItems.
Arguments
|
g_treeField
|
The tree table field that contains the items.
|
|
l_items
|
The items you want to select. l_items can either be a list of item names (symbols) or a list of ranges, specified as follows:
(s_parentItem x_topRow x_bottomRow)
where s_parentItem is the symbol of the parent item, and x_topRow and x_bottomRow are intergers specifying the range of items to select. (The first item is assumed to be 0, the second 1, and so on.)
|
|
g_notify
|
Runs the callback procedure of the tree table field. Specify nil if you do not want to execute the callback procedure.
|
Values Returned
|
t
|
The items were selected.
|
|
nil
|
The items were not selected.
|
Related Topics
Form and Field Functions
hiTreeTableSelectItem
hiTreeTableSelectAllItems
hiTreeTableDeselectItems
hiTreeTableGetSelectedItems
hiTreeTableGetSelectedItemCount
hiCreateTreeTable
Return to top
