DialogControls-Toolbox: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Text replacement - "#redirect " to "#REDIRECT ")
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
==CT_TOOLBOX Type=6==
#REDIRECT [[CT_TOOLBOX]]
 
{{Informative|TokenNames common to most controls, such as x, y, w, h, text, idc... can be found [[Arma:_GUI_Configuration#Common_Properties|'''here''']].}}
 
A Toolbox is a set of options, ordered by columns and rows. Only one can be active at a time and one is always selected (the first one by default). For Toolbox with multiple selections see [[CT_CHECKBOXES]].
 
<div style{{=}}"float:right;">
[[Image:CToolBox.jpg|thumb|right|400px|A Toolbox Control from example code with a hint dialog from UI event handler]]
[[Image:CToolBox picture.jpg|thumb|right|400px|A Toolbox Control from example code 2 with a hint dialog from UI event handler]]
</div>
{|class="wikitable" border="1" align="left" cellpadding="3" cellspacing="0" |
! colspan="3" bgcolor="#bbbbff" | Properties
|-
! bgcolor="#ddddff" | Name
! bgcolor="#ddddff" | Type
! bgcolor="#ddddff" | Remark
|-
| '''colorText'''
| color array
| color of the non-selected option text
|-
| '''colorTextSelect'''
| color array
| color of the selected option text
|-
| '''colorBackground'''
| color array
| color of the background when option is not selected
|-
| '''colorSelectedBg'''
| color array
| color of the background when option is selected
|-
| '''font'''
| [[Float]]
| the font to use. See the list of [[Fonts#Available_Fonts|available fonts]] for possible values
|-
| '''sizeEx'''
| [[Float]]
| the font size of text (0 to 1)
|-
| '''rows'''
| [[Integer]]
| amount of rows to arrange options into
|-
| '''columns'''
| [[Integer]]
| amount of columns to arrange options into
|-
| '''strings'''
| string array
| options texts to display
|-
| '''checked_strings'''
| string array
| options texts to display when an option is selected
|-
| '''values'''
| [[Float]] array
| Numerical values associated with items. Can be retrieved or set with [[lbValue]] and [[lbSetValue]]
|-
| '''tooltips'''
| string array
| Tooltips for each option
|-
|}<br clear="all">
 
* '''Example Config:'''
<syntaxhighlight lang=cpp>
class MyRscToolbox
{
onLoad = "_this select 0 lbSetCurSel 4;";
 
idc = -1;
type = 6; // CT_TOOLBOX
style = 2; // ST_CENTER
 
x = 0.25;
y = 0.25;
w = 0.5;
h = 0.1;
 
colorText[] = {0, 1, 0, 1};
colorTextSelect[] = {1, 0, 0, 1};
 
colorBackground[] = {0, 0, 1, 0.3};
colorSelectedBg[] = {0, 0, 0, 0.2};
font = "RobotoCondensed";
sizeEx = 0.04;
onToolBoxSelChanged = "hint str _this";
columns = 3;
rows = 2;
 
strings[] = {"Entry 1","Entry 2","Entry 3","Entry 4","Entry 5","Entry 6"};
checked_strings[] = {"[Entry 1]","[Entry 2]","[Entry 3]","[Entry 4]","[Entry 5]","[Entry 6]"};
tooltips[] = {"Entry 1 tip","Entry 2 tip","Entry 3 tip","Entry 4 tip","Entry 5 tip","Entry 6 tip"};
values[] = {1,2,3,4,5,6};
};</syntaxhighlight>
<br>
{{Informative | The returned option number from the <tt>onToolBoxSelChanged</tt> event handler starts at 0. So if you have 6 toolbox entries, the first is 0 and the last is 5}}
<br>
<code>[[with]] [[uiNamespace]] [[do]]
{
ctrl = [[findDisplay]] 46 [[createDisplay]] "RscDisplayEmpty" [[ctrlCreate]] ["MyRscToolbox", -1];
};</code>
 
'''Script commands for use with ToolBoxes:'''
* [[lbCurSel]] - returns index of selected option
* [[lbSetCurSel]] - sets option selected
* [[lbValue]] - returns value currently set on given option
* [[lbSetValue]] - sets value on given option
* [[lbSetText]] - sets string on given option
* [[lbClear]] - clears all strings from toolbox table
* [[lbAdd]] - adds a string to cleared toolbox table
<br>
{{Informative | When Toolbox style is <tt>ST_PICTURE</tt>, the <tt>strings</tt> property is treated as array of textures, and <tt>checked_strings</tt> property is ignored}}
<br>
* '''Example Config 2:'''
<syntaxhighlight lang=cpp>
class MyRscToolbox
{
onLoad = "_this select 0 lbSetCurSel 4;";
 
idc = -1;
type = 6; // CT_TOOLBOX
style = 2098; // ST_PICTURE + ST_CENTER + ST_KEEP_ASPECT_RATIO
 
x = 0.25;
y = 0.25;
w = 0.5;
h = 0.5;
 
colorText[] = {0, 1, 0, 1};
colorTextSelect[] = {1, 0, 0, 1};
 
colorBackground[] = {0, 0, 1, 0.3};
colorSelectedBg[] = {0, 0, 0, 0.2};
font = "RobotoCondensed";
sizeEx = 0.04;
onToolBoxSelChanged = "hint str _this";
columns = 3;
rows = 2;
 
strings[] = {
"\A3\ui_f\data\map\markers\nato\c_car.paa",
"\A3\ui_f\data\map\markers\nato\c_car.paa",
"\A3\ui_f\data\map\markers\nato\c_car.paa",
"\A3\ui_f\data\map\markers\nato\c_car.paa",
"\A3\ui_f\data\map\markers\nato\c_car.paa",
"\A3\ui_f\data\map\markers\nato\c_car.paa"};
tooltips[] = {"Entry 1 tip","Entry 2 tip","Entry 3 tip","Entry 4 tip","Entry 5 tip","Entry 6 tip"};
values[] = {1,2,3,4,5,6};
};</syntaxhighlight>
[[Category: Dialogs|Toolbox]]

Latest revision as of 06:28, 30 December 2020

Redirect to:

Retrieved from "https://community.bistudio.com/wiki?title=DialogControls-Toolbox&oldid=177348"