--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/camera_plat/active_palette_2_api/active_palette_2_api.metaxml	Thu Jan 07 16:18:56 2010 +0200
@@ -0,0 +1,14 @@
+<?xml version="1.0" ?>
+<api id="0dc7de008e438eebd524fea55073d086" dataversion="2.0">
+<name>Active Palette 2 API</name>
+<description>Active Palette 2 implements a toolbar UI component. The toolbar consists of items, which are represented by a graphical icons. Each item has also an associated identifier, which may be used by the client application to associate the item with a certain command, for example. The component is used through the Active Palette 2 API.</description>
+<type>c++</type>
+<collection>camerauis</collection>
+<libs><lib name="activepalette.lib"/>
+</libs>
+<release category="platform" sinceversion="5.1"/>
+<attributes>
+<htmldocprovided>no</htmldocprovided>
+<adaptation>no</adaptation>
+</attributes>
+</api>

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/camera_plat/active_palette_2_api/group/bld.inf	Thu Jan 07 16:18:56 2010 +0200
@@ -0,0 +1,32 @@
+/*
+* Copyright (c) 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:  Build information file for Active Palette 2 API
+*
+*/
+
+
+#include <platform_paths.hrh>
+
+PRJ_PLATFORMS
+DEFAULT
+
+PRJ_EXPORTS
+../inc/activepalette2eventdata.h          APP_LAYER_PLATFORM_EXPORT_PATH(activepalette2eventdata.h)
+../inc/activepalette2factory.h            APP_LAYER_PLATFORM_EXPORT_PATH(activepalette2factory.h)
+../inc/activepalette2genericpluginint.h   APP_LAYER_PLATFORM_EXPORT_PATH(activepalette2genericpluginint.h)
+../inc/activepalette2itemvisible.h        APP_LAYER_PLATFORM_EXPORT_PATH(activepalette2itemvisible.h)
+../inc/activepalette2navigationkeys.h     APP_LAYER_PLATFORM_EXPORT_PATH(activepalette2navigationkeys.h)
+../inc/activepalette2observer.h           APP_LAYER_PLATFORM_EXPORT_PATH(activepalette2observer.h)
+../inc/activepalette2ui.h                 APP_LAYER_PLATFORM_EXPORT_PATH(activepalette2ui.h)
+

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/camera_plat/active_palette_2_api/inc/activepalette2eventdata.h	Thu Jan 07 16:18:56 2010 +0200
@@ -0,0 +1,99 @@
+/*
+* Copyright (c) 2007-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:  Contains an event's data
+*
+*/
+
+
+/**
+ * @file ActivePalette2EventData.h
+ * Contains an event's data
+ */
+
+
+#ifndef _ACTIVE_PALETTE_2_EVENT_DATA_H
+#define _ACTIVE_PALETTE_2_EVENT_DATA_H
+
+#include <e32std.h>
+
+/**
+ * Container for the data generated when a user selects an item
+ */
+class TActivePalette2EventData
+    {
+    public:	
+    
+        /**
+         * Constructor
+         * @param aResult The result
+         * @param aCurItem The current item
+         * @param aPrevItem The previous item
+         * @param aServingItem The serving item
+         * @param aServingPlugin A reference to the serving plugin's UID
+         */
+    	TActivePalette2EventData(TInt aResult, 
+    							TInt aCurItem, 
+    							TInt aPrevItem, 
+    							TInt aServingItem, 
+    							const TUid& aServingPlugin);
+    							
+    	/**
+    	 * Returns the result
+    	 * @return The result
+    	 */
+    	IMPORT_C TInt Result(void) const;
+
+    	/**
+    	 * Returns the current item
+    	 * @return The current item
+    	 */
+    	IMPORT_C TInt CurItem(void) const;
+
+    	/**
+    	 * Returns the previous item
+    	 * @return The previous item
+    	 */
+    	IMPORT_C TInt PrevItem(void) const;
+
+    	/**
+    	 * Returns the serving item
+    	 * @return The serving item
+    	 */
+    	IMPORT_C TInt ServingItem(void) const; 
+
+    	/**
+    	 * Returns the serving plugin's UID
+    	 * @return The serving plugin's UID
+    	 */
+    	IMPORT_C TUid ServingPlugin(void) const;
+
+    private:
+        /// The result code
+    	TInt	iResult;
+    	
+    	/// The current item ID
+    	TInt	iCurItem;
+    	
+    	/// The previous item ID
+    	TInt	iPrevItem;
+    	
+    	/// The serving item ID
+    	TInt	iServingItem;
+    	
+    	/// The serving plugin's UID
+    	TUid   	iServingPlugin;
+    };
+
+
+#endif // _ACTIVE_PALETTE_2_EVENT_DATA_H

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/camera_plat/active_palette_2_api/inc/activepalette2factory.h	Thu Jan 07 16:18:56 2010 +0200
@@ -0,0 +1,86 @@
+/*
+* Copyright (c) 2007-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:  Creates concrete implementation of AP
+*
+*/
+
+
+/**
+ * @file ActivePalette2Factory.h
+ * Creates concrete implementation of AP
+ */
+
+#ifndef _ACTIVE_PALETTE_2_FACTORY_H
+#define _ACTIVE_PALETTE_2_FACTORY_H
+
+#include <e32std.h>
+#include <e32base.h>
+
+class MActivePalette2UI;
+class CHuiEnv;
+class MGui;
+
+/**
+ * Describes how the standard CCoeControl-based Active Palette will be rendered
+ */
+enum TActivePalette2DrawMode
+	{
+	EAP2DrawModeSemiTransparent = 0, ///< Semi-transparent, alpha-blended background
+	EAP2DrawModeCheckerboard,        ///< With a checkerboard background. Alpha values will either be fully opaque or fully transparent.
+	EAP2DrawModeOpaque,              ///< No tranparency. Not officially supported
+
+	EAP2DrawModeSemiTransparentTooltipModeFading ///< Semi-transparent, alpha-blended background, fading tooltip
+  };
+
+/**
+ * Factory class for Active Palette 2. Use these static functions to create AP2 objects.
+ * Class should not be instantiated.
+ */
+class ActivePalette2Factory
+    {
+public:
+    /**
+    * Creates a legacy-style, CCoeControl-based Active Palette.
+    * The control created is NOT a window-owning control. Set the container window and Mop parent using
+    * the CoeControl() function.
+    * @param aDrawMode The drawing style used to render the AP
+    * @return The constructed Active Palette
+    */
+    IMPORT_C static MActivePalette2UI* CreateActivePaletteUIL(TActivePalette2DrawMode aDrawMode);
+    
+    /**
+    * Creates a new-style, CHuiControl-based Active Palette.
+    * The control should be added to a control group using
+    * the CoeControl() function.
+    * @param aHuiEnv The client app's Hui environment
+    * @return The constructed Active Palette
+    */
+    IMPORT_C static MActivePalette2UI* CreateHUIActivePaletteUIL(CHuiEnv& aHuiEnv);
+
+    /**
+    * Creates a new-style, GuiLib-based Active Palette.
+    * @param aGui The client app's Gui environment
+    * @return The constructed Active Palette
+    */
+    IMPORT_C static MActivePalette2UI* CreateGuiActivePaletteUIL(MGui* aGui);
+
+protected:
+    /**
+     * Constructor - not for external use
+     */
+    ActivePalette2Factory() {}
+    };
+
+
+#endif //  _ACTIVE_PALETTE_2_FACTORY_H

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/camera_plat/active_palette_2_api/inc/activepalette2genericpluginint.h	Thu Jan 07 16:18:56 2010 +0200
@@ -0,0 +1,141 @@
+/*
+* Copyright (c) 2007-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:  Active Palette generic plugin public interface
+*
+*/
+
+
+/**
+ * @file ActivePalette2GenericPluginInt.h
+ * Active Palette generic plugin public interface
+ */
+
+#ifndef ACTIVE_PALETTE_2_GENERIC_PLUGIN_INT_H
+#define ACTIVE_PALETTE_2_GENERIC_PLUGIN_INT_H
+
+// INCLUDES
+#include <e32std.h>
+
+/// UID for generic plugin
+#define KActivePalette2GenericPluginUID			    0x10208A6D
+
+// CONSTANTS
+/// Maximum tooltip length, in characters
+const TInt KMaxTooltipLen = 256;
+
+// FORWARD DECLARATIONS
+
+/**
+ * Generic plugin parameters
+ */
+class TAP2GenericPluginParams
+	{
+public:
+    /**
+     * Use to signify the resource file type
+     */
+    enum TAP2GenericPluginResFileType
+        {
+        EGenericStdResFile 			= 1, ///< Use the inbuilt icons
+    	EGenericCustomResFile	    = 2  ///< Use a custom graphics file
+    	};
+    	
+    /**
+     * The IDs for the inbuilt icons
+     */
+    enum TAP2GenericPluginIconId
+        {
+        // No built-in graphics supported
+	    };
+
+public:
+
+    /**
+    * Constructor
+    */
+	TAP2GenericPluginParams();
+
+    /**
+    * Constructor
+    * @param aResFileType Resource file type
+    * @param aGraphicsFileName Graphics file name
+    * @param aIconId Bitmap UD for the item's icon
+    * @param aMaskId Bitmap UD for the item's mask
+    * @param aTooltipText Tooltip text
+    * @param aMessageId Message ID
+    * @param aMsgCustomParam Message custom parameter
+    */
+	IMPORT_C	TAP2GenericPluginParams(const TInt aResFileType,
+									   const TDesC& aGraphicsFileName,
+									   const TInt aIconId,
+									   const TInt aMaskId,
+									   const TDesC& aTooltipText,
+									   const TInt aMessageId,
+									   const TInt aMsgCustomParam);	
+
+    /// Current graphics file type in use
+	TInt					iResFileType;
+	/// Current graphics file in use
+	TFileName 				iGraphicsFileName;		
+	/// The icon ID
+	TInt      				iIconId;
+	/// The mask ID
+	TInt      				iMaskId;
+	/// Tooltip text for the item
+	TBuf<KMaxTooltipLen> 	iTooltipText;
+	/// Message ID
+	TInt					iMessageId;
+	/// Custom parameter
+	TInt					iMsgCustomParam;
+	};
+
+
+/**
+ * Message IDs used by generic plugin
+ */
+enum TAP2GenericPluginMessageIDs
+	{
+	EAPGenericPluginChangeIcon,  ///< Change the current icon
+	EAPGenericPluginChangeParams ///< Change the general parameters
+	};
+
+/**
+ * Describes an icon and its mask, for the generic plugin
+ */
+class TAP2GenericPluginIcon
+	{
+public:
+
+    /**
+    * Constructor
+    */
+	TAP2GenericPluginIcon();
+	
+    /**
+    * Constructor
+    * @param aIconId Bitmap ID for the icon
+    * @param aMaskId Bitmap ID for the mask
+    */
+	IMPORT_C	TAP2GenericPluginIcon(const TInt aIconId,
+									 const TInt aMaskId);	
+
+    /// The icon ID
+	TInt      	iIconId;
+	/// The mask ID
+	TInt      	iMaskId;
+	};
+
+#endif // ACTIVE_PALETTE_2_GENERIC_PLUGIN_INT_H
+
+// End of File

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/camera_plat/active_palette_2_api/inc/activepalette2itemvisible.h	Thu Jan 07 16:18:56 2010 +0200
@@ -0,0 +1,68 @@
+/*
+* Copyright (c) 2007-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:  Contains (item id, visible) pairs used by AP2
+*
+*/
+
+
+/**
+ * @file ActivePalette2ItemVisible.h
+ * Contains (item id, visible) pairs used by AP2
+ */
+
+#ifndef _ACTIVE_PALETTE_2_ITEM_VISIBLE_H
+#define _ACTIVE_PALETTE_2_ITEM_VISIBLE_H
+
+#include <e32std.h>
+
+/**
+ * Container class to describe (Item ID, visibility) pairs.
+ */
+class TActivePalette2ItemVisible
+    {
+    public:
+        /** 
+         * Constructor
+         * @param aItemId The Item ID
+         * @param aVisible Whether the item is / should be visible
+         */
+        IMPORT_C TActivePalette2ItemVisible(TInt aItemId, TBool aVisible);
+
+        /**
+         * Returns the item ID
+         * @return The item ID
+         */
+		IMPORT_C TInt ItemId() const;
+
+        /**
+         * Returns the visibility
+         * @return The visibility of the item
+         */
+		IMPORT_C TBool Visible() const;
+
+	private:
+	    /**
+	     * Constructor. Not for external use.
+	     */
+		TActivePalette2ItemVisible(); 
+		
+		/// The item ID
+        TInt    iItemId;
+        
+        /// The visibility
+        TBool   iVisible;
+    };
+
+
+#endif // _ACTIVE_PALETTE_2_ITEM_VISIBLE_H

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/camera_plat/active_palette_2_api/inc/activepalette2navigationkeys.h	Thu Jan 07 16:18:56 2010 +0200
@@ -0,0 +1,60 @@
+/*
+* Copyright (c) 2007-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:  Contains the key definitions used for navigation in AP
+*
+*/
+
+
+/**
+ * @file ActivePalette2NavigationKeys.h
+ * Contains the key definitions used for navigation in AP
+ */
+
+#ifndef _ACTIVE_PALETTE_2_NAVIGATION_KEYS_H
+#define _ACTIVE_PALETTE_2_NAVIGATION_KEYS_H
+
+#include <e32std.h>
+
+/**
+ * Navigation key type
+ */
+class TActivePalette2NavigationKeys
+    {
+    public:
+        /** 
+         * Constructor
+         * @param aNaviPrev The scancode of the previous key
+         * @param aNaviNext The scancode of the next key
+         * @param aNaviSelect The scancode of the select key
+         */
+        IMPORT_C TActivePalette2NavigationKeys(TInt aNaviPrev,
+        		                 TInt aNaviNext,
+        		                 TInt aNaviSelect);
+
+        /** 
+         * Constructor
+         * Assumes default navigation keys
+         */
+        IMPORT_C TActivePalette2NavigationKeys(void); 
+        
+        /// The &quot;Previous&quot; key's scancode
+        TInt    iNaviPrev;
+        /// The &quot;Next&quot; key's scancode
+        TInt    iNaviNext;
+        /// The &quot;Select&quot; key's scancode
+        TInt    iNaviSelect;
+    };
+
+
+#endif // _ACTIVE_PALETTE_2_NAVIGATION_KEYS_H

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/camera_plat/active_palette_2_api/inc/activepalette2observer.h	Thu Jan 07 16:18:56 2010 +0200
@@ -0,0 +1,94 @@
+/*
+* Copyright (c) 2007-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:  Interface used by AP to report events and request services
+*                from client application
+*
+*/
+
+
+
+/**
+ * @file ActivePalette2Observer.h
+ * Interface used by AP to report events and request services from 
+ * client application
+ */
+
+
+#ifndef _ACTIVE_PALETTE_2_OBSERVER_H
+#define _ACTIVE_PALETTE_2_OBSERVER_H
+
+#include <e32std.h>
+
+class TActivePalette2EventData;
+
+/**
+ * Interface for an Active Palette 2 observer. The AP will use this interface to inform the client app
+ * about certain events, and to request services.
+ */
+class MActivePalette2Observer
+    {
+    public:
+        /**
+         * Called when a new item is focused
+         * @param aPrevItem Item ID of previously focused item
+         * @param aFocusedItem Item ID of newly focused item
+         */
+    	virtual void NotifyItemFocused(TInt aPrevItem, TInt aFocusedItem) = 0;
+
+        /**
+         * Called when the user has selected an item from the AP, before the plugin is informed
+         * @param aEvent The event data
+         */
+    	virtual void NotifyItemSelected(const TActivePalette2EventData& aEvent) = 0;
+    	
+        /**
+         * Called when the user has selected an item from the AP, after the relevant plugin
+         * has completed processing the event
+         * @param aEvent The event data
+         * @param aDataDes Data descriptor
+         * @param aDataInt Data integer
+         */
+    	virtual void NotifyItemComplete(const TActivePalette2EventData& aEvent,
+    	                                const TDesC8& aDataDes,
+    	                                TInt aDataInt) = 0;
+
+        /**
+         * Called when a plugin generates a message for the client app.
+         * @param aEvent The event data
+         * @param aMessageID The ID of the message
+         * @param aDataDes Data descriptor
+         * @param aDataInt Data integer
+         */
+    	virtual void NotifyMessage(const TActivePalette2EventData& aEvent,
+    	                           TInt aMessageID,
+    	                           const TDesC8& aDataDes,
+    	                           TInt aDataInt) = 0;
+    	                           
+        /**
+         * Request for the client app to redraw the given area underneath the AP. Used to support semi-transparency.
+         * It is important that this completes quickly. This will only be called if a CCoeControl-derived AP is
+         * in use.
+         * @param aArea The area to redraw.
+         */    	                           
+        virtual void Redraw(const TRect& aArea) = 0;
+        
+        /**
+         * Informs the observer that the AP has been updated in some way. Includes animations. 
+         * Only called if SetGc() has previously been called on the AP with a non-NULL parameter, and if the AP
+         * in use is a CCoeControl.
+         */    	                           
+        virtual void ActivePaletteUpdated(void) = 0;
+    };
+
+#endif // _ACTIVE_PALETTE_2_OBSERVER_H

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/camera_plat/active_palette_2_api/inc/activepalette2ui.h	Thu Jan 07 16:18:56 2010 +0200
@@ -0,0 +1,275 @@
+/*
+* Copyright (c) 2007-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:  Interface class for AP2
+*
+*/
+
+
+/**
+ * @file ActivePalette2UI.h
+ * Interface class for AP2
+ */
+
+#ifndef _ACTIVE_PALETTE_2_UI_H
+#define _ACTIVE_PALETTE_2_UI_H
+
+
+#include <e32std.h>
+
+class CCoeControl;
+class CHuiControl;
+class CBitmapContext;
+class MActivePalette2Observer;
+class TActivePalette2NavigationKeys;
+class TActivePalette2ItemVisible;
+
+/**
+* The interface for the Active Palette. The ActivePalette2Factory is used to instantiate
+* objects that provide this interface.
+*/
+class MActivePalette2UI
+    {
+public: 
+    /**
+     * Installs an item to the AP. 
+     * @param aItemVisible The ID and visibility of the new item
+     * @param aPluginUid The UID of the plugin to handle this item
+     * @param aCustomDataDes Descriptor data to pass to the plugin
+     * @return Standard error code
+     */
+	virtual TInt InstallItemL(const TActivePalette2ItemVisible& aItemVisible, 
+						const TUid& aPluginUid, 
+						const TDesC8& aCustomDataDes) = 0;
+						
+    /**
+     * Installs an item to the AP. 
+     * @param aItemVisible The ID and visibility of the new item
+     * @param aPluginUid The UID of the plugin to handle this item
+     * @param aCustomDataInt Integer data to pass to the plugin
+     * @return Standard error code
+     */
+	virtual TInt InstallItemL(const TActivePalette2ItemVisible& aItemVisible,
+						const TUid& aPluginUid, 
+						TInt aCustomDataInt = 0) = 0;
+
+    /**
+     * Installs an item to the AP. 
+     * @param aItemVisible The ID and visibility of the new item
+     * @param aPluginUid The UID of the plugin to handle this item
+     * @param aCustomDataInt Integer data to pass to the plugin
+     * @param aCustomDataDes Descriptor data to pass to the plugin
+     * @return Standard error code
+     */
+	virtual TInt InstallItemL(const TActivePalette2ItemVisible& aItemVisible,
+						const TUid& aPluginUid, 
+						TInt aCustomDataInt, 
+						const TDesC8& aCustomDataDes) = 0;
+	
+    /**
+     * Removes an item
+     * @param aItemId The resource ID of the item to install
+     * @return Standard error code
+     */
+	virtual TInt RemoveItem(TInt aItemId) = 0;
+
+    /**
+     * Sets the visibility of an item
+     * @param aItemId The item's ID
+     * @param aIsVisible The visibility state
+     * @return Standard error code
+     */
+	virtual TInt SetItemVisibility(TInt aItemId, TBool aIsVisible) = 0;
+
+    /**
+     * Find out the visibility of a specified item
+     * @param aItemId The item's ID
+     * @param aIsVisible On return, indicates the visibility of the item
+     * @return Standard error code
+     */
+	virtual TInt GetItemVisibility(TInt aItemId, TBool& aIsVisible) const = 0;
+
+    /**
+     * Gets the list of currently installed items. 
+     * The list will include all items, both visible and invisible.
+     * @see SetItemList()
+     * 
+     * @param aItemVisibleList On return, will contain the item list.
+     * @return Standard error code
+     */
+    virtual TInt GetItemList(RArray<TActivePalette2ItemVisible>& aItemVisibleList) const = 0;
+
+    /**
+     * Sets the order and visibility of installed items.
+     * aItemVisibleList may be incomplete (i.e. not all installed item IDs must be present). 
+     * In this case, the non-specified items will be shuffled down to the end of the AP, 
+     * whilst retaining their relative order.
+     * If the item that was in focus before the call is still visible, it retains the focus, 
+     * else the first visible item gains focus.
+     *
+     * @see GetItemList()
+     *
+     * @param aItemVisibleList The list describing the order and visibility of the items
+     * @return Standard error code
+     */
+    virtual TInt SetItemList(const RArray<TActivePalette2ItemVisible>& aItemVisibleList) = 0;
+
+    /**
+     * Sends a message to the specified item's handling plugin
+     * @param aItemId The item's ID
+     * @param aMessageId Message ID
+     * @param aDataDes Custom data passed as a descriptor
+     * @return Error code
+     */
+	virtual TInt SendMessage(TInt aItemId, TInt aMessageId, const TDesC8& aDataDes) = 0;
+
+    /**
+     * Sends a message to the specified item's handling plugin
+     * @param aItemId The item's ID
+     * @param aMessageId Message ID
+     * @param aDataInt Custom data passed as an integer
+     * @return Standard error code
+     */
+	virtual TInt SendMessage(TInt aItemId, TInt aMessageId, TInt aDataInt) = 0;
+
+    /**
+     * Gets the currently focussed item
+     * @param aItemId On return, will contain the ID of the item in focus
+     * @return Standard error code
+     */
+	virtual TInt GetCurrentItem(TInt& aItemId) const = 0;
+	
+    /**
+     * Sets the currently focussed item
+     * @param aItemId The ID of the item to focus
+     * @return Standard error code
+     */
+	virtual TInt SetCurrentItem(TInt aItemId) = 0;
+
+    /**
+     * Hides or shows the palette.
+     * After calling this function, and until the transition (if any) is complete, the AP will
+     * not accept any user input.
+     *
+     * @see SetPaletteVisibilityAnimationDuration()
+     * @see GetPaletteVisibilityAnimationDuration()
+     *
+     * @param aVisible If ETrue, shows the AP, otherwise hides it
+     * @param aAnimated Whether the transition should be animated. If not, the change is made as soon 
+     *        as aDelayedStartMilliseconds has passed
+     * @param aDelayedStartMilliseconds An optional pause before the transition begins.
+     * @return Standard error code
+     */
+    virtual TInt SetPaletteVisibility(TBool aVisible, TBool aAnimated, TInt aDelayedStartMilliseconds = 0) = 0;
+    
+    /**
+     * Sets the duration of the SetPaletteVisibility animation.
+     *
+     * @see SetPaletteVisibility()
+     * @see GetPaletteVisibilityAnimationDuration()
+     *
+     * @param aTimeInMilliseconds How long the animation should take, in milliseconds
+     * @return Standard error code
+     */
+    virtual TInt SetPaletteVisibilityAnimationDuration(TInt aTimeInMilliseconds) = 0;
+        
+    /**
+     * Gets the duration of the SetPaletteVisibility animation.
+     *
+     * @see SetPaletteVisibility()
+     * @see SetPaletteVisibilityAnimationDuration()
+     *
+     * @param aTimeInMilliseconds On return, will contain how long the animation will take, in milliseconds
+     * @return Standard error code
+     */
+    virtual TInt GetPaletteVisibilityAnimationDuration(TInt& aTimeInMilliseconds) const = 0;
+    
+    /**
+     * Move the AP.
+     * @param aTopLeft Point specifying where to move the AP to
+     */
+	virtual void LocateTo(const TPoint& aTopLeft) = 0;
+	
+    /**
+     * Returns the top left point of the AP
+     * @return A TPoint indicating the top left point of the AP
+     */
+	virtual TPoint Location() const = 0;
+
+    /**
+     * Returns the underlying CCoeControl, if any.
+     * @return A valid CCoeControl pointer if the underlying implementation is a CCoeControl; NULL otherwise.
+     */
+    virtual CCoeControl* CoeControl() = 0;
+    
+    /**
+     * Returns the underlying CHuiControl, if any.
+     * @return A valid CHuiControl pointer if the underlying implementation is a CHuiControl; NULL otherwise.
+     */
+    virtual CHuiControl* HuiControl() = 0;
+
+    /**
+     * Sets the graphics context to draw to.
+     * If called with aGc being non-NULL, the AP will be rendered to the supplied context
+     * in future drawing operations. If called with NULL, the screen's GC will be used instead.
+     * Calls to this will only have an effect if a CCoeControl-based AP has been created.
+     * 
+     * @see RenderActivePalette()
+     *
+     * @param aGc The graphics context to draw to
+     */
+    virtual void SetGc(CBitmapContext* aGc = NULL) = 0;
+
+    /**
+     * Forces the AP to draw itself to the supplied aRect. 
+     * Uses the context previously set by SetGc, if any; uses the screen's context otherwise.
+     * Calls to this will only have an effect if a CCoeControl-based AP has been created.
+     * 
+     * @see SetGc()
+     *
+     * @param aRect The rect to render to
+     */
+    virtual void RenderActivePalette(const TRect& aRect) const = 0;
+
+    /**
+     * Sets the active palette observer used for callbacks. Calls to this function replace the previously 
+     * set observer. SetObserver(NULL) may be called to remove the previously set observer without specifying 
+     * a new observer
+     *
+     * @param aObserver The new observer to use
+     */
+    virtual void SetObserver(MActivePalette2Observer* aObserver) = 0;
+
+    /**
+     * Gets a list of available external plugins. 
+     *
+     * @param aPluginList On return, will contain a list a valid plugin UIDs
+     * @return Standard error code
+     */
+    virtual TInt GetAvailablePlugins(RArray<TUid>& aPluginList) const = 0;
+
+    /**
+     * Sets the keys the user will press to navigate the AP. This sets the scancodes responded to when 
+     * CCoeControl::OfferKeyEvent, CHuiControl::OfferEvent or similar are called.
+     *
+     * @param aNavigationKeys The new navigation keys
+     */
+    virtual void SetNavigationKeys(const TActivePalette2NavigationKeys& aNavigationKeys) = 0;
+
+    /**
+     * Destructor. Will clean up all installed plugins.
+     */        
+    virtual ~MActivePalette2UI() {};
+};
+
+#endif // _ACTIVE_PALETTE_2_UI_H