1 /****************************************************************************
2 * Copyright 2020 Thomas E. Dickey *
3 * Copyright 1998-2009,2010 Free Software Foundation, Inc. *
5 * Permission is hereby granted, free of charge, to any person obtaining a *
6 * copy of this software and associated documentation files (the *
7 * "Software"), to deal in the Software without restriction, including *
8 * without limitation the rights to use, copy, modify, merge, publish, *
9 * distribute, distribute with modifications, sublicense, and/or sell *
10 * copies of the Software, and to permit persons to whom the Software is *
11 * furnished to do so, subject to the following conditions: *
13 * The above copyright notice and this permission notice shall be included *
14 * in all copies or substantial portions of the Software. *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS *
17 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF *
18 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. *
19 * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, *
20 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR *
21 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR *
22 * THE USE OR OTHER DEALINGS IN THE SOFTWARE. *
24 * Except as contained in this notice, the name(s) of the above copyright *
25 * holders shall not be used in advertising or otherwise to promote the *
26 * sale, use or other dealings in this Software without prior written *
28 ****************************************************************************/
30 /****************************************************************************
31 * Author: Juergen Pfeifer, 1995,1997 *
32 ****************************************************************************/
34 /***************************************************************************
36 * Creation and destruction of new menus *
37 ***************************************************************************/
39 #include "menu.priv.h"
41 MODULE_ID("$Id: m_new.c,v 1.23 2020/05/24 01:40:20 anonymous.maarten Exp $")
43 /*---------------------------------------------------------------------------
45 | Function : MENU* _nc_new_menu(SCREEN*, ITEM **items)
47 | Description : Creates a new menu connected to the item pointer
48 | array items and returns a pointer to the new menu.
49 | The new menu is initialized with the values from the
52 | Return Values : NULL on error
53 +--------------------------------------------------------------------------*/
55 NCURSES_SP_NAME(new_menu) (NCURSES_SP_DCLx ITEM ** items)
57 int err = E_SYSTEM_ERROR;
58 MENU *menu = typeCalloc(MENU, 1);
60 T((T_CALLED("new_menu(%p,%p)"), (void *)SP_PARM, (void *)items));
63 *menu = _nc_Default_Menu;
65 menu->rows = menu->frows;
66 menu->cols = menu->fcols;
68 /* This ensures userwin and usersub are always non-null,
69 so we can derive always the SCREEN that this menu is
71 menu->userwin = SP_PARM->_stdscr;
72 menu->usersub = SP_PARM->_stdscr;
76 if (!_nc_Connect_Items(menu, items))
78 err = E_NOT_CONNECTED;
93 /*---------------------------------------------------------------------------
95 | Function : MENU *new_menu(ITEM **items)
97 | Description : Creates a new menu connected to the item pointer
98 | array items and returns a pointer to the new menu.
99 | The new menu is initialized with the values from the
102 | Return Values : NULL on error
103 +--------------------------------------------------------------------------*/
106 new_menu(ITEM ** items)
108 return NCURSES_SP_NAME(new_menu) (CURRENT_SCREEN, items);
112 /*---------------------------------------------------------------------------
113 | Facility : libnmenu
114 | Function : int free_menu(MENU *menu)
116 | Description : Disconnects menu from its associated item pointer
117 | array and frees the storage allocated for the menu.
119 | Return Values : E_OK - success
120 | E_BAD_ARGUMENT - Invalid menu pointer passed
121 | E_POSTED - Menu is already posted
122 +--------------------------------------------------------------------------*/
124 free_menu(MENU * menu)
126 T((T_CALLED("free_menu(%p)"), (void *)menu));
128 RETURN(E_BAD_ARGUMENT);
130 if (menu->status & _POSTED)
134 _nc_Disconnect_Items(menu);
136 if ((menu->status & _MARK_ALLOCATED) && menu->mark)
143 /* m_new.c ends here */