multicolor_menu_change_entry_c

	status.i4.v = multicolor_menu_change_entry_c(menu_id.i4.v, item.i4.v,
						     text.saa.r, num_chars.i4.v
						     [,left_color.i4.v]
						     [,right_color.i4.v])

	This routine will change the text of a multicolor menu item
	in a menu created by an earlier call to multicolor_menu_create_c.

	menu_id		menu ID (returned by a prior call to
			multicolor_menu_create_c)
			(a value of MENU_TOP will result in deleting the
			 most recently created menu)
	item		item number to change (starts at 1)
	text		new item text (If a value of NULL is passed, the
			present text will remain.)
			(array of XCHAR structures)
	num_chars	length of item text (If a value of zero is passed,
			the routine will determine the length of the text.)
	[left_color]	left padding character color
			(If a value of CLIB_DEFAULT_ARG is
			passed for this argument, the text color will
			remain unchanged.)
			(constants are in 'cnsparam')
	[right_color]	right padding character color
			(If a value of CLIB_DEFAULT_ARG is
			passed for this argument, the text color will
			remain unchanged.)
			(constants are in 'cnsparam')

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid item requested
	CBS_NO_SUCH		menu does not exist
	CBS_NOTENB		requested item is a separator or an attempt
				was made to change the color of a disabled
				item

	This function requires the following include files:

	cnsparam_h, cbslib_h, acnet_errors_h

	Related functions:

	multicolor_menu_create_c, menu_change_entry_c, menu_change_entry_case_c,
	menu_create(_c), menu_set_current_entry_c, menu_delete(_c),
	menu_update(_c), menu_topmost

	C/C++ usage:

	short	menu_id;
	int	item = 3;
	int	num_chars = NUM_CHARS;
	int	left_color = (int) CLIB_DEFAULT_ARG;
	int	right_color = (int) CLIB_DEFAULT_ARG;
	static const XCHAR	text[NUM_CHARS];

	status = multicolor_menu_change_entry_c(menu_id,item,text,num_chars,
						left_color,right_color);