multicolor_popup_menu_c

	status.i4.v = multicolor_popup_menu_c(top_row.i4.v, left_column.i4.v,
					      num_lines.i4.v, text.sa.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.sa.r, options.u4.v)

	This routine will display a scrollable popup menu on the TV screen.
	The text for this menu is in the form of XCHAR format strings
	which allows the individual entries to be comprised of any combination
	of colors.  The routine will return the number of the item selected
	or a value of zero if no item was selected.  If the passed item value
	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.

	top_row		top row of menu (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	left_column	left column of menu (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	num_lines	number of entries to display
	text		menu entry text (array of XCHAR structures)
			(entry length x number of items array)
	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 XCHAR format
			 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)
	enabl_entries	array of logical flags indicating which menu entries
			are enabled/active (Passing a value of NULL will result
			in all menu entries being enabled.)
			(MENU_ENABLED_ENTRY -> enabled entry,
			 MENU_DISABLED_ENTRY -> disabled entry,
			 MENU_SEPARATOR -> separator entry)
	help_info	entry by entry help callback information
			(array of HELP_CALLBACK_DATA structures)
			(If no help is to be provided, a value of NULL
			 may be passed.)
	header_line	null terminated XCHAR format string that will be
			displayed in a nonscrolling banner at the top of
			the window  (If a value of NULL is passed, no banner
			will be displayed.)
	options		optional menu feature flags
			(MENU_OPT_NONE -> no special menu options requested,
			 MENU_OPT_FIT_WINDOW -> resize the background window
						if necessary to fit the menu,
			 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)

	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:

	scroll_menu(_c), scroll_menu_hs_c, combo_menu_c, combo_menu_hs_c,
	logical_scroll_menu(_c), logical_combo_menu_c, popup_menu(_c),
	menu_create(_c), menu_setup_c, build_menu_text, window_restore_hint_c

	C/C++ usage:

	static const char	title[] = "Title";
	char	*enabled_entries = (char *) NULL;
	int	status;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	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;
	static const XCHAR	text[NUM_ENTRIES][NUM_CHARS];
	XCHAR	*header_line = (char *) NULL;
	HELP_CALLBACK_DATA	*help_info = (HELP_CALLBACK_DATA *) NULL;

	status = multicolor_popup_menu_c(top_row,left_column,num_lines,text,
					 num_chars,num_entries,title,&item,
					 padding_chars,enabled_entries,
					 help_info,header_line,options);