CAknNavigationDecorator Class Reference
| class CAknNavigationDecorator : public CAknControl |
Decorator class for navigation pane controls. The class, for example, decorates navigation pane controls with navi arrows.
| Inherited Functions |
|---|
| | CAknControl::CAknControl() |
| | CAknControl::~CAknControl() |
| | 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() |
| | CCoeControl::AccumulatedZoom()const |
| | CCoeControl::ActivateGc()const |
| | CCoeControl::ActivateL() |
| | CCoeControl::BackedUpWindow()const |
| | CCoeControl::Background()const |
| | CCoeControl::CCoeControl() |
| | CCoeControl::CCoeControl(CCoeEnv *) |
| | CCoeControl::CCoeControl(const CCoeControl &) |
| | CCoeControl::CapturesPointer()const |
| | CCoeControl::ClaimPointerGrab(TBool) |
| | CCoeControl::ClaimPointerGrab(TInt,TBool) |
| | CCoeControl::CloseWindow() |
| | CCoeControl::ComponentArrayExists()const |
| | CCoeControl::Components() |
| | CCoeControl::Components()const |
| | CCoeControl::ConstructFromResourceL(TResourceReader &) |
| | CCoeControl::ControlContext()const |
| | CCoeControl::ControlEnv()const |
| | CCoeControl::CopyControlContextFrom(const CCoeControl *) |
| | CCoeControl::CreateBackedUpWindowL(RWindowTreeNode &) |
| | CCoeControl::CreateBackedUpWindowL(RWindowTreeNode &,TDisplayMode) |
| | CCoeControl::CreateWindowL() |
| | CCoeControl::CreateWindowL(RWindowGroup *) |
| | CCoeControl::CreateWindowL(RWindowTreeNode &) |
| | CCoeControl::CreateWindowL(const CCoeControl *) |
| | CCoeControl::CustomGc()const |
| | CCoeControl::DeactivateGc()const |
| | CCoeControl::DrawBackground(const TRect &)const |
| | CCoeControl::DrawDeferred()const |
| | CCoeControl::DrawForeground(const TRect &)const |
| | CCoeControl::DrawNow()const |
| | CCoeControl::DrawNow(const TRect &)const |
| | CCoeControl::DrawableWindow()const |
| | CCoeControl::EnableDragEvents() |
| | CCoeControl::EnableReportControlStateChange(TBool) |
| | CCoeControl::EnableWindowTransparency() |
| | CCoeControl::FindBackground()const |
| | CCoeControl::FindFontProvider()const |
| | CCoeControl::FocusChanged(TDrawNow) |
| | CCoeControl::GetColor(TInt,TRgb &)const |
| | CCoeControl::GetColorUseListL(CArrayFix< TCoeColorUse > &)const |
| | CCoeControl::GetGc()const |
| | CCoeControl::GetHelpContext(TCoeHelpContext &)const |
| | CCoeControl::GrabbingComponent()const |
| | CCoeControl::GrabbingComponent(TInt)const |
| | CCoeControl::HandleComponentControlsResourceChange(TInt) |
| | CCoeControl::HandleControlArrayEventL(CCoeControlArray::TEvent,const CCoeControlArray *,CCoeControl *,TInt) |
| | CCoeControl::HandlePointerBufferReadyL() |
| | CCoeControl::HandleRedrawEvent(const TRect &)const |
| | CCoeControl::HasBorder()const |
| | CCoeControl::HitTest()const |
| | CCoeControl::IgnoreEventsUntilNextPointerUp() |
| | CCoeControl::Index(const CCoeControl *)const |
| | CCoeControl::InitComponentArrayL() |
| | CCoeControl::InputCapabilities()const |
| | CCoeControl::IsActivated()const |
| | CCoeControl::IsBackedUp()const |
| | CCoeControl::IsBeingDestroyed()const |
| | CCoeControl::IsBlank()const |
| | CCoeControl::IsDimmed()const |
| | CCoeControl::IsFocused()const |
| | CCoeControl::IsNonFocusing()const |
| | CCoeControl::IsReadyToDraw()const |
| | CCoeControl::IsVisible()const |
| | CCoeControl::LayoutManager()const |
| | CCoeControl::MakeVisible(TBool) |
| | CCoeControl::MaximumWidth()const |
| | CCoeControl::MinimumSize() |
| | CCoeControl::MopSupplyObject(TTypeUid) |
| | CCoeControl::NotifyFontChange(const CCoeFontProvider *) |
| | CCoeControl::Observer()const |
| | CCoeControl::OfferKeyEventL(const TKeyEvent &,TEventCode) |
| | CCoeControl::OverrideColorL(TInt,TRgb) |
| | CCoeControl::OwnsWindow()const |
| | CCoeControl::Parent() |
| | CCoeControl::Parent()const |
| | CCoeControl::Position()const |
| | CCoeControl::PositionChanged() |
| | CCoeControl::PositionRelativeToScreen()const |
| | CCoeControl::PrepareForFocusGainL() |
| | CCoeControl::PrepareForFocusLossL() |
| | CCoeControl::ProcessPointerBufferReadyL() |
| | CCoeControl::ProcessPointerEventL(const TPointerEvent &) |
| | CCoeControl::Rect()const |
| | CCoeControl::RecursivelyMergeInputCapabilities(TCoeInputCapabilities &)const |
| | CCoeControl::RecursivelyMergedInputCapabilities()const |
| | CCoeControl::RefetchPixelMappingL() |
| | CCoeControl::RemoveFromParent() |
| | CCoeControl::ReportEventL(MCoeControlObserver::TCoeEvent) |
| | CCoeControl::RequestRelayout(const CCoeControl *) |
| | CCoeControl::ResetGc()const |
| | CCoeControl::ScreenFont(const TCoeFont &)const |
| | CCoeControl::SetAdjacent(TInt) |
| | CCoeControl::SetAllowStrayPointers() |
| | CCoeControl::SetBackground(const MCoeControlBackground *) |
| | CCoeControl::SetBlank() |
| | CCoeControl::SetCanDrawOutsideRect() |
| | CCoeControl::SetComponentsToInheritVisibility(TBool) |
| | CCoeControl::SetContainerWindowL(RBackedUpWindow &) |
| | CCoeControl::SetContainerWindowL(RWindow &) |
| | CCoeControl::SetContainerWindowL(const CCoeControl &) |
| | CCoeControl::SetControlContext(MCoeControlContext *) |
| | CCoeControl::SetCornerAndSize(TGulAlignment,const TSize &) |
| | CCoeControl::SetCustomGc(CWindowGc *) |
| | CCoeControl::SetDimmed(TBool) |
| | CCoeControl::SetExtent(const TPoint &,const TSize &) |
| | CCoeControl::SetExtentToWholeScreen() |
| | CCoeControl::SetFocus(TBool,TDrawNow) |
| | CCoeControl::SetFocusing(TBool) |
| | CCoeControl::SetFontProviderL(const CCoeFontProvider &) |
| | CCoeControl::SetGc(CWindowGc *)const |
| | CCoeControl::SetGloballyCapturing(TBool) |
| | CCoeControl::SetHitTest(const MCoeControlHitTest *) |
| | CCoeControl::SetLayoutManagerL(MCoeLayoutManager *) |
| | CCoeControl::SetMaximumWidth(TInt) |
| | CCoeControl::SetMopParent(MObjectProvider *) |
| | CCoeControl::SetNeighbor(CCoeControl *) |
| | CCoeControl::SetNonFocusing() |
| | CCoeControl::SetObserver(MCoeControlObserver *) |
| | CCoeControl::SetParent(CCoeControl *) |
| | CCoeControl::SetPointerCapture(TBool) |
| | CCoeControl::SetPosition(const TPoint &) |
| | CCoeControl::SetRect(const TRect &) |
| | CCoeControl::SetSize(const TSize &) |
| | CCoeControl::SetSizeWithoutNotification(const TSize &) |
| | CCoeControl::SetTextBaselineSpacing(TInt) |
| | CCoeControl::SetUniqueHandle(TInt) |
| | CCoeControl::SetZoomFactorL(TInt,TZoomType) |
| | CCoeControl::Size()const |
| | CCoeControl::SystemGc()const |
| | CCoeControl::TextBaselineOffset(const TSize &)const |
| | CCoeControl::TextDrawer(TInt)const |
| | CCoeControl::UniqueHandle()const |
| | CCoeControl::Window()const |
| | CCoeControl::WriteInternalStateL(RWriteStream &)const |
| | CCoeControl::WriteInternalStateNowL(RWriteStream &)const |
| | CCoeControl::ZoomWithType()const |
| | CCoeControl::operator=(const CCoeControl &) |
| | CCoeControl::~CCoeControl() |
| Public Member Enumerations |
|---|
| enum | TAknNaviControlLayoutMode { ENaviControlLayoutModeAutomatic = 0x400, ENaviControlLayoutModeForced = 0x800 } |
| enum | TAknNaviControlLayoutStyle { ENaviControlLayoutNormal = 0x1, ENaviControlLayoutNarrow = 0x2, ENaviControlLayoutWide = 0x4 } |
| enum | TControlType {
ENotSpecified, ETabGroup, ENaviLabel, ENaviImage, EHintText, EEditorIndicator, ENaviVolume
} |
| enum | TScrollButton { ELeftButton = 0x0001, ERightButton = 0x0002 } |
Constructor & Destructor Documentation
~CAknNavigationDecorator()
| IMPORT_C | ~CAknNavigationDecorator | ( | ) | |
Member Functions Documentation
CancelLayoutStyleTimer()
| void | CancelLayoutStyleTimer | ( | ) | [private] |
This method cancels timer that is used for times layout style changes.
CancelTimer()
| void | CancelTimer | ( | ) | [private] |
This method cancels the timer that is used in the small direction indication animation.
ComponentControl(TInt)
| IMPORT_C CCoeControl * | ComponentControl | ( | TInt | aIndex | ) | const [protected, virtual] |
From CCoeControl.
Returns a control determined by control id.
Parameters
| TInt aIndex | Index of a control to be returned. |
ConstructL()
| IMPORT_C void | ConstructL | ( | ) | [private] |
ControlType()
Returns the type of the decorated control.
CountComponentControls()
| IMPORT_C TInt | CountComponentControls | ( | ) | const [protected, virtual] |
From CCoeControl.
Returns the number of controls inside the context pane control.
DecoratedControl()
Returns the control inside a navigation decorator object. Ownership of the control is not changed.
DecoratedControlNarrowRect(TInt)
|
TRect
| DecoratedControlNarrowRect | ( | TInt | aControlType | ) | [static] |
Gets the default rectangle of the navigation pane's default control.
Parameters
| TInt aControlType | Not used. |
DecoratedControlRect(TInt, TBool)
|
TRect
| DecoratedControlRect | ( | TInt | aControlType, |
| | TBool | aArrowsUsed = ETrue |
| | ) | [static] |
Gets the default rectangle of the given control type.
Parameters
| TInt aControlType | The control type from which default rectangle is asked. |
| TBool aArrowsUsed = ETrue | Whether or not the navigation arrows are used for the control. This is only used for the tab group control. If arrows are not used with tab group, then the whole navi pane area is provided to the tab group control. |
DecoratedDefaultControlRect()
|
TRect
| DecoratedDefaultControlRect | ( | ) | [private, static] |
Gets the default rect of default controltype relative to navipane in normal layoutstyle (ENaviControlLayoutNormal)
DecoratedTabControlRect(TBool, TBool)
|
TRect
| DecoratedTabControlRect | ( | TBool | aTopAdjacent, |
| | TBool | aArrowsUsed |
| | ) | [static] |
Gets the default rect of tab group control type relative to navipane in normal (ENaviControlLayoutNormal) or wide (ENaviControlLayoutWide) layout style.
Parameters
| TBool aTopAdjacent | ETrue to return a rectangle adjacent to the top of navi pane, EFalse for a rectangle adjacent to the bottom of navi pane. |
| TBool aArrowsUsed | Whether or not the navigation arrows are used for the tab group. If arrows are not used, then the whole navi pane area is provided to the tab group control. |
DecoratedVolumeControlRect()
|
TRect
| DecoratedVolumeControlRect | ( | ) | [private, static] |
Gets the default rect of volume controltype relative to navipane in normal layoutstyle (ENaviControlLayoutNormal)
DoLayoutStyleEvent()
| void | DoLayoutStyleEvent | ( | ) | [private] |
This method is executed when timer that is used for times layout style changes expires.
Draw(const TRect &)
| IMPORT_C void | Draw | ( | const TRect & | aRect | ) | const [private, virtual] |
ExtensionInterface(TUid)
| IMPORT_C void * | ExtensionInterface | ( | TUid | aInterface | ) | [private, virtual] |
HandleControlEventL(CCoeControl *, TCoeEvent)
| IMPORT_C void | HandleControlEventL | ( | CCoeControl * | aControl, |
| | TCoeEvent | aEventType |
| | ) | [protected] |
Parameters
| CCoeControl * aControl | Control that caused the event. |
| TCoeEvent aEventType | Type of the event. |
HandlePointerEventL(const TPointerEvent &)
| IMPORT_C void | HandlePointerEventL | ( | const TPointerEvent & | aPointerEvent | ) | [virtual] |
Parameters
| const TPointerEvent & aPointerEvent | Pointer event to be handled. |
HandleResourceChange(TInt)
| IMPORT_C void | HandleResourceChange | ( | TInt | aType | ) | [virtual] |
Handles a change to the control's resources of type aType which are shared across the environment, e.g. color scheme change.
IndicationDrawCallbackL(TAny *)
|
TInt
| IndicationDrawCallbackL | ( | TAny * | aThis | ) | [private, static] |
InitLayoutStyleTimer()
| void | InitLayoutStyleTimer | ( | ) | [private] |
This method initializes timer that is used for times layout style changes.
IsScrollButtonDimmed(TScrollButton)
Is button dimmed or highlighted.
LayoutStyleEvent(TAny *)
|
TInt
| LayoutStyleEvent | ( | TAny * | aPtr | ) | [private, static] |
This method is executed when timer that is used for times layout style changes expires.
MakeScrollButtonVisible(TBool)
| IMPORT_C void | MakeScrollButtonVisible | ( | TBool | aVisible | ) | |
Shows or hides the navigation arrows at the both ends of the navigation pane when current object is shown.
Parameters
| TBool aVisible | Boolean value if navigation arrows are shown with the decorated control. Visible if ETrue. |
NaviArrowRect(TScrollButton, TBool, TRect)
Gets the rectangle for a navigation arrow.
Parameters
| TScrollButton aScrollButton | ELeftButton to return the rectangle of the left navi arrow, ERightButton for right navi arrow. |
| TBool aNarrowLayout = EFalse | ETrue to get a navi arrow rectangle for a narrow decorator layout, EFalse otherwise. |
| TRect aNaviRect =
TRect(0, 0, 0, 0) | Navi pane rectangle to be used as parent, the returned rectangle is relative to this. If not defined, then relative to the default navi pane area. |
NaviControlLayoutMode()
Gets the current layout mode of decorated control. Can be ENaviControlLayoutModeAutomatic (default) or ENaviControlLayoutModeForced (usually set by the application).
NaviControlLayoutStyle()
Gets the current layout style of this objects decorated control (ENaviControlLayoutNormalm ENaviControlLayoutNarrow or ENaviControlLayoutWide).
NaviControlLayoutStyleSupported(TAknNaviControlLayoutStyle)
Tells if decorated control supports given layout style at the current statuspane layout. For ENotSpecified type of controls this always returns EFalse (just for safety) because their implementation is not known.
NewL(CAknNavigationControlContainer *, CCoeControl *, TControlType)
Creates a new navigation decorator. The object takes ownership of the decorated object at the beginning of the method before any leaving functions.
ParentRect()
|
TRect
| ParentRect | ( | ) | [private] |
Gets parent rect of this control. Used for layout calculation purposes.
ScrollButtonVisible()
| IMPORT_C TBool | ScrollButtonVisible | ( | ) | const |
Gets the State of the visibility of navigation arrows.
SetControlType(TControlType)
Sets the type of the decorated control.
SetNaviControlLayoutMode(TAknNaviControlLayoutMode)
Sets the layout mode ENaviControlLayoutModeAutomatic or ENaviControlLayoutModeForced. See TAknNaviControlLayoutMode for more information.
SetNaviControlLayoutStyle(TAknNaviControlLayoutStyle)
Sets the layout style for this objects decorated control. The layout style can be normal or narrow style.
The style is really applied if the decorated control supports it or if the layout mode has been set to forced mode (ENaviControlLayoutModeForced). Additionally narrow mode may not be supported at all in some statuspane configurations (even if forced).
Whether decorated control supports or does not support given style at the currently active statuspane layout can be queried using NaviControlLayoutStyleSupported() method.
Parameters
| TAknNaviControlLayoutStyle aStyle | Can be normal (ENaviControlLayoutNormal), narrow (ENaviControlLayoutNarrow) or wide (ENaviControlLayoutWide). |
SetNaviDecoratorObserver(MAknNaviDecoratorObserver *)
Sets observer for navigation decorator events in the decorated control.
SetNaviStack(CAknNavigationControlContainer *)
Sets the pointer to the default navigation pane control.
SetScrollButtonDimmed(TScrollButton, TBool)
Sets the navigation arrow dimmed (and highlighted). Arrows have to be visible so that the dimmed arrow is shown on the screen.
Parameters
| TScrollButton aButton | Navigation arrow to be set (ELeftButton or ERightButton). |
| TBool aDimmed | ETrue is the button is dimmed, EFalse if the button is set highlighted. |
SizeChanged()
| IMPORT_C void | SizeChanged | ( | ) | [protected, virtual] |
SizeChangedInNarrowLayout()
| void | SizeChangedInNarrowLayout | ( | ) | [private] |
This method handles sizechanges in narrow layout style.
SizeChangedInNormalLayout()
| void | SizeChangedInNormalLayout | ( | ) | [private] |
This method handles sizechanges in normal layout style.
SizeChangedInWideLayout()
| void | SizeChangedInWideLayout | ( | ) | [private] |
This method handles sizechanges in wide layout style.
SmallDirectionIndicationL()
| void | SmallDirectionIndicationL | ( | ) | [private] |
StartTimerL()
| void | StartTimerL | ( | ) | [private] |
Member Enumerations Documentation
Enum TAknNaviControlLayoutMode
Defines the navigation control layout mode.
Enumerators
| ENaviControlLayoutModeAutomatic = 0x400 |
This is the default layout mode. It lets UI framework to decide the proper layout style which is applied to decorated controls in all situations.
|
| ENaviControlLayoutModeForced = 0x800 |
ENaviControlLayoutModeForced layout mode can be used to lock the layout style to the current style.
|
Enum TAknNaviControlLayoutStyle
Defines the navigation control layout style.
Enumerators
| ENaviControlLayoutNormal = 0x1 |
Normal layout style.
|
| ENaviControlLayoutNarrow = 0x2 |
Narrow layout style.
|
| ENaviControlLayoutWide = 0x4 |
Wide layout style, can be used only in portrait mode, in usual status pane layout (R_AVKON_STATUS_PANE_LAYOUT_USUAL_EXT).
Tabs are not currently supported in wide layout style.
|
Enum TControlType
Defines type of the decorated control.
Enumerators
| ENotSpecified |
Type not specified.
|
| ETabGroup |
Tab group.
|
| ENaviLabel |
Label.
|
| ENaviImage |
Image.
|
| EHintText |
Text.
|
| EEditorIndicator |
Indicator.
|
| ENaviVolume |
Volume.
|
Enum TScrollButton
Enumerators
| ELeftButton = 0x0001 |
Scroll left.
|
| ERightButton = 0x0002 |
Scroll right.
|
Member Data Documentation
TSize
iArrowLeftSize
|
TSize
| iArrowLeftSize | [private] |
TPoint
iArrowRightPos
|
TPoint
| iArrowRightPos | [private] |
TSize
iArrowRightSize
|
TSize
| iArrowRightSize | [private] |
CAknNavigationControlContainer * iContainer
Navigation pane default control.
TControlType
iControlType
CCoeControl * iDecoratedControl
CAknNavigationDecoratorExtension * iExtension
| CAknNavigationDecoratorExtension * | iExtension | [private] |
TInt
iLayoutFlags
|
TInt
| iLayoutFlags | [private] |
CPeriodic * iLayoutStyleTimer
TBool
iNaviArrowLeftDimmed
|
TBool
| iNaviArrowLeftDimmed | [private] |
TBool
iNaviArrowRightDimmed
|
TBool
| iNaviArrowRightDimmed | [private] |
TBool
iNaviArrowsVisible
|
TBool
| iNaviArrowsVisible | [private] |
MAknNaviDecoratorObserver * iNaviDecoratorObserver
Observer for handling decorator events.
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.