window_find_init_c
status.i4.v = window_find_init_c(window_id.i2.v, command_row.i4.v,
command_column.i4.v [,options.u4.v])
This routine will initialize a window for subsequent text
searches by calls to 'window_find_text_c'.
window_id window ID for window to be searched
(use WMNGR_BACKGROUND for background window)
command_row top row of command dialogs created by search routines
(If a value of CLIB_DEFAULT_ARG is passed for this
argument and this routine has previously been called
for this window, the command row will remain at its
present value.)
command_column left column of command dialogs created by search
routines
(If a value of CLIB_DEFAULT_ARG is passed for this
argument and this routine has previously been called
for this window, the command column will remain at its
present value.)
options find options
(WMNGR_OPT_NONE -> no options selected, treat
coordinates as window coordinates,
WMNGR_OPT_SCREEN_COORDS -> treat coordinates as screen
coordinates (default))
This function returns ACNET status values as follows:
CLIB_OK success
CLIB_MEMFAIL dynamic memory allocation failure
CLIB_NO_SUCH requested window does not exist
This function requires the following include files:
cbslib_h, acnet_errors_h
Related functions:
window_find_delete_c, window_find_text_c, window_find_text_callback_c
C/C++ usage:
short window_id = WINDOW_ID;
int status;
int command_row = COMMAND_ROW;
int command_column = COMMAND_COLUMN;
unsigned int options = WMNGR_OPT_NONE;
status = window_find_init_c(window_id,command_row,command_column,
options);