Skip to content

Scrollbar

Robert Jelic edited this page May 2, 2022 · 10 revisions

Scrollbars are objects, the user can scroll vertically or horizontally, this can change the value.
Here is a example of how to create a standard scrollbar:

local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aScrollbar = mainFrame:addScrollbar("myFirstScrollbar"):show()

This will create a default label with a size 5 width and 1 height on position 1 1 (relative to its parent frame), the default background is colors.gray, the default text color is colors.black. the default bar type is vertical, the default symbol is " " and the default symbol color is colors.lightGray. The default zIndex is 5.

Here are all possible functions available for scrollbars. Remember scrollbar inherit from object:

setSymbol

Changes the symbol

local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aScrollbar = mainFrame:addScrollbar("myFirstScrollbar"):setSymbol("X"):show()

parameters: char symbol
returns: self

setBackgroundSymbol

Changes the background symbol color

local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aScrollbar = mainFrame:addScrollbar("myFirstScrollbar"):setSymbol("X"):setBackgroundSymbol(colors.green):show()

parameters: number symbolcolor
returns: self

setBarType

If the bar goes vertically or horizontally

local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aScrollbar = mainFrame:addScrollbar("myFirstScrollbar"):setBarType("horizontal"):show()

parameters: string value ("vertical" or "horizontal")
returns: self

setMaxValue

the default max value is always the width (if vertical) or height (if horizontal), if you change the max value the bar will always calculate the value based of his width or height - example: you set the max value to 100, the height is 10 and it is a vertical bar, this means if the bar is on top, the value is 10, if the bar goes one below, it is 20 and so on.

local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aScrollbar = mainFrame:addScrollbar("myFirstScrollbar"):setMaxValue(123):show()

parameters: any number
returns: self

Wiki Navigation

Home
Clone this wiki locally