tvSetPicture: Difference between revisions

From Bohemia Interactive Community
mNo edit summary
(Added info about transparent texture for alignment)
 
(43 intermediate revisions by 4 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
____________________________________________________________________________________________


| 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
|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.
* If not all items have a picture but you still want them to be aligned at the front, use a [[Procedural Textures|Procedural Texture]] that is transparent {{hl|#(rgb,32,32,3)color(1,1,1,0)}}.
}}


| [[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] |= Syntax


| 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= [[Nothing]] |= RETURNVALUE
|r2= [[Nothing]]
____________________________________________________________________________________________


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


|x2= <code>_ctrl [[tvSetPicture]] <nowiki>[</nowiki>[0,0,0], [[getText]] ([[configFile]] >> "CfgWeapons" >> "optic_NVS" >> "picture")];</code> |= Example 2
|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]], [[tvSetPicture]], [[tvSetPictureColor]], [[tvSetPictureRight]], [[tvSetPictureRightColor]] |= See Also
|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 14:39, 6 April 2025

Arma 3 logo black.png 0.74
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.

  • If not all items have a picture but you still want them to be aligned at the front, use a Procedural Texture that is transparent #(rgb,32,32,3)color(1,1,1,0).
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
Retrieved from "https://community.bistudio.com/wiki?title=tvSetPicture&oldid=373154"