| 1 | /**************************************************************************** | 
|---|
| 2 | * Copyright (c) 1998-2004,2005 Free Software Foundation, Inc.              * | 
|---|
| 3 | *                                                                          * | 
|---|
| 4 | * Permission is hereby granted, free of charge, to any person obtaining a  * | 
|---|
| 5 | * copy of this software and associated documentation files (the            * | 
|---|
| 6 | * "Software"), to deal in the Software without restriction, including      * | 
|---|
| 7 | * without limitation the rights to use, copy, modify, merge, publish,      * | 
|---|
| 8 | * distribute, distribute with modifications, sublicense, and/or sell       * | 
|---|
| 9 | * copies of the Software, and to permit persons to whom the Software is    * | 
|---|
| 10 | * furnished to do so, subject to the following conditions:                 * | 
|---|
| 11 | *                                                                          * | 
|---|
| 12 | * The above copyright notice and this permission notice shall be included  * | 
|---|
| 13 | * in all copies or substantial portions of the Software.                   * | 
|---|
| 14 | *                                                                          * | 
|---|
| 15 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  * | 
|---|
| 16 | * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               * | 
|---|
| 17 | * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   * | 
|---|
| 18 | * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   * | 
|---|
| 19 | * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    * | 
|---|
| 20 | * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    * | 
|---|
| 21 | * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               * | 
|---|
| 22 | *                                                                          * | 
|---|
| 23 | * Except as contained in this notice, the name(s) of the above copyright   * | 
|---|
| 24 | * holders shall not be used in advertising or otherwise to promote the     * | 
|---|
| 25 | * sale, use or other dealings in this Software without prior written       * | 
|---|
| 26 | * authorization.                                                           * | 
|---|
| 27 | ****************************************************************************/ | 
|---|
| 28 |  | 
|---|
| 29 | /**************************************************************************** | 
|---|
| 30 | *   Author:  Juergen Pfeifer, 1995,1997                                    * | 
|---|
| 31 | ****************************************************************************/ | 
|---|
| 32 |  | 
|---|
| 33 | /* $Id: menu.priv.h,v 1.22 2005/01/16 01:02:23 tom Exp $ */ | 
|---|
| 34 |  | 
|---|
| 35 | /*************************************************************************** | 
|---|
| 36 | * Module menu.priv.h                                                       * | 
|---|
| 37 | * Top level private header file for all libnmenu modules                   * | 
|---|
| 38 | ***************************************************************************/ | 
|---|
| 39 |  | 
|---|
| 40 | #ifndef MENU_PRIV_H_incl | 
|---|
| 41 | #define MENU_PRIV_H_incl 1 | 
|---|
| 42 |  | 
|---|
| 43 | #include "curses.priv.h" | 
|---|
| 44 | #include "mf_common.h" | 
|---|
| 45 | #include "menu.h" | 
|---|
| 46 |  | 
|---|
| 47 | /* Backspace code */ | 
|---|
| 48 | #define BS (8) | 
|---|
| 49 |  | 
|---|
| 50 | extern NCURSES_EXPORT_VAR(ITEM) _nc_Default_Item; | 
|---|
| 51 | extern NCURSES_EXPORT_VAR(MENU) _nc_Default_Menu; | 
|---|
| 52 |  | 
|---|
| 53 | /* Normalize item to default if none was given */ | 
|---|
| 54 | #define Normalize_Item( item ) ((item)=(item)?(item):&_nc_Default_Item) | 
|---|
| 55 |  | 
|---|
| 56 | /* Normalize menu to default if none was given */ | 
|---|
| 57 | #define Normalize_Menu( menu ) ((menu)=(menu)?(menu):&_nc_Default_Menu) | 
|---|
| 58 |  | 
|---|
| 59 | /* Get the user defined (framing) window of the menu */ | 
|---|
| 60 | #define Get_Menu_UserWin(menu) ((menu)->userwin ? (menu)->userwin : stdscr) | 
|---|
| 61 |  | 
|---|
| 62 | /* Normalize menu window */ | 
|---|
| 63 | #define Get_Menu_Window(  menu ) \ | 
|---|
| 64 | ((menu)->usersub  ? (menu)->usersub  : Get_Menu_UserWin(menu)) | 
|---|
| 65 |  | 
|---|
| 66 | /* menu specific status flags */ | 
|---|
| 67 | #define _LINK_NEEDED    (0x04) | 
|---|
| 68 | #define _MARK_ALLOCATED (0x08) | 
|---|
| 69 |  | 
|---|
| 70 | #define ALL_MENU_OPTS (                 \ | 
|---|
| 71 | O_ONEVALUE     | \ | 
|---|
| 72 | O_SHOWDESC     | \ | 
|---|
| 73 | O_ROWMAJOR     | \ | 
|---|
| 74 | O_IGNORECASE   | \ | 
|---|
| 75 | O_SHOWMATCH    | \ | 
|---|
| 76 | O_NONCYCLIC    ) | 
|---|
| 77 |  | 
|---|
| 78 | #define ALL_ITEM_OPTS (O_SELECTABLE) | 
|---|
| 79 |  | 
|---|
| 80 | /* Move to the window position of an item and draw it */ | 
|---|
| 81 | #define Move_And_Post_Item(menu,item) \ | 
|---|
| 82 | {wmove((menu)->win,(menu)->spc_rows*(item)->y,((menu)->itemlen+(menu)->spc_cols)*(item)->x);\ | 
|---|
| 83 | _nc_Post_Item((menu),(item));} | 
|---|
| 84 |  | 
|---|
| 85 | #define Move_To_Current_Item(menu,item) \ | 
|---|
| 86 | if ( (item) != (menu)->curitem)\ | 
|---|
| 87 | {\ | 
|---|
| 88 | Move_And_Post_Item(menu,item);\ | 
|---|
| 89 | Move_And_Post_Item(menu,(menu)->curitem);\ | 
|---|
| 90 | } | 
|---|
| 91 |  | 
|---|
| 92 | /* This macro ensures, that the item becomes visible, if possible with the | 
|---|
| 93 | specified row as the top row of the window. If this is not possible, | 
|---|
| 94 | the top row will be adjusted and the value is stored in the row argument. | 
|---|
| 95 | */ | 
|---|
| 96 | #define Adjust_Current_Item(menu,row,item) \ | 
|---|
| 97 | { if ((item)->y < row) \ | 
|---|
| 98 | row = (item)->y;\ | 
|---|
| 99 | if ( (item)->y >= (row + (menu)->arows) )\ | 
|---|
| 100 | row = ( (item)->y < ((menu)->rows - row) ) ? \ | 
|---|
| 101 | (item)->y : (menu)->rows - (menu)->arows;\ | 
|---|
| 102 | _nc_New_TopRow_and_CurrentItem(menu,row,item); } | 
|---|
| 103 |  | 
|---|
| 104 | /* Reset the match pattern buffer */ | 
|---|
| 105 | #define Reset_Pattern(menu) \ | 
|---|
| 106 | { (menu)->pindex = 0; \ | 
|---|
| 107 | (menu)->pattern[0] = '\0'; } | 
|---|
| 108 |  | 
|---|
| 109 | #define UChar(c)        ((unsigned char)(c)) | 
|---|
| 110 |  | 
|---|
| 111 | /* Internal functions. */ | 
|---|
| 112 | extern NCURSES_EXPORT(void) _nc_Draw_Menu (const MENU *); | 
|---|
| 113 | extern NCURSES_EXPORT(void) _nc_Show_Menu (const MENU *); | 
|---|
| 114 | extern NCURSES_EXPORT(void) _nc_Calculate_Item_Length_and_Width (MENU *); | 
|---|
| 115 | extern NCURSES_EXPORT(int)  _nc_Calculate_Text_Width(const TEXT *); | 
|---|
| 116 | extern NCURSES_EXPORT(void) _nc_Post_Item (const MENU *, const ITEM *); | 
|---|
| 117 | extern NCURSES_EXPORT(bool) _nc_Connect_Items (MENU *, ITEM **); | 
|---|
| 118 | extern NCURSES_EXPORT(void) _nc_Disconnect_Items (MENU *); | 
|---|
| 119 | extern NCURSES_EXPORT(void) _nc_New_TopRow_and_CurrentItem (MENU *,int, ITEM *); | 
|---|
| 120 | extern NCURSES_EXPORT(void) _nc_Link_Items (MENU *); | 
|---|
| 121 | extern NCURSES_EXPORT(int)  _nc_Match_Next_Character_In_Item_Name (MENU*,int,ITEM**); | 
|---|
| 122 | extern NCURSES_EXPORT(int)  _nc_menu_cursor_pos (const MENU* menu, const ITEM* item, | 
|---|
| 123 | int* pY, int* pX); | 
|---|
| 124 |  | 
|---|
| 125 | #ifdef TRACE | 
|---|
| 126 |  | 
|---|
| 127 | #define returnItem(code)        TRACE_RETURN(code,item) | 
|---|
| 128 | #define returnItemPtr(code)     TRACE_RETURN(code,item_ptr) | 
|---|
| 129 | #define returnItemOpts(code)    TRACE_RETURN(code,item_opts) | 
|---|
| 130 | #define returnMenu(code)        TRACE_RETURN(code,menu) | 
|---|
| 131 | #define returnMenuHook(code)    TRACE_RETURN(code,menu_hook) | 
|---|
| 132 | #define returnMenuOpts(code)    TRACE_RETURN(code,menu_opts) | 
|---|
| 133 |  | 
|---|
| 134 | extern NCURSES_EXPORT(ITEM *)       _nc_retrace_item (ITEM *); | 
|---|
| 135 | extern NCURSES_EXPORT(ITEM **)      _nc_retrace_item_ptr (ITEM **); | 
|---|
| 136 | extern NCURSES_EXPORT(Item_Options) _nc_retrace_item_opts (Item_Options); | 
|---|
| 137 | extern NCURSES_EXPORT(MENU *)       _nc_retrace_menu (MENU *); | 
|---|
| 138 | extern NCURSES_EXPORT(Menu_Hook)    _nc_retrace_menu_hook (Menu_Hook); | 
|---|
| 139 | extern NCURSES_EXPORT(Menu_Options) _nc_retrace_menu_opts (Menu_Options); | 
|---|
| 140 |  | 
|---|
| 141 | #else /* !TRACE */ | 
|---|
| 142 |  | 
|---|
| 143 | #define returnItem(code)        return code | 
|---|
| 144 | #define returnItemPtr(code)     return code | 
|---|
| 145 | #define returnItemOpts(code)    return code | 
|---|
| 146 | #define returnMenu(code)        return code | 
|---|
| 147 | #define returnMenuHook(code)    return code | 
|---|
| 148 | #define returnMenuOpts(code)    return code | 
|---|
| 149 |  | 
|---|
| 150 | #endif /* TRACE/!TRACE */ | 
|---|
| 151 |  | 
|---|
| 152 | #endif /* MENU_PRIV_H_incl */ | 
|---|