input_device_c (ul_dialoglib)
status.i4.v = input_device_c(top_row.i4.v, left_column.i4.v,
prompt_strings.i1a.r, prompt_length.i4.v,
device_indices.i4a.r, num_devices.i4.v)
This routine creates a window to input one or more ACNET device names.
top_row top row of dialog window (use WMNGR_CENTER for
centering or WINDOW_xxx_COORD macros in macro for
special positioning)
left_column left column of dialog window (use WMNGR_CENTER for
centering or WINDOW_xxx_COORD macros in macro for
special positioning)
prompt_strings prompt text strings
prompt_length number of characters in each prompt string
(If a value of zero is passed for this argument,
the routine will automatically determine the prompt
text length.)
device_indices ACNET device index or array of device indices
num_devices number of devices
This function returns status values as follows:
TRUE value(s) have been changed
FALSE no values were changed
CBS_MEMFAIL dynamic memory allocation failure
CBS_WINDOW_TOO_BIG window won't fit on screen
CBS_ABORT user aborted input (no values are changed)
This function requires the following include files:
cnsparam_h, ul_dialoglib_h:dialoglib_h, macro_h, acnet_errors_h
Related functions:
winput(_c), dialog_setup_c, input_array_values_c, window_restore_hint_c
C/C++ usage:
static const char prompt_strings[NUM_DEVICES][PROMPT_LENGTH+1] =
{"Prompt 1", "Prompt 2"};
int status;
int top_row = WMNGR_CENTER;
int left_column = WMNGR_CENTER;
int prompt_length = PROMPT_LENGTH;
int device_indices[NUM_DEVICES];
int num_devices = NUM_DEVICES;
status = input_device_c(top_row,left_column,(char *) prompt_strings,
prompt_length,device_indices,num_devices);