| class CEikMenuBar : public CEikBorderedControl |
Menu bars are constructed from MENU_BAR resources and issue application commands which should be handled by overriding CEikAppUi::HandleCommandL().
| Private Member Functions | |
|---|---|
| void | AddFEPMenuL() |
| void | AddMenuIfNotPresentL(TInt) |
| void | CloseState() |
| void | CreateTitleArrayL() |
| IMPORT_C void * | ExtensionInterface(TUid) |
| void | HideMenuPane() |
| IMPORT_C TCoeInputCapabilities | InputCapabilities() |
| TBool | MenuHasItems() |
| TBool | MenuHasPane() |
| TTypeUid::Ptr | MopSupplyObject(TTypeUid) |
| void | ProcessCommandL(TInt) |
| IMPORT_C void | Reserved_1() |
| IMPORT_C void | Reserved_2() |
| void | ResetTitleArray() |
| void | SaveCurrentMenuPositionL() |
| void | SetCursorPositionFromArray() |
| void | SetMenuHasItems() |
| void | SetMenuHasPane() |
| void | SetMenuPaneFlag(TInt) |
| void | StartDisplayingMenuBarL() |
| TBool | TitleArrayOwnedExternally() |
| void | UpdateTitleTextBaseline() |
| Public Member Enumerations | |
|---|---|
| enum | TMenuType { EMenuOptions = 0, EMenuContext = 1, EMenuEdit = 2, EMenuOptionsNoTaskSwapper = 3 } |
| Private Member Enumerations | |
|---|---|
| enum | TEikMenuFlags { ETitleArrayOwnedExternally = 0x01, EMenuHasItems = 0x02, EMenuHasPane = 0x04, EBackgroundFaded = 0x08, ESoundsInstalled = 0x10 } |
| Inherited Enumerations | |
|---|---|
| CCoeControl:TZoomType | |
| Inherited Attributes | |
|---|---|
| CCoeControl::iCoeEnv | |
| CCoeControl::iContext | |
| CCoeControl::iPosition | |
| CCoeControl::iSize | |
| CEikBorderedControl::iBorder | |
| void | AddMenuIfNotPresentL | ( | TInt | aResourceId | ) | [private] |
| TInt aResourceId |
| IMPORT_C void | ChangeMenuBarL | ( | TInt | aHotKeyResourceId = 0, |
| TInt | aMenuTitleResourceId = 0, | |||
| TInt | aDisplayNow = ETrue | |||
| ) | ||||
Not implemented
| IMPORT_C void | ConstructFromResourceL | ( | TResourceReader & | aReader | ) | [virtual] |
Second phase constructor for a menu bar which builds the menu bar from the given resource file.
| TResourceReader & aReader | The resource reader. |
| IMPORT_C void | ConstructL | ( | MEikMenuObserver * | aMenuObserver, |
| TInt | aHotKeyResourceId = 0, | |||
| TInt | aMenuTitleResourceId = 0 | |||
| ) | ||||
Second phase constructor for a menu bar.
| MEikMenuObserver * aMenuObserver | The menu's observer. |
| TInt aHotKeyResourceId = 0 | The ID of the resource, of type HOTKEY from which the hotkey table is created. This is optional. By default it's nil. |
| TInt aMenuTitleResourceId = 0 | The ID of the resource, of type MENU_BAR from which the menu title array is created. This is optional. By default it's nil. |
| IMPORT_C void | Draw | ( | const TRect & | aRect | ) | const [virtual] |
From CCoeControl
Not implemented.
| const TRect & aRect |
| IMPORT_C void * | ExtensionInterface | ( | TUid | aInterface | ) | [private, virtual] |
From CAknControl
| TUid aInterface |
| IMPORT_C void | FindCommandIdInResourceL | ( | TInt | aCommandId, |
| TInt & | aPaneindex, | |||
| TInt & | aItemindex | |||
| ) | [virtual] | |||
Searches for the menu item that corresponds to the specified command.
| IMPORT_C void | GetColorUseListL | ( | CArrayFix< TCoeColorUse > & | aColorUseList | ) | const [virtual] |
From CCoeControl.
Gets the list of logical colours used to draw the control.
The list includes an explanation of how each colour is used. By default, this function has an empty implementation.
5.1 SDK.
| CArrayFix< TCoeColorUse > & aColorUseList | The colour list. |
| IMPORT_C void | HandlePointerEventL | ( | const TPointerEvent & | aPointerEvent | ) | [virtual] |
From CCoeControl
Handles pointer events. This function gets called whenever a pointer event occurs in the control, i.e. when the pointer is within the control's extent, or when the control has grabbed the pointer. The control should implement this function to handle pointer events.
Note: events of type EButton1Down are processed before HandlePointerEventL() is called, in order to transfer keyboard focus to the control in which the EButton1Down event occurred.
If overriding HandlePointerEventL(), the implementation must include a base call to CCoeControl's HandlePointerEventL().
| const TPointerEvent & aPointerEvent | The pointer event. |
| IMPORT_C void | HandleResourceChange | ( | TInt | aType | ) | [virtual] |
From CCoeControl.
Handles a change to the control's resources.
The types of resources handled are those which are shared across the environment, e.g. colours or fonts.
5.1 SDK.
| TInt aType | A message UID value. The most common is KEikMessageColorSchemeChange which controls get when the colour scheme is changed. Other examples include: KEikMessageFadeAllWindows, KEikMessageUnfadeWindows, KEikMessageZoomChange, KEikMessageVirtualCursorStateChange, KEikMessageCapsLock, KEikMessagePrepareForSave. |
| CEikHotKeyTable * | HotKeyTable | ( | ) | const [inline] |
Gets a pointer to the menu s hot key table.
| IMPORT_C TBool | IsDisplayed | ( | ) |
Allows the client to determine if the menubar instance is displayed.
Etrue if displayed and EFalse if not.
| IMPORT_C TBool | ItemSpecificCommandsEnabled | ( | ) | const |
Returns ETrue when item specific commands are enabled in menu bar (main pane collection has a highlight) and EFalse when they are disabled (main pane collection does not have a highlight).
S60 5.2
ETrue when item specific commands are enabled.
| IMPORT_C CEikMenuPane * | MenuPane | ( | ) |
Gets a menu pane resource.
The pointer to CEikMenuPane object containing a menu pane resource.
| TTypeUid::Ptr | MopSupplyObject | ( | TTypeUid | aId | ) | [private] |
| TTypeUid aId |
| IMPORT_C void | MoveHighlightToL | ( | TInt | aNewSelectedTitle, |
| TInt | aNewSelectedItem = 0 | |||
| ) | ||||
Not implemented.
| IMPORT_C TKeyResponse | OfferKeyEventL | ( | const TKeyEvent & | aKeyEvent, |
| TEventCode | aType | |||
| ) | [virtual] | |||
From CCoeControl
Handles key events offered to the menu by the control environment and provides an appropriate implementation of CCoeControl::OfferKeyEventL().
Indicates whether or not the key event was used by this control.
| const TKeyEvent & aKeyEvent | The key event. |
| TEventCode aType | The type of key event: EEventKey, EEventKeyUp or EEventKeyDown. |
| CEikMenuPane * | PopulateItemActionMenuL | ( | CAknItemActionMenu & | aItemActionMenu | ) |
Populates item action menu.
| CAknItemActionMenu & aItemActionMenu |
| IMPORT_C void | ReduceRect | ( | TRect & | aRect | ) | const |
If the menu bar is visible, removes the menu bar height from the top of aRect and returns the new rectangle in a new value of aRect.
| TRect & aRect | A rectangle that on return is reduced in height by the height of the menu bar. |
| IMPORT_C void | RemoveEditMenuObserver | ( | MEikMenuObserver * | aEditMenuObserver | ) |
Sets the menu observer interface to NULL.
| MEikMenuObserver * aEditMenuObserver | Menu observer interface that will be set to NULL. |
| IMPORT_C TInt | SelectedItem | ( | ) |
Gets the index of the menu item selected by the cursor.
The index of the selected menu item.
| IMPORT_C TInt | SelectedTitle | ( | ) |
Gets the index of the menu pane selected by the cursor.
The index of the selected menu pane.
| IMPORT_C void | SetContextMenuTitleResourceId | ( | TInt | aMenuTitleResourceId | ) |
| TInt aMenuTitleResourceId |
| IMPORT_C void | SetEditMenuObserver | ( | MEikMenuObserver * | aEditMenuObserver | ) |
Sets menu observer interface.
| MEikMenuObserver * aEditMenuObserver | Menu observer interface. |
| IMPORT_C CEikHotKeyTable * | SetHotKeyTable | ( | CEikHotKeyTable * | aHotKeyTable | ) |
Not implemented!
NULL.
| CEikHotKeyTable * aHotKeyTable | Not used. |
| void | SetItemActionMenu | ( | CAknItemActionMenu * | aItemActionMenu | ) |
Sets item action menu instance to menu bar.
| CAknItemActionMenu * aItemActionMenu |
| IMPORT_C SCursor | SetMenuCursor | ( | const SCursor & | aCursor | ) |
Sets the cursor to the specifed menu pane and menu item.
A SCursor structure holding the menu item within the menu pane.
| const SCursor & aCursor | The menu pane and menu item to which the cursor is set. |
| IMPORT_C void | SetMenuTitleArray | ( | CTitleArray * | aTitleArray | ) |
Not implemented.
| CTitleArray * aTitleArray | Not used. |
| IMPORT_C void | SetMenuTitleResourceId | ( | TInt | aMenuTitleResourceId | ) |
Sets the menu s resource ID.
| TInt aMenuTitleResourceId | The ID of the resource to use. |
| IMPORT_C void | SetMenuType | ( | TMenuType | aMenuType | ) |
Sets type of the menu. Menu can be for example Options menu launched from Options softkey or context sensitive menu launched from the selection key. By default the launched menu is options menu. S60 3.1
| TMenuType aMenuType | One of values of CEikMenuBar::TMenuType enumeration. |
| IMPORT_C void | SetTitleArrayOwnedExternally | ( | TBool | aOwnedExternally | ) |
Not implemented.
| TBool aOwnedExternally | Not used. |
| IMPORT_C void | StopDisplayingMenuBar | ( | ) |
Stops displaying the menu bar.
This function causes the menu bar to disappear from the screen until it is invoked again by the user. In most circumstances this is done by the Uikon framework, so an application program will not normally need to use this function.
| IMPORT_C CTitleArray * | TitleArray | ( | ) |
Gets array of information about the menu bar titles.
Pointer to CTitleArray object containing array of information about menu bar titles.
| IMPORT_C void | TryDisplayMenuBarL | ( | ) |
Displays the menu bar.
If the menu is not already displayed, this function displays the menu bar and allows the user to make a selection. In most circumstances this is done by the Uikon framework, so an application program will not normally need to use this function.
| IMPORT_C void | TryDisplayMenuBarWithoutFepMenusL | ( | ) |
If the menu is not already displayed, this function displays the menu bar without fep menu and allows the user to make a selection. In most circumstances this is done by the Uikon framework, so an application program will not normally need to use this function.
| ETitleArrayOwnedExternally = 0x01 | |
| EMenuHasItems = 0x02 | |
| EMenuHasPane = 0x04 | |
| EBackgroundFaded = 0x08 | |
| ESoundsInstalled = 0x10 |
| EMenuOptions = 0 |
Options menu launched from the Options softkey. This is the default value. |
| EMenuContext = 1 |
Context sensitive menu that is launched from selection key when the application supports it. |
| EMenuEdit = 2 |
Edit menu containing editing specific items. |
| EMenuOptionsNoTaskSwapper = 3 |
Options menu launched from the Options softkey. Task swapper item is not shown. |
| CArrayFixFlat< SPosition > * | iPastMenuPosArray | [private] |