H63637 s 00122/00000/00000 d D 1.1 02/05/02 15:35:04 root 2 1 cC cF1 cK31174 cO-rw-rw-r-- e s 00000/00000/00000 d D 1.0 02/05/02 15:35:04 root 1 0 c BitKeeper file /Mastodon/Core/Build/ncurses/Ada95/html/mitem_current.3x.html cBor@egypt.pell.portland.or.us|ChangeSet|20020502223039|07086|e73225ae258b78f8 cHegypt.pell.portland.or.us cK33455 cPAda95/html/mitem_current.3x.html cR5aebe08d885e112e cV4 cX0x821 cZ-07:00 e u U f e 0 f x 0x821 t T I 2
mitem_current - set and get current_menu_item
#include <menu.h> int set_current_item(MENU *menu, const ITEM *item); ITEM *current_item(const MENU *menu); int set_top_row(MENU *menu, int row); int top_row(const MENU *menu); int item_index(const ITEM *item);
The function set_current_item sets the current item (the item on which the menu cursor is positioned). cur- rent_item returns a pointer to the current item in the given menu. The function set_top_row sets the top row of the menu to show the given row (the top row is initially 0, and is reset to this value whenever the O_ROWMAJOR option is tog- gled). The item leftmost on the given row becomes cur- rent. The function top_row returns the number of the top menu row being displayed. The function item_index returns the (zero-origin) index of item in the menu's item pointer list.
current_item returns NULL on error. top_row and item_index return ERR (the general curses error value) on error. set_current_item and set_top_row return one of the follow- ing: E_OK The routine succeeded. E_SYSTEM_ERROR System error occurred (see errno). E_BAD_ARGUMENT Routine detected an incorrect or out-of-range argu- ment. E_BAD_STATE Routine was called from an initialization or termina- tion function. E_NOT_CONNECTED No items are connected to the menu.
The header file <menu.h> automatically includes the header file <curses.h>.
These routines emulate the System V menu library. They were not supported on Version 7 or BSD versions. The SVr4 menu library documentation specifies the top_row and index_item error value as -1 (which is the value of ERR).
Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond.E 2 I 1 E 1