Button Class Reference

stateless transient button. More...

Inheritance diagram for Button:

Public Member Functions
	Button (string name)
	creates a push button widget on the user interface.
void	push (bool callChangedCallback)
	push the button!

Public Attributes
string	normalImage
	image path for normal buttonState
string	pressedImage
	image path for pressed buttonState
string	overImage
	image path for over buttonState
string	backgroundColourOff
	background colour Off: colour string that defines the desired colour.
string	textColourOff
	textColour Off: colour string that defines the desired colour.
string	backgroundColourOn
	background colour On: colour string that defines the desired colour.
string	textColourOn
	textColour On: colour string that defines the
bool	triggeredOnMouseDown
	Sets whether the button click should happen when the mouse is pressed or released.
string	dragAndDropFilepath
	file path that should be used for drag and drop
number	fontSize
	font size
string	font
	path to TrueType font
Public Attributes inherited from ParamWidget
Mapper::Type	mapper
	Mapper type, default is Mapper.Linear.
Unit::Type	unit
	Unit type, default is Unit.Generic.
Public Attributes inherited from Widget
string	name
	widget name
string	displayName
	widget display name
string	tooltip
	widget tooltip, default is name
int	x
	x position in pixels
int	y
	y position in pixels
int	width
	widget width in pixels
int	height
	widget height in pixels
table	size
	widget size {width, height}
table	position
	widget position {x,y}
table	bounds
	widget bounding rect {x,y,width,height}
number	alpha
	transparency value between 0.0 and 1.0
bool	enabled
	boolean flag to enable / disable the widget
bool	visible
	boolean flag to toggle widget visibility
bool	interceptsMouseClicks
	boolean flag to toggle mouse handling on widget
bool	showLabel
	show widgets label if any
bool	persistent
	flag to tell if the widget values should be serialized when saving.
function	changed
	callback function used by child widgets to be notified of changes

Detailed Description

stateless transient button.

creates a push button widget on the user interface. Image properties support Retina @2x variants.

b = Button("button")
b.backgroundColourOff = "darkgrey"
b.backgroundColourOn = "darkred"
b.textColourOff = "white"
b.textColourOn = "white"
b.changed = function(self, mods)
print("button clicked:", mods.altDown)
end

Constructor & Destructor Documentation

Button()

Button::Button

(

string

name

)

creates a push button widget on the user interface.

Parameters

name	the name to give to the widget

Member Function Documentation

push()

void Button::push

(

bool

callChangedCallback

)

push the button!

Parameters

callChangedCallback

trigger the button changed callback if true

Member Data Documentation

backgroundColourOff

string Button::backgroundColourOff

background colour Off: colour string that defines the desired colour.

It can be either a named colour like "blue" or "red" or an hexadecimal string in RGB ("#FF00CC") or ARGB ("#3C00FECD") format

backgroundColourOn

string Button::backgroundColourOn

background colour On: colour string that defines the desired colour.

It can be either a named colour like "blue" or "red" or an hexadecimal string in RGB ("#FF00CC") or ARGB ("#3C00FECD") format

textColourOff

string Button::textColourOff

textColour Off: colour string that defines the desired colour.

It can be either a named colour like "blue" or "red" or an hexadecimal string in RGB ("#FF00CC") or ARGB ("#3C00FECD") format

textColourOn

string Button::textColourOn

textColour On: colour string that defines the

desired colour. It can be either a named colour like "blue" or "red" or an hexadecimal string in RGB ("#FF00CC") or ARGB ("#3C00FECD") format

triggeredOnMouseDown

bool Button::triggeredOnMouseDown

Sets whether the button click should happen when the mouse is pressed or released.

By default the button is only considered to have been clicked when the mouse is released