tvAdd

0.74

Hover & click on the images for description

Description

Description:

Adds an item with given text to Tree View control. The position on Tree View where to add the item and the actual path to this item once added are different. If item is added to existing item, then parent item path is used. If no parent exists, empty array [] is used. See Tree View Path for more information.

Groups:

GUI Control

Syntax

Syntax:

tvAdd [idc, pathParent, text]

Parameters:

[idc, pathParent, text]: Array

idc: Number

pathParent: Array - Tree View Path of parent item or [] if no parent exists

text: String

Return Value:

Number - Index of the added item relative to the branch it was added to

Alternative Syntax

Syntax:

control tvAdd [pathParent, text]

Parameters:

control: Control

[pathParent, text]: Array

pathParent: Array - Tree View Path of parent item or [] if no parent exists

text: String

Return Value:

Number - Index of the added item relative to the branch it was added to

Examples

Example 1:

_index = _ctrl tvAdd [[], "Parent Item"];

Example 2:

_index = tvAdd [101, [0], "First item"];

Additional Information

See also:

tvCleartvCollapsetvCounttvCurSeltvDatatvDeletetvExpandtvPicturetvSetCurSeltvSetDatatvSetValuetvSorttvSortByValuetvValuetvTexttvSetTexttvSetPicturetvSetPictureColortvSetPictureRighttvSetPictureRightColor

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Notes

Posted on Sep 11 2014

ffur2007slx2_5

(A3 1.28)tv command family overview //tv command family available for CT_TREE (type 12) private ["_count","_current","_data","_text","_value","_pic"]; _CT_TREE tvAdd [ [],"Parent_A"]; _CT_TREE tvAdd [ [0],"Child_A"]; _CT_TREE tvAdd [ [0,0],"Grandchild_A"]; _CT_TREE tvAdd [ [],"Parent_B"]; _CT_TREE tvAdd [ [1],"Child_B"]; _count = _CT_TREE tvCount []; //return 2 _CT_TREE tvSetCurSel [0,0,0]; //select grandchild_A _current = tvCurSel _CT_TREE; //return [0,0,0] _CT_TREE tvSetData [_current,"I'm grandchild_A"]; _data = _CT_TREE tvData _current; // "I'm grandchild_A" _text = _CT_TREE tvText _current; //"Grandchild_A" _CT_TREE tvSetValue [_current,14]; _value = _CT_TREE tvValue _current; // 14 _CT_TREE tvSetPicture [_current,getText (configFile >> "CfgWeapons" >> "optic_NVS" >> "picture")]; _pic = _CT_TREE tvPicture _current; _CT_TREE tvExpand [1]; _CT_TREE tvSort [[],false ]; _CT_TREE tvSortByValue [[],false ]; _CT_TREE tvDelete [0,0]; //remove child_b tvClear 12; _CT_TREE tvCollapse [];