NAME

C SPECIFICATION

#include <cx/UI.h>

void cxInWdgtScrollListItemsInsert (char *portname, char *listEntriesString, int index)

FORTRAN SPECIFICATION

subroutine cxInWdgtScrollListItemsInsert (portname, numEntries,
listEntriesString, int index)
character* portname, listEntriesString
integer index

PARAMETERS

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 insert. "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(backslash-n). The last substring should also have a terminating newline.

index

This is the position to start inserting list items into the list.

DESCRIPTION

This is the IRIS Explorer Widget Library call used to insert a series of items to an IRIS Explorer Scrolled List widget. They are inserted starting at the position indicated by the value "index". Items inserted at position 1 will start at the beginning of the list.

Sample call:

cxInWdgtScrollListItemsInsert (

				"Dynamic Scroll List",
				"Line 1\nLine 2\n",
				 1);

would insert new items: "Line 1" and "Line 2", starting at list position 1. The parameter value for the widget is set to be the empty string.

SEE ALSO