DialogControls-Toolbox: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Text replacement - "#redirect " to "#REDIRECT ")
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==CT_TOOLBOX Type=6==
#REDIRECT [[CT_TOOLBOX]]
 
'''TokenNames common to most controls, such as x,y,w,h,text,idc... are not listed 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>
{| 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:'''
<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 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]]

Latest revision as of 06:28, 30 December 2020

Redirect to:

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