window_message_create_c
status.i4.v = window_message_create_c(top_row.i4.v, left_column.i4.v,
overall_message.i1a.r,
overall_color.i4.v,
message.i1a.r, message_color.i4.v,
message_id.i2.r)
This routine will display a single line message window. It supports
both an overall message which will appear in the title of the window
as well as a more explicit message in the body of the window. Both
text strings should be null terminated. The message in the body
of the window can be changed by calls to window_message_update_c.
The message window will remain until it is deleted by a call to
window_message_delete_c.
top_row top row of window
(use WMNGR_CENTER for centering or WINDOW_xxx_COORD
macros in 'macro' for special positioning)
left_column left column of window
(use WMNGR_CENTER for centering or WINDOW_xxx_COORD
macros in 'macro' for special positioning)
overall_message overall message for the title of the window
(must be null terminated)
overall_color color of overall title message
(constants are in 'cnsparam')
message first message to be displayed (must be null terminated)
message_color message color
(constants are in 'cnsparam')
message_id returned ID which can be used in future calls to
window_message_update_c or window_message_delete_c
This function returns ACNET status values as follows:
OK success
CBS_WINDOW_TOO_BIG message window won't fit on the TV screen
This function requires the following include files:
cnsparam_h, cbslib_h, macro_h, acnet_errors_h
Related functions:
window_message_delete_c, window_message_update_c, post_message(_c)
C/C++ usage:
static const char overall_message[] = "This is the title!";
static const char message[] = "This is the message inside the window!";
short message_id;
int status;
int top_row = TOP_ROW;
int left_column = LEFT_COLUMN;
int overall_color = OVERALL_COLOR;
int message_color = MESSAGE_COLOR;
status = window_message_create_c(top_row,left_column,overall_message,
overall_color,message,message_color,
&message_id);