inc/FUiCtrlSlidableGroupedList.h

   1 //
   2 // Open Service Platform
   3 // Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.
   4 //
   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
   8 //
   9 //     http://www.apache.org/licenses/LICENSE-2.0/
  10 //
  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.
  16 //
  17
  18 /**
  19  * @if OSPDEPREC
  20  * @file        FUiCtrlSlidableGroupedList.h
  21  * @brief       This is the header file for the %SlidableGroupedList class.
  22  *
  23  * This header file contains the declarations of the %SlidableGroupedList class and its helper classes.
  24  * @endif
  25  */
  26 #ifndef _FUI_CTRL_SLIDABLE_GROUPED_LIST_H_
  27 #define _FUI_CTRL_SLIDABLE_GROUPED_LIST_H_
  28
  29 #include <FBaseObject.h>
  30 #include <FBaseTypes.h>
  31 #include <FGrpRectangle.h>
  32 #include <FUiControl.h>
  33 #include <FUiContainer.h>
  34 #include <FUiCtrlGroupedList.h>
  35 #include <FUiCtrlControlsTypes.h>
  36 #include <FUiISlidableGroupedListEventListener.h>
  37 #include <FUiCtrlCustomListItem.h>
  38
  39 namespace Tizen { namespace Base { namespace Runtime
  40 {
  41 class IEvent;
  42 } } }
  43
  44 namespace Tizen { namespace Ui { namespace Controls
  45 {
  46
  47 /**
  48  * @if OSPDEPREC
  49  * @class               SlidableGroupedList
  50  * @brief       <i> [Deprecated] </i> This class defines the common behavior of the %SlidableGroupedList control.
  51  *
  52  * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
  53  * @since               2.0
  54  *
  55  * The %SlidableGroupedList class represents a list which loads grouped
  56  * items on demand and unloads unused grouped items to save memory. Like GroupedList,
  57  * the list items of GroupedList consist of groups and items. A group represents grouped
  58  * items and is inserted into the first level just as items are inserted into List. Items
  59  * which are from CustomListItems are inserted under related groups. So, items are uniquely
  60  * identified with two indices: group index and item index.
  61  *
  62  * The operation of %SlidableGroupedList is the same as that of a GroupedList, except
  63  * that a %SlidableGroupedList does not hold all items in the memory. Most of the item manipulations
  64  * are available when they are loaded, but the check state is maintained for all items
  65  * whether they are loaded or not.
  66  * ISlidableGroupedListEventListener must be implemented so that an application can
  67  * be notified when the items need to be loaded as the user scrolls through a list.
  68  * If an application wants to perform tasks when the state of a list item is changed,
  69  * it must implement IGroupedItemEventListener and register it to the slidable
  70  * grouped list. It will then receive related events from %SlidableGroupedList.
  71  *
  72  * Note that CustomListItem and CustomListItemFormat need to be created on a heap. CustomListItems will be deleted automatically
  73  * when the %SlidableGroupedList itself is destroyed. If you want to remove certain list items, you must use RemoveItemAt(). CustomListItemFormat
  74  * must be deleted by the application.
  75  *
  76  * Refer to CustomListItem and CustomListItemFormat.
  77  *
  78  * Example:
  79  *
  80  * @image html ui_controls_slidablegroupedlist.png
  81  *
  82  * This is the simple UI application which uses a %SlidableGroupedList control.
  83  *
  84  * @code
  85 // Sample code for SlidableGroupedListSample.h
  86 #include <FUi.h>
  87
  88 class SlidableGroupedListSample
  89         : public Tizen::Ui::Controls::Form
  90         , public Tizen::Ui::IGroupedItemEventListener
  91         , public Tizen::Ui::ISlidableGroupedListEventListener
  92 {
  93 public:
  94         SlidableGroupedListSample(void)
  95         : __pSlidableGroupedList(null)
  96         , __pCustomListItemFormat(null){}
  97
  98         bool Initialize(void);
  99         virtual result OnInitializing(void);
 100         virtual result OnTerminating(void);
 101
 102         Tizen::Ui::Controls::CustomListItem* LoadListItem(int itemId);
 103         virtual void OnItemStateChanged(const Tizen::Ui::Control &source, int groupIndex, int itemIndex, int itemId, int elementId, Tizen::Ui::ItemStatus status);
 104         virtual void OnItemStateChanged(const Tizen::Ui::Control &source, int groupIndex, int itemIndex, int itemId, Tizen::Ui::ItemStatus status);
 105         virtual void OnListPropertyRequested(const Tizen::Ui::Control &source);
 106         virtual void OnLoadToTopRequested(const Tizen::Ui::Control &source, int groupIndex, int itemIndex, int numItems);
 107         virtual void OnLoadToBottomRequested(const Tizen::Ui::Control &source, int groupIndex, int itemIndex, int numItems);
 108         virtual void OnUnloadItemRequested(const Tizen::Ui::Control& source, int groupIndex, int itemIndex);
 109
 110 private:
 111         static const int ID_LIST_TEXT  = 101;
 112         static const int ID_LIST_BITMAP = 102;
 113         static const int ITEM_HEIGHT = 103;
 114         static const int ITEM_COUNT = 104;
 115         static const int ITEM_COUNT_GROUP1 = 10;
 116         static const int ITEM_COUNT_GROUP2 = 20;
 117         static const int ITEM_COUNT_GROUP3 = 30;
 118         static const int ITEM_ID_LIMITS = 30;
 119
 120         Tizen::Ui::Controls::SlidableGroupedList* __pSlidableGroupedList;
 121         Tizen::Ui::Controls::CustomListItemFormat* __pCustomListItemFormat;
 122 };
 123  *      @endcode
 124  *
 125  *      @code
 126 // Sample code for SlidableGroupedListSample.cpp
 127 #include <FApp.h>
 128 #include <FGraphics.h>
 129
 130 #include "SlidableGroupedListSample.h"
 131
 132 using namespace Tizen::App;
 133 using namespace Tizen::Base;
 134 using namespace Tizen::Base::Collection;
 135 using namespace Tizen::Graphics;
 136 using namespace Tizen::Ui;
 137 using namespace Tizen::Ui::Controls;
 138
 139
 140 bool
 141 SlidableGroupedListSample::Initialize(void)
 142 {
 143         Construct(FORM_STYLE_NORMAL);
 144         return true;
 145 }
 146
 147 result
 148 SlidableGroupedListSample::OnInitializing(void)
 149 {
 150         result r = E_SUCCESS;
 151
 152         // Creates an instance of SlidableGroupedList
 153         __pSlidableGroupedList = new SlidableGroupedList();
 154         __pSlidableGroupedList->Construct(Rectangle(0, 0, GetClientAreaBounds().width, GetClientAreaBounds().height), CUSTOM_LIST_STYLE_NORMAL);
 155         __pSlidableGroupedList->AddGroupedItemEventListener(*this);
 156         __pSlidableGroupedList->AddSlidableGroupedListEventListener(*this);
 157
 158         // Creates an instance of CustomListItemFormat
 159         __pCustomListItemFormat = new CustomListItemFormat();
 160         __pCustomListItemFormat->Construct();
 161         __pCustomListItemFormat->AddElement(ID_LIST_TEXT, Rectangle(10, 25, 240, 80));
 162         __pCustomListItemFormat->AddElement(ID_LIST_BITMAP, Rectangle(250, 10, 70, 80));
 163
 164         // Adds the groups to the slidable grouped list
 165         __pSlidableGroupedList->AddGroup(L"Group1", null, ITEM_COUNT_GROUP1, ITEM_COUNT_GROUP1 * ITEM_HEIGHT);
 166         __pSlidableGroupedList->AddGroup(L"Group2", null, ITEM_COUNT_GROUP2, ITEM_COUNT_GROUP2 * ITEM_HEIGHT);
 167         __pSlidableGroupedList->AddGroup(L"Group3", null, ITEM_COUNT_GROUP3, ITEM_COUNT_GROUP3 * ITEM_HEIGHT);
 168
 169         // Adds the slidable grouped list to the form
 170         AddControl(__pSlidableGroupedList);
 171
 172         return r;
 173 }
 174
 175 result
 176 SlidableGroupedListSample::OnTerminating(void)
 177 {
 178         result r = E_SUCCESS;
 179
 180         // Deallocates the item format
 181         delete __pCustomListItemFormat;
 182
 183         return r;
 184 }
 185
 186 CustomListItem*
 187 SlidableGroupedListSample::LoadListItem(int itemId)
 188 {
 189         // Gets instances of Bitmap
 190         AppResource* pAppResource = Application::App::GetInstance()->GetAppResource();
 191         Bitmap *pBitmapNormal  = pAppResource->GetBitmapN(L"tizen.png");
 192         Bitmap *pBitmapFocused = pAppResource->GetBitmapN(L"tizen.png");
 193
 194         // Creates an instance of String to set an item element
 195         String itemText;
 196         int groupIndex = itemId / ITEM_ID_LIMITS;
 197         int itemIndex  = itemId % ITEM_ID_LIMITS;
 198         itemText.Format(128, L"ITEM %d-%d", groupIndex+1, itemIndex+1);
 199
 200         // Creates an instance of CustomListItem
 201         CustomListItem* pItem = new CustomListItem();
 202         pItem->Construct(ITEM_HEIGHT);
 203         pItem->SetItemFormat(*__pCustomListItemFormat);
 204         pItem->SetElement(ID_LIST_TEXT, itemText);
 205         pItem->SetElement(ID_LIST_BITMAP, *pBitmapNormal, pBitmapFocused);
 206
 207         // Deallocates bitmaps
 208         delete pBitmapNormal;
 209         delete pBitmapFocused;
 210
 211         return pItem;
 212 }
 213
 214 // IGroupedItemEventListener implementation
 215 void
 216 SlidableGroupedListSample::OnItemStateChanged(const Control &source, int groupIndex, int itemIndex, int itemId, ItemStatus status)
 217 {
 218         switch (itemId)
 219         {
 220         case 1:
 221                 {
 222                         // ....
 223                 }
 224                 break;
 225         default:
 226                 break;
 227         }
 228 }
 229
 230 void
 231 SlidableGroupedListSample::OnItemStateChanged(const Control &source, int groupIndex, int itemIndex, int itemId, int elementId, ItemStatus status)
 232 {
 233         switch (itemId)
 234         {
 235         case 1:
 236                 switch (elementId)
 237                 {
 238                 case ID_LIST_TEXT:
 239                         {
 240                                 // ....
 241                         }
 242                         break;
 243                 case ID_LIST_BITMAP:
 244                         {
 245                                 // ....
 246                         }
 247                         break;
 248                 }
 249                 break;
 250         default:
 251                 break;
 252         }
 253 }
 254
 255 // IFastScrollEventListener implementation
 256 void
 257 SlidableGroupedListSample::OnListPropertyRequested(const Control &source)
 258 {
 259         // ....
 260 }
 261
 262 void
 263 SlidableGroupedListSample::OnLoadToTopRequested(const Control &source, int groupIndex, int itemIndex, int numItems)
 264 {
 265         for(int i=0; i < numItems; ++i)
 266         {
 267                 // Loads items upwards
 268                 int itemId = ITEM_ID_LIMITS * groupIndex + itemIndex;
 269
 270                 CustomListItem* pItem = LoadListItem(itemId);
 271                 __pSlidableGroupedList->LoadItemToTop(*pItem, itemId);
 272         }
 273 }
 274
 275 void
 276 SlidableGroupedListSample::OnLoadToBottomRequested (const Control &source, int groupIndex, int itemIndex, int numItems)
 277 {
 278         for(int i=0; i< numItems; ++i)
 279         {
 280                 // Loads items downwards
 281                 int itemId = ITEM_ID_LIMITS * groupIndex + itemIndex + i;
 282
 283                 CustomListItem* pItem = LoadListItem(itemId);
 284                 __pSlidableGroupedList->LoadItemToBottom(*pItem, itemId);
 285         }
 286 }
 287
 288 void
 289 SlidableGroupedListSample::OnUnloadItemRequested(const Control& source, int groupIndex, int itemIndex)
 290 {
 291         // Releases resources of the specified item
 292         // ....
 293 }
 294  * @endcode
 295  * @endif
 296  */
 297 class _OSP_EXPORT_ SlidableGroupedList
 298         : public Tizen::Ui::Control
 299 {
 300 public:
 301         /**
 302          * @if OSPDEPREC
 303          * The object is not fully constructed after this constructor is called. @n
 304          * For full construction, the SlidableGroupedList::Construct() method must be called right after calling this constructor.
 305          *
 306          * @brief       <i> [Deprecated] </i>
 307          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 308          * @since       2.0
 309          * @endif
 310          */
 311         SlidableGroupedList(void);
 312
 313         /**
 314          * @if OSPDEPREC
 315          * This polymorphic destructor should be overridden if required.@n
 316          * This way, the destructors of the derived classes are called when the destructor of this interface is called.
 317          *
 318          * @brief       <i> [Deprecated] </i>
 319          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 320          * @since       2.0
 321          * @endif
 322          */
 323         virtual ~SlidableGroupedList(void);
 324
 325 // Operation
 326         /**
 327          * @if OSPDEPREC
 328          * Initializes this instance of %SlidableGroupedList with the specified parameters.
 329          *
 330          * @brief       <i> [Deprecated] </i>
 331          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 332          * @since     2.0
 333          *
 334          * @return    An error code
 335          * @param[in] rect           An instance of the Graphics::Rectangle class @n
 336          *                                                                      This instance represents the x and y coordinates of the top-left corner of the created %SlidableGroupedList along with
 337          *                                                                      the width and height.
 338          * @param[in] style          The style of the CustomListItem instances
 339          * @param[in]   itemDivider                     Set to @c true to display an item divider, @n
 340          *                                                                      else @c false
 341          * @param[in]   fastScroll                      Set to @c true to use fast scroll, @n
 342          *                                                                      else @c false
 343          * @exception   E_SUCCESS                       The method is successful.
 344          * @exception   E_INVALID_ARG     A specified input parameter is invalid.
 345          * @exception   E_SYSTEM                        A system error has occurred.
 346          * @remarks
 347          *                              - The size of the control must be within the range defined by the minimum size and the maximum size.
 348          *                              - 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.
 349          *
 350          * @endif
 351          */
 352         result Construct(const Tizen::Graphics::Rectangle& rect, CustomListStyle style, bool itemDivider = true, bool fastScroll = false);
 353
 354         /**
 355          * @if OSPDEPREC
 356          * Adds the specified listener instance.
 357          * The added listener can listen to the events on the context of the given event dispatcher when they are fired.
 358          *
 359          * @brief       <i> [Deprecated] </i>
 360          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 361          * @since                       2.0
 362          *
 363          * @param[in]   listener        The event listener to add
 364          * @endif
 365          */
 366         void AddSlidableGroupedListEventListener(Tizen::Ui::ISlidableGroupedListEventListener& listener);
 367
 368         /**
 369          * @if OSPDEPREC
 370          * Removes the specified listener instance.
 371          * The removed listener cannot listen to the events when they are fired.
 372          *
 373          * @brief       <i> [Deprecated] </i>
 374          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 375          * @since                       2.0
 376          *
 377          * @param[in]   listener        The event listener to remove
 378          * @endif
 379          */
 380         void RemoveSlidableGroupedListEventListener(Tizen::Ui::ISlidableGroupedListEventListener& listener);
 381
 382         /**
 383          * @if OSPDEPREC
 384          * Loads the item to the top of the %SlidableGroupedList control.
 385          *
 386          * @brief       <i> [Deprecated] </i>
 387          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 388          * @since                       2.0
 389          *
 390          * @return              An error code
 391          * @param[in]   item            The %CustomListItem instance
 392          * @param[in]   itemId                  The item ID
 393          * @exception   E_SUCCESS               The method is successful.
 394          * @exception   E_SYSTEM                A system error has occurred.
 395          * @endif
 396          */
 397         result LoadItemToTop(const Tizen::Ui::Controls::CustomListItem& item, int itemId = LIST_ITEM_UNSPECIFIED_ID);
 398
 399         /**
 400          * @if OSPDEPREC
 401          * Loads the item to the end of the %SlidableGroupedList control.
 402          *
 403          * @brief       <i> [Deprecated] </i>
 404          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 405          * @since                       2.0
 406          *
 407          * @return              An error code
 408          * @param[in]   item            The %CustomListItem object
 409          * @param[in]   itemId                  The item ID
 410          * @exception   E_SUCCESS               The method is successful.
 411          * @exception   E_SYSTEM                A system error has occurred.
 412          * @endif
 413          */
 414         result LoadItemToBottom(const Tizen::Ui::Controls::CustomListItem& item, int itemId = LIST_ITEM_UNSPECIFIED_ID);
 415
 416         /**
 417          * @if OSPDEPREC
 418          * Unloads all the loaded items of the %SlidableGroupedList control.
 419          *
 420          * @brief       <i> [Deprecated] </i>
 421          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 422          * @since                       2.0
 423          *
 424          * @return              An error code
 425          * @exception   E_SUCCESS               The method is successful.
 426          * @exception   E_SYSTEM                A system error has occurred.
 427          * @endif
 428          */
 429         result UnloadAllItems(void);
 430
 431
 432         /**
 433          * @if OSPDEPREC
 434          * Removes all the items in the specified group. @n
 435          * The group is not removed.
 436          *
 437          * @brief       <i> [Deprecated] </i>
 438          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 439          * @since                       2.0
 440          *
 441          * @return              An error code
 442          * @param[in]   groupIndex              The group index
 443          * @exception   E_SUCCESS               The method is successful.
 444          * @exception   E_INVALID_ARG   A specified input parameter is invalid.
 445          * @exception   E_SYSTEM                A system error has occurred.
 446          * @remarks   The removed list items are deleted from the memory.
 447          * @endif
 448          */
 449         result RemoveAllItemsAt(int groupIndex);
 450
 451         /**
 452          * @if OSPDEPREC
 453          * Removes all the items in the list.
 454          *
 455          * @brief       <i> [Deprecated] </i>
 456          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 457          * @since                       2.0
 458          *
 459          * @return              An error code
 460          * @exception   E_SUCCESS               The method is successful.
 461          * @exception   E_SYSTEM                A system error has occurred.
 462          * @remarks
 463          *                              - The removed list items are deleted from the memory.
 464          *                              - After the items have been removed, the ISlidableGroupedListEventListener::OnListPropertyRequested() method is called.
 465          * @see                         ISlidableGroupedListEventListener
 466          * @endif
 467          */
 468         result RemoveAllItems(void);
 469
 470         /**
 471          * @if OSPDEPREC
 472          * Removes the specified listener instance. @n
 473          * The removed listener cannot listen to events when they are fired.
 474          *
 475          * @brief       <i> [Deprecated] </i>
 476          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 477          * @since                       2.0
 478          *
 479          * @param[in]   listener                The event listener to remove
 480          * @endif
 481          */
 482         void RemoveFastScrollEventListener(Tizen::Ui::IFastScrollEventListener& listener);
 483
 484         /**
 485          * @if OSPDEPREC
 486          * Removes the specified listener instance. @n
 487          * The removed listener cannot listen to events when they are fired.
 488          *
 489          * @brief       <i> [Deprecated] </i>
 490          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 491          * @since                       2.0
 492          *
 493          * @param[in]   listener        The event listener to remove
 494          * @endif
 495          */
 496         void RemoveGroupedItemEventListener(Tizen::Ui::IGroupedItemEventListener& listener);
 497
 498         /**
 499          * @if OSPDEPREC
 500          * Scrolls to the bottom of the %SlidableGroupedList control.
 501          *
 502          * @brief       <i> [Deprecated] </i>
 503          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 504          * @since                       2.0
 505          * @endif
 506          */
 507         void ScrollToBottom(void);
 508
 509         /**
 510          * @if OSPDEPREC
 511          * Scrolls to the top of the %SlidableGroupedList control.
 512          *
 513          * @brief       <i> [Deprecated] </i>
 514          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 515          * @since                       2.0
 516          * @endif
 517          */
 518         void ScrollToTop(void);
 519
 520         /**
 521          * @if OSPDEPREC
 522          * Scrolls to the item at the specified index. @n
 523          * The specified item is drawn at the top of the %SlidableGroupedList control.
 524          *
 525          * @brief       <i> [Deprecated] </i>
 526          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 527          * @since                       2.0
 528          *
 529          * @return                      An error code
 530          * @param[in]   groupIndex              The group index
 531          * @param[in]   itemIndex               The item index
 532          * @exception   E_SUCCESS               The method is successful.
 533          * @exception   E_INVALID_ARG   A specified input parameter is invalid.
 534          * @exception   E_SYSTEM            A system error has occurred.
 535          * @endif
 536          */
 537         result ScrollToTop(int groupIndex, int itemIndex);
 538
 539         /**
 540          * @if OSPDEPREC
 541          * Scrolls to the group at the specified index. @n
 542          * The specified group is drawn at the top of the %SlidableGroupedList control.
 543          *
 544          * @brief       <i> [Deprecated] </i>
 545          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 546          * @since                       2.0
 547          *
 548          * @return                      An error code
 549          * @param[in]   groupIndex              The group index
 550          * @exception   E_SUCCESS               The method is successful.
 551          * @exception   E_INVALID_ARG   The specified input parameter is invalid.
 552          * @exception   E_SYSTEM            A system error has occurred.
 553          * @endif
 554          */
 555         result ScrollToTop(int groupIndex);
 556
 557
 558         /**
 559          * @if OSPDEPREC
 560          * Sets all the items at the specified group index.
 561          *
 562          * @brief       <i> [Deprecated] </i>
 563          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 564          * @since                                       2.0
 565          *
 566          * @param[in]       groupIndex  The group index
 567          * @param[in]           check           Set to @c true to check the item, @n
 568          *                                                              else @c false to uncheck
 569          * @exception   E_SUCCESS               The method is successful.
 570          * @exception   E_INVALID_ARG   A specified input parameter is invalid.
 571          * @exception   E_SYSTEM            A system error has occurred.
 572          * @endif
 573          */
 574         result SetAllItemsChecked(int groupIndex, bool check);
 575
 576         /**
 577          * @if OSPDEPREC
 578          * Sets the contents of the group of the %SlidableGroupedList control at the specified group index.
 579          *
 580          * @brief       <i> [Deprecated] </i>
 581          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 582          * @since                       2.0
 583          *
 584          * @return              An error code
 585          * @param[in]   groupIndex                      The group index
 586          * @param[in]   text                            The string of the group to append
 587          * @param[in]   pBackgroundBitmap       The bitmap of the group
 588          * @param[in]   groupId                         The group ID
 589          * @exception   E_SUCCESS                       The method is successful.
 590          * @exception   E_SYSTEM                        A system error has occurred.
 591          * @endif
 592          */
 593         result SetGroupAt(int groupIndex, const Tizen::Base::String& text, const Tizen::Graphics::Bitmap* pBackgroundBitmap, int groupId = LIST_ITEM_UNSPECIFIED_ID);
 594
 595         /**
 596          * @if OSPDEPREC
 597          * Sets the specified item as checked or unchecked.
 598          *
 599          * @brief       <i> [Deprecated] </i>
 600          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 601          * @since                                       2.0
 602          *
 603          * @return                              An error code
 604          * @param[in]   groupIndex              The group index of the item to check
 605          * @param[in]   itemIndex               The index of the item to check
 606          * @param[in]   check                   Set to @c true to check the item, @n
 607          *                              else @c false to uncheck it
 608          * @exception   E_SUCCESS               The method is successful.
 609          * @exception   E_INVALID_ARG   A specified input parameter is invalid.
 610          * @exception   E_SYSTEM                A system error has occurred.
 611          * @endif
 612          */
 613         result SetItemChecked(int groupIndex, int itemIndex, bool check);
 614
 615         /**
 616          * @if OSPDEPREC
 617          * Enables or disables the item at the specified index of the %SlidableGroupedList.
 618          *
 619          * @brief       <i> [Deprecated] </i>
 620          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 621          * @since                       2.0
 622          *
 623          * @return              An error code
 624          * @param[in]   groupIndex              The group index of the item to check
 625          * @param[in]   itemIndex               The index of the item to check
 626          * @param[in]   enable                  Set to @c true to enable the item, @n
 627          *                              else @c false to disable it
 628          * @exception   E_SUCCESS               The method is successful.
 629          * @exception   E_INVALID_ARG   A specified input parameter is invalid.
 630          * @exception   E_SYSTEM                A system error has occurred.
 631          * @endif
 632          */
 633         result SetLoadedItemEnabled(int groupIndex, int itemIndex, bool enable);
 634
 635         /**
 636          * @if OSPDEPREC
 637          * Removes all the checked items from the group.
 638          *
 639          * @brief       <i> [Deprecated] </i>
 640          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 641          * @since                                       2.0
 642          *
 643          * @return              An error code
 644          * @param[in]   groupIndex              The group index
 645          * @param[in]   height                  The estimated/real height of the items of the group
 646          * @exception   E_SUCCESS               The method is successful.
 647          * @exception   E_INVALID_ARG   A specified input parameter is invalid.
 648          * @exception   E_SYSTEM                A system error has occurred.
 649          * @endif
 650          */
 651         result RemoveAllCheckedItemsAt(int groupIndex, int height);
 652
 653         /**
 654          * @if OSPDEPREC
 655          * Removes the specified item from the group.
 656          *
 657          * @brief       <i> [Deprecated] </i>
 658          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 659          * @since                       2.0
 660          *
 661          * @return              An error code
 662          * @param[in]   groupIndex              The group index
 663          * @param[in]   itemIndex                       The item index
 664          * @param[in]   height                  The estimated/real height of the item
 665          * @exception   E_SUCCESS               The method is successful.
 666          * @exception   E_INVALID_ARG   A specified input parameter is invalid.
 667          * @exception   E_SYSTEM                A system error has occurred.
 668          * @remarks   The removed list item is deleted from the memory.
 669          * @endif
 670          */
 671         result RemoveItemAt(int groupIndex, int itemIndex, int height);
 672
 673
 674         /**
 675          * @if OSPDEPREC
 676          * Removes the group of the %SlidableGroupedList control at the group index.
 677          *
 678          * @brief       <i> [Deprecated] </i>
 679          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 680          * @since                       2.0
 681          *
 682          * @return              An error code
 683          * @param[in]   groupIndex              The group index
 684          * @exception   E_SUCCESS               The method is successful.
 685          * @exception   E_INVALID_ARG   The specified input parameter is invalid.
 686          * @exception   E_SYSTEM                A system error has occurred.
 687          * @remarks             When the specified group is removed, all the items in the group are also removed.
 688          * @remarks   The removed list items are deleted from the memory.
 689          * @endif
 690          */
 691         result RemoveGroupAt(int groupIndex);
 692
 693
 694         /**
 695          * @if OSPDEPREC
 696          * Gets the item at the specified indexes if the item is currently loaded.
 697          *
 698          * @brief       <i> [Deprecated] </i>
 699          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 700          * @since                       2.0
 701          *
 702          * @return              A pointer to the loaded item, @n
 703          *                              else @c null if the specified item is not currently loaded
 704          * @param[in]   groupIndex              The group index
 705          * @param[in]   itemIndex               The item index
 706          * @endif
 707          */
 708         const Tizen::Ui::Controls::CustomListItem* GetLoadedItemAt(int groupIndex, int itemIndex) const;
 709
 710
 711         /**
 712          * @if OSPDEPREC
 713          * Gets the item ID at the specified index if the item is currently loaded.
 714          *
 715          * @brief       <i> [Deprecated] </i>
 716          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 717          * @since                       2.0
 718          *
 719          * @return              The item ID, @n
 720          *                              else LIST_ITEM_UNSPECIFIED_ID if the specified item is not currently loaded
 721          * @param[in]   groupIndex              The group index
 722          * @param[in]   itemIndex               The item index
 723          * @endif
 724          */
 725         int GetLoadedItemIdAt(int groupIndex, int itemIndex) const;
 726
 727
 728         /**
 729          * @if OSPDEPREC
 730          * Gets the item index from the specified item ID.
 731          *
 732          * @brief       <i> [Deprecated] </i>
 733          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 734          * @since                               2.0
 735          *
 736          * @return              An error code, @n
 737          *                              else @c -1 if the specified item is not currently loaded
 738          * @param[in]   itemId                  The item ID
 739          * @param[out]  groupIndex              The group index
 740          * @param[out]  itemIndex               The item index
 741          * @exception   E_SUCCESS               The method is successful.
 742          * @exception   E_SYSTEM                A system error has occurred.
 743          * @endif
 744          */
 745         result GetLoadedItemIndexFromItemId(int itemId, int& groupIndex, int& itemIndex) const;
 746
 747         /**
 748          * @if OSPDEPREC
 749          * Removes all the checked items of the %SlidableGroupedList control.
 750          *
 751          * @brief       <i> [Deprecated] </i>
 752          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 753          * @since                       2.0
 754          *
 755          * @return              An error code
 756          * @param[in]   height                  The height of the item to delete
 757          * @exception   E_SUCCESS               The method is successful.
 758          * @exception   E_SYSTEM                A system error has occurred.
 759          * @remarks   The removed list items are deleted from the memory.
 760          * @remarks         This method can only be used when the style of the list allows multiple selections.
 761          * @endif
 762          */
 763         result RemoveAllCheckedItems(int height);
 764
 765         /**
 766          * @if OSPDEPREC
 767          * Gets the index of the first loaded item.
 768          *
 769          * @brief       <i> [Deprecated] </i>
 770          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 771          * @since                               2.0
 772          *
 773          * @return              An error code
 774          * @param[out]  groupIndex              The group index
 775          * @param[out]  itemIndex               The item index
 776          * @exception   E_SUCCESS               The method is successful.
 777          * @exception   E_SYSTEM                A system error has occurred.
 778          * @endif
 779          */
 780         result GetFirstLoadedItemIndex(int& groupIndex, int& itemIndex) const;
 781
 782         /**
 783          * @if OSPDEPREC
 784          * Gets the index of the last loaded item.
 785          *
 786          * @brief       <i> [Deprecated] </i>
 787          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 788          * @since                               2.0
 789          *
 790          * @return              An error code
 791          * @param[out]  groupIndex              The group index
 792          * @param[out]  itemIndex               The item index
 793          * @exception   E_SUCCESS               The method is successful.
 794          * @exception   E_SYSTEM                A system error has occurred.
 795          * @endif
 796          */
 797         result GetLastLoadedItemIndex(int& groupIndex, int& itemIndex) const;
 798
 799         /**
 800          * @if OSPDEPREC
 801          * Sets the first index list of the scroll by text.
 802          *
 803          * @brief       <i> [Deprecated] </i>
 804          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 805          * @since                               2.0
 806          *
 807          * @return              An error code
 808          * @param[in]   text                    The text of the first index
 809          * @exception   E_SUCCESS               The method is successful.
 810          * @exception   E_SYSTEM                A system error has occurred.
 811          * @endif
 812          */
 813         result SetFastScrollMainIndex(const Tizen::Base::String& text);
 814
 815         /**
 816          * @if OSPDEPREC
 817          * Sets the background color of this control.
 818          *
 819          * @brief       <i> [Deprecated] </i>
 820          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 821          * @since       2.0
 822          *
 823          * @param[in]   color    The background color
 824          * @endif
 825          */
 826         void SetBackgroundColor(const Tizen::Graphics::Color& color);
 827
 828         /**
 829          * @if OSPDEPREC
 830          * Sets the text of the empty list.
 831          *
 832          * @brief       <i> [Deprecated] </i>
 833          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 834          * @since               2.0
 835          *
 836          * @param[in]   text    The text of the empty list
 837          * @endif
 838          */
 839         void SetTextOfEmptyList(const Tizen::Base::String& text);
 840
 841         /**
 842          * @if OSPDEPREC
 843          * Sets the color of the text to be displayed in the absence of a %SlidableGroupedList item.
 844          *
 845          * @brief       <i> [Deprecated] </i>
 846          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 847          * @since       2.0
 848          *
 849          * @param[in]   color   The color of the text to display
 850          * @endif
 851          */
 852         void SetTextColorOfEmptyList(const Tizen::Graphics::Color& color);
 853
 854         /**
 855          * @if OSPDEPREC
 856          * Gets the color of the text to be displayed in the absence of a %SlidableGroupedList item.
 857          *
 858          * @brief       <i> [Deprecated] </i>
 859          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 860          * @since   2.0
 861          *
 862          * @return      The color of the text to be displayed
 863          * @endif
 864          */
 865         Tizen::Graphics::Color GetTextColorOfEmptyList(void) const;
 866
 867         /**
 868          * @if OSPDEPREC
 869          * Sets the contents of the item in the specified group.
 870          *
 871          * @brief       <i> [Deprecated] </i>
 872          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 873          * @since               2.0
 874          *
 875          * @return              An error code
 876          * @param[in]   groupIndex              The group index
 877          * @param[in]   itemIndex           The %CustomListItem object
 878          * @param[in]   item            The item
 879          * @param[in]   itemId              The item ID
 880          * @exception   E_SUCCESS               The method is successful.
 881          * @exception   E_INVALID_ARG   A specified input parameter is invalid.
 882          * @exception   E_SYSTEM                A system error has occurred.
 883          * @remarks             Do not add, insert, or set an item, that already belongs to %SlidableGroupedList.
 884          * @endif
 885          */
 886         result SetItemAt(int groupIndex, int itemIndex, const Tizen::Ui::Controls::CustomListItem& item, int itemId = LIST_ITEM_UNSPECIFIED_ID);
 887
 888         /**
 889          * @if OSPDEPREC
 890          * Adds the specified listener instance.
 891          * The added listener can listen to events on the context of the given event dispatcher when they are fired.
 892          *
 893          * @brief       <i> [Deprecated] </i>
 894          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 895          * @since               2.0
 896          *
 897          * @param[in]   listener        The event listener to add
 898          * @endif
 899          */
 900         void AddFastScrollEventListener(Tizen::Ui::IFastScrollEventListener& listener);
 901
 902         /**
 903          * @if OSPDEPREC
 904          * Adds the specified group to the %SlidableGroupedList control.
 905          *
 906          * @brief       <i> [Deprecated] </i>
 907          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 908          * @since               2.0
 909          *
 910          * @return              An error code
 911          * @param[in]   text                                    The string of the group to append
 912          * @param[in]   pBackgroundBitmap               The background bitmap of the group
 913          * @param[in]   itemCount                               The number of items of the group
 914          * @param[in]   groupHeight                             The total height of the items of the group
 915          * @param[in]   groupId                                 The group ID
 916          * @exception   E_SUCCESS                               The method is successful.
 917          * @exception   E_SYSTEM                                A system error has occurred.
 918          * @endif
 919          */
 920         result AddGroup(const Tizen::Base::String& text, const Tizen::Graphics::Bitmap* pBackgroundBitmap, int itemCount, int groupHeight, int groupId = LIST_ITEM_UNSPECIFIED_ID);
 921
 922         /**
 923          * @if OSPDEPREC
 924          * Adds the specified listener instance.
 925          * The added listener can listen to events on the context of the given event dispatcher when they are fired.
 926          *
 927          * @brief       <i> [Deprecated] </i>
 928          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 929          * @since               2.0
 930          *
 931          * @param[in]   listener        The event listener to add
 932          * @endif
 933          */
 934         void AddGroupedItemEventListener(Tizen::Ui::IGroupedItemEventListener& listener);
 935
 936
 937         /**
 938          * @if OSPDEPREC
 939          * Adds the item to the specified group.
 940          *
 941          * @brief       <i> [Deprecated] </i>
 942          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 943          * @since                                       2.0
 944          *
 945          * @return              An error code
 946          * @param[in]   groupIndex              The group index
 947          * @param[in]   item                    The CustomListItem object
 948          * @param[in]   itemId                  The item ID
 949          * @exception   E_SUCCESS               The method is successful.
 950          * @exception   E_INVALID_ARG   A specified input parameter is invalid.
 951          * @exception   E_SYSTEM                A system error has occurred.
 952          * @remarks   The added item is deleted automatically when the list is destroyed.
 953          *                              Do not add, insert, or set an item that already belongs to %SlidableGroupedList.
 954          * @endif
 955          */
 956         result AddItem(int groupIndex, const Tizen::Ui::Controls::CustomListItem& item, int itemId = LIST_ITEM_UNSPECIFIED_ID);
 957
 958         /**
 959          * @if OSPDEPREC
 960          * Gets the index of the current bottom drawn item.
 961          *
 962          * @brief       <i> [Deprecated] </i>
 963          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 964          * @since                        2.0
 965          *
 966          * @return              An error code
 967          * @param[out]  groupIndex              The group index
 968          * @param[out]  itemIndex               The item index
 969          * @exception   E_SUCCESS               The method is successful.
 970          * @exception   E_SYSTEM                A system error has occurred.
 971          * @endif
 972          */
 973         result GetBottomDrawnItemIndex(int& groupIndex, int& itemIndex) const;
 974
 975
 976         /**
 977          * @if OSPDEPREC
 978          * Gets the index of the first checked list item.
 979          *
 980          * @brief       <i> [Deprecated] </i>
 981          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
 982          * @since                        2.0
 983          *
 984          * @return              An error code
 985          * @param[out]  groupIndex              The group index
 986          * @param[out]  itemIndex               The item index
 987          * @exception   E_SUCCESS               The method is successful.
 988          * @exception   E_SYSTEM                A system error has occurred.
 989          * @endif
 990          */
 991         result GetFirstCheckedItemIndex(int& groupIndex, int& itemIndex) const;
 992
 993
 994         /**
 995          * @if OSPDEPREC
 996          * Gets the group ID from the specified group index.
 997          *
 998          * @brief       <i> [Deprecated] </i>
 999          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1000          * @since                       2.0
1001          *
1002          * @return              The group ID
1003          * @param[in]   groupIndex      The group index
1004          * @endif
1005          */
1006         int GetGroupIdAt(int groupIndex) const;
1007
1008
1009         /**
1010          * @if OSPDEPREC
1011          * Gets the group index from the specified group ID.
1012          *
1013          * @brief       <i> [Deprecated] </i>
1014          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1015          * @since                       2.0
1016          *
1017          * @return              The group index
1018          * @param[in]   groupId         The group ID
1019          * @endif
1020          */
1021         int GetGroupIndexFromGroupId(int groupId) const;
1022
1023
1024         /**
1025          * @if OSPDEPREC
1026          * Gets the index of the last checked item.
1027          *
1028          * @brief       <i> [Deprecated] </i>
1029          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1030          * @since                        2.0
1031          *
1032          * @return              An error code
1033          * @param[out]  groupIndex              The group index
1034          * @param[out]  itemIndex               The item index
1035          * @exception   E_SUCCESS               The method is successful.
1036          * @exception   E_SYSTEM                A system error has occurred.
1037          * @endif
1038          */
1039         result GetLastCheckedItemIndex(int& groupIndex, int& itemIndex) const;
1040
1041         /**
1042          * @if OSPDEPREC
1043          * Gets the index of the next checked item after the specified item.
1044          *
1045          * @brief       <i> [Deprecated] </i>
1046          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1047          * @since                                       2.0
1048          *
1049          * @return                      An error code
1050          * @param[in,out]       groupIndex              The group index
1051          * @param[in,out]       itemIndex               The item index
1052          * @exception           E_SUCCESS               The method is successful.
1053          * @exception       E_SYSTEM            A system error has occurred.
1054          * @endif
1055          */
1056         result GetNextCheckedItemIndexAfter(int& groupIndex, int& itemIndex) const;
1057
1058         /**
1059          * @if OSPDEPREC
1060          * Gets the index of the current top drawn item.
1061          *
1062          * @brief       <i> [Deprecated] </i>
1063          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1064          * @since                               2.0
1065          *
1066          * @return              An error code
1067          * @param[out]  groupIndex              The group index
1068          * @param[out]  itemIndex               The item index
1069          * @exception   E_SUCCESS               The method is successful.
1070          * @exception   E_SYSTEM            A system error has occurred.
1071          * @endif
1072          */
1073         result GetTopDrawnItemIndex(int& groupIndex, int& itemIndex) const;
1074
1075         /**
1076          * @if OSPDEPREC
1077          * Gets the index of the item at the specified item position.
1078          *
1079          * @brief       <i> [Deprecated] </i>
1080          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1081          * @since                               2.0
1082          *
1083          * @return              An error code
1084          * @param[in]           x           The x position of the point
1085          * @param[in]           y           The y position of the point
1086          * @param[out]  groupIndex              The index of the group, that the item belongs to
1087          * @param[out]  itemIndex       The index of the item
1088          * @exception   E_SUCCESS               The method is successful.
1089          * @exception   E_SYSTEM                A system error has occurred. @n
1090          *                                                              There is no item at the specified position.
1091          * @endif
1092          */
1093         result GetItemIndexFromPosition(int x, int y, int& groupIndex, int& itemIndex) const;
1094
1095         /**
1096          * @if OSPDEPREC
1097          * Gets the index of the item at the specified item position.
1098          *
1099          * @brief       <i> [Deprecated] </i>
1100          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1101          * @since                               2.0
1102          *
1103          * @return              An error code
1104          * @param[in]   position        The position of the point
1105          * @param[out]  groupIndex      The index of the group, that the item belongs to
1106          * @param[out]  itemIndex       The index of the item
1107          * @exception   E_SUCCESS               The method is successful.
1108          * @exception   E_SYSTEM        A system error has occurred. @n
1109          *                                                              There is no item at the specified position.
1110          * @endif
1111          */
1112         result GetItemIndexFromPosition(const Tizen::Graphics::Point& position, int& groupIndex, int& itemIndex) const;
1113
1114         /**
1115          * @if OSPDEPREC
1116          * Inserts the group at the specified group index.
1117          *
1118          * @brief       <i> [Deprecated] </i>
1119          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1120          * @since                               2.0
1121          *
1122          * @return              An error code
1123          * @param[in]   groupIndex                      The group index
1124          * @param[in]   text                            The string of the group to append
1125          * @param[in]   pBackgroundBitmap       The background bitmap of the group
1126          * @param[in]   itemCount                       The count of all the items in the group
1127          * @param[in]   groupHeight                     The total height of all the items in the group
1128          * @param[in]   groupId                         The group ID
1129          * @exception   E_SUCCESS                   The method is successful.
1130          * @exception   E_INVALID_ARG       A specified input parameter is invalid.
1131          * @exception   E_SYSTEM                    A system error has occurred.
1132          * @endif
1133          */
1134         result InsertGroupAt(int groupIndex, const Tizen::Base::String& text, const Tizen::Graphics::Bitmap* pBackgroundBitmap, int itemCount, int groupHeight, int groupId = LIST_ITEM_UNSPECIFIED_ID);
1135
1136         /**
1137          * @if OSPDEPREC
1138          * Checks whether the item at the specified index is checked.
1139          *
1140          * @brief       <i> [Deprecated] </i>
1141          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1142          * @since                       2.0
1143          *
1144          * @return              @c true if the item is checked, @n
1145          *                  else @c false
1146          * @param[in]   groupIndex                      The group index
1147          * @param[in]   itemIndex                       The item index
1148          *
1149          * @remarks     This method can only be used when the style of the list allows selection.
1150          * @endif
1151          */
1152         bool IsItemChecked(int groupIndex, int itemIndex) const;
1153
1154         /**
1155          * @if OSPDEPREC
1156          * Checks whether the item at the specified index is enabled.
1157          *
1158          * @brief       <i> [Deprecated] </i>
1159          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1160          * @since                       2.0
1161          *
1162          * @return      @c true if the item is enabled, @n
1163          *              else @c false
1164          * @param[in]   groupIndex                      The group index
1165          * @param[in]   itemIndex                       The item index
1166          * @endif
1167          */
1168         bool IsLoadedItemEnabled(int groupIndex, int itemIndex) const;
1169
1170
1171         /**
1172          * @if OSPDEPREC
1173          * Checks whether the item at the specified index is currently loaded to the slidable list.
1174          *
1175          * @brief       <i> [Deprecated] </i>
1176          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1177          * @since               2.0
1178          *
1179          * @return      @c true if the item is loaded, @n
1180          *                              else @c false
1181          * @param[in]   groupIndex                      The group index
1182          * @param[in]   itemIndex                       The item index
1183          * @endif
1184          */
1185         bool IsItemLoaded(int groupIndex, int itemIndex) const;
1186
1187
1188         /**
1189          * @if OSPDEPREC
1190          * Removes all the groups of the %SlidableGroupedList control.
1191          *
1192          * @brief       <i> [Deprecated] </i>
1193          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1194          * @since               2.0
1195          *
1196          * @return              An error code
1197          * @exception   E_SUCCESS               The method is successful.
1198          * @exception   E_SYSTEM                A system error has occurred.
1199          * @remarks             When the specified group is removed, all the items in the group are also removed.
1200          * @remarks     The removed list items are deleted from the memory.
1201          * @remarks             After the items have been removed, the ISlidableGroupedListEventListener::OnListPropertyRequested() method is called.
1202          * @endif
1203          */
1204         result RemoveAllGroups(void);
1205
1206         /**
1207          * @if OSPDEPREC
1208          * Gets the count of all the groups of the %SlidableGroupedList control.
1209          *
1210          * @brief       <i> [Deprecated] </i>
1211          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1212          * @since               2.0
1213          *
1214          * @return              The count of all the groups
1215          * @endif
1216          */
1217         int GetGroupCount(void) const;
1218
1219         /**
1220          * @if OSPDEPREC
1221          * Inserts the item to the specified group and item indices.
1222          *
1223          * @brief       <i> [Deprecated] </i>
1224          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1225          * @since               2.0
1226          *
1227          * @return              An error code
1228          * @param[in]   groupIndex              The group index
1229          * @param[in]   itemIndex               The item index
1230          * @param[in]   item            The CustomListItem object
1231          * @param[in]   itemId                  The item ID
1232          * @exception   E_SUCCESS               The method is successful.
1233          * @exception   E_SYSTEM                A system error has occurred.
1234          * @remarks     The inserted item is deleted automatically when the list is destroyed.
1235          *                              Do not add, insert, or set an item, that already belongs to %SlidableGroupedList.
1236          * @endif
1237          */
1238         result InsertItemAt(int groupIndex, int itemIndex, const Tizen::Ui::Controls::CustomListItem& item, int itemId = LIST_ITEM_UNSPECIFIED_ID);
1239
1240
1241         /**
1242          * @if OSPDEPREC
1243          * Gets the count of all the items in the specified group.
1244          *
1245          * @brief       <i> [Deprecated] </i>
1246          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1247          * @since               2.0
1248          *
1249          * @return              The count of all the items in the specified group
1250          * @param[in]   groupIndex              The group index
1251          * @endif
1252          */
1253         int GetItemCountAt(int groupIndex) const;
1254
1255         /**
1256          * @if OSPDEPREC
1257          * Draws and shows the specified item of %SlidableGroupedList.
1258          *
1259          * @brief       <i> [Deprecated] </i>
1260          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1261          * @since                       2.0
1262          *
1263          * @return              An error code
1264          * @param[in]   groupIndex              The group index
1265          * @param[in]   itemIndex               The item index
1266          * @exception   E_SUCCESS               The method is successful.
1267          * @exception   E_INVALID_ARG   The specified @c groupIndex or @c itemIndex is invalid.
1268          * @exception   E_INVALID_OPERATION The item has never been drawn before calling this method.
1269          * @exception   E_SYSTEM                                A system error has occurred.
1270          * @endif
1271          */
1272         result RefreshItem(int groupIndex, int itemIndex);
1273
1274         /**
1275          * @if OSPDEPREC
1276          * Draws and shows the specified group of %SlidableGroupedList.
1277          *
1278          * @brief       <i> [Deprecated] </i>
1279          * @deprecated  This class is deprecated. Instead of using this class, use the %GroupedListView class.
1280          * @since                       2.0
1281          *
1282          * @return              An error code
1283          * @param[in]   groupIndex                      The group index
1284          * @exception   E_SUCCESS                       The method is successful.
1285          * @exception   E_INVALID_ARG           The specified @c groupIndex is invalid.
1286          * @exception   E_SYSTEM                        A system error has occurred.
1287          * @endif
1288          */
1289         result RefreshGroup(int groupIndex);
1290
1291 protected:
1292
1293         friend class _SlidableGroupedListImpl;
1294 private:
1295         //
1296         // The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
1297         //
1298         SlidableGroupedList(const SlidableGroupedList& rhs);
1299
1300         //
1301         // The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
1302         //
1303         SlidableGroupedList& operator =(const SlidableGroupedList& rhs);
1304
1305 }; //SlidableGroupedList
1306
1307 }}} // Tizen::Ui::Controls
1308
1309 #endif // _FUI_CTRL_SLIDABLE_GROUPED_LIST_H_