cxInWdgtChoiceLabelMultiSet - set a range of labels on a choice widget
#include <cx/UI.h>

void cxInWdgtChoiceLabelMultiSet (const char *portname, int minIndex, int cnt, char * const *label)
subroutine cxInWdgtChoiceLabelMultiSet (portname, minindex, cnt, label)
character*(*) portname, label(*)
integer minindex, cnt
This is the name of the input parameter port whose widget is to be relabeled.
This is the start index of the range of labels to be changed.
This is the number of labels to change.
This is the array of labels to be applied to the widget.

This is the IRIS Explorer Widget Library call used to set a range of labels on one of the IRIS Explorer choice widgets. The choice widgets include option menus and radio button boxes. This call may be used to change the label on a single item within a choice widget or to re-label several items at a time.

Individual labels are addressed by indices where the range of valid indices is zero to N-1, where N is the number of entries in the choice widget. Out of range indices are ignored.

In C, the strings provided in the fourth argument must be NULL terminated.

Last modified: Mon Nov 6 16:33:23 GMT 2000
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996