menu_item_current(
M3
IS
X)
CELLANEOUS LIBRARY FUNCTI
mO
eN
nS
u_item_current(3X)



NAME
     menuitemcurrent:      setcurrentitem,      currentitem,
     settoprow, toprow, itemindex - set and get current menus
     items

SYNOPSIS
     #include <menu.h>

     int setcurrentitem(MENU *menu, ITEM *item);
     ITEM *currentitem(MENU *menu);

     int settoprow(MENU *menu, int row);
     int toprow(MENU *menu);
     int itemindex(ITEM *item);

DESCRIPTION
     The current item of a menu is the item where the  cursor  is
     currently  positioned.   setcurrentitem  sets  the current
     item of menu to item.  currentitem returns a pointer to the
     the current item in menu.

     settoprow sets the top row of menu to row.  The  left-most
     item  on  the new top row becomes the current item.  toprow
     returns the number of the menu row  currently  displayed  at
     the  top  of menu.  itemindex returns the index to the item
     in the item pointer array.  The value of this  index  ranges
     from  0  through  N-1,  where N is the total number of items
     connected to the menu.

RETURN VALUE
     currentitem returns NULL on error.  toprow and  indexitem
     return -1 on error.  setcurrentitem and settoprow return
     one of the following:
     E_OK            - The routine returned successfully.
     E_SYSTEM_ERROR  - System error.
     E_BAD_ARGUMENT  - An incorrect argument was passed to the routine.
     E_BAD_STATE     - The routine was called from an initialization or
                       termination function.
     E_NOT_CONNECTED - No items are connected to the menu.

NOTES
     The header file <menu.h> automatically includes  the  header
     files <eti.h> and <curses.h>.

SEE ALSO
     curses(3X), menus(3X).









                          Last change:                          1