NAME    [Toc]    [Back]

     current_item, item_index, set_current_item, set_top_row top_row - get or
     set item pointers or top row

LIBRARY    [Toc]    [Back]

     Curses Menu Library (libmenu, -lmenu)

SYNOPSIS    [Toc]    [Back]

     #include <menu.h>

     ITEM *
     current_item(MENU *menu);

     int
     item_index(ITEM *item);

     int
     set_current_item(MENU *menu, ITEM *item);

     int
     set_top_row(MENU *menu, int row);

     int
     top_row(MENU *menu);

DESCRIPTION    [Toc]    [Back]

     The current_item() returns a pointer to the current menu item.  The
     set_current_item() can be used to set this to the item give.  The
     item_index() function returns the index number in the array of items for
     the item pointed to by the item parameter.  The set_top_row() function
     sets the top row of the menu displayed to be the row given.  The current
     item becomes the leftmost item of the top row.  The top_row() call
     returns the row number that is currently at the top of the displayed
     menu.

RETURN VALUES    [Toc]    [Back]

     current_item() returns NULL if no items are attached to the menu.

     E_OK             The function was successful.
     E_BAD_ARGUMENT   One or more of the arguments passed to the function was
                      incorrect.
     E_BAD_STATE      The function was called from within an initialisation or
                      termination routine.
     E_NOT_CONNECTED  The item is not connected to a menu.

SEE ALSO    [Toc]    [Back]

     curses(3), menus(3)

NOTES    [Toc]    [Back]

     The header <menu.h> automatically includes both <curses.h> and <eti.h>.

BSD                           September 10, 1999                           BSD