Creation/Dev/Script/Client/GuiScrollCtrl: Difference between revisions

From Graal Bible
(Added picture, description and an example script)
(→‎Variables: Added some comments to the scrollbar variables)
Line 12: Line 12:
=Variables=
=Variables=


childmargin - string
childmargin - {xmargin,ymargin} - gap between the borders and the child controls


constantthumbheight - boolean
constantthumbheight - boolean
Line 18: Line 18:
hscrollbar - string - "alwaysOn", "alwaysOff", "dynamic" - controls the horizontal scroll bar
hscrollbar - string - "alwaysOn", "alwaysOff", "dynamic" - controls the horizontal scroll bar


scrollpos - string
scrollpos - {x, y}


tile - boolean
tile - boolean - says if the scroll field background should be drawn tiled (otherwise stretched)


vscrollbar - string - "alwaysOn", "alwaysOff", "dynamic" - controls the vertical scroll bar
vscrollbar - string - "alwaysOn", "alwaysOff", "dynamic" - controls the vertical scroll bar


wheelscrolllines - integer
wheelscrolllines - integer - number of lines to scroll when the mouse wheel is turned


willfirstrespond - boolean
willfirstrespond - boolean

Revision as of 11:37, 22 May 2007

Inherits GuiControl.

Description

Guicontrol scroll.png

The scroll control is basicly a container where you can add other controls, and the scroll control is automatically displaying vertical and horizontal scroll bars so that you can reach those child controls. Use the hScrollBar and vScrollBar variables to say which scroll bars should be displayed.

Use globalToLocalCoord() and localToGlobalCoord() described in GuiControl to translate between child position to mouse position and vice versa.


Variables

childmargin - {xmargin,ymargin} - gap between the borders and the child controls

constantthumbheight - boolean

hscrollbar - string - "alwaysOn", "alwaysOff", "dynamic" - controls the horizontal scroll bar

scrollpos - {x, y}

tile - boolean - says if the scroll field background should be drawn tiled (otherwise stretched)

vscrollbar - string - "alwaysOn", "alwaysOff", "dynamic" - controls the vertical scroll bar

wheelscrolllines - integer - number of lines to scroll when the mouse wheel is turned

willfirstrespond - boolean

Functions

scrolldelta(int, int)

scrollto(int, int)


Events

onScrolled(newposx,newposy,deltax,deltay) - either the horizontal or vertical scrollbar has been moved


Example

new GuiScrollCtrl("Test_ScrollField") {
  profile = GuiBlueScrollProfile;
  x = 10;
  y = 10;
  width = 160;
  height = 80;
  hScrollBar = "dynamic";
  vScrollBar = "alwaysOn";
}