item_opts(3)

item_opts3

Set and get menu item options

Usage

#include <menu.h>

int set_item_opts(ITEM *item, Item_Options opts); Item_Options item_opts(const ITEM *item);

int item_opts_on(ITEM *item, Item_Options opts); int item_opts_off(ITEM *item, Item_Options opts);

Overview

The function set_item_opts sets all the given item's option bits (menu option bits may be logically “or”-ed together).

The function item_opts_on turns on the given option bits, and leaves others alone.

The function item_opts_off turns off the given option bits, and leaves others alone.

The function item_opts returns the item's current option bits.

There is only one defined option bit mask, O_SELECTABLE. When this is on, the item may be selected during menu processing. This option defaults to on.

Return value

Except for item_opts, each routine returns one of the following:

E_OK

The routine succeeded.

E_SYSTEM_ERROR

System error occurred (see errno(3)).

Portability

These routines emulate the System V menu library. They were not supported on Version 7 or BSD versions.

Releases

66 releases since FreeBSD 4.3-RELEASE; the text changed 11 times.

  1. 4.3–6.2
  2. 6.3
  3. 6.4
  4. 7.0
  5. 7.1–10.4
  6. 11.0–12.4
  7. 13.0–13.5
  8. 14.0–14.1
  9. 14.2–14.4
  10. 14.5
  11. 15.0
  12. 15.1–16.0

Authors

Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's man source.