NAME
current_item,
item_index,
set_current_item,
set_top_row
top_row
- get or set item pointers or top row
LIBRARY
Curses Menu Library (libmenu, -lmenu)
SYNOPSIS
ITEM *
current_item(MENU *menu)
int
item_index(ITEM *item)
int
set_current_item(MENU *menu, ITEM *item)
int
set_top_row(MENU *menu, int row)
int
top_row(MENU *menu)
DESCRIPTION
The
current_item()
returns a pointer to the current menu item.
The
set_current_item()
can be used to set this to the item give.
The
item_index()
function returns the index number in the array of items for the item
pointed to by the
item
parameter.
The
set_top_row()
function sets the top row of the menu displayed to be the row given.
The current item becomes the leftmost item of the top row.
The
top_row()
call returns the row number that is currently at the top of the
displayed menu.
RETURN VALUES
current_item()
returns NULL if no items are attached to the menu.
E_OK-
The function was successful.
E_BAD_ARGUMENT-
One or more of the arguments passed to the function was incorrect.
E_BAD_STATE-
The function was called from within an initialization or termination
routine.
E_NOT_CONNECTED-
The item is not connected to a menu.
SEE ALSO
curses(3),
menus(3)
NOTES
The header
<menu.h>
automatically includes both
<curses.h>
and
<eti.h>.