hilite_suspend_c
status.i4.v = hilite_suspend_c(hilite_id.i2.v, mode.i4.v)
This routine will suspend updates to the requested highlighting
region on the TV screen. Updates can be reenabled by a call to
'hilite_resume_c'.
hilite_id highlighting ID returned from 'hilite_create_c'
mode screen handling mode
(HILITE_ERASE_LAST -> erase any present highlighting,
HILITE_STOP_UPDATE -> leave present highlighting as is
but inhibit updates,
HILITE_RESTORE_LAST -> restore the highlighted text
upon the next call to
'hilite_resume_c')
This function returns ACNET status values as follows:
CBS_OK success
CBS_INVARG invalid mode value
CBS_MEMFAIL dynamic memory allocation failure
CBS_NO_SUCH couldn't find the requested highlight region
CBS_DUPREQ updates have already been suspended
This function requires the following include files:
cbslib_h, acnet_errors_h
Related functions:
hilite_resume_c, hilite_update_c, hilite_create_c,
hilite_simple_row_create_c, hilite_delete_c, hilite_window_delete_c,
hilite_modify_save_buffer_c
C/C++ usage:
short hilite_id;
int status;
int mode = HILITE_ERASE_LAST;
status = hilite_suspend_c(hilite_id,mode);