hilite_modify_save_buffer_c
status.i4.v = hilite_modify_save_buffer_c(hilite_id.i2.v,
text.sa.r, num_chars.i4.v,
offset.i4.v)
This routine allows the caller to modify text in the highlight
saved text buffer. This is useful if your program supports
data entry within a highlight region. When the user types in
text and interrupts, this routine allows you to update the saved
text buffer with the text that the user has just entered.
Otherwise, as soon as the cursor leaves this field, the text
just entered will be replaced by the text that was there when
the field was first highlighted.
hilite_id highlighting ID returned from 'hilite_create_c'
text replacement text string (array of XCHAR structures)
num_chars number of characters in string
offset offset into the highlight text (starts at 0)
This function returns ACNET status values as follows:
CBS_OK success
CBS_INVARG invalid string length or offset value
CBS_NO_SUCH couldn't find the requested highlight region
CBS_NOTENB requested highlight region does not have
a text buffer or no text is currently
highlighted
This function requires the following include files:
cbslib_h, cns_data_structs_h, acnet_errors_h
Related functions:
hilite_update_c, hilite_create_c, hilite_resume_c, hilite_suspend_c,
hilite_simple_row_create_c, hilite_delete_c, hilite_window_delete_c
C/C++ usage:
short hilite_id;
int status;
int num_chars = NUM_CHARS;
int offset = 0;
XCHAR text[NUM_CHARS];
status = hilite_modify_save_buffer_c(hilite_id,text,num_chars,offset);