comparison src/aci2/bmi/MmiMenu.h @ 3:93999a60b835

src/aci2, src/condat2: import of g23m/condat source pieces from TCS211
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 26 Sep 2016 00:29:36 +0000
parents
children
comparison
equal deleted inserted replaced
2:c41a534f33c6 3:93999a60b835
1 #ifndef _MMI_MENU_H_
2 #define _MMI_MENU_H_ 1
3
4 /*******************************************************************************
5
6 CONDAT (UK)
7
8 ********************************************************************************
9
10 This software product is the property of Condat (UK) Ltd and may not be
11 disclosed to any third party without the express permission of the owner.
12
13 ********************************************************************************
14
15 $Project name: Basic MMI
16 $Project code: BMI (6349)
17 $Module: Menus
18 $File: MmiMenu.h
19 $Revision: 1.0
20
21 $Author: Condat(UK)
22 $Date: 25/10/00
23
24 ********************************************************************************
25
26 Description:
27
28 This provides the implementation of the main menu handling for the basic
29 MMI
30
31 ********************************************************************************
32 $History: MmiMenu.h
33
34 25/10/00 Original Condat(UK) BMI version.
35
36 $End
37
38 *******************************************************************************/
39
40
41 /*******************************************************************************
42
43 Public Definitions
44
45 *******************************************************************************/
46
47 #define ALLOC_MEMORY mfwAlloc
48 #define FREE_MEMORY mfwFree
49
50
51 typedef void ( *SimMenuFunc )( MfwHnd window );
52
53
54 /* Reason definitions
55 */
56 // RAVI - COMMENTED - NOT USED IN ANY PLACE - 24-11-2005
57 //typedef enum
58 //{
59 // MenuNone = MenuDummy, /* no reason */
60 // MenuNormal, /* normal menu mode */
61 // MenuDone /* done with menu */
62 //};
63
64
65 /* How is the menu being accessed
66 */
67 //typedef enum
68 //{
69 // MenuAccess,
70 // HotKeyAccess
71 //};
72
73
74 /*******************************************************************************
75
76 Public Prototypes
77
78 *******************************************************************************/
79
80 /* Standard menu initialise, exit and handler routines
81 */
82 void menuInit( MfwHnd parent );
83 void menuExit( void );
84 void menuEnter( void );
85
86
87 /* Following functinos are provided to allow dynamic menu
88 construction tables to be generated by other modules
89 */
90 EXTERN USHORT item_flag_none( struct MfwMnuTag * m, struct MfwMnuAttrTag * ma, struct MfwMnuItemTag * mi );
91 //xpradipg - Aug 4:changes for WAP2.0 Menu
92 EXTERN USHORT item_flag_WAP_2_0( struct MfwMnuTag * m, struct MfwMnuAttrTag * ma, struct MfwMnuItemTag * mi );
93 EXTERN USHORT item_flag_hide( T_MFW_MNU * m, T_MFW_MNU_ATTR * ma, T_MFW_MNU_ITEM * mi );
94 EXTERN int menuSimItemCallback( MfwMnu* m, MfwMnuItem* i );
95
96
97 /* Display the soft keys associated with the menu window
98 */
99 void showMenuSoftkeys( void );
100
101
102 /* Returns 1 if the menu window has the focus, else returns 0.
103 */
104 int menuIsFocussed( void );
105
106
107 /* Make the menu window (if it exists) the top window.
108 */
109 void menuRaise( void );
110
111
112 /* If possible go <levels> steps up the menu tree.
113 */
114 void menuPop( int levels );
115
116
117 /* Go to the root level and then exit the main menu in an orderly fasion.
118 Can only be called when the user is logically somewhere in the main menu tree,
119 e.g. _after_ fully exiting an application invoked by the main menu, and
120 this includes DYI sub-menu(tree)s of the main menu.
121 */
122 void menuDropOut( void );
123
124
125 /* Unhides the SIM toolkit menu item, using <label> as the label.
126 If <label> is NULL, the default label is used.
127 If the SIM toolkit menu item is invoked by the user, <simCallback>
128 gets called with argument <simWindow>, unless <simCallback> is NULL.
129 */
130 void menuEnableSimMenu( char *label, SimMenuFunc simCallback, MfwHnd simWindow );
131
132
133 /* Hides the SIM toolkit menu item.
134 */
135 void menuDisableSimMenu( void );
136
137 /* From where was the menu accessed?
138 */
139 void menuAccessFrom( U8 source );
140
141
142 /*******************************************************************************
143
144 Developmental
145
146 *******************************************************************************/
147
148 /* Following definitions are provided for development use only
149 */
150 #ifdef MMI_UNDER_DEVELOPMENT
151
152 int mmiMenuNotImplemented( MfwMnu* m, MfwMnuItem* i );
153 void mmiMenuNotImplementedCB( T_MFW_HND win, UBYTE identifier, UBYTE reason );
154
155 #endif
156
157
158
159 /*******************************************************************************
160
161 End of File
162
163 *******************************************************************************/
164
165 #endif
166