CAknViewAppUi Class Reference

class CAknViewAppUi : public CAknAppUi

Base class for view architecture-based applications.

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 &)
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::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:@154
CAknAppUiBase:TAppUiOrientation
CAknAppUiBase:TKeyEventFlag
CEikAppUi:@109
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. 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.

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. Extension object.

FocusedView()

IMPORT_C TUidFocusedView()const

Returns the currently focused view. Series 60 5.0

UID of the currently focused view.

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. 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. Series 60 3.0

Parameters

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

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. 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. 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, Series 60 5.0

Pointer to a correct split view or NULL if no corresponding split view was found.

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. Series 60 5.0

ETrue if a split view is active.

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. Pointer to application view object, NULL if aView doesn't exists.

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. 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. Series 60 5.0

ETrue if the given view is visible.

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]