tvSetPicture: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " \| ?r2=(.*)\|RETURNVALUE= *" to " |r2=(.*)|RETURNVALUE2=")
m (Fix)
 
(32 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= Sets picture to item selected by path. IDC means id of parent Tree View. Name is picture name. The picture is searched in the mission directory.
 
{{Feature|informative|
 
Adding pictures to lists is very slow. In order to prevent the filling of the list to be slowed down, add the pictures in a '''scheduled''' environment - See {{Link|#Example 3}}.
____________________________________________________________________________________________
One drawback of this method is that sorting the entries is not easily possible.
 
}}
| Sets picture to item selected by path. IDC means id of parent Tree View. Name is picture name. The picture is searched in the mission directory. |DESCRIPTION=
____________________________________________________________________________________________


| [[tvSetPicture]] [idc, path, name] |SYNTAX=
|s1= [[tvSetPicture]] [idc, path, name]


|p1= [idc, path, name]: [[Array]] |PARAMETER1=
|p1= idc: [[Number]]


|p2= idc: [[Number]] |PARAMETER2=
|p2= path: [[Array]] of [[Number]]s


|p3= path: [[Array]] - Array containing numbers. |PARAMETER3=
|p3= name: [[String]]


|p4= name: [[String]] |PARAMETER4=
|r1= [[Nothing]]


| [[Nothing]] |RETURNVALUE=
|s2= control [[tvSetPicture]] [path, name]
____________________________________________________________________________________________
| s2= control [[tvSetPicture]] [path, name] |SYNTAX2=


|p21= control: [[Control]] |PARAMETER1=
|p21= control: [[Control]]


| p22= [path, name]: [[Array]] |PARAMETER2=
|p22= path: [[Array]] of [[Number]]s


|p23= path: [[Array]] - Array containing numbers. |PARAMETER3=
|p23= name: [[String]]
|p24= name: [[String]] |PARAMETER4=


|r2=(.*)|RETURNVALUE2=
|r2= [[Nothing]]
____________________________________________________________________________________________


|x1= <code>[[tvSetPicture]] [101, [0], "picture"];</code> |EXAMPLE1=
|x1= <sqf>tvSetPicture [101, [0], "picture"];</sqf>


|x2= <code>_ctrl [[tvSetPicture]] [<nowiki/>[0,0,0], [[getText]] ([[configFile]] >> "CfgWeapons" >> "optic_NVS" >> "picture")];</code> |EXAMPLE2=
|x2= <sqf>_ctrl tvSetPicture [[0,0,0], getText (configFile >> "CfgWeapons" >> "optic_NVS" >> "picture")];</sqf>
____________________________________________________________________________________________


| [[tvAdd]], [[tvClear]], [[tvCollapse]], [[tvCount]], [[tvCurSel]], [[tvData]], [[tvDelete]], [[tvExpand]], [[tvPicture]], [[tvSetCurSel]], [[tvSetData]], [[tvSetValue]], [[tvSort]], [[tvSortByValue]], [[tvValue]], [[tvText]], [[tvSetText]], [[tvSetPictureColor]], [[tvSetPictureRight]], [[tvSetPictureRightColor]] |SEEALSO=
|x3= Adding images in a scheduled environment:
<sqf>
private _path = _ctrlTV tvAdd [[], "Some Entry"];
[_ctrlTV, _path] spawn {
(_this select 0) tvSetPictureRight [[_this select 1], "someImage.paa"];
};
</sqf>


| |MPBEHAVIOUR=  
|seealso= [[tvPicture]] [[tvSetPictureColor]] [[tvSetPictureRight]] [[tvSetPictureRightColor]]
____________________________________________________________________________________________
}}
}}
<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 22:26, 29 March 2024

Hover & click on the images for description

Description

Description:
Sets picture to item selected by path. IDC means id of parent Tree View. Name is picture name. The picture is searched in the mission directory.
Adding pictures to lists is very slow. In order to prevent the filling of the list to be slowed down, add the pictures in a scheduled environment - See Example 3. One drawback of this method is that sorting the entries is not easily possible.
Groups:
GUI Control - Tree View

Syntax

Syntax:
tvSetPicture [idc, path, name]
Parameters:
idc: Number
path: Array of Numbers
name: String
Return Value:
Nothing

Alternative Syntax

Syntax:
control tvSetPicture [path, name]
Parameters:
control: Control
path: Array of Numbers
name: String
Return Value:
Nothing

Examples

Example 1:
tvSetPicture [101, [0], "picture"];
Example 2:
_ctrl tvSetPicture [[0,0,0], getText (configFile >> "CfgWeapons" >> "optic_NVS" >> "picture")];
Example 3:
Adding images in a scheduled environment:
private _path = _ctrlTV tvAdd [[], "Some Entry"]; [_ctrlTV, _path] spawn { (_this select 0) tvSetPictureRight [[_this select 1], "someImage.paa"]; };

Additional Information

See also:
tvPicture 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