multicolor_menu_create_c

	status.i4.v = multicolor_menu_create_c(top_row.i4.v, left_column.i4.v,
					       num_items.i4.v, num_chars.i4.v,
					       item_text.sa.r, title.i1a.r,
					       num_columns.i4.v, menu_id.i2.r,
					       funcs.fa.r, func_data.ga.r,
					       auto_update.i4.v,
					       num_lines.i4.v,
					       enabled_entries.i1a.r,
					       help_info.sa.r,
					       header_line.sa.r,
					       padding_chars.i4.v, options.u4.v)

	This routine will create a fixed menu on the TV screen using XCHAR
	format strings.  This differs from multicolor_popup_menu_c in that
	the menu remains active until it is removed by calling
	menu_delete(_c).  (Note: If hierarchical menus are to be created,
	window_freeze_c should be called following this call.  The window
	ID argument passed to the freeze routine should be "menu_id".)

	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_items	number of menu items
	num_chars	number of characters in a menu item
			(If a value of zero is passed for this argument,
			the routine will automatically determine the
			length of a menu item.)
	item_text	menu item text ("num_chars" characters per entry)
			(array of XCHAR structures)
	title		null-terminated text string (ie. a quoted literal)
			to be written to the top line of the window. It
			may be no longer than:
			(("num_chars" + "padding_chars" + 1) *
			 "num_columns" - 3) characters.
	num_columns	number of menu columns
	menu_id		menu ID
	funcs		pointers to functions to be called by the menu
			(called as follows:
			 funcs(mid.i2.v, func_data.g.v, menu_data.s.r)
			 ("menu_data" is a structure of type
			  MENU_INTERRUPT_DATA))
			(A value of NULL can be passed for this argument
			 if no functions are supplied.)
	func_data	pointers to data to be passed to "funcs"
			(A value of NULL can be passed for this argument
			 if no function data is supplied.)
	auto_update	flag to determine whether to automatically update
			(TRUE -> automatically update this menu,
			 FALSE -> update by calls to menu_update_c)
	num_lines	number of menu lines to display
	enabled_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
			 can 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.)
	padding_chars	number of blank characters to insert before and
			after every menu entry (must be >= 1)
	options		optional menu feature flags
			(MENU_OPT_NONE -> no special menu options requested,
			 MENU_OPT_HEADER_SEPARATOR -> insert a separator line
						      between the header line
						      and the menu entries,
			 MENU_OPT_SAME_FUNCTION -> use the same function and
						   function data for all
						   menu entries)

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid number of items passed
	CBS_TOO_MANY		there are too many menus to create another
	CBS_MEMFAIL		error in allocating dynamic memory
	CBS_WINDOW_TOO_BIG	window is too big to fit on the screen

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, cbslib_h, acnet_errors_h

	Related functions:

	multicolor_menu_change_entry_c, menu_create(_c),
	multicolor_popup_menu_c, menu_update(_c), menu_delete(_c),
	menu_topmost, menu_change_entry_c, menu_change_entry_case_c,
	menu_set_current_entry_c, window_freeze_c, wmenu(_c),
	popup_menu(_c), scroll_menu(_c), logical_scroll_menu(_c),
	menu_setup_c

	C/C++ usage:

	static const char	title[] = "Title";
	char	*enabled_entries = (char *) NULL;
	short	menu_id;
	int	status;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	int	num_items = NUM_ITEMS;
	int	num_chars = NUM_CHARS;
	int	num_columns = 1;
	int	auto_update = TRUE;
	int	num_lines = 4;
	int	padding_chars = 1;
	void	**func_data = (void **) NULL;
	menu_function	funcs[NUM_ITEMS];
	unsigned int	options = MENU_OPT_NONE;
	static const XCHAR	item_text[NUM_ITEMS][NUM_CHARS];
	XCHAR	*header_line = (char *) NULL;
	HELP_CALLBACK_DATA	*help_info = (HELP_CALLBACK_DATA *) NULL;

	funcs[0] = function_0;
		.
		.
		.
	status = multicolor_menu_create_c(top_row,left_column,num_items,
					  num_chars,item_text,title,num_columns,
					  &menu_id,funcs,func_data,auto_update,
					  num_lines,enabled_entries,help_info,
					  header_line,padding_chars,options);