X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=inc%2FFUiCtrlGroupedList.h;h=e75a552d3fe91d2e182cdd9e55c1ce9df4a6aba2;hb=e9c41ee70f34877291c56082e40592f259ce1e54;hp=b268a32fff14ddfb360b82ea018fed21cd04fe31;hpb=fa32ff33f232f7b35d1e04d98927de2982d3bd72;p=platform%2Fframework%2Fnative%2Fuifw.git
diff --git a/inc/FUiCtrlGroupedList.h b/inc/FUiCtrlGroupedList.h
index b268a32..e75a552 100644
--- a/inc/FUiCtrlGroupedList.h
+++ b/inc/FUiCtrlGroupedList.h
@@ -2,24 +2,26 @@
// Open Service Platform
// Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.
//
-// Licensed under the Flora License, Version 1.0 (the License);
+// Licensed under the Apache License, Version 2.0 (the License);
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
-// http://floralicense.org/license/
+// http://www.apache.org/licenses/LICENSE-2.0/
//
// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an AS IS BASIS,
+// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
/**
+ * @if OSPDEPREC
* @file FUiCtrlGroupedList.h
* @brief This is the header file for the %GroupedList class.
*
* This header file contains the declarations of the %GroupedList class and its helper classes.
+ * @endif
*/
#ifndef _FUI_CTRL_GROUPED_LIST_H_
@@ -39,7 +41,7 @@
namespace Tizen { namespace Ui { namespace Controls {
/**
- * @if OSPDEPREC
+ * @if OSPDEPREC
* @class GroupedList
* @brief [Deprecated] This class defines the common behavior of a %GroupedList control.
*
@@ -163,7 +165,7 @@ GroupedListSample::OnInitializing(void)
}
// Adds the grouped list to the form
- AddControl(*__pGroupedList);
+ AddControl(__pGroupedList);
// Deallocates bitmaps
delete pBitmapNormal;
@@ -254,7 +256,8 @@ class _OSP_EXPORT_ GroupedList
public:
/**
* @if OSPDEPREC
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called. @n
+ * For full construction, the GroupedList::Construct() method must be called right after calling this constructor.
*
* @brief [Deprecated]
* @deprecated This class is deprecated. Instead of using this class, use GroupedListView class.
@@ -265,7 +268,8 @@ public:
/**
* @if OSPDEPREC
- * This polymorphic destructor should be overridden if required. This way, the destructors of the derived classes are called when the destructor of this interface is called.
+ * This polymorphic destructor should be overridden if required. @n
+ * This way, the destructors of the derived classes are called when the destructor of this interface is called.
*
* @brief [Deprecated]
* @deprecated This class is deprecated. Instead of using this class, use GroupedListView class.
@@ -284,7 +288,7 @@ public:
*
* @return An error code
* @param[in] rect An instance of the Graphics::Rectangle class @n
- * This instance represents the X, Y coordinates of the top-left corner of the created %GroupedList along with the width and
+ * This instance represents the X, Y coordinates of the top-left corner of the created %GroupedList along with the width and
* height.
* @param[in] style The style of the %GroupedList control
* @param[in] itemDivider Set to @c true to display an item divider, @n
@@ -294,8 +298,9 @@ public:
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG A specified input parameter is invalid.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The size of the control must be within the range as defined by the minimum and maximum size.
- * @remarks The minimum size of this control is 274 x 148 on a WVGA screen, 180 x 96 on a HVGA screen and 137 x 74 on a WQVGA screen.
+ * @remarks
+ * - The size of the control must be within the range as defined by the minimum and maximum size.
+ * - The minimum size of this control is 274 x 148 on a WVGA screen, 180 x 96 on a HVGA screen and 137 x 74 on a WQVGA screen.
* @endif
*/
result Construct(const Tizen::Graphics::Rectangle& rect, CustomListStyle style, bool itemDivider = true, bool fastScroll = false);
@@ -309,7 +314,7 @@ public:
* @since 2.0
*
* @return An error code
- * @param[in] text The string of the group to be appended
+ * @param[in] text The string of the group to append
* @param[in] pBackgroundBitmap The background bitmap of the group
* @param[in] groupId The ID of the group
* @exception E_SUCCESS The method is successful.
@@ -348,7 +353,7 @@ public:
*
* @return An error code
* @param[in] groupIndex The group index
- * @param[in] text The string of the group to be appended
+ * @param[in] text The string of the group to append
* @param[in] pBackgroundBitmap The bitmap of the group
* @param[in] groupId The ID of the group
* @exception E_SUCCESS The method is successful.
@@ -371,8 +376,9 @@ public:
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c groupIndex is invalid.
* @exception E_SYSTEM A system error has occurred.
- * @remarks When the specified group is removed, all the items in the group are also removed. @n
- * The removed list items are deleted from the memory.
+ * @remarks
+ * - When the specified group is removed, all the items in the group are also removed.
+ * - The removed list items are deleted from the memory.
* @endif
*/
result RemoveGroupAt(int groupIndex);
@@ -388,8 +394,9 @@ public:
* @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM A system error has occurred.
- * @remarks When the specified group is removed, all the items in the group are also removed. @n
- * The removed list items are deleted from the memory.
+ * @remarks
+ * - When the specified group is removed, all the items in the group are also removed.
+ * - The removed list items are deleted from the memory.
* @endif
*/
result RemoveAllGroups(void);
@@ -417,13 +424,14 @@ public:
*
* @return An error code
* @param[in] groupIndex The group index
- * @param[in] item The custom list item object to be added
+ * @param[in] item The custom list item object to add
* @param[in] itemId The specified item ID for this item
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c groupIndex or @c itemId is invalid.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The added item is deleted automatically when the list is destroyed. @n
- * Do not add, insert, or set an item that already belongs to a %GroupedList control.
+ * @remarks
+ * - The added item is deleted automatically when the list is destroyed.
+ * - Do not add, insert, or set an item that already belongs to a %GroupedList control.
* @endif
*/
result AddItem(int groupIndex, const CustomListItem& item, int itemId = LIST_ITEM_UNSPECIFIED_ID);
@@ -439,13 +447,14 @@ public:
* @return An error code
* @param[in] groupIndex The group index
* @param[in] itemIndex The item index in the specified group
- * @param[in] item The custom list item to be inserted
+ * @param[in] item The custom list item to insert
* @param[in] itemId The item ID for this item
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c groupIndex or @c itemId is invalid.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The inserted item is deleted automatically when the list is destroyed.
- * Do not add, insert, or set an item that already belongs to a %GroupedList control.
+ * @remarks
+ * - The inserted item is deleted automatically when the list is destroyed.
+ * - Do not add, insert, or set an item that already belongs to a %GroupedList control.
* @endif
*/
result InsertItemAt(int groupIndex, int itemIndex, const CustomListItem& item, int itemId = LIST_ITEM_UNSPECIFIED_ID);
@@ -461,7 +470,7 @@ public:
* @return An error code
* @param[in] groupIndex The group index
* @param[in] itemIndex The item index in the specified group
- * @param[in] item The custom list item to be set
+ * @param[in] item The custom list item to set
* @param[in] itemId The item ID for this item
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified @c groupIndex or @c itemId is invalid.
@@ -545,7 +554,7 @@ public:
* @deprecated This class is deprecated. Instead of using this class, use GroupedListView class.
* @since 2.0
*
- * @param[in] color The color of the text to be displayed
+ * @param[in] color The color of the text to display
* @endif
*/
void SetTextColorOfEmptyList(const Tizen::Graphics::Color& color);
@@ -966,7 +975,7 @@ public:
* @deprecated This class is deprecated. Instead of using this class, use GroupedListView class.
* @since 2.0
*
- * @param[in] listener The listener to be added
+ * @param[in] listener The listener to add
* @endif
*/
void AddFastScrollEventListener(Tizen::Ui::IFastScrollEventListener& listener);
@@ -979,7 +988,7 @@ public:
* @deprecated This class is deprecated. Instead of using this class, use GroupedListView class.
* @since 2.0
*
- * @param[in] listener The listener to be removed
+ * @param[in] listener The listener to remove
* @endif
*/
void RemoveFastScrollEventListener(Tizen::Ui::IFastScrollEventListener& listener);
@@ -992,7 +1001,7 @@ public:
* @deprecated This class is deprecated. Instead of using this class, use GroupedListView class.
* @since 2.0
*
- * @param[in] listener The listener to be added
+ * @param[in] listener The listener to add
* @endif
*/
void AddGroupedItemEventListener(Tizen::Ui::IGroupedItemEventListener& listener);
@@ -1005,7 +1014,7 @@ public:
* @deprecated This class is deprecated. Instead of using this class, use GroupedListView class.
* @since 2.0
*
- * @param[in] listener The listener to be removed
+ * @param[in] listener The listener to remove
* @endif
*/
void RemoveGroupedItemEventListener(Tizen::Ui::IGroupedItemEventListener& listener);