DialogControls-Sliders

From Bohemia Interactive Community
Jump to navigation Jump to search

Template:SideTOC

General

TokenNames common to most controls, such as x, y, w, h, text, idc... are not listed here.
  • 'Sliders' and 'ScrollBars' are synonymous.
  • Default scrollbars are vertical. Use ST_HORZ to change orientation.
  • Embedded child scrollbars are created by the engine as and when required for various control types. (CT_LISTBOX e.g.). The engine generates it's own idc for them. In most cases you can alter characteristics of that auto-generated scrollbar via class ScrollBar
It makes no sense to create 'independent' scrollbars without an idc.

CT_SLIDER=3 (deprecated)

Properties
Name Type Remark
coloractive color array color of the arrows.
Title/Value classes Optional and probably script only related


CT_XSLIDER=43 or Embedded Scrollbar Class

Embedded scrollbar classes (such as those in listboxes e.g.) use the xbox properties as per a CT_XSLIDER

Properties
Name Type Remark
arrowEmpty textures Texture shown when the left or right arrow is not pressed
arrowFull textures Texture shown when the left or right arrow is pressed
border texture
colorActive color color of the arrows.
colorDisabled color
thumb texture Texture of the part that can be dragged
vspacing float


Title or Value class

Properties
Name Type Remark
idc integer
colorBase color array
colorActive color array


A Slider Control
  • Example Config:
class MySlider 
{
  idc = -1; 
  type = CT_SLIDER; 
  style = SL_HORZ; 
  x = 0.4; 
  y = 0.2; 
  w = 0.3; 
  h = 0.025; 
  color[] = { 1, 1, 1, 1 }; 
  coloractive[] = { 1, 0, 0, 0.5 };
  // This is an ctrlEventHandler to show you some response if you move the sliderpointer.
  onSliderPosChanged = "hint format[""%1"",_this];";
  sliderPosition = 500;//Initial position when slider is created
  sliderRange[] = {50,2000};//Min and max value of the slider
  sliderStep = 1;//Size of step when dragging
};

Helpful Script Commands

sliderPosition, sliderRange, sliderSetPosition, sliderSetRange, sliderSetSpeed, sliderSpeed