NAME

cxInWdgtDblSet - set the value of a double precision input parameter and widget

C SPECIFICATION

#include <cx/UI.h>

void cxInWdgtDblSet (char *portname, double val)

FORTRAN SPECIFICATION

subroutine cxInWdgtDblSet (portname, val)
character*(*) portname
double precision val

PARAMETERS

portname
Name of the parameter port whose widget is being altered.
val
Double precision value assigned to port.

DESCRIPTION

cxInWdgtDblSet is an IRIS Explorer Widget Library call used within modules to set the value of a parameter and its associated widget from a double.

An IRIS Explorer parameter data structure and widget are always associated with an input port of type parameter.

cxInWdgtDblSet alters the state of the parameter-widget pair associated with the input parameter port named in the first argument.

The second argument to cxInWdgtDblSet is the double precision value assigned to which the parameter-widget pair are set.

This call is used to set the value of sliders, dials, text slots, radio buttons and toggle buttons. For text slots the value is converted to a string before display. Dials and sliders clamp their input values to their min/max range prior to updating the widget. Option menus, radio boxes and toggle buttons clamp the value to the number of options.

Within the calling module, the parameter value associated with the port is changed immediately (synchronously with the call). The parameter value is transmitted to the IRIS Explorer Map Editor where it causes the module's widget to be changed. Widgets wired to the widget being changed will also have their values adjusted.


Last modified: Mon Nov 18 13:49:43 GMT 1996
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996