NAME

DsInputValue − Post a value to an input slot

SYNOPSIS

C:

void DsInputValue(slot, value)
DtObject   slot;
DtReal value;

FORTRAN:

CALL DSIV(SLOT, VALUE)
INTEGER∗4   SLOT
REAL∗8 VALUE

DESCRIPTION

DsInputValue posts a floating point value to an input slot organizational object.  An input slot is an entry point for a DtReal <REAL∗8> value and provides the primary interface for connecting input events and values to Dor´
e.

Each input slot has a group of 0 or more valuator callback objects.  A valuator is a callback object that depends upon input slots.  DsInputValue is used primarily to achieve dynamic displays by using these input values to affect object attributes or their geometry.  The input values can be generated by application programs or by asynchronous external events such as dial or mouse movement events. 

When an input value arrives at an input slot, all valuator callback objects dependent upon it are called. 

The parameter slot specifies the input slot to which the DtReal <REAL∗8> in parameter value is to be posted. 

ERRORS

DsInputValue will fail if passed an invalid slot handle. 

[WARNING - invalid slot handle]

SEE ALSO

DoCallback(3D), DoInputSlot(3D), DsInqValuatorGroup(3D), DsUpdateAllViews(3D), DsValuatorSwitch(3D)

September 02, 1992