%HI_GetItemData, %HI_SetItemData functions

Function

The function %HI_SetItemData sets the value pertaining to the item of the Windows control of Tree view type.

The function %HI_GetItemData detects the user defined value pertaining to the item of the Windows control of Tree view type.

Declaration

%HI_SetItemData(
   INT in refId,
   INT in itemHandle,
   INT in position,
       in data
 )
 
 
 UNIVAL %HI_GetItemData(
   INT in refId,
   INT in itemHandle,
   INT in position
 )

Parameters

refId	Reference to graphic object `(`reference variable`).`
itemHandle	Item identifier.
position	Position of the item data within the interval 1 ... 15.
data	Inserted data (optional type).

Description

Each tree view item can contains an array of 15 data, that may be read or set by the user. Use of the data is optional and their values have no effect on the item behaviour.

The tree view is defined by the reference variable refId.
The item is specified by the parameter itemHandle (see: %HI_AddTreeItem).
The item data is identified by the serial number within the interval 1 .. 15 - the parameter position.

The value type of the parameter data is optional, beside a structure type.

Return code of the function %HI_GetItemData is given by the type of the value stored in particular position.