|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE task |
|
11 PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd"> |
|
12 <task id="GUID-244631CF-03F9-4C48-9802-682A76E9ECCC" xml:lang="en"><title>Hiding |
|
13 item-specific commands in submenus</title><shortdesc>This document describes the changes required to your application's |
|
14 code for hiding item-specific commands in submenus.</shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody> |
|
15 <steps-unordered id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-4-1-1-7-1-4-1-5-1-3-1"> |
|
16 <step id="GUID-8718D32E-27CA-4305-A5EB-4193AE78D630"><cmd>You can hide item-specific |
|
17 commands in submenus in either of the following ways:</cmd> |
|
18 <choices> |
|
19 <choice><p>Add the <codeph>EEikMenuItemSpecific</codeph> flag to submenu resource |
|
20 definitions. As a result, the submenu items are displayed in the stylus pop-up |
|
21 menu at the same level as main menu items.</p><codeblock xml:space="preserve">RESOURCE MENU_PANE r_calendarapiexample_entries_menu_option |
|
22 { |
|
23 items = |
|
24 { |
|
25 MENU_ITEM |
|
26 { |
|
27 command = ECalendarAPIexampleOption; |
|
28 txt = qtn_options_option; |
|
29 cascade = r_calendarapiexample_entries_menu; |
|
30 // ----Add the following line----- |
|
31 <b>flags = EEikMenuItemSpecific;</b> |
|
32 //-------------------------------------- |
|
33 }, |
|
34 MENU_ITEM |
|
35 { |
|
36 command = ECalendarAPIexampleDeleteAll; |
|
37 txt = qtn_options_delet_all; |
|
38 } |
|
39 }; |
|
40 } |
|
41 RESOURCE MENU_PANE r_calendarapiexample_entries_menu |
|
42 { |
|
43 items = |
|
44 { |
|
45 MENU_ITEM { command = ECalendarAPIexampleCmdDelete; txt = qtn_options_delete;} |
|
46 }; |
|
47 }</codeblock><p>For example, the following illustrations show how the |
|
48 item-specific submenu item (<uicontrol>Delete</uicontrol>) is hidden in the |
|
49 options menu and displayed in the stylus pop-up menu by setting the <codeph>EEikMenuItemSpecific</codeph> flag.</p><fig id="GUID-5B14DC3B-857A-4F79-9B47-4E00786386D8"> |
|
50 <title> Before setting the EEikMenuItemSpecific flag</title> |
|
51 <image href="GUID-B92B7DF8-0086-431F-91CE-6F193C045FB5_d0e2770_href.png" placement="inline"/> |
|
52 </fig><fig id="GUID-87A153E3-2451-4C2E-B998-5ACDB30C627E"> |
|
53 <title>After setting the EEikMenuItemSpecific flag</title> |
|
54 <image href="GUID-41A53C1F-E9BF-420F-A967-83906299FE8B_d0e2777_href.png" placement="inline"/> |
|
55 </fig></choice> |
|
56 <choice><p>Add the <codeph>EEikMenuItemSpecificListQuery</codeph> flag to |
|
57 submenu resource definitions. As a result, the submenu items are displayed |
|
58 in a list query dialog box within stylus pop-up menus.</p><codeblock xml:space="preserve">RESOURCE MENU_PANE r_calendarapiexample_entries_menu_option |
|
59 { |
|
60 items = |
|
61 { |
|
62 MENU_ITEM |
|
63 { |
|
64 command = ECalendarAPIexampleOption; |
|
65 txt = qtn_options_option; |
|
66 cascade = r_calendarapiexample_entries_menu; |
|
67 //----Add the following line---------- |
|
68 <b>flags = EEikMenuItemSpecificListQuery;</b> |
|
69 //--------------------------------------- |
|
70 }, |
|
71 MENU_ITEM |
|
72 { |
|
73 command = ECalendarAPIexampleDeleteAll; |
|
74 txt = qtn_options_delet_all; |
|
75 } |
|
76 }; |
|
77 } |
|
78 </codeblock><p>For example, the following illustration shows how the <uicontrol>Delete</uicontrol> command |
|
79 is displayed in the list query dialog box under <uicontrol>option</uicontrol> by |
|
80 setting the <codeph>EEikMenuItemSpecificListQuery</codeph> flag.</p><fig id="GUID-F158E9FA-11A5-485D-A5A1-B2C936FF1ABC"> |
|
81 <title>After setting the EEikMenuItemSpecificListQuery flag</title> |
|
82 <image href="GUID-2B820ED0-D0E1-4CF0-9D63-C91806EDB8F6_d0e2807_href.png" placement="inline"/> |
|
83 </fig></choice> |
|
84 </choices> |
|
85 </step> |
|
86 </steps-unordered> |
|
87 </taskbody></task> |