UIQ Technology
 Developer Library

UIQ 3 SDK

UIQ developer portal

FEEDBACK 

[Index] [Spacer] [Previous] [Next]



Location: QikMenuPopout.h
Link against: qikcore.lib

Class CQikMenuPopout

class CQikMenuPopout : public CBase;

Description

Class for displaying menu popouts. Uses CEikMenuPane .

Derivation

Members

Defined in CQikMenuPopout:
AddCommandL(), DisplayL(), MenuPane(), NewL(), ResetL(), SetCommandListL(), SetRootPaneId(), ~CQikMenuPopout()

Inherited from CBase:
Delete(), Extension_(), operator new()

See also:


Construction and destruction


NewL()

static IMPORT_C CQikMenuPopout *NewL(CEikonEnv &aEikonEnv, MQikCommandHandler &aCommandHandler);

Description

Creates the menu popout

Parameters

CEikonEnv &aEikonEnv

Reference to the calling applications CEikonEnv .

MQikCommandHandler &aCommandHandler

The command handler to be notified when an item is selected in the menu popout.

Return value

CQikMenuPopout *

The newly constructed CQikMenupopout


~CQikMenuPopout()

IMPORT_C ~CQikMenuPopout();

Description

Destructor Clears and deallocates resources used by the menu popout. If the commands are added through SetCommandListL() they are deleted, if the commands are added through AddCommandL() are not deleted.

[Top]


Member functions


ResetL()

IMPORT_C void ResetL();

Description

Clears and initializes the menu popout. Will not leave. Name retained for BC reasons


AddCommandL()

IMPORT_C void AddCommandL(const CQikCommand &aCommand);

Description

Adds a command to the menu popout. Does not take ownership of the commands added through this method.

Parameters

const CQikCommand &aCommand

The command to add to the menu.


SetCommandListL()

IMPORT_C void SetCommandListL(TInt aResourceId);

Description

Initializes the menu popout with a command list and creates the menu pane. Takes ownership of the commands created from resource. Calling this method will remove all other commands added.

Parameters

TInt aResourceId

Resource id of a command list, if NULL no commands are added.


DisplayL()

IMPORT_C void DisplayL(TPoint &aPopoutPos, TPopupTargetPosType aTargetType, TBool aFullClientWidth=EFalse);

Description

Displays the popout menu.

Parameters

TPoint &aPopoutPos

Position of the corner of the popout menu identified by aTargetType .

TPopupTargetPosType aTargetType

The corner of the popout menu to which aPopoutPos relates. Legal values are EPopupTargetTopLeft , EPopupTargetTopRight , EPopupTargetBottomLeft , EPopupTargetBottomRight .

TBool aFullClientWidth

Indicates if the popout menu menu should fill the entire width of the client (default is to fit it to the longest text).


MenuPane()

IMPORT_C CEikMenuPane *MenuPane();

Description

Returns the CEikMenuPane used by the menu popout so it can be directly manipulated. Note: calling ResetL() will invalidate this pointer!

Return value

CEikMenuPane *

The CEikMenuPane used by the menu popout.

See also:


SetRootPaneId()

IMPORT_C void SetRootPaneId(TInt aId);

Description

Use this method to set namedgroup-id of the root menupane. This only needs to be done if you for some reason don't use 0 as id for the first menupane. In normal circumstances this method isn't used. If not zero, the namedgroup-id needs to be set before before calling AddCommandL .

Parameters

TInt aId

Terms and conditions of use of the material