menu_item_current(S)

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

Syntax

cc ... -lmenu -lcurses

#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

set_current_item- set current menu item

current_item- return current menu item

set_top_row- set current menu top row

top_row- return current menu top row

item_index- return index to item in item pointer array

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

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

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

Warning

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

Files

/usr/lib/libmenu.a: the library

Standards conformance

set_current_item(S), current_item(S), set_top_row(S), top_row(S), and item_index(S) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.