diff -r 2fe1408b6811 -r e1b950c65cb4 epoc32/include/mw/eikcmobs.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/epoc32/include/mw/eikcmobs.h Wed Mar 31 12:27:01 2010 +0100 @@ -0,0 +1,64 @@ +// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies). +// All rights reserved. +// This component and the accompanying materials are made available +// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members +// which accompanies this distribution, and is available +// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". +// +// Initial Contributors: +// Nokia Corporation - initial contribution. +// +// Contributors: +// +// Description: +// + +#ifndef __EIKCMOBS_H__ +#define __EIKCMOBS_H__ + +#include + +class CCoeControl; + +/** 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. + +@publishedAll +@released */ +class MEikCommandObserver + { +public: + /** 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. + + @param aCommandId ID of the command to respond to. */ + virtual void ProcessCommandL(TInt aCommandId)=0; + /** 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. + + @param aControlType A custom control ID. + @return By default, NULL. */ + IMPORT_C virtual CCoeControl* CreateCustomCommandControlL(TInt aControlType); +protected: + IMPORT_C MEikCommandObserver(); +private: + IMPORT_C virtual void MEikCommandObserver_Reserved1(); + IMPORT_C virtual void MEikCommandObserver_Reserved2(); +private: + TInt iMEikCommandObserver_Reserved1; + }; + +#endif // __EIKCMOBS_H__