UIvaluator

Synopsis

base class for all objects that accept numeric input

UIprimitive UIvaluator {
       float &min;
       float &max;
       float+Port2 &value;
       enum mode= {integer, real};
       int &decimalPoints;
       Boolean &immediateMode;
       Boolean &includeMin<NEvisible=0> = 1;
       Boolean &includeMax<NEvisible=0> = 1;
  };

Description

UIvaluator is the base class for all widget objects that accept numeric input. This includes the supplied UIslider, UIdial, and UIfield. It defines subobjects and behavior that are common to all valuator-type widgets.

A valuator provides an interface to a numerical value. The value may be integer or real. It is possible to restrict the values produced by a valuator. Values can be restricted to be > a value, >= another value, < a value, <= a value, or unbounded.

The precision produced by a valuator is determined by the number of decimal places that are requested by setting the decimalPoints attribute.

Subobjects

message

UIprimitive class attribute.

x; y;

width;

height;

UIgeom class attributes.

* parent;

grouptoParent;

&cursor;

events <Not visible in Network Editor>;

UIwindow class attributes

shellParent <Not visible in Network Editor>;

canHaveChildren <Not visible in Network Editor> =0

UIconnection class attributes inherited from UIwindow.

&visible=0;

&active;

pixmap;

color;

fontAttribute;

fontlist <No longer used. Not visible in Network Editor>;

cxxhandle <Internal Object. Not visible in Network Editor>;

handle <Internal Object. Not visible in Network Editor>;

window_resources <No longer used. Not visible in Network Editor>;

motif_resources <No longer used. Not visible in Network Editor>;

layout <No longer used. Not visible in Network Editor>

Attributes inherited from UIcore class through UIwindow.

&min;

&max

Floats. References that specify the minimum and maximum bounds (range) of the valuator widget. If &min or &max is not set, that value is unbounded.

For UIsliders, the default min/max is 0 and 100.

For UIfields and UIdials, the default is unbounded.

&value

Float. Port2. A reference that specifies the current value of the valuator widget.

mode

Enumerator. Specifies whether the values of value, &min, and &max are to be reals, or converted to integers. 1=integer; 2=real.

&decimalPoints

Integer. If mode=2 (real), specifies the number of decimal places of precision to the right of the decimal point.

&immediateMode

Boolean. Flag that changes whether some valuators produce values continuously as the mouse is moved, or only when it is released. 1=continuous feedback; 0=generate value only when the mouse button is released. The default is 0.

&includeMin <Not visible in Network Editor>;

&includeMax <Not visible in Network Editor>

Booleans. Flags that specify whether to include labels that show the min/max values on the widget. 1=include; 0=don't include. The default is 0.

Not yet implemented.

&includeMin <Not visible in Network Editor>;

&includeMax <Not visible in Network Editor>

Booleans. Flags that specify whether to include labels that show the min/max values on the widget. 1=include; 0=don't include. The default is 0.

Not yet implemented.

Example

See specific valuators.

File

v/UI.v

See Also Related Modules

UIdial

UIdynamic_toggle

UIslider