Ada95/html/menu_items.3x.html

   1 <HTML>
   2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
   3 <PRE>
   4        <STRONG>menu_items</STRONG>  - make and break connections between items and
   5        menus
   6
   7
   8 </PRE>
   9 <H2>SYNOPSIS</H2><PRE>
  10        <STRONG>#include</STRONG> <STRONG>&lt;menu.h&gt;</STRONG>
  11        int set_menu_items(MENU *menu, ITEM **items);
  12        ITEM **menu_items(const MENU *menu);
  13        int item_count(const MENU *menu);
  14
  15
  16 </PRE>
  17 <H2>DESCRIPTION</H2><PRE>
  18        The function <STRONG>set_menu_items</STRONG> changes the item pointer array
  19        of  the  given  <EM>menu</EM>.   The  array must be terminated by a
  20        <STRONG>NULL</STRONG>.
  21
  22        The function <STRONG>menu_items</STRONG> returns  the  item  array  of  the
  23        given menu.
  24
  25        The  function  <STRONG>item_count</STRONG>  returns  the  count of items in
  26        <EM>menu</EM>.
  27
  28
  29 </PRE>
  30 <H2>RETURN VALUES</H2><PRE>
  31        The function <STRONG>menu_items</STRONG> returns <STRONG>NULL</STRONG> on error.
  32
  33        The function <STRONG>item_count</STRONG> returns <STRONG>ERR</STRONG>  (the  general  <STRONG>curses</STRONG>
  34        error return value) on error.
  35
  36        The  function  <STRONG>set_menu_items</STRONG> returns one of the following
  37        codes on error:
  38
  39        <STRONG>E_OK</STRONG> The routine succeeded.
  40
  41        <STRONG>E_SYSTEM_ERROR</STRONG>
  42             System error occurred (see <STRONG>errno</STRONG>).
  43
  44        <STRONG>E_BAD_ARGUMENT</STRONG>
  45             Routine detected an incorrect or  out-of-range  argu-
  46             ment.
  47
  48        <STRONG>E_POSTED</STRONG>
  49             The menu is already posted.
  50
  51        <STRONG>E_NOT_CONNECTED</STRONG>
  52             No items are connected to the menu.
  53
  54
  55 </PRE>
  56 <H2>SEE ALSO</H2><PRE>
  57        <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>, <STRONG><A HREF="menu.3x.html">menu(3X)</A></STRONG>.
  58
  59
  60 </PRE>
  61 <H2>NOTES</H2><PRE>
  62        The header file <STRONG>&lt;menu.h&gt;</STRONG> automatically includes the header
  63        file <STRONG>&lt;curses.h&gt;</STRONG>.
  64
  65
  66 </PRE>
  67 <H2>PORTABILITY</H2><PRE>
  68
  69        The   SVr4   menu   library  documentation  specifies  the
  70        <STRONG>item_count</STRONG> error value as -1 (which is the value of  <STRONG>ERR</STRONG>).
  71
  72
  73 </PRE>
  74 <H2>AUTHORS</H2><PRE>
  75        Juergen  Pfeifer.   Manual  pages  and  adaptation for new
  76        curses by Eric S. Raymond.
  77
  78
  79
  80
  81
  82
  83
  84
  85
  86
  87
  88
  89
  90
  91
  92
  93
  94
  95
  96
  97
  98
  99
 100
 101
 102
 103
 104
 105
 106
 107
 108
 109
 110
 111
 112
 113
 114
 115
 116
 117
 118
 119
 120
 121
 122 </PRE>
 123 </BODY>
 124 </HTML>