NAME

menu_item_current, set_current_item, current_item, set_top_row, top_row, item_index − set and get current menus items

SYNOPSIS

cc [ flag ... ] file ... −lmenu  -lcurses [ library .. ]

#include <menu.h>

int set_current_item(MENU ∗menu, ITEM ∗item);

ITEM ∗current_item(MENU ∗menu);

int set_top_row(MENU ∗menu, int row);

int top_row(MENU ∗menu);

int item_index(ITEM ∗item);

MT-LEVEL

Unsafe

DESCRIPTION

The current item of a menu is the item where the cursor is currently positioned.  set_current_item() sets the current item of menu to item.  current_item() returns a pointer to the the current item in menu. 

set_top_row() sets the top row of menu to row.  The left-most item on the new top row becomes the current item.  top_row() returns the number of the menu row currently displayed at the top of menu. 

item_index() 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

current_item() returns NULL on error. 

top_row() and index_item() return -1 on error. 

set_current_item() and set_top_row() return one of the following:

E_OKThe routine returned successfully.
E_SYSTEM_ERRORSystem error.
E_BAD_ARGUMENTAn incorrect argument was passed
to the routine.
E_BAD_STATEThe routine was called from an
initialization or termination function.
E_NOT_CONNECTEDNo items are connected to the menu.

SEE ALSO

curses(3X), menus(3X)

NOTES

The header <menu.h> automatically includes the headers <eti.h> and <curses.h>. 
 

SunOS 5.5/SPARC  —  Last change: 22 Jan 1993