CAknViewAppUi Class Reference

#include <mw/aknViewAppUi.h>

Link against: Pbk2CommonUI.lib

class CAknViewAppUi : public CAknAppUi

Inherits from

Public Member Type Definitions
typedef CArrayPtrFlat< CViewActivationItem > CAknViewActivationQueue
typedef CArrayPtrFlat< CAknView > CAknViews
Protected Attributes
CAknView *iView
CAknViews *iViews
Public Member Functions
virtual ~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()
virtual 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
virtual IMPORT_C voidHandleForegroundEventL(TBool)
IMPORT_C voidHandleStatusPaneSizeChange()
virtual IMPORT_C voidHandleWsEventL(const TWsEvent &, CCoeControl *)
Inherited Attributes
CCoeAppUi::iCoeEnv
CEikAppUi::iContainerAppUi
CEikAppUi::iDocument
CEikAppUi::iDoorObserver
CEikAppUi::iEmbeddedAndReadOnly
CEikAppUi::iFlags
Inherited Enumerations
CAknAppUiBase:@68
CAknAppUiBase:TAppUiOrientation
CAknAppUiBase:TKeyEventFlag
CEikAppUi:@65
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()

Detailed Description

Base class for view architecture-based applications.

Since
Series 60 0.9

Member Type Definition Documentation

Typedef CAknViewActivationQueue

typedef CArrayPtrFlat< CViewActivationItem >CAknViewActivationQueue

Typedef CAknViews

typedef CArrayPtrFlat< CAknView >CAknViews

Member Attribute Documentation

iView

CAknView *iView[protected]

iViews

CAknViews *iViews[protected]

Constructor & Destructor Documentation

~CAknViewAppUi ( )

IMPORT_C~CAknViewAppUi()[virtual]

Destructor.

Member Function 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.

ParameterDescription
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.

ParameterDescription
aViewIdIdentifier of the view to activate.
aCustomMessageIdSpecifies the message type.
aCustomMessageThe message passed to the activated view.

AddViewL ( CAknView * )

IMPORT_C voidAddViewL(CAknView *aView)

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

ParameterDescription
aViewThe view to be registered and added.

BaseConstructL ( TInt )

IMPORT_C voidBaseConstructL(TIntaAppUiFlags = EStandardApp)

Initialises this app UI with standard values.

ParameterDescription
aAppUiFlagsApplication 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
ParameterDescription
aEnableETrue enables local screen clearer. EFalse disables local screen clearer.

FocusedView ( )

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

Returns: 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.

ParameterDescription
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
ParameterDescription
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
ParameterDescription
aEventWindow server event.
aDestinationPointer to the control which the event is targeted to.

NONSHARABLE_CLASS ( CViewActivationItem )

NONSHARABLE_CLASS(CViewActivationItem)[inline]

NONSHARABLE_CLASS ( TAknSplitViewContainer )

NONSHARABLE_CLASS(TAknSplitViewContainer)[inline]

Container class used to hold information about one split view.

ProcessCommandL ( TInt )

IMPORT_C voidProcessCommandL(TIntaCommand)

Processes user commands.

ParameterDescription
aCommandA command ID.

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
ParameterDescription
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.

ParameterDescription
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
ParameterDescription
aView1IdUID of the first (leftmost) view.
aView2IdUID of the second view.
aLeftViewSizeSize of the first view (in percentages).

SplitViewActive ( )

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

Returns: 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.

ParameterDescription
aViewID of the application view.

Returns: Pointer to application view object, NULL if aView doesn't exists.

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

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

ViewDeactivated ( CAknView * )

voidViewDeactivated(CAknView *aView)

ViewRect ( const TUid )

TRect ViewRect(const TUidaViewId)const
Returns view's rectangle.
Since
Series 60 5.0
ParameterDescription
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
ParameterDescription
aViewIdView to be checked.

Returns: ETrue if the given view is visible.