DialogControls-ControlsGroup

CT_CONTROLS_GROUP Type=15

TokenNames common to most controls, such as x,y,w,h,text,idc... are not listed here.

• The x and y coords of the child control are relative to the parent class, the height and width are not
• If the height and / or width of the child control are greater than the parent control then scrollbars will be seen
  • This allows the creation of scrollable active text controls etc
• The entire child class needs to be defined in the parents subclass class Controls {};

Properties
Name	Type	Remark
VScrollbar	class
HScrollbar	class
ScrollBar	class
Controls	class

class VScrollbar

Properties
Name	Type	Remark
autoScrollSpeed'	integer	typically -1
autoScrollDelay	integer	in seconds
autoScrollRewind'	boolean
color	color array
shadow	integer
width	float

class HScrollbar

Properties
Name	Type	Remark
color	color array
height	float
shadow	integer

class Scrollbar

Properties
Name	Type	Remark
color	color array
colorActive	color array
colorDisabled	color array
thumb	string	path to texture or "#(argb,8,8,3)color(1,1,1,1)";
arrowEmpty/Full	string	path to texture or "#(argb,8,8,3)color(1,1,1,1)";
border	string	path to texture or "#(argb,8,8,3)color(1,1,1,1)";

class Controls

• additional user added controls of any type can be added in a derived class. the base is empty because the engine looks for it regardless.

Example

• In this example, the child control My_RscStructuredText is higher (h value) than the parent control, so a vertical scrollbar is automatically created, which allows scrolling the entire length of the structured text display

• A generalised screw-up occurs in Arrowhead rscControlGroup where color is not specified for V and H scrollbars and shadow should not have been specified. As a result any deriving class a) cannot inherit the existing scrollbar, and b) must repeat the entire thing with the addition of color.

class RscControlsGroup { type = CT_CONTROLS_GROUP; idc = -1; style = ST_MULTI; x = 0; y = 0; w = 1; h = 1; shadow=0; class VScrollbar { width = 0.021; autoScrollSpeed = -1; autoScrollDelay = 5; autoScrollRewind = 0; shadow=0; }; class HScrollbar { height = 0.028; shadow=0; }; class ScrollBar { color[] = {1,1,1,0.6}; colorActive[] = {1,1,1,1}; colorDisabled[] = {1,1,1,0.3}; thumb = "#(argb,8,8,3)color(1,1,1,1)"; arrowEmpty = "#(argb,8,8,3)color(1,1,1,1)"; arrowFull = "#(argb,8,8,3)color(1,1,1,1)"; border = "#(argb,8,8,3)color(1,1,1,1)"; }; class Controls{};// an empty class telling the engine, no custom, additional controls }; class dialog { class controls { class MyControls:RscControlsGroup { x = (safeZoneX + (SafezoneW * 0.0363)); // scalability code which resizes correctly no matter what gui size or screen dimensions is used y = (safeZoneY + (SafezoneH * 0.132)); // scalability code which resizes correctly no matter what gui size or screen dimensions is used w = (SafezoneW * 0.31); // scalability code which resizes correctly no matter what gui size or screen dimensions is used h = (SafezoneH * 0.752); // scalability code which resizes correctly no matter what gui size or screen dimensions is used class Controls { ...class whatever additional controls you want }; }; }; };