xchar_text_message_c
status.i4.v = xchar_text_message_c(top_row.i4.v, left_column.i4.v,
num_rows.i4.v, num_columns.i4.v,
text.sa.r, exit_switch.i4.v,
resize_screen.i4.v, title.i1a.r,
synchronous.i4.v)
This routine will display a message window. The text should
be a block of text in XCHAR format.
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)
num_rows number of rows of text (>= 1)
num_columns number of columns of text (>= 1)
text text to display ("num_rows" * "num_columns" characters)
(array of XCHAR structures)
exit_switch determine whether or not to display an exit switch
(Note: This argument has no effect if "synchronous"
has a value of FALSE.)
(TRUE -> display exit ("OK") switch,
FALSE -> no exit switch)
resize_screen determine whether or not to resize the background
window to accommodate this window
(Note: This argument has no effect if "synchronous"
has a value of FALSE.)
(TRUE -> resize screen to fit large windows,
FALSE -> don't resize screen)
title window title (A value of NULL can be passed for this
argument if no title is desired.)
synchronous declares the handling of the window
(TRUE -> window will remain open until closed by user
action and then control will return to
the caller,
FALSE -> routine will return immediately after
drawing the window and will return the
window ID for deletion by the caller)
This function returns status values as follows:
OK success
CBS_INVARG invalid number of rows or columns
CBS_WINDOW_TOO_BIG message window won't fit on the TV screen
CBS_INVSIZ image is too large for TV screen
otherwise window ID if asynchronous mode is selected
This function requires the following include files:
cnsparam_h, cbslib_h, macro_h, acnet_errors_h
Related functions:
text_message_c, horz_scrolling_text_message_c, tvmess(_c), timmes(_c),
post_message(_c), meswin(_c), window_tvdisp(_c), dialog_setup_c,
window_restore_hint_c
C/C++ usage:
static const char title[] = "Title";
int status;
int top_row = WMNGR_CENTER;
int left_column = WMNGR_CENTER;
int num_rows = NUM_ROWS;
int num_columns = NUM_COLUMNS;
int exit_switch = TRUE;
int resize_screen = TRUE;
int synchronous = TRUE;
XCHAR text[NUM_ROWS*NUM_COLUMNS];
status = xchar_text_message_c(top_row,left_column,num_rows,num_columns,
text,exit_switch,resize_screen,title,
synchronous);