Curses Library Functions               menuitemcurrent(3CURSES)



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

SYNOPSIS
     cc [ flag... ] file... -lmenu  -lcurses  [ library... ]
     #include 

     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 VALUES
     currentitem() returns NUL on error.


     toprow() and indexitem() return -1 on error.


     setcurrentitem() and settoprow() return one of the  fol-
     lowing:




SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions               menuitemcurrent(3CURSES)



     EOK               The routine returned successfully.


     ESYSTEMEROR     System error.


     EBADARGUMENT     An incorrect argument was passed  to  the
                        routine.


     EBADSTATE        The    routine    was     called     from
                        an     initialization    or   termination
                        function.


     ENOTCONECTED    No items are connected to the menu.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     curses(3CURSES), menus(3CURSES), attributes(5)

NOTES
     The  header    automatically  includes  the  headers
      and .


















SunOS 5.11          Last change: 31 Dec 1996                    2