HELP
An object that outputs an enumerated value
from a user-defined list.

USE
Use Enum to set an enumerated constant or to
get user input that is chosen from a list of
acceptable choices.  To input an array, press
tab to enter the next value.  The first item
in the list is assigned ordinal position 0;
the nth item in the list is assigned ordinal
position n-1.

LOCATION
Data ==> Enum

OBJECT MENU

* Auto Execute - If set, the object operates
whenever the values in the field are edited.

* Edit Enum Values - Allows you to add valid
selections to the enumerated list of choices
or edit existing choices.

* Format ==> - Specifies the appearance of
the Enum object and the method of selecting a
choice.  Default is List.

  * List - The enumerated choices are
presented in a list box when the button field
is pressed.  The selection is made when the
choice is clicked on.

  * Cyclic - The enumerated choices cycle as
the the button field is clicked on.  This
choice is best used if there are two choices
such as On/Off or Stop/Go or in a dialog box
where the choice is confirmed by another
button.

  * Buttons - The enumerated choices are all
displayed.  The selection is made when the
radio button next to the choice is pressed.

* Initialize - Used to set this object to a
particular value at PreRun and/or Activate
time.

  * Initial Value - A dialog box that
specifies the value to be set.  Default value
is the zero value of that container type.

  * Initialize At PreRun - Whether to set the
Initial Value at PreRun time.  Default is
off.

  * Initialize At Activate - Whether to set
the Initial Value at Activate time.  Default
is off.

NOTES
Initialize is most often used for
initializing values inside UserObject.

The other method for setting an initial
value is the Default Value control pin.  The
Default Value pin allows you to
programmatically change the current value.

Enum containers are automatically
converted into Text for many objects,
including Collector, Concatenator, Sliding
Collector, and most Math objects.

You must add values to each enumerated
field to create a list of valid choices.

EXAMPLE
To use Enum as a prompt on a user panel,
change the name of the Enum object to a
prompt such as "Choose the type of test:".
The user selects an input that depends on the
format of the Enum object.

SEE ALSO
Complex, Constant, Coord, Date/Time, Integer,
Number Formats, PComplex, Real, Text, and
Toggle.
