Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Location: eikcmobs.h
Link against: eikcoctl.lib

Class MEikCommandObserver

MEikCommandObserver

Support

Supported from 6.0

Description

Command observers respond to user commands, and have the secondary function of creating custom controls on request for classes such as CEikToolbar, or user-defined classes.

An implementation of the pure virtual function ProcessCommandL() must be provided for each concrete class derived from MEikCommandObserver. CreateCustomCommandControlL() may also be re-implemented.

Defined in MEikCommandObserver:
CreateCustomCommandControlL(), ProcessCommandL()


ProcessCommandL()

virtual void ProcessCommandL (TInt aCommandId) = 0;

Description

Processes user commands.

Derived classes must provide an implementation of this function which responds to user commands appropriately based on a user-defined ID for the command.

Parameters

TInt aCommandId

ID of the command to respond to.

[Top]


CreateCustomCommandControlL()

virtual CCoeControl* CreateCustomCommandControlL(TInt aControlType);

Description

Glue for creating custom controls.

This function can be called to create custom controls on request from their control ID. Custom controls are user-supplied control classes.

Given the ID of a custom control, this function should return a pointer to a newly-instantiated and fully constructed control. If the ID is unrecognised, NULL should be returned. The control returned will be owned by the caller.

Parameters

TInt aControlType

A custom control ID.

Return value

CCoeControl*

By default, NULL.