meswin(_c)
status.i4.v = meswin(top_row.i4.r, left_column.i4.r, num_rows.i4.r,
num_columns.i4.r, text.i1a.r, text_color.i4.r
[,title.i1a.r] [,exit_switch.i4.r]
[,resize_screen.i4.r] [,synchronous.i4.r])
status.i4.v = meswin_c(top_row.i4.v, left_column.i4.v, num_rows.i4.v,
num_columns.i4.v, text.i1a.r, text_color.i4.v
[,title.i1a.r] [,exit_switch.i4.v]
[,resize_screen.i4.v] [,synchronous.i4.v])
This routine will display a message window. The text should
be a null terminated string containing the message. If the
string will not fit within the constraints of the window,
a scroll bar will be created, to allow all of the text to be
viewed.
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 for the window
num_columns number of columns for the window
text message text
text_color text color
[title] window title (default (NULL) is no title)
[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 (default))
[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 (default))
[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_WINDOW_TOO_BIG message window won't fit on the TV screen
otherwise window ID if asynchronous mode is selected
This function requires the following include files:
cbslib_h, macro_h, acnet_errors_h
Related functions:
timmes(_c), post_message(_c), tvmess(_c), text_message_c,
xchar_text_message_c, dialog_setup_c, window_restore_hint_c
C/C++ usage:
static const char text[] =
"This is a program text message.";
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 text_color = CYAN;
int exit_switch = TRUE;
int resize_screen = TRUE;
int synchronous = TRUE;
status = meswin_c(top_row,left_column,num_rows,num_columns,
text,text_color,title,exit_switch,
resize_screen,synchronous);