tvAdd: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|Game version=" to "|Game version= |gr1= GUI Control |GROUP1= ")
m (Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *I([a-z ])" to "$1 - i$2")
 
(39 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 0.74


|0.74|Game version=
|gr1= GUI Control - Tree View


|gr1= GUI Control |GROUP1=
|descr= 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.


|s1= [[tvAdd]] [idc, pathParent, text]


____________________________________________________________________________________________
|p1= idc: [[Number]]


| 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. |DESCRIPTION=
|p2= pathParent: [[Array]] - [[Tree View Path]] of parent item or [] if no parent exists
____________________________________________________________________________________________


| [[tvAdd]] [idc, pathParent, text] |SYNTAX=
|p3= text: [[String]]


|p1= [idc, pathParent, text]: [[Array]] |PARAMETER1=
|r1= [[Number]] - index of the added item relative to the branch it was added to


|p2= idc: [[Number]] |PARAMETER2=
|s2= control [[tvAdd]] [pathParent, text]


|p3= pathParent: [[Array]] - [[Tree View Path]] of parent item or [] if no parent exists|PARAMETER3=
|p21= control: [[Control]]


|p4= text: [[String]] |PARAMETER4=
|p22= pathParent: [[Array]] - [[Tree View Path]] of parent item or [] if no parent exists


| [[Number]] - Index of the added item relative to the branch it was added to |RETURNVALUE=
|p23= text: [[String]]


____________________________________________________________________________________________
|r2= [[Number]] - index of the added item relative to the branch it was added to


| s2= control [[tvAdd]] [pathParent, text] |SYNTAX2=
|x1= <sqf>_index = _ctrl tvAdd [[], "Parent Item"];</sqf>


|p21= control: [[Control]] |PARAMETER1=
|x2= <sqf>_index = tvAdd [101, [0], "First item"];</sqf>


| p22= [pathParent, text]: [[Array]] |PARAMETER2=
|seealso= [[tvClear]] [[tvCollapse]] [[tvCount]] [[tvCurSel]] [[tvData]] [[tvDelete]] [[tvExpand]] [[tvPicture]] [[tvSetCurSel]] [[tvSetData]] [[tvSetValue]] [[tvSort]] [[tvSortByValue]] [[tvValue]] [[tvText]] [[tvSetText]] [[tvSetPicture]] [[tvSetPictureColor]] [[tvSetPictureRight]] [[tvSetPictureRightColor]]
 
|p23= pathParent: [[Array]] - [[Tree View Path]] of parent item or [] if no parent exists |PARAMETER3=
 
|p24= text: [[String]] |PARAMETER4=
 
| r2= [[Number]] - Index of the added item relative to the branch it was added to |RETURNVALUE=
____________________________________________________________________________________________
 
|x1= <code>_index = _ctrl [[tvAdd]] [<nowiki/>[], "Parent Item"];</code> |EXAMPLE1=
|x2= <code>_index = [[tvAdd]] [101, [0], "First item"];</code> |EXAMPLE2=
____________________________________________________________________________________________
 
| [[tvClear]], [[tvCollapse]], [[tvCount]], [[tvCurSel]], [[tvData]], [[tvDelete]], [[tvExpand]], [[tvPicture]], [[tvSetCurSel]], [[tvSetData]], [[tvSetValue]], [[tvSort]], [[tvSortByValue]], [[tvValue]], [[tvText]], [[tvSetText]], [[tvSetPicture]], [[tvSetPictureColor]], [[tvSetPictureRight]], [[tvSetPictureRightColor]] |SEEALSO=
 
|  |MPBEHAVIOUR=
____________________________________________________________________________________________
}}
}}
<h3 style='display:none'>Notes</h3>
<dl class='command_description'>
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on Sep 11 2014</dd>
<dt class="note">[[User:ffur2007slx2_5|ffur2007slx2_5]]</dt>
<dd class="note">(A3 1.28)tv command family overview
<code>
//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"];
[[file:WuChaoRen_CTTree001.png]]
_count = _CT_TREE [[tvCount]] []; //return 2
_CT_TREE [[tvSetCurSel]] [0,0,0]; //select grandchild_A
[[file:WuChaoRen_CTTree003.png]]
_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;
[[file:WuChaoRen_CTTree004.png]]
_CT_TREE [[tvExpand]] [1];
[[file:WuChaoRen_CTTree005.png]]
_CT_TREE [[tvSort]] [[],[[false]] ];
_CT_TREE [[tvSortByValue]] [[],[[false]] ];
[[file:WuChaoRen_CTTree006.png]]
_CT_TREE [[tvDelete]] [0,0]; //remove child_b
[[tvClear]] 12;
_CT_TREE [[tvCollapse]] [];
[[file:WuChaoRen_CTTree002.png]]
</code>
<!-- Note Section END -->
</dl>
<h3 style='display:none'>Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_GUI_Control|{{uc:{{PAGENAME}}}}]]

Latest revision as of 15:33, 8 November 2023

Arma 3 logo black.png0.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 - Tree View

Syntax

Syntax:
tvAdd [idc, pathParent, text]
Parameters:
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: 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:
tvClear tvCollapse tvCount tvCurSel tvData tvDelete tvExpand tvPicture tvSetCurSel tvSetData tvSetValue tvSort tvSortByValue tvValue tvText tvSetText tvSetPicture tvSetPictureColor tvSetPictureRight tvSetPictureRightColor

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
Retrieved from "https://community.bistudio.com/wiki?title=tvAdd&oldid=348792"