menuc (ul_pccns)

	menuc(type.i4.v, top_row.i4.v, left_column.i4.v, num_items.i4.v,
	      num_chars.i4.v, item_text.i1p.r, title.i1a.r, item.i2.r,
	      menu_columns.i4.v, window_id.i2.r)

	This routine will create, update, return selections, and destroy
	a menu of choices on the color TV display.  The action that is
	taken is dictated by the value of "type".  This menu routine
	differs from the popup menu type created by 'wmenu' in that it
	does not destroy itself as soon as a selection is made.  It
	continues to exist until you tell it to delete itself.  This
	means that the application programmer must help service this
	menu himself.  It should at least be called during periodic
	interrupts in order to update selection highlighting and
	during keyboard interrupts to determine if a selection has
	been made.  The value of "item" is updated during keyboard
	interrupts.  If the interrupt did not occur within the menu,
	a value of 0 is returned.  If the menu is occluded by another
	window, menu highlighting and "item" returns are not updated.
	The routine automatically determines the window size.  The menu
	item which the cursor is under is highlighted with a white
	background.  The arguments are defined as follows:

	type		type of desired action where :
			(0 --> create and display menu,
			 1 --> update highlighting (periodic update),
			 2 --> fetch "item" value (keyboard interrupt),
			 3 --> destroy menu)
	top_row		top row where window should be placed
	left_column	left column where window should be placed
	num_items	number of menu items
	num_chars	number of characters in a menu item
	item_text	character * "num_chars" array dimensioned "num_items"
			which contains text for each menu item
	title		a 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".
	item		number of selected item (or zero).  On a type 2
			call, "item" will be set to the number of the item
			which the user clicked under (zero is returned
			if no item was clicked on).
	menu_columns	number of menu columns
	window_id	window ID returned when menu is created
	
	This function requires the following include files:

	ul_pccns_h:tvlib34_h

	Related functions:

	wmenu

	C usage:

	static char	*item_text[NUM_ITEMS] =
	{"Entry 1", "Entry 2", "Entry 3", "Entry 4", "Entry 5", "Entry 6"};
	static const char	title[] = "Title";
	short	window_id;
	short	item = 0;
	int	type = 0;
	int	top_row = 1;
	int	left_column = 1;
	int	num_items = NUM_ITEMS;
	int	num_chars = NUM_CHARS;
	int	num_columns = 1;

	menuc(type,top_row,left_column,num_items,num_chars,item_text,
	      title,&item,num_columns,&window_id);
			.
			.
			.
	type = 2;

	menuc(type,top_row,left_column,num_items,num_chars,item_text,
	      title,&item,num_columns,&window_id);