NAME

cxInWdgtStrSet - set the value of a string input parameter and widget
#include <cx/UI.h>

void cxInWdgtStrSet (const char *portname, const char * str)
subroutine cxInWdgtStrSet (portname, str)
character*(*) portname, str
portname
Name of the parameter port whose widget is being altered.
str
String value assigned to port.
cxInWdgtStrSet is an IRIS Explorer Widget Library call used within modules to set the value of a parameter and its associated widget from a string.

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

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

The second argument to cxInWdgtStrSet is a string which, in C, must be NULL terminated.

This call is primarily used to set the value of text widgets and file browsers. The call may be used to set the value of numeric widgets, but the string passed in as the second argument must be convertible to a long or double precision number by the C library call scanf.

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 6 16:33:25 GMT 2000
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996