NAME

cxInWdgtScrollListItemsSel - select a series of items in an list widget
#include <cx/UI.h>

void cxInWdgtScrollListItemsSel (char *portname, char *listEntriesString)
subroutine cxInWdgtScrollListItemsSel (portname, listEntriesString)
character* portname, listEntriesString
portname
This is the name of the input parameter port whose widget is to get new items
listEntriesString
This is a string of newline terminated substrings that make up the list of items to be selected. "listEntriesString" should be a single null-terminated string composed of substrings representing each selected item in order. These substrings should be separated by newline characters ('\n'). The last substring should also have a terminating newline.

This is the IRIS Explorer Widget Library call used to select a series of items in an IRIS Explorer Scrolled List widget. "listEntriesString" should be a single null-terminated string composed of substrings representing each selected item in order. The widget parameter value will change to a string of newline separated list item substrings.

Sample call:

  cxInWdgtScrollListItemsSel
        (
        "Line List",
        "Line 1\nLine 3\n"
        );

This function call would select list items "Line 1" and "Line 3", if and only if those items are in the list. If only a subset of those items are in the list, the items in the subset are selected. (assuming multiple or extended selection was enabled for the widget). If single or browse selection is enabled, the first list item in the selection list is selected.

cxInWdgtScrollListItemsDelete(3E), cxInWdgtScrollListItemsInsert(3E), cxInWdgtScrollListItemsSelSet(3E), cxInWdgtScrollListItemsSet(3E)
Last modified: Mon Nov 6 16:33:25 GMT 2000
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996

Website Feedback

If you would like a response from NAG please provide your e-mail address below.

(If you're a human, don't change the following field)
Your first name.
CAPTCHA
This question is for testing whether you are a human visitor and to prevent automated spam submissions.
Image CAPTCHA
Enter the characters shown in the image.