window_menu_bar_create_c

	status.i4.v = window_menu_bar_create_c(window_id.i2.v, field_text.i1a.r
					       [,funcs.fa.r] [,row.i4.v]
					       [,color.i4.v]
					       [,auto_update.i4.v]
					       [,func_data.ga.r]
					       [,help_info.sa.r])

	This routine will create a menu bar on the TV screen in the
	window indicated by "window_id".

	window_id	ID of desired window
	field_text	null terminated string containing the menu bar
			field labels separated by back slashes
	[funcs]		pointers to functions to be called by
			window_menu_bar_update_c when a field is clicked on
			(called as follows:
			 funcs(wid.i2.v, func_data.g.v, mb_data.s.r)
			 ("mb_data" is a structure of type
			  MENU_BAR_INTERRUPT_DATA))
			(default is NULL)
	[row]		row to display menu bar (default is 1)
	[color]		color of menu bar (Note: The passed foreground and
			background colors are reversed by this routine.)
			(default is WHITE which produces black text on a
			 white background)
	[auto_update]	flag to determine whether to automatically update
			(TRUE -> automatically update this menu bar
				 (application doesn't need to call
				  window_menu_bar_update_c),
			 FALSE -> update by calls to
				  window_menu_bar_update_c (default))
	[func_data]	addresses of caller-supplied data to be passed to
			"funcs" (default is NULL)
	[help_info]	entry by entry help callback information
			(array of HELP_CALLBACK_DATA structures)
			(default is NULL)

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid window ID
	CBS_TOO_MANY		there is already a menu bar present
	CBS_INVSIZ		menu bar is too big to fit in the window
	CBS_MEMFAIL		failed in allocating dynamic memory
	CBS_NO_WINDOW		window doesn't exist

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, cbslib_h, acnet_errors_h

	Related functions:

	menu_bar_create, window_menu_bar_delete_c, window_menu_bar_update_c,
	window_read_menu_bar_info, menu_bar_enable_c, menu_bar_disable_c,
	menu_bar_field_coordinates_c, menu_bar_upcase_entry_c,
	menu_bar_dncase_entry_c, menu_bar_change_entry_c,
	window_has_menu_bar_c, build_menu_bar_text, menu_bar_min_width_c

	C/C++ usage:

	static const char	field_text[] = "field 1\\field 2";
	short	window_id = WMNGR_BACKGROUND;
	int	status;
	int	row = 3;
	int	color = WHITE;
	int	auto_update = TRUE;
	void	**func_data = (void **) NULL;
	menu_bar_function	funcs[NUM_FIELDS];
	HELP_CALLBACK_DATA	*help_info = (HELP_CALLBACK_DATA *) NULL;
	void	func1(short window_id, void *callback_data,
		      MENU_BAR_INTERRUPT_DATA *mb_data);
	void	func2(short window_id, void *callback_data,
		      MENU_BAR_INTERRUPT_DATA *mb_data);

	funcs[0] = func1;
	funcs[1] = func2;

	status = window_menu_bar_create_c(window_id,field_text,funcs,
					  row,color,auto_update,
					  func_data,help_info);