commonuisupport/uikon/coreinc/EIKCMOBS.H
changeset 0 2f259fa3e83a
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/commonuisupport/uikon/coreinc/EIKCMOBS.H	Tue Feb 02 01:00:49 2010 +0200
@@ -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 "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+#ifndef __EIKCMOBS_H__
+#define __EIKCMOBS_H__
+
+#include <e32def.h>
+
+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__