DialogControls-Toolbox

CT_TOOLBOX Type=6

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).

Properties
Name	Type	Remark
color	color array	Color of the selection box when this the control isn't active.
colorTextSelect	color array	Color of the text when selected.
colorSelect	color array	Color of the selection box.
colorTextDisable	color array	Color of control text when the control is disabled.
colorDisable	color array	Color of the selection box when the control is disabled.
rows	integer	Amount of rows to display
columns	integer	Amount of columns to display
colorSelectedBg	color array	The color of the background when selected.
strings	string array	Text for each toolbox entry
values	float array	Currently serve no purpose. Believed to be associated with each option, however there is no way of retrieving them.

A Toolbox Control from example code with a hint dialog from UI event handler

• Example:

class MyRscToolbox 
{
  idc = 200;
  type = CT_TOOLBOX;  //defined constant (6)
  style = ST_LEFT; //defined constant (0)

  x = 0.1;
  y = 0.2;
  w = 0.2;
  h = 0.15;
  
  colorText[] = {1, 1, 1, 1};
  color[] = {0, 0, 0, 1};    // seems nothing to change, but define it to avoid error!
  colorTextSelect[] = {1, 0, 0, 1};
  colorSelect[] = {0, 0, 1, 1};
  colorTextDisable[] = {0.4, 0.4, 0.4, 1};
  colorDisable[] = {0.4, 0.4, 0.4, 1};
	
  font = "Zeppelin32";
  sizeEx = 0.0208333;
	
  rows = 3;
  columns = 2;
  strings[] = {"Entry 1","Entry 2","Entry 3","Entry 4","Entry 5","Entry 6"};
  values[] = {1,1,0,1,0,0};

  // Only a simple user interface event handler to show some response	
  onToolBoxSelChanged = "hint format[""Toolbox change:\n%1\nEntry#:%2"",(_this select 0),(_this select 1)];"
};

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!