menu_item_current(3ocurses)


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 -locurses [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);

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 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.

 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.

Notices

The header file menu.h automatically includes the header files eti.h and ocurses.h.

References

curses(3ocurses), menus(3ocurses)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004