2 // Open Service Platform
3 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
5 // Licensed under the Apache License, Version 2.0 (the License);
6 // you may not use this file except in compliance with the License.
7 // You may obtain a copy of the License at
9 // http://www.apache.org/licenses/LICENSE-2.0
11 // Unless required by applicable law or agreed to in writing, software
12 // distributed under the License is distributed on an "AS IS" BASIS,
13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 // See the License for the specific language governing permissions and
15 // limitations under the License.
19 * @file FWebBookmarkItem.h
20 * @brief This is the header file for the %BookmarkItem class.
22 * This header file contains the declarations of the %BookmarkItem class.
25 #ifndef _FWEB_BOOKMARK_ITEM_H_
26 #define _FWEB_BOOKMARK_ITEM_H_
28 #include <FBaseString.h>
30 namespace Tizen { namespace Graphics
35 namespace Tizen { namespace Web
37 class _BookmarkItemImpl;
40 * A unique ID. This ID is unique within a local storage only. @n
41 * @c RecordId is assigned by the local storage when a record is saved to the storage. @n
49 * The root folder ID. @n
50 * In fact, it is symbolic value because the root folder record doesn't exist physically.
54 const RecordId ROOT_FOLDER_ID = -1;
58 * @brief This class is used for accessing a bookmark item stored in the WebBookmark class.
61 * @final This class is not intended for extension.
63 * The %BookmarkItem class provides access to the WebBookmark class.
64 * Each item contains the title, the URL of the page, the item type and parent folder id.
66 class _OSP_EXPORT_ BookmarkItem
67 : public Tizen::Base::Object
72 * Copying of objects using this copy constructor is allowed.
73 * This is the copy constructor for the %BookmarkItem class. @n
74 * It creates an instance of %BookmarkItem with the values of the specified instance.
78 * @param[in] rhs An instance of %BookmarkItem
80 BookmarkItem(const BookmarkItem& rhs);
83 * This destructor overrides Tizen::Base::Object::~Object().
87 virtual ~BookmarkItem(void);
90 * Gets the title from the current bookmark item.
94 * @return The title of the current bookmark item
96 Tizen::Base::String GetTitle(void) const;
99 * Gets the URL from the current bookmark item.
103 * @return The URL of the current bookmark item @n
104 * If the item type is folder, this method will return the empty string.
107 Tizen::Base::String GetUrl(void) const;
110 * Gets the favicon image from current bookmark item.
116 * @exception E_SUCCESS The method is successful.
117 * @exception E_SYSTEM Either of the following conditions has occurred: @n
118 * - The method cannot proceed due to a severe system error. @n
119 * - The method has failed because it doesn't work on a service application.
120 * @remarks The specific error code can be accessed using the GetLastResult() method.
122 Tizen::Graphics::Bitmap* GetFaviconN(void) const;
125 * Gets the parent folder id of the current bookmark item.
129 * @return The parent folder id of the current bookmark item @n
130 * If the current bookmark item is the one in topmost level, this method will return ::ROOT_FOLDER_ID.
132 RecordId GetParentFolderId(void) const;
135 * Checks whether the type of current bookmark item is folder or not.
139 * @return @c true if the type of current bookmark item is folder, @n
142 bool IsFolder(void) const;
145 * Gets the hash value of the current instance.
149 * @return The hash value of the current instance
151 virtual int GetHashCode(void) const;
154 * Compares two instances of the %BookmarkItem class.
158 * @return @c true if the two instances match, or if and only if the two instances contain the same elements, @n
160 * @param[in] obj The object to compare with the current instance
161 * @see Tizen::Base::Object::Equals()
163 virtual bool Equals(const Tizen::Base::Object& obj) const;
166 * Copying of objects using this copy assignment operator is allowed.
170 * @param[in] rhs The instance of the %BookmarkItem class to assign from
172 BookmarkItem& operator =(const BookmarkItem& rhs);
176 // This default constructor is intentionally declared as private to implement the Singleton semantic
178 // @remarks This constructor is hidden.
183 _BookmarkItemImpl* __pBookmarkItemImpl;
185 friend class _BookmarkItemImpl;
187 friend class _WebBookmarkImpl;
191 #endif // _FWEB_BOOKMARK_ITEM_H_