menu_item_current(3X) — MISCELLANEOUS LIBRARY FUNCTIONS
NAME
menu_item_current: set_current_item, current_item, set_top_row, top_row, item_index − set and get current menus items
SYNOPSIS
#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);
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 VALUE
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_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.