1 /****************************************************************************
2 * Copyright 2020,2021 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.27 2021/06/17 21:26:02 tom 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 T((T_CREATE("menu %p"), (void *)menu));
64 *menu = _nc_Default_Menu;
66 menu->rows = menu->frows;
67 menu->cols = menu->fcols;
69 /* This ensures userwin and usersub are always non-null,
70 so we can derive always the SCREEN that this menu is
72 menu->userwin = SP_PARM->_stdscr;
73 menu->usersub = SP_PARM->_stdscr;
77 if (!_nc_Connect_Items(menu, items))
79 err = E_NOT_CONNECTED;
94 /*---------------------------------------------------------------------------
96 | Function : MENU *new_menu(ITEM **items)
98 | Description : Creates a new menu connected to the item pointer
99 | array items and returns a pointer to the new menu.
100 | The new menu is initialized with the values from the
103 | Return Values : NULL on error
104 +--------------------------------------------------------------------------*/
107 new_menu(ITEM **items)
109 return NCURSES_SP_NAME(new_menu) (CURRENT_SCREEN, items);
113 /*---------------------------------------------------------------------------
114 | Facility : libnmenu
115 | Function : int free_menu(MENU *menu)
117 | Description : Disconnects menu from its associated item pointer
118 | array and frees the storage allocated for the menu.
120 | Return Values : E_OK - success
121 | E_BAD_ARGUMENT - Invalid menu pointer passed
122 | E_POSTED - Menu is already posted
123 +--------------------------------------------------------------------------*/
125 free_menu(MENU *menu)
127 T((T_CALLED("free_menu(%p)"), (void *)menu));
129 RETURN(E_BAD_ARGUMENT);
131 if (menu->status & _POSTED)
135 _nc_Disconnect_Items(menu);
137 if ((menu->status & _MARK_ALLOCATED) && menu->mark)
144 /* m_new.c ends here */