--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/applayerpluginsandutils/bookmarksupport/inc/bookmarkdatabase.h	Tue Feb 02 01:09:52 2010 +0200
@@ -0,0 +1,163 @@
+// Copyright (c) 2005-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:
+// Class for opening and manipulating the bookmark database.
+// 
+//
+
+/**
+ @file
+ @publishedPartner
+ @released
+*/
+
+#ifndef __BOOKMARKDATABASE_H__
+#define __BOOKMARKDATABASE_H__
+
+#include <bookmarkdef.h>
+#include <bookmark.h>
+
+class CBookmarkDb;
+
+/**
+Applications can derive from this class in order to receive notifications if the
+the database changes. The system shares a single bookmark database so it is possible 
+for another application or service to change the database while you are using it.
+By registering as an observer, and deriving from MBookmarkObserver, you can be 
+notified if such an event occurs. 
+
+Your view of the database will not be automatically updated. You will need to call
+RBkDatabase::RefreshL() in order for changes to be updated.
+
+@publishedPartner
+@released
+*/
+class MBookmarkObserver
+	{
+public:
+	/**
+	  Bookmark database change notification events.
+	 */
+	enum TEvent
+		{
+		/**
+			One or more folders or bookmarks have had their properties modified
+		 */
+		EEventUpdatedBookmarkTree,	
+		/**
+			One or more database-wide properties has been modified
+		 */
+		EEventUpdatedConfig,		
+		/**
+			Icon data has been added or modified
+		 */
+		EEventUpdatedIcons
+		};
+public:
+	/**
+	The call-back function that will be called when the database has changed.
+	
+	@param aEvent The type of bookmark database change.
+	@publishedPartner
+	@released
+	*/
+	virtual void MBONotify(TEvent aEvent) = 0;
+	};
+
+
+
+/**
+RBkDatabase represents a handle to the database as a whole. Opening the handle 
+will initiate a connection to the system-wide bookmark store. RBkDatabase is 
+responsible for all operations such as creating new bookmarks and folders or changing 
+database-wide data such as setting the home page or registering custom properties.
+
+@publishedPartner
+@released
+*/
+class RBkDatabase
+	{
+public:
+	IMPORT_C RBkDatabase();
+
+	IMPORT_C void OpenL(Bookmark::TVisibility aVisibility = Bookmark::EVisibilityDefault, MBookmarkObserver* aObserver = NULL);
+	IMPORT_C void Close();
+
+	IMPORT_C void RefreshL();
+
+	IMPORT_C void CommitL();
+
+	IMPORT_C RBkFolder OpenRootL() const;
+	
+	IMPORT_C RBkBookmark CreateBookmarkL(RBkFolder* aParent = NULL);
+	IMPORT_C RBkFolder CreateFolderL(const TDesC& aTitle, RBkFolder* aParent = NULL);
+
+	IMPORT_C void DeleteItemL(Bookmark::TItemId aBookmarkId, TBool aRecursive = EFalse);
+
+	IMPORT_C RBkBookmark OpenBookmarkL(Bookmark::TItemId aBookmarkID) const;
+	IMPORT_C RBkFolder OpenFolderL(Bookmark::TItemId aFolderID) const;
+	IMPORT_C RBkFolder OpenFolderL(const TDesC& aFolderTitle) const;
+
+	IMPORT_C Bookmark::TAttachmentId CreateIconL(const TDesC8& aIconData);
+	IMPORT_C const TDesC8& GetIconL(Bookmark::TAttachmentId aIconId) const;
+	IMPORT_C TInt DeleteIconL(Bookmark::TAttachmentId aIconId);
+
+	IMPORT_C TVersion Version() const;
+
+	IMPORT_C RBkBookmark OpenHomeL() const;
+
+	/**
+	Method for setting the home page bookmark. 
+ 
+	@param aHome Reference to the new home page
+	@publishedPartner
+	@deprecated Left in for source compatibility, Use SetHomeL function instead
+	*/
+	inline void SetHome(const RBkBookmark& aHome)	
+		{SetHomeL(aHome);}
+
+	IMPORT_C const TDesC& HomePageText() const;
+	IMPORT_C void SetHomePageTextL(const TDesC& aHomePageText);
+
+	IMPORT_C const TDesC8& SearchUri() const;
+	IMPORT_C void SetSearchUriL(const TDesC8& aUri);
+
+	IMPORT_C TUint32 DefaultProxy() const;
+	IMPORT_C void SetDefaultProxy(TUint32 aServiceId);
+
+	IMPORT_C TUint32 DefaultNap() const;
+	IMPORT_C void SetDefaultNap(TUint32 aNetworkId);
+
+	IMPORT_C void RegisterDatabasePropertyL(TUid aCustomId, Bookmark::TPropertyType aDataType);
+	IMPORT_C void RegisterFolderPropertyL(TUid aCustomId, Bookmark::TPropertyType aDataType);
+	IMPORT_C void RegisterBookmarkPropertyL(TUid aCustomId, Bookmark::TPropertyType aDataType);
+
+	IMPORT_C TInt DeregisterDatabasePropertyL(TUid aCustomId);
+	IMPORT_C TInt DeregisterFolderPropertyL(TUid aCustomId);
+	IMPORT_C TInt DeregisterBookmarkPropertyL(TUid aCustomId);
+
+	IMPORT_C void GetCustomPropertyL(TUid aPropertyId, TInt& aValue) const;
+	IMPORT_C void GetCustomPropertyL(TUid aPropertyId, TReal& aValue) const;
+	IMPORT_C void GetCustomPropertyL(TUid aPropertyId, TDes& aValue) const;
+	IMPORT_C void GetCustomPropertyL(TUid aPropertyId, TDes8& aValue) const;
+	IMPORT_C void SetCustomPropertyL(TUid aPropertyId, TInt aValue);
+	IMPORT_C void SetCustomPropertyL(TUid aPropertyId, TReal aValue);
+	IMPORT_C void SetCustomPropertyL(TUid aPropertyId, const TDesC& aValue);
+	IMPORT_C void SetCustomPropertyL(TUid aPropertyId, const TDesC8& aValue);
+
+	IMPORT_C void SetHomeL(const RBkBookmark& aHome);
+private:
+	CBookmarkDb* iDatabase; // The internal database object that this handle is connected to
+	};
+
+#endif //__BOOKMARKDATABASE_H__
\ No newline at end of file