check_box_menu_c

	status.i4.v = check_box_menu_c(top_row.i4.v, left_column.i4.v,
				       num_lines.i4.v, text.i1a.r,
				       num_chars.i4.v, num_entries.i4.v,
				       title.i1a.r, logical_values.i4a.r
				       [,padding_chars.i4.v]
				       [,enabl_entries.i1a.r]
				       [,text_color.i4.v]
				       [,help_info.sa.r]
				       [,exit_switches.i4.v])

	This routine will display a popup menu of check boxes
	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.  "logical_values" is an array of
	the logical status values to be modified.

	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 at a time
	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
	logical_values	array of logical values
	[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)
	[text_color]	desired text color for enabled entries
			(default is WHITE)
	[help_info]	entry by entry help callback information
			(array of HELP_CALLBACK_DATA structures)
			(default is NULL)
	[exit_switches]	determine whether or not to display exit switches
			(TRUE -> display exit ("OK" and "Cancel") switches,
			 FALSE -> no exit switches (default))

	This function returns status values as follows:

	CBS_INVARG		invalid number of menu entries or
				padding characters
	CBS_WINDOW_TOO_BIG	window won't fit on screen
	CBS_MEMFAIL		dynamic memory allocation failure
	CBS_ABORT		user aborted by clicking on the cancel button
	TRUE			value(s) have been changed
	FALSE			no values were changed

	This function requires the following include files:

	cnsparam_h, cbslib_h, macro_h, acnet_errors_h

	Related functions:

	logical_scroll_menu(_c), logical_combo_menu_c, scroll_menu(_c),
	scroll_menu_hs_c, combo_menu_c, combo_menu_hs_c, wmenu(_c),
	popup_menu(_c), menu_create(_c), menu_setup_c, build_menu_text,
	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;
	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;
	static int	logical_values[NUM_ENTRIES] =
	{TRUE, TRUE, TRUE, TRUE, TRUE, TRUE};
	int	padding_chars = 1;
	int	text_color = WHITE;
	int	exit_switches = TRUE;
	HELP_CALLBACK_DATA	*help_info = (HELP_CALLBACK_DATA *) NULL;

	status = check_box_menu_c(top_row,left_column,num_lines,
				  (char *) text,num_chars,num_entries,
				  title,logical_values,padding_chars,
				  enabled_entries,text_color,help_info,
				  exit_switches);