wn_scroll_menu_c

	status.i4.v = wn_scroll_menu_c(x.r8.v, y.r8.v, coordinate_type.i4.v,
				       num_lines.i4.v, text.i1a.r,
				       num_chars.i4.v, num_entries.i4.v,
				       title.i1a.r, item.i4.r
				       [,padding_chars.i4.v]
				       [,enabl_entries.i1a.r] [,help_info.sa.r]
				       [,header_line.i1a.r] [,options.u4.v])

	This routine will display a scrollable popup menu having
	its upper left hand corner at ("top_row", "left_column").
	The window will display "num_lines" of "text" which are each
	"num_chars" characters long.  The "text" buffer will have a total
	length of "num_entries" lines.  "item" is the returned user selected
	item from the menu.  If the passed value of "item" is equal to
	the entry number of one of the menu entries, a ">" character will
	be displayed on that line of the menu indicating the initial value.

	x		x location of the upper left hand corner of the
			window relative to the parent graphic window
	y		y location of the upper left hand corner of the
			window relative to the parent graphic window
	coordinate_type	type of coordinate values passed
			(WN_WORLD_COORDS -> normal window world coordinates,
			 WN_PIXEL_COORDS -> raw pixel coordinates)
	num_lines	number of entries to display
	text		menu entry text
	num_chars	length of a menu entry
			(If a value of zero is passed for this argument,
			 the routine will assume that all of the menu text is
			 contained in a single null terminated or descriptor
			 described string and will automatically determine the
			 length of a single menu item by dividing the total
			 string length by the number of items.)
	num_entries	number of menu entries
	title		null terminated window title
	item		returned item (starts at 1)
			(If the value passed for this argument has a value
			 between 1 and "num_entries", this will be marked
			 as the default entry indicated by a ">" character.
			 Also, the menu will be scrolled such that that
			 entry is at the top of the menu.)
	[padding_chars]	number of blank characters to insert before and
			after every menu entry (must be >= 1) (default is 1)
	[enabl_entries]	array of logical flags indicating which menu entries
			are enabled/active (default is NULL which enables
			all menu entries)
			(MENU_ENABLED_ENTRY -> enabled entry (default),
			 MENU_DISABLED_ENTRY -> disabled entry,
			 MENU_SEPARATOR -> separator entry)
	[help_info]	entry by entry help callback information
			(array of HELP_CALLBACK_DATA structures)
			(default is NULL)
	[header_line]	null terminated text string that will be displayed
			in a nonscrolling banner at the top of the window
			(default is NULL)
	[options]	optional menu feature flags
			(MENU_OPT_NONE -> no special menu options requested
					  (default),
			 MENU_OPT_SIZE_TO_TITLE -> resize the menu if
						   necessary to fit the
						   title and banner lines,
			 MENU_OPT_HEADER_SEPARATOR -> insert a separator line
						      between the header line
						      and the menu entries,
			 MENU_OPT_CENTER_DEFAULT -> attempt to center the
						    default selection int
						    the window,
			 MENU_OPT_TRUNCATE_BLANKS -> truncate trailing blanks)

	This function returns status values as follows:

	CBS_INVARG		invalid number of menu entries or
				padding characters
	CBS_MEMFAIL		dynamic memory allocation failure
	CBS_WINDOW_TOO_BIG	menu won't fit on screen
	TRUE			user made a valid menu selection
	FALSE			user interrupted outside of menu

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, cbslib_h, macro_h, acnet_errors_h

	Related functions:

	wn_scroll_menu_hs_c, wn_combo_menu_c, wn_combo_menu_hs_c,
	scroll_menu(_c), scroll_menu_hs_c, combo_menu_c, combo_menu_hs_c,
	logical_scroll_menu(_c), logical_combo_menu_c, wmenu(_c),
	popup_menu(_c), menu_create(_c), menu_setup_c, build_menu_text,
	menu_assert_choice_c, menu_is_open, window_restore_hint_c

	C/C++ usage:

	static const char	text[NUM_ENTRIES][NUM_CHARS] =
	{"Entry 1", "Entry 2", "Entry 3", "Entry 4", "Entry 5", "Entry 6"};
	static const char	title[] = "Title";
	char	*enabled_entries = (char *) NULL;
	char	*header_line = (char *) NULL;
	int	status;
	int	coordinate_type = WN_PIXEL_COORDS;
	int	num_lines = 4;
	int	num_chars = NUM_CHARS;
	int	num_entries = NUM_ENTRIES;
	int	item = 0;
	int	padding_chars = 1;
	unsigned int	options = MENU_OPT_NONE;
	double	x = 0;
	double	y = 0;
	HELP_CALLBACK_DATA	*help_info = (HELP_CALLBACK_DATA *) NULL;

	status = wn_scroll_menu_c(x,y,coordinate_type,num_lines,(char *) text,
				  num_chars,num_entries,title,&item,
				  padding_chars,enabled_entries,help_info,
				  header_line,options);