menu_item_current(3X)                                 menu_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:
         EOK            - The routine returned successfully.
         ESYSTEMERROR  - System error.
         EBADARGUMENT  - An incorrect argument was passed to the routine.
         EBADSTATE     - The routine was called from an initialization or
                           termination function.
         ENOTCONNECTED - 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).








   8/91                                                                 Page 1