CEikTwoPictureCommandButton Class Reference

#include <mw/eikcmbut.h>

Link against: eikcoctl.dll

class CEikTwoPictureCommandButton : public CEikCommandButtonBase
Public Member Enumerations
enumTDisplayContent { ETextOnly, EPictureOnly, ETextAndPicture }
enumTExcess { EShare, EToText, EToPicture }
enumTLayout { ETextRightPictureLeft, ETextBottomPictureTop, ETextTopPictureBottom, ETextLeftPictureRight }
Public Member Functions
CEikTwoPictureCommandButton()
~CEikTwoPictureCommandButton()
virtual IMPORT_C voidActivateL()
virtual IMPORT_C voidConstructFromResourceL(TResourceReader &)
IMPORT_C voidConstructImagesFromResourceL(TResourceReader &, TWhichComponent)
virtual IMPORT_C voidHandlePointerEventL(const TPointerEvent &)
IMPORT_C TBoolIsSecondPictureOwnedExternally()
IMPORT_C CEikImage *Picture()
IMPORT_C voidSetPictureFromFileL(const TDesC &, TInt, TInt)
IMPORT_C voidSetSecondPicture(const CFbsBitmap *, const CFbsBitmap *)
IMPORT_C voidSetSecondPictureFromFileL(const TDesC &, TInt, TInt)
IMPORT_C voidSetSecondPictureOwnedExternally(TBool)
IMPORT_C voidSetTextL(const TDesC &)
IMPORT_C voidSetTwoPicturesL(const CFbsBitmap *, const CFbsBitmap *, const CFbsBitmap *, const CFbsBitmap *)
Protected Member Functions
virtual IMPORT_C voidWriteInternalStateL(RWriteStream &)
Inherited Attributes
CCoeControl::iCoeEnv
CCoeControl::iContext
CCoeControl::iPosition
CCoeControl::iSize
CEikBorderedControl::iBorder
CEikButtonBase::iButFlags
CEikCommandButtonBase::iCmdFlags
CEikCommandButtonBase::iComponents
CEikCommandButtonBase::iMargins
Inherited Enumerations
CCoeControl:TZoomType
CEikButtonBase:TDrawState
CEikButtonBase:TState
CEikCommandButtonBase:TWhichComponent
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::BackedUpWindow()const
CCoeControl::Background()const
CCoeControl::CCoeControl()
CCoeControl::CCoeControl(CCoeEnv *)
CCoeControl::CCoeControl(const CCoeControl &)
CCoeControl::CCoeControlArray
CCoeControl::CapturesPointer()const
CCoeControl::ClaimPointerGrab(TBool)
CCoeControl::ClaimPointerGrab(TInt,TBool)
CCoeControl::CloseWindow()
CCoeControl::ComponentArrayExists()const
CCoeControl::Components()
CCoeControl::Components()const
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::GetColor(TInt,TRgb &)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::HitTest()const
CCoeControl::IgnoreEventsUntilNextPointerUp()
CCoeControl::Index(const CCoeControl *)const
CCoeControl::InitComponentArrayL()
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::MopSupplyObject(TTypeUid)
CCoeControl::NotifyFontChange(const CCoeFontProvider *)
CCoeControl::Observer()const
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::SetAllowStrayPointers()
CCoeControl::SetBackground(const MCoeControlBackground *)
CCoeControl::SetBlank()
CCoeControl::SetCanDrawOutsideRect()
CCoeControl::SetComponentsToInheritVisibility(TBool)
CCoeControl::SetContainerWindowL(RBackedUpWindow &)
CCoeControl::SetContainerWindowL(RWindow &)
CCoeControl::SetControlContext(MCoeControlContext *)
CCoeControl::SetCornerAndSize(TGulAlignment,const TSize &)
CCoeControl::SetCustomGc(CWindowGc *)
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::WriteInternalStateNowL(RWriteStream &)const
CCoeControl::ZoomWithType()const
CCoeControl::operator=(const CCoeControl &)
CCoeControl::~CCoeControl()
CEikBorderedControl::Border()const
CEikBorderedControl::CEikBorderedControl()
CEikBorderedControl::CEikBorderedControl(const TGulBorder &)
CEikBorderedControl::HasBorder()const
CEikBorderedControl::SetAdjacent(TInt)
CEikBorderedControl::SetBorder(TGulBorder::TBorderType)
CEikBorderedControl::SetBorder(TInt)
CEikButtonBase::Animate()
CEikButtonBase::CEikButtonBase()
CEikButtonBase::CopyDrawStateTo(CEikButtonBase *)const
CEikButtonBase::DrawState()const
CEikButtonBase::InputCapabilities()const
CEikButtonBase::IsPressed()const
CEikButtonBase::SetAllowTristate()
CEikButtonBase::SetBehavior(TButtonBehavior)
CEikButtonBase::SetCoordinator(TEikButtonCoordinator *)
CEikButtonBase::SetIgnoreNextPointerUp()
CEikButtonBase::SetReportOnPointerDown()
CEikButtonBase::SetState(TState)
CEikButtonBase::State()const
CEikButtonBase::~CEikButtonBase()
CEikCommandButtonBase::Behavior()const
CEikCommandButtonBase::ButFlags()const
CEikCommandButtonBase::CEikCommandButtonBase()
CEikCommandButtonBase::CheckCreateCommandStackL()
CEikCommandButtonBase::CommandStack()const
CEikCommandButtonBase::ComponentControl(TInt)const
CEikCommandButtonBase::ConstructImageFromResourceL(TResourceReader &,TWhichComponent)
CEikCommandButtonBase::ConstructLabelFromResourceL(TResourceReader &,TWhichComponent)
CEikCommandButtonBase::CountComponentControls()const
CEikCommandButtonBase::FocusChanged(TDrawNow)
CEikCommandButtonBase::GetColorUseListL(CArrayFix< TCoeColorUse > &)const
CEikCommandButtonBase::HandleResourceChange(TInt)
CEikCommandButtonBase::IsDefault()const
CEikCommandButtonBase::LayoutComponents()
CEikCommandButtonBase::MinimumSize()
CEikCommandButtonBase::OfferKeyEventL(const TKeyEvent &,TEventCode)
CEikCommandButtonBase::SetButtonLayout(TLayout)
CEikCommandButtonBase::SetContainerWindowL(const CCoeControl &)
CEikCommandButtonBase::SetDefault(TBool)
CEikCommandButtonBase::SetDimmed(TBool)
CEikCommandButtonBase::SetDisplayContent(TDisplayContent)
CEikCommandButtonBase::SetExcessSpace(TExcess)
CEikCommandButtonBase::SetImageAttributes(CEikImage *)
CEikCommandButtonBase::SetPictureFromFileL(const TDesC &,TInt,TInt,CEikAlignedControl *&)
CEikCommandButtonBase::SetPictureL(const CFbsBitmap *,const CFbsBitmap *,CEikAlignedControl *&)
CEikCommandButtonBase::SetTextL(const TDesC &,CEikAlignedControl *&)
CEikCommandButtonBase::StartConstructFromResourceL(TResourceReader &)
CEikCommandButtonBase::UpdateComponentAlignment()
CEikCommandButtonBase::~CEikCommandButtonBase()

Detailed Description

The CEikTwoPictureCommandButton class is a command button which can hold two pictures as well as label text. If a second picture is set for the button it is shown when the button is pressed.

Since
S60 1.0

Member Enumeration Documentation

Enum TDisplayContent

Content to display for the text

EnumeratorValueDescription
ETextOnly0x0100
EPictureOnly0x0200
ETextAndPicture0x0300

Enum TExcess

Where to put the excess space when laying out the bitmaps or text

EnumeratorValueDescription
EShare0x0000
EToText0x0010
EToPicture0x0020

Enum TLayout

Layout options for the Two Picture botton

Constructor & Destructor Documentation

CEikTwoPictureCommandButton ( )

IMPORT_CCEikTwoPictureCommandButton()

Two picture command button constructor

~CEikTwoPictureCommandButton ( )

IMPORT_C~CEikTwoPictureCommandButton()

Two picture command button C++ destructor

Member Function Documentation

ActivateL ( )

IMPORT_C voidActivateL()[virtual]

Reimplemented from CEikCommandButtonBase::ActivateL()

From CCoeControl

Make the control ready for display

ConstructFromResourceL ( TResourceReader & )

IMPORT_C voidConstructFromResourceL(TResourceReader &aReader)[virtual]

Reimplemented from CCoeControl::ConstructFromResourceL(TResourceReader &)

ParameterDescription
aReaderFully constructed resource reader

ConstructImagesFromResourceL ( TResourceReader &, TWhichComponent )

IMPORT_C voidConstructImagesFromResourceL(TResourceReader &aReader,
TWhichComponentaWhich
)

Constructs the two images from resource

ParameterDescription
aReaderConstructed resource reader.
aWhichWhich picture to be constructing

HandlePointerEventL ( const TPointerEvent & )

IMPORT_C voidHandlePointerEventL(const TPointerEvent &aPointerEvent)[virtual]

Reimplemented from CEikCommandButtonBase::HandlePointerEventL(const TPointerEvent &)

From CCoeControl

Handle a pointer event coming from the CONE framework

ParameterDescription
aPointerEventEvent to handle

IsSecondPictureOwnedExternally ( )

IMPORT_C TBoolIsSecondPictureOwnedExternally()

Accesses ownership of the second picture' bitmap and mask (if present)

Returns: EFalse iff and if the second picture is not owned externally

Picture ( )

IMPORT_C CEikImage *Picture()const

Access the picture image.

Returns: The picture as a CEikImage. No ownership transferred.

SetPictureFromFileL ( const TDesC &, TInt, TInt )

IMPORT_C voidSetPictureFromFileL(const TDesC &aFilename,
TIntaMain,
TIntaMask = -1
)

Sets the bitmap and optional mask for the first picture from an mbm file.

ParameterDescription
aMainIndex of the bitmap to use
aMaskIndex of the mask. If -1, then a null mask will be used

SetSecondPicture ( const CFbsBitmap *, const CFbsBitmap * )

IMPORT_C voidSetSecondPicture(const CFbsBitmap *aSecondMain,
const CFbsBitmap *aSecondMask = NULL
)

Sets the bitmap and optional mask for the button's second picture

SetSecondPictureFromFileL ( const TDesC &, TInt, TInt )

IMPORT_C voidSetSecondPictureFromFileL(const TDesC &aFilename,
TIntaMain,
TIntaMask = -1
)

Sets the bitmap and optional mask for the second picture from an mbm file.

ParameterDescription
aMainIndex of the bitmap to use
aMaskIndex of the mask. If -1, then a null mask will be used

SetSecondPictureOwnedExternally ( TBool )

IMPORT_C voidSetSecondPictureOwnedExternally(TBoolaOwnership)

Sets the ownership of the second picture object

ParameterDescription
aOwnershipSet to EFalse if bitmaps associated with the object are owned by the button

SetTextL ( const TDesC & )

IMPORT_C voidSetTextL(const TDesC &aText)

Sets the label text on the button

ParameterDescription
aTextThe text to set

SetTwoPicturesL ( const CFbsBitmap *, const CFbsBitmap *, const CFbsBitmap *, const CFbsBitmap * )

IMPORT_C voidSetTwoPicturesL(const CFbsBitmap *aMain,
const CFbsBitmap *aMask = NULL,
const CFbsBitmap *aSecondMain = NULL,
const CFbsBitmap *aSecondMask = NULL
)

Sets the bitmap and optional mask for the button's two pictures. Optionally, only the first button's picture may be set up.

ParameterDescription
aMainThe bitmap to use for the first picture
aMaskThe mask. If null, then no mask will be used
aSecondMainThe bitmap to use for the second picture
aSecondMaskThe mask. If null, then no mask will be used

WriteInternalStateL ( RWriteStream & )

IMPORT_C voidWriteInternalStateL(RWriteStream &aWriteStream)const [protected, virtual]

From CCoeControl

Serialize the state of the control

ParameterDescription
aWriteStreamOutput stream for the serialization