dio_digital_control_menu_c

	status.i4.v = dio_digital_control_menu_c(top_row.i4.v,
						 left_column.i4.v,
						 num_lines.i4.v,
						 device_index.i4.v,
						 array_index.i4.v
						 [,num_user.i4.v]
						 [,user_text_len.i4.v]
						 [,user_text.i1a.r]
						 [,user_func.fa.r]
						 [,func_data.ga.r]
						 [,options.u4.v])

	This routine provides a menu for digital control for a device.

	top_row		top row of menu (use WMNGR_CENTER for centering)
	left_column	left column of menu (use WMNGR_CENTER for centering)
	num_lines	maximum number of entries to display at a time
			(If a value of CLIB_DEFAULT_ARG is passed for this
			 argument, the routine will determine the size
			 of the menu.)
	device_index	device index of device to control
	array_index	desired array index (usually 0)
	[num_user]	optional number of additional user entries
			(default is 0)
	[user_text_len]	length of each user text entry including any nulls
	[user_text]	text for user-supplied entries
			("user_text_len" characters per entry)
			(default is NULL)
	[user_func]	user-supplied functions (default is NULL)
	[func_data]	pointers to data to be passed to "user_func"
			(default is NULL)
	[options]	menu options (Individual options can be ORed together.)
			(DIO_DIGCON_OPT_NONE -> no options selected,
			 DIO_DIGCON_OPT_USER_FUNC_ON_TOP -> user-supplied
							    entries should come
							    first (default is
							    for them to come
							    last),
			 DIO_DIGCON_OPT_CONTROLLED_SET -> observe controlled
							  setting restrictions,
			 DIO_DIGCON_OPT_ALLOW_CREW_CHIEF -> allow the MCR crew
							    chief to make
							    controlled settings)

	This function returns ACNET status values as follows:

	OK			success
	DIO_NO_SUCH		no digital control property for this device
	CLIB_NO_SUCH		no digital control entries exist for this device
	CLIB_MEMFAIL		memory allocation failure
	CLIB_ABORT		user aborted input
	DIO_SETDIS		DIO settings are disabled
	negative value		other ACNET format error

	This function requires the following include files:

	diolib_h, acnet_errors_h

	Related functions:

	dio_digital_control_info_c, dio_digital_control_text_to_value_c,
	dio_digital_control_text_to_value_list_c, dio_raw_to_control_text_c,
	dio_digital_control_c, dio_digital_control_list_c,
	dio_set_raw(_c)

	C/C++ usage:

	char	user_text[] = "user 1      user 2      ";
	int	status;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	int	num_lines = 5;
	int	device_index = Z_ACLTST;
	int	array_index = 0;
	int	num_user = 2;
	int	user_text_len = 12;
	unsigned int	options = DIO_DIGCON_OPT_NONE;
	void	user_func_1(void *dummy);
	void	user_func_2(void *dummy);
	digital_control_user_function	user_funcs[2];
	void	**func_data = (void **) NULL;

	user_funcs[0] = (digital_control_user_function) user_func_1;
	user_funcs[1] = (digital_control_user_function) user_func_2;

	status = dio_digital_control_menu_c(top_row,left_column,num_lines,
					    device_index,array_index,
					    num_user,user_text_len,user_text,
					    user_funcs,func_data,options);