WsButton | SuperCollider 3.13.0 Help

Instance Methods

.states

An array of labels and colors defining the states of the button.

Arguments:

statesArray

An Array of arrays of the form [ [String, strColor, bgColor] , .... ]

.value

Sets the current state. Does not trigger the action.

Arguments:

val	An integer setting the state number.

.valueAction

Sets the current state and triggers the action.

Arguments:

val	An integer setting the state number.

.action

Gets or sets function to be evaluated when the button is pressed.

Arguments:

function

Any object to set as default action, usually a Function. It is passed the current instance.

.string

Get/set a text content for applicable widgets.

Arguments:

thisString

A string to be set.

Returns:

current string

.align

Change alignment of the text.

Arguments:

align

Can be \left, \right, \center, \justify.

Returns:

Current alignment.

Examples

a = WsWindow.new("new title", 8000, true);//start the window
"http://localhost:8000".openOS; //open in a browser

//button - add to window immediately
i = WsButton.new(a, Rect(0, 0, 0.2, 0.2)); //WsButton imitates SC style multistate button
i.states_([
    ["zero", Color.black, Color.rand],
    ["one", Color.black, Color.rand],
    ["two", Color.black, Color.rand]
]);
i.value_(0);
i.value_(1);
i.item;
i.item_("two"); // not implemented
i.states[i.value][0];
i.font_(Font.new(\Georgia).size_(24));
i.action_({|but| "got state: ".post; but.value.postln; "item: ".post; but.item.postln;}); //passed button object now
i.remove;

//button - add to window later
i = WsButton.init(a, Rect(0, 0, 0.2, 0.2)); //WsButton imitates SC style multistate button
i.states_([
    ["zero", Color.black, Color.rand],
    ["one", Color.black, Color.rand],
    ["two", Color.black, Color.rand]
]);
// now send
i.addToPage;

i.value_(0)
i.value_(1)
i.item
i.item_("two") // not implemented
i.states[i.value][0]
i.font_(Font.new(\Georgia).size_(24))
i.action_({|but| "got state: ".post; but.value.postln; "item: ".post; but.item.postln;}); //passed button object now
i.remove;//remove the button

a.free;//free the window

helpfile source: HelpSource/Classes/WsButton.schelp
link::WsGUI/Classes/WsButton::

wsWindow	An instance of `WsWindow`
bounds	A `Rect` specifying the size of the widget. NOTE: Currently a relative measurement is used: 1 for full window width, 1 for full window height, e.g. `Rect(0, 0, 1, 1)` would occupy whole window.

WsButton
Extension

Description

Class Methods

.new

.init

.init

Arguments:

Returns:

Instance Methods

.states

Arguments:

.value

Arguments:

.valueAction

Arguments:

.item

Returns:

.action

Arguments:

.string

Arguments:

Returns:

.align

Arguments:

Returns:

.font

Arguments:

Returns:

.addToPage

.remove

Examples

WsButtonExtension

Description

Class Methods

.new

.init

.init

Arguments:

Returns:

Instance Methods

.states

Arguments:

.value

Arguments:

.valueAction

Arguments:

.item

Returns:

.action

Arguments:

.string

Arguments:

Returns:

.align

Arguments:

Returns:

.font

Arguments:

Returns:

.addToPage

.remove

Examples

WsButton
Extension