DialogControls-Toolbox: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(properties)
m (Text replacement - "#redirect " to "#REDIRECT ")
 
(16 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 buttons, 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]].
 
{| 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 unchecked checkbox text
|-
| '''colorTextSelect'''
| color array
| color of the checked checkbox text
|-
| '''colorBackground'''
| color array
| color of the background when checkbox is not in focus (doesn't matter if checked or not)
|-
| '''colorSelectedBg'''
| color array
| color of the background when checkbox is in focus (doesn't matter if checked or not)
|-
| '''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 checkboxes into
|-
| '''columns'''
| integer
| amount of columns to arrange checkboxes into
|-
| '''strings'''
| string array
| checkboxes texts to display
|-
| '''checked_strings'''
| string array
| checkboxes texts to display when checkboxes are checked
|-
| '''values'''
| float array
| Numerical values associated with items. Can be retrieved or set with [[lbValue]] and [[lbSetValue]]
|-
| '''tooltips'''
| string array
| Tooltips for each checkbox
|-
|}<br clear="all">
 
[[Image:ToolboxControl.jpg|thumb|200px|A Toolbox Control from example code with a hint dialog from UI event handler]]
* '''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>
 
'''Notice:'''
As you see in the example image, the returned entry number from the ''onToolBoxSelChanged'' event handler starts at zero (0)! So if you have 6 toolbox entrys, the first is 0 and the last is 5!
[[Category: Dialogs]]

Latest revision as of 06:28, 30 December 2020

Redirect to: