--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mds_pub/content_listing_framework_api/inc/MCLFModifiableItem.h	Mon Jan 18 20:34:07 2010 +0200
@@ -0,0 +1,100 @@
+/*
+* Copyright (c) 2002-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 MCLFMODIFIABLEITEM_H
+#define MCLFMODIFIABLEITEM_H
+
+//  INCLUDES
+#include <MCLFItem.h>
+
+// FORWARD DECLARATIONS
+class MCLFModifiableItemExt;
+
+// CLASS DECLARATION
+
+/**
+*  Modifiable item for Content Listing Framework.
+*  Use ContentListingFactory to create modifiable items. These new items are
+*  used as groups in the custom grouper (see MCLFCustomGrouper). Modifiable
+*  item is like MCLFItem but you can add new fields to the modifiable item.
+*  One item can contain multiple fields, but normally it is not needed in
+*  a custom grouper. The field consists of a Field ID and field data. Type
+*  of the field is defined with Field ID. See TCLFDefaultFieldId in
+*  CLFContentListing.hrh.<br><br>
+*  Example:
+*  @code
+*  // Create a modifiable item and add one string field to it.
+*  // Field id is ECLFFieldIdArtist and field value is "test".
+*  _LIT( KTest, "test" );
+*  MCLFModifiableItem* item = ContentListingFactory::NewModifiableItemLC();
+*  item->AddFieldL( ECLFFieldIdArtist, KTest );
+*  CleanupStack::Pop(); // item
+*  @endcode
+*
+*  @lib ContentListingFramework.lib
+*  @since S60 3.1
+*/
+class MCLFModifiableItem : public MCLFItem
+    {
+    public:  // Destructor
+        /**
+        * Destructor.
+        */
+        virtual ~MCLFModifiableItem() {}
+
+    public: // New functions
+
+        /**
+        * Add new string field to the item.
+        * @since S60 3.1
+        * @param aFieldId Field ID
+        * @param aValue Field value
+        */
+        virtual void AddFieldL( TCLFFieldId aFieldId,
+                                const TDesC& aValue ) = 0;
+
+        /**
+        * Add new integer field to the item.
+        * @since S60 3.1
+        * @param aFieldId Field ID
+        * @param aValue Field value
+        */
+        virtual void AddFieldL( TCLFFieldId aFieldId,
+                                TInt32 aValue ) = 0;
+
+        /**
+        * Add new time field to the item.
+        * @since S60 3.1
+        * @param aFieldId Field ID
+        * @param aValue Field value
+        */
+        virtual void AddFieldL( TCLFFieldId aFieldId,
+                                const TTime& aValue ) = 0;
+
+    private: // Extension interface
+
+        /**
+        * This member is internal and not intended for use.
+        */
+        virtual MCLFModifiableItemExt* ModifiableItemExtension() { return NULL; }
+
+    };
+
+#endif      // MCLFMODIFIABLEITEM_H
+
+// End of File