CAknPopupList Class Reference

#include <mw/aknPopup.h>

class CAknPopupList : public CEikBorderedControl

Inherits from

CAknPopupList
- CEikBorderedControl
  - CAknControl

Protected Attributes
TBool	iAppBroughtForwards
TInt	iCurrentResource
CIdle *	iIdle
TAknPopupWindowLayoutDef	iLayout
CEikListBox *	iListBox
TBool	iMarkable
CEikButtonGroupContainer *	iPopoutCba
TAknPopupFader	iPopupFader
TBool *	iReturn
CAknPopupHeadingPane *	iTitle
CActiveSchedulerWait	iWait
AknPopupLayouts::TAknPopupLayouts	iWindowType

Public Member Enumerations
enum	anonymous { ETypeId }

Public Member Functions
IMPORT_C CEikButtonGroupContainer *	ButtonGroupContainer()
IMPORT_C void	CancelPopup()
IMPORT_C TBool	EnableAdaptiveFind(TBool)
IMPORT_C TBool	EnableFind(TBool)
IMPORT_C TBool	ExecuteLD()
IMPORT_C CAknSearchField *	FindBox()
virtual IMPORT_C void	HandlePointerEventL(const TPointerEvent &)
IMPORT_C CAknPopupHeadingPane *	Heading()
IMPORT_C CAknPopupHeadingPane *	Heading()
IMPORT_C CEikListBox *	ListBox()
IMPORT_C CAknPopupList *	NewL(CEikListBox *, TInt, AknPopupLayouts::TAknPopupLayouts)
IMPORT_C void	SetMaximumHeight(TInt)
IMPORT_C void	SetTitleL(const TDesC &)

Protected Member Functions
	CAknPopupList()
	~CAknPopupList()
virtual IMPORT_C void	AttemptExitL(TBool)
IMPORT_C void	ConstructL(CEikListBox *, TInt, AknPopupLayouts::TAknPopupLayouts)
IMPORT_C void	FadeBehindPopup(TBool)
IMPORT_C void	HandleControlEventL(CCoeControl *, TCoeEvent)
IMPORT_C void	HandleListBoxEventL(CEikListBox *, TListBoxEvent)
virtual IMPORT_C void	HandleResourceChange(TInt)
IMPORT_C const TAknPopupWindowLayoutDef &	Layout()
IMPORT_C TAknPopupWindowLayoutDef &	Layout()
IMPORT_C CEikListBox *	ListBox()
IMPORT_C TTypeUid::Ptr	MopSupplyObject(TTypeUid)
IMPORT_C void	ProcessCommandL(TInt)
virtual IMPORT_C void	SetupWindowLayout(AknPopupLayouts::TAknPopupLayouts)

Inherited Attributes
	CCoeControl::iCoeEnv
	CCoeControl::iContext
	CCoeControl::iPosition
	CCoeControl::iSize
	CEikBorderedControl::iBorder

Inherited Enumerations
	CCoeControl:TZoomType

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::CCoeControlArray
	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::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::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::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::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::SizeChanged()
	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::GetColorUseListL(CArrayFix< TCoeColorUse > &)const
	CEikBorderedControl::HasBorder()const
	CEikBorderedControl::SetAdjacent(TInt)
	CEikBorderedControl::SetBorder(TGulBorder::TBorderType)
	CEikBorderedControl::SetBorder(TInt)
	CEikBorderedControl::WriteInternalStateL(RWriteStream &)const

Detailed Description

Used to popup a list or grid. Takes an existing listbox control and puts it into a popup frame together with an optional title.

CAknPopupList is not a dialog!

There are two standard usages of CAknPopupList:

  CAknPopupList *plist = CAknPopupList::NewL(...);
  CleanupStack::PushL(plist);
  ...
  TInt popupOk = plist->ExecuteLD(...);
  // No leaving functions allowed between ExecuteLD and
  // CleanupStack::Pop().
  CleanupStack::Pop(); // plist
  if (popupOk) { ... } else { ... }

And then another way:

  iPList = CAknPopupList::NewL(...);
  ...
  TInt popupOk = iPlist->ExecuteLD(...);
  // No leaving functions allowed between ExecuteLD and iPlist=NULL;
  iPlist = NULL;
  if (popupOk) {... } else {... }
  // note, destructor deletes the iPlist instance.

Both these work corretly and leave-safe way. Notice this usage is pretty different of how dialogs work. With dialogs you _always_ want to do CleanupStack::Pop() before calling ExecuteLD().

Member Attribute Documentation

iAppBroughtForwards

TBool

iAppBroughtForwards

[protected]

iCurrentResource

TInt

iCurrentResource

[protected]

iIdle

CIdle *

iIdle

[protected]

iLayout

TAknPopupWindowLayoutDef

iLayout

[protected]

collects all LAF specification lines that are needed for popup window.

iListBox

CEikListBox *

iListBox

[protected]

iMarkable

TBool

iMarkable

[protected]

iPopoutCba

CEikButtonGroupContainer *

iPopoutCba

[protected]

A button group container - a wrapper around the different button arrays.

iPopupFader

TAknPopupFader

iPopupFader

[protected]

iReturn

TBool *

iReturn

[protected]

The address to hold the return value from the popup

iTitle

CAknPopupHeadingPane *

iTitle

[protected]

Header control for queries. Defines properties of the header of the pop-up menu.

iWait

CActiveSchedulerWait

iWait

[protected]

iWindowType

AknPopupLayouts::TAknPopupLayouts

iWindowType

[protected]

Popup layout type.

Member Enumeration Documentation

Enum anonymous

Enumerator	Value	Description
ETypeId	0x20018439

Constructor & Destructor Documentation

CAknPopupList ( )

IMPORT_C

CAknPopupList

(

)

[protected]

C++ default constructor.

~CAknPopupList ( )

IMPORT_C

~CAknPopupList

(

)

[protected]

Destructor.

Member Function Documentation

AttemptExitL ( TBool )

IMPORT_C void

AttemptExitL

(

TBool

aAccept

)

[protected, virtual]

Called when the user accepts or cancels the listbox.

Parameter	Description
aAccept	ETrue if the user has accepted, EFalse if the user has cancelled the listbox.

ButtonGroupContainer ( )

IMPORT_C CEikButtonGroupContainer *

ButtonGroupContainer

(

)

Gets a button group container.

Returns: The button group.

CancelPopup ( )

IMPORT_C void

CancelPopup

(

)

Cancels the current popup. The popup ExecuteLD will return with EFalse.

ConstructL ( CEikListBox *, TInt, AknPopupLayouts::TAknPopupLayouts )

IMPORT_C void	ConstructL	(	CEikListBox *	aListBox,
			TInt	aCbaResource,
			AknPopupLayouts::TAknPopupLayouts	aType
		)	[protected]

Handles 2nd phase construction.

Parameter	Description
aListBox	Pre-existing listbox-derived class.
aCbaResource	Softkey pane to display while pop-up is active.
aType	The layout used.

EnableAdaptiveFind ( TBool )

IMPORT_C TBool

EnableAdaptiveFind

(

TBool

aEnable = ETrue

)

Enables the findbox with adaptive search of the popup list.

Since: 5.0

Parameter	Description
aEnable	Enables (default) or disables the adaptive findbox.

Returns: ETrue if enabling/disabling was successfull.

EnableFind ( TBool )

IMPORT_C TBool

EnableFind

(

TBool

aEnable = ETrue

)

Enables the findbox of the popup list.

Parameter	Description
aEnable	Enables (default) or disables the findbox.

Returns: ETrue if enabling/disabling was successfull.

ExecuteLD ( )

IMPORT_C TBool

ExecuteLD

(

)

Executes the pop-up selection list. Function returns when the user have accepted or cancelled the pop-up.

Returns: ETrue if the popup was accepted. EFalse if the popup was cancelled.

FadeBehindPopup ( TBool )

IMPORT_C void

FadeBehindPopup

(

TBool

aFade

)

[protected]

FindBox ( )

IMPORT_C CAknSearchField *

FindBox

(

)

const

Gets the search field control.

Returns: Search field control.

HandleControlEventL ( CCoeControl *, TCoeEvent )

IMPORT_C void	HandleControlEventL	(	CCoeControl *	aControl,
			TCoeEvent	aEventType
		)	[protected]

From MCoeControlObserver.

Handles an event from an observed control.

Parameter	Description
aControl	Control being observed.
aEventType	Event observed.

HandleListBoxEventL ( CEikListBox *, TListBoxEvent )

IMPORT_C void	HandleListBoxEventL	(	CEikListBox *	aListBox,
			TListBoxEvent	aEventType
		)	[protected]

From MEikListBoxObserver.

Processes key events from the listbox. Responds to EEventEnterKeyPressed to accept the pop-up.

Parameter	Description
aListBox	Listbox being observed.
aEventType	Event being observed.

HandlePointerEventL ( const TPointerEvent & )

IMPORT_C void

HandlePointerEventL

(

const TPointerEvent &

aPointerEvent

)

[virtual]

Reimplemented from CEikBorderedControl::HandlePointerEventL(const TPointerEvent &)

From CCoeControl.

Handles pointer events of popups.

Parameter	Description
aPointerEvent	Pointer event to be handled.

HandleResourceChange ( TInt )

IMPORT_C void

HandleResourceChange

(

TInt

aType

)

[protected, virtual]

Reimplemented from CEikBorderedControl::HandleResourceChange(TInt)

From CCoeControl.

Handles a change to the control's resources.

Parameter	Description
aType	A message UID value.

Heading ( )

IMPORT_C CAknPopupHeadingPane *

Heading

(

)

Gets the popup header.

Returns: Header properties of the pop-up menu.

Heading ( )

IMPORT_C CAknPopupHeadingPane *

Heading

(

)

const

Gets the popup header.

Returns: Header properties of the pop-up menu.

Layout ( )

IMPORT_C const TAknPopupWindowLayoutDef &

Layout

(

)

const [protected]

Gets the layout definitions for the popup list.

Returns: Collects all LAF specification lines that are needed for popup windows.

Layout ( )

IMPORT_C TAknPopupWindowLayoutDef &

Layout

(

)

[protected]

Gets the layout definitions for the popup list.

Returns: Collects all LAF specification lines that are needed for popup windows.

ListBox ( )

IMPORT_C CEikListBox *

ListBox

(

)

Gets the list box.

Returns: The list box.

ListBox ( )

IMPORT_C CEikListBox *

ListBox

(

)

const [protected]

Returns the listbox being used.

Returns: Listbox contained in the pop-up.

MopSupplyObject ( TTypeUid )

IMPORT_C TTypeUid::Ptr

MopSupplyObject

(

TTypeUid

aId

)

[protected]

Reimplemented from CCoeControl::MopSupplyObject(TTypeUid)

From MopSupplyObject.

Retrieves an object of the same type as that encapsulated in aId.

Parameter	Description
aId	Encapsulated object type ID.

Returns: Encapsulates the pointer to the object provided. Note that the encapsulated pointer may be NULL.

NewL ( CEikListBox *, TInt, AknPopupLayouts::TAknPopupLayouts )

IMPORT_C CAknPopupList *	NewL	(	CEikListBox *	aListBox,
			TInt	aCbaResource,
			AknPopupLayouts::TAknPopupLayouts	aType = AknPopupLayouts::EMenuWindow
		)	[static]

Two-phased constructor.

Creates the pop-up list.

Parameter	Description
aListBox	Pre-existing listbox-derived class.
aCbaResource	Softkey pane to display while pop-up is active.
aType	The layout used.

Returns: A pointer to a pop-up list object.

ProcessCommandL ( TInt )

IMPORT_C void

ProcessCommandL

(

TInt

aCommandId

)

[protected]

From MEikCommandObserver.

Processes events from the softkeys. Responds to EAknSoftkeyOk and EAknSoftkeyBack to accept or cancel the pop-up.

Parameter	Description
aCommandId	Event Id from the soft-key.

SetMaximumHeight ( TInt )

IMPORT_C void

SetMaximumHeight

(

TInt

aItems

)

Sets the maximum height for the popup frame.

Parameter	Description
aItems	The maximum height.

SetTitleL ( const TDesC & )

IMPORT_C void

SetTitleL

(

const TDesC &

aTitle

)

Sets the title for the selection list.

Parameter	Description
aTitle	Title to be displayed.

SetupWindowLayout ( AknPopupLayouts::TAknPopupLayouts )

IMPORT_C void

SetupWindowLayout

(

AknPopupLayouts::TAknPopupLayouts

aType

)

[protected, virtual]

Setup the whole window layout; window position, grid and heading position, shadow for the window.

Parameter	Description
aType	A choice of layout.