CAknViewAppUi Class Reference

class CAknViewAppUi : public CAknAppUi

Base class for view architecture-based applications.

Since
Series 60 0.9
Public Member Functions
~CAknViewAppUi()
IMPORT_C voidActivateLocalViewL(TUid)
IMPORT_C voidActivateLocalViewL(TUid, TUid, const TDesC8 &)
IMPORT_C voidAddViewL(CAknView *)
IMPORT_C voidBaseConstructL(TInt)
IMPORT_C voidEnableLocalScreenClearer(TBool)
IMPORT_C TUidFocusedView()
TKeyResponse HandleViewNavigationL(const TKeyEvent &)
NONSHARABLE_CLASS(CViewActivationItem)
NONSHARABLE_CLASS(TAknSplitViewContainer)
IMPORT_C voidProcessCommandL(TInt)
IMPORT_C voidRemoveSplitViewL(const TUid)
IMPORT_C voidRemoveView(TUid)
IMPORT_C voidSetSplitViewL(const TUid, const TUid, const TInt)
IMPORT_C TBoolSplitViewActive()
IMPORT_C voidStopDisplayingMenuBar()
IMPORT_C CAknView *View(TUid)
voidViewActivatedL(CAknView *, const TVwsViewId &, TUid, const TDesC8 &)
voidViewDeactivated(CAknView *)
TRect ViewRect(const TUid)
IMPORT_C TBoolViewShown(const TUid)
Protected Member Functions
IMPORT_C voidHandleForegroundEventL(TBool)
IMPORT_C voidHandleStatusPaneSizeChange()
IMPORT_C voidHandleWsEventL(const TWsEvent &, CCoeControl *)
Private Member Functions
voidActivateSplitViewL(CViewActivationItem *)
TInt ActivationCallBack(TAny *)
voidActivationTick()
CAknViewAppUiExtension *Extension()
voidQueueActivationTick()
TAknSplitViewContainer *SplitView(const TUid)
Inherited Functions
CAknAppUi::CaptureKey(TUint,TUint,TUint)
CAknAppUi::CaptureKeyL(TUint,TUint,TUint,TInt32 &)
CAknAppUi::Cba()
CAknAppUi::ConstructL()
CAknAppUi::CurrentFixedToolbar()const
CAknAppUi::CurrentPopupToolbar()const
CAknAppUi::DecideWsClientBufferSizesL()
CAknAppUi::DisableNextKeySound(TInt)
CAknAppUi::DumpControl(CCoeControl *,TInt,RDebug &)
CAknAppUi::ExitHidesInBackground()const
CAknAppUi::GetAliasKeyCodeL(TUint &,const TKeyEvent &,TEventCode)
CAknAppUi::HandleError(TInt,const SExtendedError &,TDes &,TDes &)
CAknAppUi::HandleErrorL(TInt,HBufC **,TBool)
CAknAppUi::HandleSystemEventL(const TWsEvent &)
CAknAppUi::HandleTouchPaneSizeChange()
CAknAppUi::HandleViewDeactivation(const TVwsViewId &,const TVwsViewId &)
CAknAppUi::HideApplicationFromFSW(TBool)
CAknAppUi::HideInBackground()
CAknAppUi::IsAppHiddenInBackground()const
CAknAppUi::IsAppShutterRunning()const
CAknAppUi::PopupToolbar()const
CAknAppUi::PrepareToExit()
CAknAppUi::Reserved_MtsmObject()
CAknAppUi::Reserved_MtsmPosition()
CAknAppUi::RunAppShutter()
CAknAppUi::SetAliasKeyCodeResolverL(MAknAliasKeyCodeResolver *)
CAknAppUi::SetKeyBlockMode(TAknKeyBlockMode)
CAknAppUi::StatusPane()
CAknAppUi::StopDisplayingPopupToolbar()
CAknAppUi::TouchPane()
CAknAppUi::~CAknAppUi()
CAknAppUiBase::ApplicationRect()const
CAknAppUiBase::ApplyLayoutChangeL(TBool)
CAknAppUiBase::CAknAppUiBase()
CAknAppUiBase::EventForForegroundState(TBool,TBool)
CAknAppUiBase::EventMonitor()const
CAknAppUiBase::Exit()
CAknAppUiBase::FindAppWgIdBelowMeL()
CAknAppUiBase::HandleApplicationSpecificEventL(TInt,const TWsEvent &)
CAknAppUiBase::HandleResourceChangeL(TInt)
CAknAppUiBase::HandleScreenDeviceChangedL()
CAknAppUiBase::HasFullOrPartialForeground()const
CAknAppUiBase::IsAppClosing()const
CAknAppUiBase::IsFaded()const
CAknAppUiBase::IsForeground()const
CAknAppUiBase::IsFullScreenApp()const
CAknAppUiBase::IsLayoutAwareApp()const
CAknAppUiBase::IsMSKEnabledApp()const
CAknAppUiBase::IsPartialForeground()const
CAknAppUiBase::IsSingleClickCompatible()const
CAknAppUiBase::IsTouchCompatible()const
CAknAppUiBase::KeySounds()const
CAknAppUiBase::LocalUiZoom()const
CAknAppUiBase::MopSupplyObject(TTypeUid)
CAknAppUiBase::Orientation()const
CAknAppUiBase::OrientationCanBeChanged()const
CAknAppUiBase::PointerEventModifier()
CAknAppUiBase::ReplaceKeySoundsL(TInt)
CAknAppUiBase::ScreenMode()const
CAknAppUiBase::SetFadedL(TBool)
CAknAppUiBase::SetFullScreenApp(TBool)
CAknAppUiBase::SetKeyEventFlags(const TInt)
CAknAppUiBase::SetLayoutAwareApp(TBool)
CAknAppUiBase::SetLocalUiZoom(TAknUiZoom)
CAknAppUiBase::SetOrientationL(TAppUiOrientation)
CAknAppUiBase::SetScreenModeL(TInt)
CAknAppUiBase::SimulateWsEventL(TInt)
CAknAppUiBase::ThreadIsForeground()const
CAknAppUiBase::~CAknAppUiBase()
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
CCoeAppUi::ActivateTopViewL()
CCoeAppUi::ActivateViewL(const TVwsViewId &)
CCoeAppUi::ActivateViewL(const TVwsViewId &,TUid,const TDesC8 &)
CCoeAppUi::AddToStackL(CCoeControl *,TInt,TInt)
CCoeAppUi::AddToStackL(const MCoeView &,CCoeControl *,TInt,TInt)
CCoeAppUi::AddToViewStackL(const MCoeView &,CCoeControl *,TInt,TInt)
CCoeAppUi::AddViewActivationObserverL(MCoeViewActivationObserver *)
CCoeAppUi::AddViewDeactivationObserverL(MCoeViewDeactivationObserver *)
CCoeAppUi::AddViewObserverL(MCoeViewObserver *)
CCoeAppUi::AppHelpContextL()const
CCoeAppUi::CCoeAppUi()
CCoeAppUi::CheckInitializeViewsL(TUid)
CCoeAppUi::CheckSourceOfViewSwitchL(const TSecurityPolicy &,const char *)const
CCoeAppUi::ConstructL(CCoeAppUi *)
CCoeAppUi::CreateActivateViewEventL(const TVwsViewId &,TUid,const TDesC8 &)
CCoeAppUi::DeactivateActiveViewIfOwnerMatchL()
CCoeAppUi::DeactivateActiveViewL()
CCoeAppUi::DeregisterApplicationView()
CCoeAppUi::DeregisterView(const MCoeView &)
CCoeAppUi::DeregisterViewAndRemoveStack(const MCoeView &)
CCoeAppUi::EnableExternalViewSwitches(TBool)
CCoeAppUi::FrameworkCallsRendezvous()const
CCoeAppUi::GetActiveViewId(TVwsViewId &)const
CCoeAppUi::GetDefaultViewId(TVwsViewId &)const
CCoeAppUi::GetSystemDefaultViewL(TVwsViewId &)
CCoeAppUi::GetTopViewId(TVwsViewId &)const
CCoeAppUi::HandleStackChanged()
CCoeAppUi::HandleStackedControlsResourceChange(TInt)
CCoeAppUi::InputCapabilities()const
CCoeAppUi::IsControlOnStack(CCoeControl *)const
CCoeAppUi::IsDisplayingControlBetweenPriorities(TInt,TInt)const
CCoeAppUi::IsDisplayingDialog()const
CCoeAppUi::IsDisplayingMenuOrDialog()const
CCoeAppUi::IsViewConstructed(const TVwsViewId &)const
CCoeAppUi::MonitorWsEvent(const TWsEvent &)
CCoeAppUi::NotifyFontChange(const CCoeFontProvider &)
CCoeAppUi::NotifyNextActivation(MCoeViewActivationObserver &)
CCoeAppUi::NotifyNextActivation(const TVwsViewId &,MCoeViewActivationObserver &)
CCoeAppUi::NotifyNextDeactivation(MCoeViewDeactivationObserver &)
CCoeAppUi::NotifyNextDeactivation(const TVwsViewId &,MCoeViewDeactivationObserver &)
CCoeAppUi::RefetchPixelMappingL()
CCoeAppUi::RegisterApplicationViewL(TUid)
CCoeAppUi::RegisterViewAndAddStackL(MCoeView &)
CCoeAppUi::RegisterViewL(MCoeView &)
CCoeAppUi::RemoveFromStack(CCoeControl *)
CCoeAppUi::RemoveFromViewStack(const MCoeView &,CCoeControl *)
CCoeAppUi::RemoveViewActivationObserver(MCoeViewActivationObserver *)
CCoeAppUi::RemoveViewDeactivationObserver(MCoeViewDeactivationObserver *)
CCoeAppUi::RemoveViewObserver(MCoeViewObserver *)
CCoeAppUi::SetApplicationViewAsDefaultL()
CCoeAppUi::SetCurrentControlStackGroupId(TInt)
CCoeAppUi::SetCustomControl(TInt)
CCoeAppUi::SetDefaultViewL(const MCoeView &)
CCoeAppUi::SetSystemDefaultViewL(const TVwsViewId &)
CCoeAppUi::SetSystemDefaultViewL(const TVwsViewId &,TInt)
CCoeAppUi::SetWindowGroupOrdinal(TInt)
CCoeAppUi::TopFocusedControl()const
CCoeAppUi::UpdateStackedControlFlags(CCoeControl *,TInt,TInt)
CCoeAppUi::UpdateViewServerBackgroundColor(const TRgb &)
CCoeAppUi::UpdateViewStackedControlFlags(const MCoeView &,CCoeControl *,TInt,TInt)
CCoeAppUi::WriteInternalStateOfStackedControlsL(RWriteStream &)const
CCoeAppUi::~CCoeAppUi()
CEikAppUi::AppUiExtra()
CEikAppUi::Application()const
CEikAppUi::ApplicationLanguageL()const
CEikAppUi::CEikAppUi()
CEikAppUi::ClientRect()const
CEikAppUi::ClosePopup()
CEikAppUi::ContainerAppUi()const
CEikAppUi::CreateFileL(const TDesC &)
CEikAppUi::CreateHotKeyControlL(TInt)
CEikAppUi::Document()const
CEikAppUi::FadeWhenInBackground()
CEikAppUi::HandleCommandL(TInt)
CEikAppUi::HandleMessageL(TUint32,TUid,const TDesC8 &)
CEikAppUi::HandleModelChangeL()
CEikAppUi::HandleSideBarMenuL(TInt,const TPoint &,TInt,const CEikHotKeyTable *)
CEikAppUi::LaunchPopupMenuL(TInt,const TPoint &,TPopupTargetPosType,const CEikHotKeyTable *)
CEikAppUi::MopNext()
CEikAppUi::OpenFileL(const TDesC &)
CEikAppUi::ProcessCommandParametersL(CApaCommandLine &)
CEikAppUi::ProcessCommandParametersL(TApaCommand,TFileName &)
CEikAppUi::ProcessCommandParametersL(TApaCommand,TFileName &,const TDesC8 &)
CEikAppUi::ProcessMessageL(TUid,const TDesC8 &)
CEikAppUi::ReadAppInfoResourceL(TInt)
CEikAppUi::ReportResourceChangedToAppL(TInt)
CEikAppUi::ReportResourceChangedToAppStackL(CEikAppUi *,TInt)
CEikAppUi::SaveAnyChangesL()
CEikAppUi::SaveL()
CEikAppUi::SetDocChanged()
CEikAppUi::SetDocument(CEikDocument *)
CEikAppUi::SetEmbeddedDocInfo(MApaEmbeddedDocObserver *,TBool)
CEikAppUi::SetFaded(TBool)
CEikAppUi::~CEikAppUi()
Inherited Enumerations
CAknAppUiBase:@206
CAknAppUiBase:TAppUiOrientation
CAknAppUiBase:TKeyEventFlag
CEikAppUi:@203
Public Member Type Definitions
typedef CArrayPtrFlat< CViewActivationItem > CAknViewActivationQueue
typedef CArrayPtrFlat< CAknView > CAknViews
Protected Attributes
CAknView *iView
CAknViews *iViews
Private Attributes
CAknViewActivationQueue *iActivationQueue
CIdle *iActivationTick
CAknLocalScreenClearer *iClearer
CAknViewAppUiExtension *iExtension
CAknViewShutter *iShutter
Inherited Attributes
CCoeAppUi::iCoeEnv
CEikAppUi::iContainerAppUi
CEikAppUi::iDocument
CEikAppUi::iDoorObserver
CEikAppUi::iEmbeddedAndReadOnly
CEikAppUi::iFlags

Constructor & Destructor Documentation

~CAknViewAppUi()

IMPORT_C~CAknViewAppUi()[virtual]

Destructor.

Member Functions Documentation

ActivateLocalViewL(TUid)

IMPORT_C voidActivateLocalViewL(TUidaViewId)

Activates a specified application view, without passing any message. The function leaves if activation of the view fails.

Parameters

TUid aViewIdIdentifier of the view to activate.

ActivateLocalViewL(TUid, TUid, const TDesC8 &)

IMPORT_C voidActivateLocalViewL(TUidaViewId,
TUidaCustomMessageId,
const TDesC8 &aCustomMessage
)

Activates a specified application view, then passes the message text descriptor aCustomMessage for a message of type aCustomMessageId. The function leaves if activation of the view fails.

Parameters

TUid aViewIdIdentifier of the view to activate.
TUid aCustomMessageIdSpecifies the message type.
const TDesC8 & aCustomMessageThe message passed to the activated view.

ActivateSplitViewL(CViewActivationItem *)

voidActivateSplitViewL(CViewActivationItem *aItem)[private]
Activates views in split view.
Since
Series 60 5.0

Parameters

CViewActivationItem * aItem

ActivationCallBack(TAny *)

TInt ActivationCallBack(TAny *aThis)[private, static]

Parameters

TAny * aThis

ActivationTick()

voidActivationTick()[private]

AddViewL(CAknView *)

IMPORT_C voidAddViewL(CAknView *aView)

Registers and adds the view to the app UI. This function calls CCoeAppUi::RegisterViewL.

Parameters

CAknView * aViewThe view to be registered and added.

BaseConstructL(TInt)

IMPORT_C voidBaseConstructL(TIntaAppUiFlags = EStandardApp)

Initialises this app UI with standard values.

Parameters

TInt aAppUiFlags = EStandardAppApplication user interface flags.

EnableLocalScreenClearer(TBool)

IMPORT_C voidEnableLocalScreenClearer(TBoolaEnable = ETrue)

Enables/disables local screen clearer. Local screen clearer is used in the view based applications to clear the application window if/when the view itself fails to do this. By default, the clearer is used. This function must be called before the BaseConstructL() to prevent the screen clearer on application start up.

Since
3.2

Parameters

TBool aEnable = ETrueETrue enables local screen clearer. EFalse disables local screen clearer.

Extension()

CAknViewAppUiExtension *Extension()const [private]

Asserts that extension object has been created.

FocusedView()

IMPORT_C TUidFocusedView()const
Returns the currently focused view.
Since
Series 60 5.0

HandleForegroundEventL(TBool)

IMPORT_C voidHandleForegroundEventL(TBoolaForeground)[protected, virtual]

From CCoeAppUi. Handles changes in keyboard focus when an application switches to foreground.

Parameters

TBool aForegroundETrue if the application is in the foreground, otherwise EFalse.

HandleStatusPaneSizeChange()

IMPORT_C voidHandleStatusPaneSizeChange()[protected]

From MEikStatusPaneObserver. Handles a change in the position or size of the screen area occupied by the status pane.

HandleViewNavigationL(const TKeyEvent &)

TKeyResponse HandleViewNavigationL(const TKeyEvent &aKeyEvent)
Handles keyboard initiated navigation between visible split views.
Since
Series 60 5.0

Parameters

const TKeyEvent & aKeyEventKeyboard event.

HandleWsEventL(const TWsEvent &, CCoeControl *)

IMPORT_C voidHandleWsEventL(const TWsEvent &aEvent,
CCoeControl *aDestination
)[protected, virtual]
From AknAppUi. Handles pointer-initiated view switch. Currently this function does nothing but calls base class function.
Since
Series 60 3.0

Parameters

const TWsEvent & aEventWindow server event.
CCoeControl * aDestinationPointer to the control which the event is targeted to.

NONSHARABLE_CLASS(CViewActivationItem)

NONSHARABLE_CLASS(CViewActivationItem)[inline]

Parameters

CViewActivationItem

NONSHARABLE_CLASS(TAknSplitViewContainer)

NONSHARABLE_CLASS(TAknSplitViewContainer)[inline]

Container class used to hold information about one split view.

Parameters

TAknSplitViewContainer

ProcessCommandL(TInt)

IMPORT_C voidProcessCommandL(TIntaCommand)

Processes user commands.

Parameters

TInt aCommandA command ID.

QueueActivationTick()

voidQueueActivationTick()[private]

RemoveSplitViewL(const TUid)

IMPORT_C voidRemoveSplitViewL(const TUidaViewId)
Removes a view combination containing the given view UID. If the view with the given UID is currently visible then the screen is switched to single view and the the given view stays active.
Since
Series 60 5.0

Parameters

const TUid aViewIdUID of a view combination.

RemoveView(TUid)

IMPORT_C voidRemoveView(TUidaViewId)

Removes and deregisteres the view from the app UI. This function calls CCoeAppUi::DeregisterView.

Parameters

TUid aViewIdThe view to be deregistered and removed.

SetSplitViewL(const TUid, const TUid, const TInt)

IMPORT_C voidSetSplitViewL(const TUidaView1Id,
const TUidaView2Id,
const TIntaLeftViewSize
)
Combines two views. If either of the views belongs to another view combination then that combination is removed.
Since
Series 60 5.0

Parameters

const TUid aView1IdUID of the first (leftmost) view.
const TUid aView2IdUID of the second view.
const TInt aLeftViewSizeSize of the first view (in percentages).

SplitView(const TUid)

TAknSplitViewContainer *SplitView(const TUidaViewId)const [private]
If the given view is part of a split view then returns that split view,
Since
Series 60 5.0

Parameters

const TUid aViewIdUID of a view that belongs to a split view.

SplitViewActive()

IMPORT_C TBoolSplitViewActive()const
Checks if split view is in use.
Since
Series 60 5.0

StopDisplayingMenuBar()

IMPORT_C voidStopDisplayingMenuBar()[virtual]

Stops displaying the application s menu bar.

View(TUid)

IMPORT_C CAknView *View(TUidaView)const

Gets a pointer to specified application view.

Parameters

TUid aViewID of the application view.

ViewActivatedL(CAknView *, const TVwsViewId &, TUid, const TDesC8 &)

voidViewActivatedL(CAknView *aView,
const TVwsViewId &aPrevViewId,
TUidaCustomMessageId,
const TDesC8 &aCustomMessage
)

Parameters

CAknView * aView
const TVwsViewId & aPrevViewId
TUid aCustomMessageId
const TDesC8 & aCustomMessage

ViewDeactivated(CAknView *)

voidViewDeactivated(CAknView *aView)

Parameters

CAknView * aView

ViewRect(const TUid)

TRect ViewRect(const TUidaViewId)const
Returns view's rectangle.
Since
Series 60 5.0

Parameters

const TUid aViewIdUID of the view whose rectangle should be returned.

ViewShown(const TUid)

IMPORT_C TBoolViewShown(const TUidaViewId)const
Checks if the given view is visible on the screen.
Since
Series 60 5.0

Parameters

const TUid aViewIdView to be checked.

Member Type Definitions Documentation

Typedef CAknViewActivationQueue

typedef CArrayPtrFlat< CViewActivationItem >CAknViewActivationQueue

Typedef CAknViews

typedef CArrayPtrFlat< CAknView >CAknViews

Member Data Documentation

CAknViewActivationQueue * iActivationQueue

CAknViewActivationQueue *iActivationQueue[private]

CIdle * iActivationTick

CIdle *iActivationTick[private]

CAknLocalScreenClearer * iClearer

CAknLocalScreenClearer *iClearer[private]

CAknViewAppUiExtension * iExtension

CAknViewAppUiExtension *iExtension[private]

CAknViewShutter * iShutter

CAknViewShutter *iShutter[private]

CAknView * iView

CAknView *iView[protected]

CAknViews * iViews

CAknViews *iViews[protected]