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:: 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

@@ Line 1: / Line 1: @@
 {{RV|type=command
-| arma3
+|game1= arma3
+|version1= 0.74
-|0.74
 |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.
+|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]
+|s1= [[tvSetPicture]] [idc, path, name]
 |p1= idc: [[Number]]
@@ Line 17: / Line 21: @@
 |p3= name: [[String]]
-| [[Nothing]]
+|r1= [[Nothing]]
-| s2= control [[tvSetPicture]] [path, name]
+|s2= control [[tvSetPicture]] [path, name]
-|p21= control: [[Control]] |PARAMETER21=
+|p21= control: [[Control]]
-|p22= path: [[Array]] of [[Number]]s |PARAMETER22=
+|p22= path: [[Array]] of [[Number]]s
-|p23= name: [[String]] |PARAMETER23=
+|p23= name: [[String]]
 |r2= [[Nothing]]
-|x1= <code>[[tvSetPicture]] [101, [0], "picture"];</code>
+|x1= <sqf>tvSetPicture [101, [0], "picture"];</sqf>
-|x2= <code>_ctrl [[tvSetPicture]] [<nowiki/>[0,0,0], [[getText]] ([[configFile]] >> "CfgWeapons" >> "optic_NVS" >> "picture")];</code>
+|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]]
+|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>
-|
+|seealso= [[tvPicture]] [[tvSetPictureColor]] [[tvSetPictureRight]] [[tvSetPictureRightColor]]
 }}