menu_item_current(3X)            UNIX System V            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:
      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)









10/89                                                                    Page 1