HELP
An object that may contain other objects.

USE
Use UserObject to logically and physically
group objects together.  A UserObject
constitutes a separate "context" from the
root context of a model.  You can use
multiple UserObjects, or nested UserObjects
within a model.

To create the desired UserObject, you can
move other objects into the work area of the
open view of the UserObject, or you can
select objects and use Create UserObject from
the Edit menu.

The Make UserFunction item in the object
menu allows you to make the UserObject into a
User Function, which can then be called using
the Call Function object, or from certain
expressions.

Operation:

A UserObject operates just like any other
object -- no objects inside of a UserObject
operate until all data inputs to the
UserObject are activated.  All operations
inside of the UserObject must be completed
before the data outputs are activated.

The right-most button on the title bar of
the open view is a maximize button -- it
increases the size of the UserObject to the
full size of the HP VEE work area.

When objects inside the UserObject are
connected to objects outside the UserObject,
input and output pins are automatically
created.

Creating a User Function:

Once you have created a UserObject, you
can use Make UserFunction (see "Object Menu,"
below) to create a User Function with the
same functionality.  The UserObject will
disappear from the screen and will be
replaced with a Call Function object
containing a call to the new User Function.
The User Function will be added to the list
of available User Functions, which exists in
the "background" within the model.  You can
call the User Function using the Call
Function object, or from certain expressions.
You can edit the User Function by using Edit
UserFunction in the Edit menu.

LOCATION
Device ==> UserObject

OBJECT MENU
You can select the object menu of the
UserObject from the object menu button, but
you cannot select it from within the work
area of the UserObject open view.  From
within the work area, the right mouse button
provides a pop-up Edit menu, just like the
one available in the main work area.  When
the pointer is over an object within the
UserObject, the right mouse button gives the
object menu for that object.  You can also
get UserObject object menu by placing the
pointer over the borders of the UserObject
and clicking the right mouse button.

* Make UserFunction - Converts the UserObject
into a User Function.  The UserObject will
disappear from the work area and it is
replaced with a Call Function object
containing a call to the new User Function.
Before you do this operation, enter a unique
name into the title field.  This name will
become the User Function name, which will be
the name by which Call Function or certain
expressions can call the User Function.
Should the name conflict with the name of an
existing User Function, an error will be
displayed.  You will then need to enter a
different name and repeat the operation.

* Unpack - Deletes the UserObject, but not
the objects contained in it.

* Secure - Prevents the UserObject from being
modified.

* Show Panel on Exec - When set, shows the
panel view associated with the UserObject
when the UserObject operates.  This is only
available after the UserObject panel view has
been created (by way of Add To Panel).

* Trig Mode ==> - Specifies the trig mode
used in the UserObject context (degrees,
radians, or gradians).

* Edit ==> - A parent menu that leads to the
UserObject context Edit menu.  This menu
contains the same choices as the main menu
Edit menu.  You can get the pop-up Edit menu
by clicking the right mouse button on the
UserObject work area.

The following choices are context
sensitive to the UserObject:

  * Clean Up Lines - Routes the lines in the
UserObject around objects.

  * Move Objects - Moves several objects at
  once.

  * Create UserObject - Creates a UserObject
of the currently selected objects.

  * Add To Panel - Creates a panel view (for
the UserObject) containing the selected
objects.

NOTES
To create a UserObject of the currently
selected objects, use Create UserObject.

It is convenient to save UserObjects of
common functions (using Save Objects) to
create a library of functions to be used
again.

You can create a library of User Functions
by creating several UserObjects, turning them
into User Functions, and then saving them all
to a file.  This library then can be imported
into a model using Import Library, and
deleted with Delete Library.

UserObject allows the addition of XEQ
inputs.

If the XEQ input is activated, UserObject
operates even if all its data input elements
are not satisfied.

When a breakpoint is set on an object in a
UserObject that is displayed as an icon view
and Show Panel on Exec is off, Step ignores
the breakpoint.

SEE ALSO
Add To Panel, Call Function, Create
UserObject, Delete Library, Direct I/O, Edit
UserFunction, Formula, If/Then/Else, Import
Library, Secure, Sequencer, and User
Function.
