class CEikAppUi : public CCoeAppUi |
Handles application-wide aspects of the application's user interface such as the menu bar, toolbar pop-up menus, opening and closing files and exiting the application cleanly.
Every GUI application should use its own class derived from CEikAppUi.
An app UI's main role is to handle commands, in its HandleCommandL() function. These may be invoked using the menu bar, toolbar, or hotkeys; the commands that an app UI handles are specified in the application's resource file.
In addition, the app UI normally needs to respond to other kinds of events, by providing suitable implementations of the following virtual functions, all inherited from CCoeAppUi:
HandleKeyEventL(): Key events.
HandleForegroundEventL(): Application switched to foreground.
HandleSwitchOnEventL(): Machine switched on.
HandleSystemEventL(): System events.
HandleApplicationSpecificEventL(): Application-specific events.
Protected Member Functions | |
---|---|
IMPORT_C void | BaseConstructL(TInt) |
IMPORT_C void | ClosePopup() |
IMPORT_C void | CreateHotKeyControlL(TInt) |
IMPORT_C void | Exit() |
IMPORT_C void | HandleApplicationSpecificEventL(TInt, const TWsEvent &) |
IMPORT_C void | HandleForegroundEventL(TBool) |
IMPORT_C MCoeMessageObserver::TMessageResponse | HandleMessageL(TUint32, TUid, const TDesC8 &) |
IMPORT_C void | HandleScreenDeviceChangedL() |
IMPORT_C void | HandleSideBarMenuL(TInt, const TPoint &, TInt, const CEikHotKeyTable *) |
IMPORT_C void | HandleSystemEventL(const TWsEvent &) |
IMPORT_C void | HandleWsEventL(const TWsEvent &, CCoeControl *) |
IMPORT_C MObjectProvider * | MopNext() |
IMPORT_C TTypeUid::Ptr | MopSupplyObject(TTypeUid) |
IMPORT_C void | ProcessCommandL(TInt) |
IMPORT_C TBool | ProcessCommandParametersL(TApaCommand, TFileName &) |
IMPORT_C void | ReadAppInfoResourceL(TInt) |
IMPORT_C void | SaveAnyChangesL() |
IMPORT_C void | SaveL() |
IMPORT_C void | SetDocChanged() |
Private Member Functions | |
---|---|
void | CreateResourceIndependentFurnitureL() |
IMPORT_C void | Reserved_3() |
IMPORT_C void | Reserved_4() |
IMPORT_C void | SetEmphasis(CCoeControl *, TBool) |
TBool | ValidFileExistsL(const TDesC &) |
IMPORT_C TBool | ValidFileType(TUid) |
Public Member Enumerations | |
---|---|
enum | anonymous { EStandardApp = 0x00, ENoAppResourceFile = 0x01, ENonStandardResourceFile = 0x02, ENoScreenFurniture = 0x04, ELastReservedEikAppUiFlag = 0x8000 } |
Private Member Enumerations | |
---|---|
enum | anonymous { EEmbedded = 0x01 } |
Protected Attributes | |
---|---|
CEikAppUi * | iContainerAppUi |
CEikDocument * | iDocument |
MApaEmbeddedDocObserver * | iDoorObserver |
TBool | iEmbeddedAndReadOnly |
TInt | iFlags |
Private Attributes | |
---|---|
CEikAppUiExtra * | iAppUiExtra |
Inherited Attributes | |
---|---|
CCoeAppUi::iCoeEnv |
IMPORT_C void | BaseConstructL | ( | TInt | aAppUiFlags = 0 | ) | [protected] |
TInt aAppUiFlags = 0 |
CEikAppUi * | ContainerAppUi | ( | ) | const [inline] |
Returns the app UI inside which this app UI is embedded. Embedded app UIs are used for editing embedded documents.
A pointer to this object's container app UI. NULL if this app UI is not embedded
IMPORT_C void | CreateFileL | ( | const TDesC & | aFileName | ) | [virtual] |
const TDesC & aFileName |
IMPORT_C void | CreateHotKeyControlL | ( | TInt | aResourceId | ) | [protected] |
TInt aResourceId |
IMPORT_C void | HandleApplicationSpecificEventL | ( | TInt | aType, |
const TWsEvent & | aEvent | |||
) | [protected, virtual] |
IMPORT_C TErrorHandlerResponse | HandleError | ( | TInt | aError, |
const SExtendedError & | aExtErr, | |||
TDes & | aErrorText, | |||
TDes & | aContextText | |||
) | [virtual] |
TInt aError | |
const SExtendedError & aExtErr | |
TDes & aErrorText | |
TDes & aContextText |
IMPORT_C void | HandleForegroundEventL | ( | TBool | aForeground | ) | [protected, virtual] |
TBool aForeground |
IMPORT_C MCoeMessageObserver::TMessageResponse | HandleMessageL | ( | TUint32 | aClientHandleOfTargetWindowGroup, |
TUid | aMessageUid, | |||
const TDesC8 & | aMessageParameters | |||
) | [protected] |
IMPORT_C void | HandleResourceChangeL | ( | TInt | aType | ) | [virtual] |
TInt aType |
IMPORT_C void | HandleSideBarMenuL | ( | TInt | aResourceId, |
const TPoint & | aPos, | |||
TInt | aModifiers, | |||
const CEikHotKeyTable * | aTable | |||
) | [protected] |
IMPORT_C void | HandleSystemEventL | ( | const TWsEvent & | aEvent | ) | [protected, virtual] |
const TWsEvent & aEvent |
IMPORT_C void | HandleWsEventL | ( | const TWsEvent & | aEvent, |
CCoeControl * | aDestination | |||
) | [protected, virtual] |
const TWsEvent & aEvent | |
CCoeControl * aDestination |
IMPORT_C void | LaunchPopupMenuL | ( | TInt | aResourceId, |
const TPoint & | aTargetPos, | |||
TPopupTargetPosType | aTargetType, | |||
const CEikHotKeyTable * | aHotKeyTable = NULL | |||
) |
TInt aResourceId | |
const TPoint & aTargetPos | |
TPopupTargetPosType aTargetType | |
const CEikHotKeyTable * aHotKeyTable = NULL |
IMPORT_C TTypeUid::Ptr | MopSupplyObject | ( | TTypeUid | aId | ) | [protected, virtual] |
TTypeUid aId |
IMPORT_C void | OpenFileL | ( | const TDesC & | aFileName | ) | [virtual] |
const TDesC & aFileName |
IMPORT_C TBool | ProcessCommandParametersL | ( | TApaCommand | aCommand, |
TFileName & | aDocumentName, | |||
const TDesC8 & | aTail | |||
) | [virtual] |
TApaCommand aCommand | |
TFileName & aDocumentName | |
const TDesC8 & aTail |
IMPORT_C TBool | ProcessCommandParametersL | ( | CApaCommandLine & | aCommandLine | ) | [virtual] |
CApaCommandLine & aCommandLine |
IMPORT_C TBool | ProcessCommandParametersL | ( | TApaCommand | aCommand, |
TFileName & | aDocumentName | |||
) | [protected] |
TApaCommand aCommand | |
TFileName & aDocumentName |
IMPORT_C void | ProcessMessageL | ( | TUid | aUid, |
const TDesC8 & | aParams | |||
) | [virtual] |
IMPORT_C void | ReadAppInfoResourceL | ( | TInt | aResourceFileOffset = 0 | ) | [protected] |
TInt aResourceFileOffset = 0 |
IMPORT_C void | ReportResourceChangedToAppL | ( | TInt | aType | ) | [virtual] |
TInt aType |
IMPORT_C void | ReportResourceChangedToAppStackL | ( | CEikAppUi * | aTopApp, |
TInt | aEventId | |||
) |
IMPORT_C void | SetDocument | ( | CEikDocument * | aDocument | ) |
CEikDocument * aDocument |
IMPORT_C void | SetEmbeddedDocInfo | ( | MApaEmbeddedDocObserver * | aObserver, |
TBool | aReadOnly | |||
) |
MApaEmbeddedDocObserver * aObserver | |
TBool aReadOnly |
IMPORT_C void | SetEmphasis | ( | CCoeControl * | aMenuWindow, |
TBool | aEmphasis | |||
) | [private] |
CCoeControl * aMenuWindow | |
TBool aEmphasis |
TBool | ValidFileExistsL | ( | const TDesC & | aFileName | ) | [private] |
const TDesC & aFileName |
IMPORT_C TBool | ValidFileType | ( | TUid | aFileUid | ) | const [private, virtual] |
TUid aFileUid |
Application resource file and screen furniture flags, passed to BaseConstructL().
EStandardApp = 0x00 |
Application uses a standard resource file. |
ENoAppResourceFile = 0x01 |
Application has no resource file. |
ENonStandardResourceFile = 0x02 |
Application uses a different resource file from the standard. |
ENoScreenFurniture = 0x04 |
Application uses no screen furniture. |
ELastReservedEikAppUiFlag = 0x8000 |
Indicates the last value in the enum. |
CEikAppUi * | iContainerAppUi | [protected] |
A pointer to the containing app UI. This is NULL for non-embedded apps.
CEikDocument * | iDocument | [protected] |
A pointer to the application's document.
MApaEmbeddedDocObserver * | iDoorObserver | [protected] |
Embedded document observer.
TBool | iEmbeddedAndReadOnly | [protected] |
Indicates whether or not this is the app UI for an embedded, read-only document.