| class CAknAppUi : public CAknAppUiBase |
Abstract Avkon application UI class
S60 0.9
| Protected Member Functions | |
|---|---|
| void | DecideWsClientBufferSizesL() |
| IMPORT_C void | HandleErrorL(TInt, HBufC **, TBool) |
| IMPORT_C void | HandleForegroundEventL(TBool) |
| IMPORT_C void | HandleStatusPaneSizeChange() |
| IMPORT_C void | HandleSystemEventL(const TWsEvent &) |
| IMPORT_C void | HandleWsEventL(const TWsEvent &, CCoeControl *) |
| IMPORT_C void | Reserved_MtsmObject() |
| IMPORT_C void | Reserved_MtsmPosition() |
| IMPORT_C void | SetKeyBlockMode(TAknKeyBlockMode) |
| Private Member Functions | |
|---|---|
| TBool | ExitHidesInBackgroundL() |
| TBool | SimulateHashKeyMarkingEvent(const TWsEvent &) |
| void | UpdateKeyBlockMode() |
| Inherited Enumerations | |
|---|---|
| CAknAppUiBase:@169 | |
| CAknAppUiBase:TAppUiOrientation | |
| CAknAppUiBase:TKeyEventFlag | |
| CEikAppUi:@154 | |
| Private Attributes | |
|---|---|
| CAknAppShutter * | iAppShutter |
| TAknKeyBlockMode | iBlockMode |
| TBool | iDumpNextControl |
| CAknAppUiExtension * | iExtension |
| Inherited Attributes | |
|---|---|
| CCoeAppUi::iCoeEnv | |
| CEikAppUi::iContainerAppUi | |
| CEikAppUi::iDocument | |
| CEikAppUi::iDoorObserver | |
| CEikAppUi::iEmbeddedAndReadOnly | |
| CEikAppUi::iFlags | |
| IMPORT_C void | BaseConstructL | ( | TInt | aAppUiFlags = EStandardApp | ) |
Initialises this Avkon app UI with standard values. aAppUiFlags values are common with CEikAppUi::BaseConstructL(aAppUiFlags). Additionally those aAppUiFlags values can be bitwise ORed with EAknEnableSkin flag to provide default skin parameters for this AppUi instance.
| TInt aAppUiFlags = EStandardApp | Application user interface flags. |
| IMPORT_C TInt32 | CaptureKey | ( | TUint | aKeycode, |
| TUint | aModifierMask, | |||
| TUint | aModifier | |||
| ) | ||||
This is same as RWindowGroup::CaptureKey, except that this version takes S60 keymappings into account and captures the key that produces requested aKeyCode according to S60 keymappings. Standard RWindowgroup::CaptureKey functionality takes place before S60 AppUi framework and has no knowledge of S60 keymappings. Note: This method requires same capabilites as RWindowGroup::CaptureKey()
S60 V3.2
A handle identifying the capture key, or one of the system-wide error codes (if <0). Handles should be kept in order to be passed to CancelCaptureKey() later.
| TUint aKeycode | The key code for the key to be captured. Key codes for special keys are defined in TKeyCode. |
| TUint aModifierMask | |
| TUint aModifier | The key is captured only when the modifier keys specified in aModifierMask match these states, where 1=modifier set, and 0=modifier not set. Modifier key states are defined in TEventModifier. |
| IMPORT_C void | CaptureKeyL | ( | TUint | aKeycode, |
| TUint | aModifierMask, | |||
| TUint | aModifier, | |||
| TInt32 & | aHandle | |||
| ) | ||||
This is same as RWindowGroup::CaptureKey, except that this version takes S60 keymappings into account and captures the key that produces requested aKeyCode according to S60 keymappings. This version leaves instead of returning an error code. Standard RWindowgroup::CaptureKey functionality takes place before S60 AppUi framework and has no knowledge of S60 keymappings. Note: This method requires same capabilites as RWindowGroup::CaptureKey()
S60 V3.2
| TUint aKeycode | The key code for the key to be captured. Key codes for special keys are defined in TKeyCode. |
| TUint aModifierMask | |
| TUint aModifier | The key is captured only when the modifier keys specified in aModifierMask match these states, where 1=modifier set, and 0=modifier not set. Modifier key states are defined in TEventModifier. |
| TInt32 & aHandle | identifying the capture key. Handles should be kept in order to be passed to CancelCaptureKey() later. |
| IMPORT_C CEikButtonGroupContainer * | Cba | ( | ) |
Gets a pointer to the Command Button Area. Pointer to the CBA
| IMPORT_C void | ConstructL | ( | ) | [virtual] |
From CEikAppUi. Completes construction. The implementation of ConstructL() in CAknAppUi simply calls BaseConstructL().
| IMPORT_C CAknToolbar * | CurrentFixedToolbar | ( | ) | const |
Gets a pointer to the current fixed toolbar( view toolbar is priority ). Pointer to the current fixed toolbar or NULL
S60 5.0
| IMPORT_C CAknToolbar * | CurrentPopupToolbar | ( | ) | const |
Gets a pointer to the current toolbar( view toolbar is priority ). Pointer to the current toolbar or NULL
S60 3.1
| void | DecideWsClientBufferSizesL | ( | ) | [protected] |
Try to set window server buffer size to KAknDefaultWsBufferSize.
| IMPORT_C void | DisableNextKeySound | ( | TInt | aScanCode | ) |
Disables next key sound (and repeated key sounds until pointer up event).
S60 V5.0
| TInt aScanCode | Scan code of disabled key. |
| IMPORT_C TBool | ExitHidesInBackground | ( | ) | const |
This tells the application if it is allowed to hide itself in the background in response to a user (menu or softkey) exit command, instead of actually exiting. If the application appears to exit, but actually leaves itself in memory, it may appear to start faster next time the user activates it.
S60 V5.0
ETrue if the application can hide itself in the background, EFalse if it must exit properly by calling Exit().
| IMPORT_C void | GetAliasKeyCodeL | ( | TUint & | aCode, |
| const TKeyEvent & | aKeyEvent, | |||
| TEventCode | aType | |||
| ) | ||||
Gets keyboard layout specific keycode. Uses given resolver SetAliasKeyCodeResolverL() if set, by default fetches alternative code from avkon server.
S60 3.1
| TUint & aCode | reference to variable to contain new keycode |
| const TKeyEvent & aKeyEvent | reference to original, complete, event |
| TEventCode aType | indicating original event type |
| IMPORT_C TErrorHandlerResponse | HandleError | ( | TInt | aError, |
| const SExtendedError & | aExtErr, | |||
| TDes & | aErrorText, | |||
| TDes & | aContextText | |||
| ) | [virtual] | |||
Handles errors. ENoDisplay if Error handled proper way, else EErrorNotHandled
| TInt aError | The error code. |
| const SExtendedError & aExtErr | For extended error messages. Not used. |
| TDes & aErrorText | Error text. Not used. |
| TDes & aContextText | Text describing the context of the error. Not used. |
| IMPORT_C void | HandleErrorL | ( | TInt | aError, |
| HBufC ** | aErrorDesc, | |||
| TBool | aShowNote = ETrue | |||
| ) | [protected] | |||
| IMPORT_C void | HandleForegroundEventL | ( | TBool | aForeground | ) | [protected, virtual] |
Handles changes in keyboard focus when an application switches to, or from, the foreground.
| TBool aForeground | ETrue if the application is in the foreground, otherwise EFalse. |
| IMPORT_C void | HandleStatusPaneSizeChange | ( | ) | [protected] |
From MEikStatusPaneObserver. Handles a change in the position or size of the screen area occupied by the status pane.
| IMPORT_C void | HandleSystemEventL | ( | const TWsEvent & | aEvent | ) | [protected, virtual] |
From CCoeAppUi. Handles system events generated by the window server.
| const TWsEvent & aEvent | The window server event that occurred. |
| IMPORT_C void | HandleTouchPaneSizeChange | ( | ) |
From . Handles a change in the size or position of touch pane.
| IMPORT_C void | HandleViewDeactivation | ( | const TVwsViewId & | aViewIdToBeDeactivated, |
| const TVwsViewId & | aNewlyActivatedViewId | |||
| ) | [virtual] | |||
From MCoeViewDeactivationObserver. Handles the deactivation of the view identified by aViewIdToBeDeactivated before the newly activated view with id aNewlyActivatedViewId is marked as current. Default implementation calls iAvkonEnv->CloseAllIntermediateStates() without using aViewIdToBeDeactivated and aNewlyActivatedViewId.
| const TVwsViewId & aViewIdToBeDeactivated | |
| const TVwsViewId & aNewlyActivatedViewId |
| IMPORT_C void | HandleWsEventL | ( | const TWsEvent & | aEvent, |
| CCoeControl * | aDestination | |||
| ) | [protected, virtual] | |||
Handles window server events.
| const TWsEvent & aEvent | The window server event that occurred. |
| CCoeControl * aDestination | The control associated with the event. |
| IMPORT_C void | HideApplicationFromFSW | ( | TBool | aHide = ETrue | ) |
Hide application from Fast-swap window. S60 2.6
| TBool aHide = ETrue | ETrue if application is hided from Fast-swap window, otherwise EFalse |
| IMPORT_C void | HideInBackground | ( | ) |
Hide the running instance of this application from the user, which makes it appear as if the application has exited. This is done by placing the application in the background, behind all other apps, and removing the application from the Fast Swap Window. When the application comes to the foreground again, it will be restored to the Fast Swap Window (in HandleForegroundEventL). If the application is not supposed to be in the Fast Swap Window, it will have to remove itself again. S60 V5.0
| TBool | IsAppHiddenInBackground | ( | ) | const |
Determines whether the application is hidden in background. (i.e. HideInBackground has been called and application has not yet been activated) ETrue if application is hidden in background.
| IMPORT_C TBool | IsAppShutterRunning | ( | ) | const |
Determines whether the application shutter is active. ETrue if application shutter is active.
| IMPORT_C CAknToolbar * | PopupToolbar | ( | ) | const |
Gets a pointer to the application toolbar. Pointer to the applicaton toolbar or NULL
S60 3.1
| IMPORT_C void | PrepareToExit | ( | ) | [virtual] |
From CCoeAppUiBase. Performs pre-exit processing to ensure the application will exit cleanly.
| IMPORT_C void | ProcessCommandL | ( | TInt | aCommand | ) |
Processes user commands. This function passes aCommand (except values EAknSoftkeyOptions, EAknCmdExit, EEikCmdCanceled) to user derived HandleCommandL.
| TInt aCommand | A command ID. |
| IMPORT_C void | SetAliasKeyCodeResolverL | ( | MAknAliasKeyCodeResolver * | aResolver | ) |
Sets custom resolver for keycode aliases Creates iExtension if it doesn't exist S60 3.1
| MAknAliasKeyCodeResolver * aResolver |
| IMPORT_C void | SetKeyBlockMode | ( | TAknKeyBlockMode | aMode | ) | [protected] |
Set key block mode. In default mode, the S60 Developer Platform blocks simultaneous key presses.
| TAknKeyBlockMode aMode | ENoKeyBlock if no key block, otherwise EDefaultBlockMode |
| TBool | SimulateHashKeyMarkingEvent | ( | const TWsEvent & | aEvent | ) | [private] |
| const TWsEvent & aEvent |
| IMPORT_C CEikStatusPane * | StatusPane | ( | ) |
Gets a pointer to the status pane. Pointer to the status pane
| void | StopDisplayingPopupToolbar | ( | ) |
Hides popup toolbar if it is visible S60 3.1
| IMPORT_C CAknTouchPane * | TouchPane | ( | ) |
Gets a pointer to the touch pane. Pointer to the the touch pane
S60 5.0