EZGui an abstract superclass for EZ widget wrappers
Inherits from: Object
Users will not normally directly create instances of EZGui, but only use it through its subclasses. It provides the basic mechanisms for various EZ widget wrappers. It also provides a standard for EZ GUI Classes, and new EZ Classes should subclass EZGUI to help keep a consistent user interface .
See also: EZListView, EZPopUpMenu, EZSlider, EZNumber, EZRanger, EZKnob
Accessing Instance and Class Variables
view
Returns the enclosing CompositeView.
bounds
Returns the bounds of the enclosing CompositeView.
label
label_(string)
Sets/gets it the label. Will add the label view if none was initially created.
string - An Instance of String.
window
Returns the window if you used the popUp window function.
Accessing GUI options
alwaysOnTop_(bool)
alwaysOnTop
Makes the popup window always on top, if there is one
bool - An Instance of Boolean. Default is false;
visible
visible_(bool)
Sets/gets it the component views are visible.
bool - An Instance of Boolean. Default is true;
enabled
enabled_(bool)
Sets/gets if the list is enabled.
bool - An Instance of Boolean. Default is true;
onClose
onClose_(func)
Sets/gets the onClose function of either view or window, depending on whether the EZ view used a popup window.
func - An Instance of Function or FunctionList.
font_(font)
font - An Instance of Font;
Subclassing
EZGui provides a standard and basic tools for most EZ classes. If you make a new EZ class, then subclass EZGui, and override the necessary methods. If your class only has a label and a widget, chances are, you need to overide nothing, but only need to write the new and init class methods. See existing subclasses of EZGui for examples of this. You may also want to override the following:
widget
returns the active widget.
subclasses will typically refer to it or ignor it, e.g.:
MyEZClass{
myOtherMethods{}
....
listView{^widget}
}
action
action_(func)
Gets/sets the action of the EZclass instance.
fund - An Instance of Function or FunctionList.
value
value_ (val)
Gets/sets the value of the widget. Does not perform the action.
val - An integer.
valueAction_ (val)
Gets/sets thevalue of the widget. Performs do action
val - An integer.
doAction
Performs this.action.value(this) .
Internal Utilities
prSubViewBounds(rect, hasLabel)
This calculates the bounds of the subviews and the gaps. It returns an array of Rects, which depends on how many subview there are. Subclasses override this if they have more than one widget.
prMakeView(parentView,bounds);
Called by init . Returns s [view,bounds]. The container is either the enclosing Container, or a popUpWindow with a container.
prSetViewParams
Only defined by some subclassses. Sets the resize and align of all the views, according to the state of layout
prMakeMarginGap(parentView, argMargin, argGap)
Called in the init method of all subclasses. Sets the margin and gap of view. By default, it tries to get its parent's gap, otherwise it defaults to 2@2. Setting argGap overrides these.