Scrollbox¶

structure ScrollBox¶

ScrollBox objects are created by using BOX:ADDSCROLLBOX.

A scollbox is a box who’s contents can be bigger than it is, accessable via scrollbars.

To constrain the actual size of the box, you can use the :style suffix of the box. For example, this code:

set sb to mygui:addscrollbox().
set sb:style:width to 200.
set sb:style:height to 200.

would make a scrollbox whose visible part is limited to 200 pixels by 200 pixels.

By default, the GUI layout manager would attempt to make the scrollbox as big as it can, within the constraints of the containing window.

Suffix	Type	Description
Every suffix of `BOX`.
`HALWAYS`	`Boolean`	Always show the horizontal scrollbar.
`VALWAYS`	`Boolean`	Always show the vertical scrollbar.
`POSITION`	`Vector`	The position of the scrolled content (Z is ignored).

ScrollBox:HALWAYS¶

Type: Boolean
Access: Get/Set

Set to true if you want the horizontal scrollbar to always appear for the box regardless of whether the contents are large enough to require it.

ScrollBox:VALWAYS¶

Type: Boolean
Access: Get/Set

Set to true if you want the vertical scrollbar to always appear for the box regardless of whether the contents are large enough to require it.

ScrollBox:POSITION¶

Type: Vector
Access: Get/Set

This value tells you where within the window’s content the currently visible portion is. The Vector’s X component tells you the X coordinate of the upper-left corner of the visible portion within the content. The Vector’s Y component tells you the Y coordinate of the upper-left corner of the visible portion within the content. The Vector’s Z component is irrelevant and ignored. (This is really an X/Y pair stored inside a 3D vector).

You can set this value to force the window to scroll to a new position.