tvSetPicture: Difference between revisions

Latest revision as of 14:39, 6 April 2025

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:: Copy
tvSetPicture [101, [0], "picture"];
Example 2:: Copy
_ctrl tvSetPicture [[0,0,0], getText (configFile >> "CfgWeapons" >> "optic_NVS" >> "picture")];
Example 3:: Adding images in a scheduled environment:
Copy
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

@@ 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.
+|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.
-<br>
+{{Feature|informative|
-Name is picture name. The picture is searched in the mission directory. |= Description
+* 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)}}.
+}}
+|s1= [[tvSetPicture]] [idc, path, name]
-| '''tvSetPicture''' [idc, [path], name] |= Syntax
+|p1= idc: [[Number]]
-|p1= [idc, [path], name]: [[Array]] |= PARAMETER1
+|p2= path: [[Array]] of [[Number]]s
-|p2= idc: [[Number]] |= PARAMETER2
+|p3= name: [[String]]
-|p3= [path]: [[Array]] - Array containing numbers. |= PARAMETER3
+|r1= [[Nothing]]
-|p4= name: [[String]] |= PARAMETER4
+|s2= control [[tvSetPicture]] [path, name]
-| [[Nothing]] |= RETURNVALUE
+|p21= control: [[Control]]
+|p22= path: [[Array]] of [[Number]]s
-|x1= <code>[[tvSetPicture]] [101, [0], "picture"];</code> |= Example 1
+|p23= name: [[String]]
-____________________________________________________________________________________________
-| [[tvAdd]], [[tvClear]], [[tvCollapse]], [[tvCount]], [[tvCurSel]], [[tvData]], [[tvDelete]], [[tvExpand]], [[tvPicture]], [[tvSetCurSel]], [[tvSetData]], [[tvSetValue]], [[tvSort]], [[tvSortByValue]], [[tvText]], [[tvValue]] |= See Also
+|r2= [[Nothing]]
-|  |= MPBEHAVIOUR
+|x1= <sqf>tvSetPicture [101, [0], "picture"];</sqf>
-____________________________________________________________________________________________
-}}
-<h3 style='display:none'>Notes</h3>
+|x2= <sqf>_ctrl tvSetPicture [[0,0,0], getText (configFile >> "CfgWeapons" >> "optic_NVS" >> "picture")];</sqf>
-<dl class='command_description'>
-<!-- Note Section BEGIN -->
-<!-- Note Section END -->
+|x3= Adding images in a scheduled environment:
-</dl>
+<sqf>
+private _path = _ctrlTV tvAdd [[], "Some Entry"];
+[_ctrlTV, _path] spawn {
+	(_this select 0) tvSetPictureRight [[_this select 1], "someImage.paa"];
+};
+</sqf>
-<h3 style='display:none'>Bottom Section</h3>
+|seealso= [[tvPicture]] [[tvSetPictureColor]] [[tvSetPictureRight]] [[tvSetPictureRightColor]]
-[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
+}}
-[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]