MENU_ITEM_VALUE(3) | Library Functions Manual | MENU_ITEM_VALUE(3) |
item_value
, set_item_value
,
item_selected
—
#include <menu.h>
int
item_value
(ITEM
*item);
int
set_item_value
(ITEM
*item, int
flag);
int
item_selected
(MENU
*menu, int
**array);
item_value
() function returns value of the item. If
the item has been selected then this value will be TRUE. The value can also be
set by calling set_item_value
() to set the value to a
defined state. Setting the value to a value other than TRUE or FALSE will have
undefined results. The item_selected
() function
returns the number of items that are selected in the menu, that is the number
of items whose value is TRUE. The indexes of the selected items will be
returned in array which will be dynamically allocated to
hold the number of indexes. It is the responsibility of the caller to release
this storage by calling free(3)
when the storage is no longer required. If there are no elements selected in
the items array then item_selected
() will return 0 and
array will be NULL. If an error occurs
item_selected
() will return one of the below return
values which are less than 0.
E_OK
E_NOT_CONNECTED
E_REQUEST_DENIED
E_SYSTEM_ERROR
The function item_selected
() is a
NetBSD extension and must not be used in portable
code.
September 10, 1999 | NetBSD 9.0 |