timer_window_c (ul_dialoglib)
status.i4.v = timer_window_c(top_row.i4.v, left_column.i4.v,
device_index.i4.v, data_type.i4.v,
allow_settings.i4.v [,options.u4.v]
[,help_info.s.r])
This routine creates a window to read and set the triggering events
and delay values for a timer device.
top_row top row of the dialog window
left_column left column of the dialog window
device_index device index of timer card
data_type type of timer information to display
(DIALOG_TIMER_EVENTS -> display reference events only,
DIALOG_TIMER_DELAY -> display delay only,
DIALOG_TIMER_BOTH -> display both reference events
and delay)
allow_settings setting control flag
(DIALOG_ALLOW_SETTINGS -> allow settings,
DIALOG_CAUTION_SETTINGS -> allow settings but put
a caution dialog first,
DIALOG_NO_SETTINGS -> don't allow settings)
[options] optional control window feature flags
(DIALOGLIB_OPT_NONE -> no special options requested
(default),
DIALOGLIB_OPT_FIT_WINDOW -> resize the background
window if necessary to
fit the dialog window)
[help_info] help callback information
(structure of type HELP_CALLBACK_DATA)
(default is NULL)
This function returns ACNET status values as follows:
TRUE settings were changed
FALSE no settings were changed
CBS_INVARG invalid data type passed
DIO_MEMFAIL dynamic memory allocation failure
DIO_INVDEV not a timer device
DIO_NO_SUCH invalid timer database entries
CBS_WINDOW_TOO_BIG window won't fit on screen
DIO_xxx error accessing device
This function requires the following include files:
cnsparam_h, ul_dialoglib_h:dialoglib_h, acnet_errors_h
Related functions:
wn_timer_window_c, timer_list_window_c, setting_window_c,
wn_setting_window_c, device_control_window_c,
wn_device_control_window_c
C/C++ usage:
int status;
int top_row = WMNGR_CENTER;
int left_column = WMNGR_CENTER;
int device_index = 59100;
int data_type = DIALOG_TIMER_BOTH;
int allow_settings = DIALOG_CAUTION_SETTINGS;
unsigned int options = DIALOGLIB_OPT_NONE;
HELP_CALLBACK_DATA *help_info = (HELP_CALLBACK_DATA *) NULL;
status = timer_window_c(top_row,left_column,device_index,data_type,
allow_settings,options,help_info);