<< Click to Display Table of Contents >> Navigation: ThinBASIC Modules > UI (User Interface) > CONTROLS > Control Types > TreeView Control > TreeView Control Commands > TreeView_InsertItem |
Description
Insert a new data item into a TreeView control.
Syntax
hItem = TreeView_InsertItem(hWnd, ctrlID, hParent, hAfter, Image, ImageSel, sText [, SetBold])
Returns
Number
If the operation is successful, the handle to the new data item is returned.
If the operation fails, the value zero is returned.
Parameters
Name |
Type |
Optional |
Meaning |
hWnd |
Number |
No |
Handle of the dialog containing the list-view control |
ctrlID |
Number |
No |
Control identifier assigned to the control during CONTROL ADD ... |
hParent |
Number |
Specifies the parent of this item, or zero if item is to be inserted at the root |
|
hAfter |
Number |
Specifies the handle of the item after which this new item is to be inserted. Use the following equates for special positions: %TVI_FIRST to insert new item at the beginning %TVI_LAST to insert new item at the end %TVI_SORT to insert new item in alphabetical order |
|
Image |
Number |
Number |
If an ImageList has been attached to the control, this parameters specify which image should be displayed (1=first, 2=second, etc.) for normal items.
If no image is needed, the value(s) 0 should be used. But if an ImageList is connected to the TreeView control 0 (zero) will in any case load first image of the ImageList. In this case, load as first image of the ImageList an empty image |
ImageSel |
Number |
Number |
If an ImageList has been attached to the control, this parameters specify which image should be used for selected items.
If no image is needed, the value(s) 0 should be used. But if an ImageList is connected to the TreeView control 0 (zero) will in any case load first image of the ImageList. In this case, load as first image of the ImageList an empty image |
sText |
String |
No |
The text string to insert into the control |
SetBold |
Number |
Yes |
If %TRUE, than items text is set to bold |
Remarks
Restrictions
See also
Examples