graphic_window_menu_c (ul_dialoglib)
status.i4.v = graphic_window_menu_c(title.i1a.r, top_row.i4.v,
left_column.i4.v,
console_window.i4.r,
cursor_handling.i4.v,
console_number.i4.v,
menu_text_type.i4.v)
This routine displays a menu of console graphic windows.
title title of input window (Note: A null pointer may be
passed if no title is desired.)
top_row top row of menu (use WMNGR_CENTER for centering
or WINDOW_xxx_COORD macros in macro for special
positioning)
left_column left column of menu (use WMNGR_CENTER for centering
or WINDOW_xxx_COORD macros in macro for special
positioning)
console_window returned console graphic window
cursor_handling cursor positioning after the menu is closed
(WMNGR_LEAVE_CURSOR -> leave cursor where it is when
the menu is closed,
WMNGR_RESTORE_CURSOR -> position the cursor where
it was located when the
menu was created,
CLIB_DEFAULT_ARG -> use cursor handling set up by
the most recent call to
menu_setup_c)
console_number console number to create menu for
(use a value of LOCAL for the current console)
menu_text_type type of menu text
(CNV_SHORT_MENU_TEXT -> short menu text,
CNV_LONG_MENU_TEXT -> int menu text
(includes window title text))
This function returns ACNET status values as follows:
OK success
CBS_WINDOW_TOO_BIG window won't fit on screen
CBS_ABORT user aborted input
This function requires the following include files:
cnsparam_h, cbslib_h, ul_dialoglib_h:dialoglib_h, nodedefs_h, macro_h, acnet_errors_h
Related functions:
console_window_menu_c, tv_window_menu_c, console_slot_menu_c,
pa_menu_c, sa_menu_c, scroll_menu(_c), winput(_c), menu_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 console_window;
int cursor_handling = WMNGR_LEAVE_CURSOR;
int console_number = LOCAL;
int menu_text_type = CNV_LONG_MENU_TEXT;
status = graphic_window_menu_c(title,top_row,left_column,
&console_window,cursor_handling,
console_number,menu_text_type);