menu_item_current(3X)          DG/UX R4.11MU05         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).


Licensed material--property of copyright holder(s)