EZSlider:
Filter:
Classes | GUI > EZ-GUI

EZSlider

Wrapper class for label, slider, number box
Location: NOT INSTALLED!

Description

EZSlider is wrapper class which creates an (optional) StaticText, and a Slider plus a NumberBox. If the parent is nil, then EZSlider will create its own window. See EZGui more options.

Scrolling and Arrow Keys

EZSlider's number box scrolls by default, using the step size of the ControlSpec. If the controlSpec's step is set to 0, or is not set, then the stepping and scrolling will be guessed according to the minval and maxval values of the spec on creation of the view. Unlike the step variable of a regular NumberBox, controlSpec.step is also the smallest possible increment for the NumberBox. By default, the shift-key modifier will allow you to step by 100x controlSpec.step, while the ctrl-key will give you 10x controlSpec.step. Since the alt-key would give you 0.1 of the minimum step, it is disabled by default, but you can change that by setting numberView.alt_step to any value you like. Accordingly you can customize the other modifiers to fit your needs. See NumberBox and Slider. This also effects the arrow keys for the slider.

Class Methods

Creation / Class Methods

.new

Arguments:

parent

The parent view or window. If the parent is nil, then EZSlider will create its own Window, and place it conveniently on the screen if the bounds are a Point. If the bounds are a Rect, then the Rect determines the window bounds.

bounds

An instance of Rect or Point. Default value is 160@20.

label

The label. Default value is nil. If nil, then no StaticText is created.

controlSpec

The ControlSpec for scaling the value.

action

A Function called when the value changes. The function is passed the EZSlider instance as its argument.

initVal

The value to initialize the slider and number box with. If nil, then it uses the ControlSpec's default value.

initAction

A Boolean indicating whether the action function should be called when setting the initial value. The default is false.

labelWidth

Number of pixels width for the label. The default is 60.

numberWidth

Number of pixels width for the number box. The default is 45.

unitWidth

Number of pixels width for the unit label. The default is 0. If 0, then no unitLabel is created.

labelHeight

The default is 20;

layout

\vert, \line2, or \horz. The default is \horz.

gap

A Point. By default, the view tries to get its parent's gap, otherwise it defaults to 2@2. Setting it overrides these.

margin

A Point. This will inset the bounds occupied by the subviews of view.

Discussion:

The contained views can be accessed via the EZSlider instance variables: labelView, sliderView, numberView.

Inherited class methods

Instance Methods

Accessing Instance and Class Variables

.numberView

Returns the numberView.

.action

A Function or FunctionList to be evaluated when the value changes. The first argument will be the EZSlider.

.value

The value of the slider.

.round

Rounds the values in the number box.

.controlSpec

An instance of ControlSpec for scaling the values.

.value

Gets/sets the list/menu to the index at value. Does not perform the action.

Arguments:

val

An Integer.

.valueAction

Sets the value and performs the action at the index value and the global action.

Arguments:

val

An Integer.

.doAction

Performs the action at the current index and the global action.

.set

Set the args after creation. You can only set the label if it was not nil from the beginning.

.visible

Sets/gets it the component views are visible.

Arguments:

bool

An instance of Boolean. Default is true.

Changing Appearance

.setColors

Arguments:

stringBackground

An instance of Color. The background of the label and unit views.

stringColor

An instance of Color. The stringColor of the label and unit views.

sliderBackground

An instance of Color. The slider background.

numBackground

An instance of Color. The numColor of the number view.

numStringColor

An instance of Color. The stringColor of the number view.

numNormalColor

An instance of Color. The normalColor of the number view.

numTypingColor

An instance of Color. The typingColor of the number view.

knobColor

An instance of Color. The knobColor of the knob view.

background

An instance of Color. The background of the enclosing view.

.font

Set the Font used by all the views.

Arguments:

font

An instance of Font.

Inherited instance methods

Examples