inc/FUiCtrlTab.h

   1 //
   2 // Open Service Platform
   3 // Copyright (c) 2012-2013 Samsung Electronics Co., Ltd.
   4 //
   5 // Licensed under the Flora License, Version 1.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://floralicense.org/license/
  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  * @file        FUiCtrlTab.h
  20  * @brief       This is the header file for the %Tab class.
  21  *
  22  * This header file contains the declarations of the %Tab class and its helper classes.
  23  */
  24
  25 #ifndef _FUI_CTRL_TAB_H_
  26 #define _FUI_CTRL_TAB_H_
  27
  28 #include <FBaseObject.h>
  29 #include <FBaseTypes.h>
  30 #include <FBaseString.h>
  31 #include <FGrpBitmap.h>
  32 #include <FGrpRectangle.h>
  33 #include <FUiControl.h>
  34 #include <FUiContainer.h>
  35 #include <FUiCtrlForm.h>
  36 #include <FUiIActionEventListener.h>
  37
  38 namespace Tizen { namespace Ui
  39 {
  40 class IActionEventListener;
  41 }}
  42
  43 namespace Tizen { namespace Ui { namespace Controls
  44 {
  45 class _PublicActionEvent;
  46
  47
  48 /**
  49  * @if OSPDEPREC
  50  * @class       Tab
  51  * @brief        <i> [Deprecated] </i> This class is an implementation of a %Tab control.
  52  *
  53  * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
  54  * @since       2.0
  55  *
  56  * @remarks     Note that tabs are part of a Form control, not a Frame control. This means that each tab item cannot be a form. You can associate a Panel
  57  *                              control or a ScrollPanel control to each tab item.
  58  *
  59  * The %Tab class is an implementation of a %Tab control.
  60  * %Tab control displays the user selection in the form of a horizontal list. Each
  61  * item of %Tab control consists of its text string and optional bitmap image.
  62  * Items can be added to an itemlist of the tab model with AddItem(). Items can
  63  * be inserted into an itemlist by InsertItemAt(), updated into an itemlist by SetItemAt(),
  64  * removed from an itemlist by RemoveItemAt(), etc. It is possible to customize the
  65  * background image of the tab shelf, and the image of the currently selected tab item.
  66  * A badge icon can also be used to give more information for each tab item.
  67  *
  68  * Example:
  69  *
  70  * @image html ui_controls_tab.png
  71  *
  72  *
  73  * This is the simple UI application that uses a %Tab control.
  74  *
  75  *
  76  * @code
  77 //Sample code for TabSample.h
  78
  79 #include <FUi.h>
  80
  81 class TabSample
  82         : public Tizen::Ui::Controls::Form
  83         , public Tizen::Ui::IActionEventListener
  84 {
  85 public:
  86         TabSample(void)
  87         : __pTab(null){}
  88
  89         bool Initialize(void);
  90         virtual result OnInitializing(void);
  91
  92         // IActionEventListener
  93         virtual void OnActionPerformed(const Tizen::Ui::Control& source, int actionId);
  94
  95 private:
  96         Tizen::Ui::Controls::Tab* __pTab;
  97 };
  98  *      @endcode
  99  *
 100  *      @code
 101 // Sample code for TabSample.cpp
 102 #include "TabSample.h"
 103
 104 using namespace Tizen::Ui::Controls;
 105
 106 bool
 107 TabSample::Initialize()
 108 {
 109         Construct(FORM_STYLE_NORMAL|FORM_STYLE_TEXT_TAB);
 110         return true;
 111 }
 112
 113 result
 114 TabSample::OnInitializing(void)
 115 {
 116         result r = E_SUCCESS;
 117
 118         // Gets an instance of Tab
 119         __pTab = GetTab();
 120
 121         // Adds items to the tab
 122         __pTab->AddItem(L"First", 0);
 123         __pTab->AddItem(L"Second", 1);
 124         __pTab->AddActionEventListener(*this);
 125
 126         return r;
 127 }
 128
 129 // IActionEventListener implementation
 130 void
 131 TabSample::OnActionPerformed(const Control& source, int actionId)
 132 {
 133         switch (actionId)
 134         {
 135         case 0:
 136                 {
 137                         // ....
 138                 }
 139                 break;
 140         case 1:
 141                 {
 142                         // ....
 143                 }
 144                 break;
 145         default:
 146                 break;
 147         }
 148 }
 149  * @endcode
 150  * @endif
 151  */
 152 class _OSP_EXPORT_ Tab
 153         : public Tizen::Ui::Control
 154 {
 155 public:
 156         /**
 157          * @if OSPDEPREC
 158          * Adds a listener instance.
 159          * The added listener can listen to events on the context of the given event dispatcher when they are fired.
 160          *
 161          * @brief        <i> [Deprecated] </i>
 162          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 163          * @since               2.0
 164          *
 165          * @param[in]   listener        The event listener to add
 166          * @endif
 167          */
 168         void AddActionEventListener(Tizen::Ui::IActionEventListener& listener);
 169
 170         /**
 171          * @if OSPDEPREC
 172          * Removes a listener instance.
 173          * The removed listener cannot listen to events when they are fired.
 174          *
 175          * @brief        <i> [Deprecated] </i>
 176          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 177          * @since               2.0
 178          *
 179          * @param[in]   listener        The event listener to remove
 180          * @endif
 181          */
 182         void RemoveActionEventListener(Tizen::Ui::IActionEventListener& listener);
 183
 184 public:
 185         /**
 186          * @if OSPDEPREC
 187          * Adds an item consisting of the specified text string.
 188          *
 189          * @brief        <i> [Deprecated] </i>
 190          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 191          * @since               2.0
 192          *
 193          * @return              An error code
 194          * @param[in]   text            The text string of the item
 195          * @param[in]   actionId                The action ID for this item
 196          * @exception   E_SUCCESS               The method is successful.
 197          * @exception   E_OUT_OF_RANGE  The specified @c actionId is out of range.
 198          * @exception   E_SYSTEM                A system error has occurred, or @n
 199          *                                                              the total number of items has exceed the %Tab control's maximum item count.
 200          * @remarks             The @c actionId range is @c 0-999. @n
 201          *                              The maximum number of items for %Tab with text style is @c 9. @n
 202          *                              The maximum number of items for icon style %Tab is @c 8.
 203          * @remarks     This method can only be used when the %Form control has the FORM_STYLE_TEXT_TAB style.
 204          * @endif
 205          */
 206         result AddItem(const Tizen::Base::String& text, int actionId);
 207
 208         /**
 209          * @if OSPDEPREC
 210          * Adds an item consisting of the title icon and the specified text string.
 211          *
 212          * @brief        <i> [Deprecated] </i>
 213          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 214          * @since               2.0
 215          *
 216          * @return              An error code
 217          * @param[in]   titleIcon           The bitmap for the title icon
 218          * @param[in]   text                    The text string of the item
 219          * @param[in]   actionId                The specified @c actionId for this item
 220          * @exception   E_SUCCESS       The method is successful.
 221          * @exception   E_OUT_OF_RANGE  The specified @c actionId is out of range.
 222          * @exception   E_SYSTEM        A system error has occurred, or @n
 223          *                                                              the total number of items has exceed the %Tab control's maximum item count.
 224          * @remarks         The @c actionId range is @c 0-999. @n
 225          *                              The maximum number of items for %Tab with text style is @c 9. @n
 226          *              The maximum number of items for icon style %Tab is @c 8. @n
 227          *                              This method can only be used when the %Form control has the FORM_STYLE_TEXT_TAB style.
 228          * @remarks     If the size of bitmap is greater than the default size , the bitmap is scaled down.
 229          * @endif
 230          */
 231         result AddItem(const Tizen::Graphics::Bitmap& titleIcon, const Tizen::Base::String& text, int actionId);
 232
 233         /**
 234          * @if OSPDEPREC
 235          * Adds the item that consists of the specified icon.
 236          *
 237          * @brief        <i> [Deprecated] </i>
 238          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 239          * @since               2.0
 240          *
 241          * @return              An error code
 242          * @param[in]   icon            The bitmap for the icon
 243          * @param[in]   actionId                The specified @c actionId for this item
 244          * @exception   E_SUCCESS       The method is successful.
 245          * @exception   E_OUT_OF_RANGE  The specified @c actionId is out of range.
 246          * @exception   E_SYSTEM                A system error has occurred, or @n
 247          *                                                              the total number of items has exceed the %Tab control's maximum item count.
 248          * @remarks         The @c actionId range is @c 0-999. @n
 249          *                              The maximum number of items for %Tab with text style is @c 9. @n
 250          *                              The maximum number of items for icon style %Tab is @c 8. @n
 251          *              This method can only be used when the Form control has the FORM_STYLE_ICON_TAB style. @n
 252          *                              If the size of the bitmap is greater than the default size, the bitmap is scaled down.
 253          * @endif
 254          */
 255         result AddItem(const Tizen::Graphics::Bitmap& icon, int actionId);
 256
 257         /**
 258          * @if OSPDEPREC
 259          * Inserts the item that consists of only a text string at the specified index.
 260          *
 261          * @brief        <i> [Deprecated] </i>
 262          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 263          * @since               2.0
 264          *
 265          * @return              An error code
 266          * @param[in]   index           The index of the item
 267          * @param[in]   text            The text string of the item
 268          * @param[in]   actionId        The specified @c actionId for this item
 269          * @exception   E_SUCCESS       The method is successful.
 270          * @exception   E_OUT_OF_RANGE  The specified @c actionId is out of range.
 271          * @exception   E_SYSTEM        A system error has occurred, or @n
 272          *                                                              the total number of items has exceed the %Tab control's maximum item count.
 273          * @remarks         The @c actionId range is @c 0-999. @n
 274          *                              The maximum number of items for %Tab with text style is @c 9. @n
 275          *                              The maximum number of items for icon style %Tab is @c 8.
 276          * @remarks     This method can only be used when the Form control has the FORM_STYLE_TEXT_TAB style.
 277          * @endif
 278          */
 279         result InsertItemAt(int index, const Tizen::Base::String& text, int actionId);
 280
 281         /**
 282          * @if OSPDEPREC
 283          * Inserts the item that consists of the title icon and specified text string at the specified index.
 284          *
 285          * @brief        <i> [Deprecated] </i>
 286          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 287          * @since               2.0
 288          *
 289          * @return              An error code
 290          * @param[in]   index           The index of the item
 291          * @param[in]   titleIcon           The bitmap for the title icon
 292          * @param[in]   text                    The text string of the item
 293          * @param[in]   actionId                The specified @c actionId for this item
 294          * @exception   E_SUCCESS       The method is successful.
 295          * @exception   E_OUT_OF_RANGE  The specified @c actionId is out of range.
 296          * @exception   E_SYSTEM        A system error has occurred, or @n
 297          *                                                              the total number of items has exceed the %Tab control's maximum item count.
 298          * @remarks         The @c actionId range is @c 0-999.
 299          * @remarks     The maximum number of items for %Tab with text style is @c 9. @n
 300          *              The maximum number of items for icon style %Tab is @c 8. @n
 301          *                              This method can only be used when the %Form control has the FORM_STYLE_TEXT_TAB style. @n
 302          *                              If the size of bitmap is greater than the default size, the bitmap is scaled down.
 303          * @endif
 304          */
 305         result InsertItemAt(int index, const Tizen::Graphics::Bitmap& titleIcon, const Tizen::Base::String& text, int actionId);
 306
 307         /**
 308          * @if OSPDEPREC
 309          * Inserts the item which consists of the title icon and specified text string at the specified index.
 310          *
 311          * @brief        <i> [Deprecated] </i>
 312          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 313          * @since               2.0
 314          *
 315          * @return              An error code
 316          * @param[in]   index                   The index of the item
 317          * @param[in]   icon            The Bitmap for the Icon
 318          * @param[in]   actionId                The specified @c actionId for this item
 319          * @exception   E_SUCCESS       The method is successful.
 320          * @exception   E_OUT_OF_RANGE  The specified @c actionId is out of range.
 321          * @exception   E_SYSTEM        A system error has occurred, or @n
 322          *                                                              the total number of items has exceed the %Tab control's maximum item count.
 323          * @remarks         The @c actionId range is @c 0-999.
 324          * @remarks             The maximum number of items for %Tab with text style is @c 9. @n
 325          *                              The maximum number of items for icon style %Tab is @c 8. @n
 326          *                              This method can only be used when the Form control has the FORM_STYLE_ICON_TAB style. @n
 327          *                              If the size of bitmap is greater than the default size, the bitmap is scaled down.
 328          * @endif
 329          */
 330         result InsertItemAt(int index, const Tizen::Graphics::Bitmap& icon, int actionId);
 331
 332         /**
 333          * @if OSPDEPREC
 334          * Sets the item that consists of only a text string at the specified index.
 335          *
 336          * @brief        <i> [Deprecated] </i>
 337          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 338          * @since               2.0
 339          *
 340          * @return              An error code
 341          * @param[in]   index                   The index of the item
 342          * @param[in]   text                    The text string of the item
 343          * @param[in]   actionId                The specified @c actionId for this item
 344          * @exception   E_SUCCESS       The method is successful.
 345          * @exception   E_OUT_OF_RANGE  The specified @c actionId is out of range.
 346          * @exception   E_SYSTEM        A system error has occurred.
 347          * @remarks         The @c actionId range is @c 0-999. @n
 348          *                              This method can only be used when the Form control has the FORM_STYLE_TEXT_TAB style.
 349          * @endif
 350          */
 351         result SetItemAt(int index, const Tizen::Base::String& text, int actionId);
 352
 353         /**
 354          * @if OSPDEPREC
 355          * Sets the item that consists of the title icon and the specified text string at the given index.
 356          *
 357          * @brief        <i> [Deprecated] </i>
 358          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 359          * @since               2.0
 360          *
 361          * @return              An error code
 362          * @param[in]   index           The index of the item
 363          * @param[in]   titleIcon       The bitmap for the title icon
 364          * @param[in]   text            The text string of the item
 365          * @param[in]   actionId                The action ID for the item
 366          * @exception   E_SUCCESS       The method is successful.
 367          * @exception   E_OUT_OF_RANGE  The specified @c actionId is out of range.
 368          * @exception   E_SYSTEM        A system error has occurred.
 369          * @remarks         The @c actionId range is @c 0-999. @n
 370          *                              This method can only be used when the Form control has the FORM_STYLE_TEXT_TAB style. @n
 371          *                              If the size of bitmap is greater than the default size, the bitmap is scaled down.
 372          * @endif
 373          */
 374         result SetItemAt(int index, const Tizen::Graphics::Bitmap& titleIcon, const Tizen::Base::String& text, int actionId);
 375
 376         /**
 377          * @if OSPDEPREC
 378          * Sets the item that consists of only a title icon at the specified index.
 379          *
 380          * @brief        <i> [Deprecated] </i>
 381          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 382          * @since               2.0
 383          *
 384          * @return              An error code
 385          * @param[in]   index                   The index of the item
 386          * @param[in]   icon            The bitmap for the icon
 387          * @param[in]   actionId                The action ID for the item
 388          * @exception   E_SUCCESS       The method is successful.
 389          * @exception   E_OUT_OF_RANGE  The specified @c actionId is out of range.
 390          * @exception   E_SYSTEM        A system error has occurred.
 391          * @remarks         The @c actionId range is @c 0-999. @n
 392          *                              This method can only be used when the Form control has the FORM_STYLE_ICON_TAB style. @n
 393          *                              If the size of bitmap is greater than the default size, the bitmap is scaled down.
 394          * @endif
 395          */
 396         result SetItemAt(int index, const Tizen::Graphics::Bitmap& icon, int actionId);
 397
 398         /**
 399          * @if OSPDEPREC
 400          * Removes item at the given index from the tab.
 401          *
 402          * @brief        <i> [Deprecated] </i>
 403          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 404          * @since               2.0
 405          *
 406          * @return              An error code
 407          * @param[in]   index               The index of the item
 408          * @exception   E_SUCCESS       The method is successful.
 409          * @exception   E_INVALID_ARG   The specified input parameter is invalid.
 410          * @exception   E_SYSTEM        A system error has occurred.
 411          * @endif
 412          */
 413         result RemoveItemAt(int index);
 414
 415         /**
 416          * @if OSPDEPREC
 417          * Removes all the items from the tab.
 418          *
 419          * @brief        <i> [Deprecated] </i>
 420          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 421          * @since               2.0
 422          *
 423          * @return              An error code
 424          * @exception   E_SUCCESS               The method is successful.
 425          * @exception   E_SYSTEM                A system error has occurred.
 426          * @endif
 427          */
 428         result RemoveAllItems(void);
 429
 430         /**
 431          * @if OSPDEPREC
 432          * Sets the badge icon of the specified item.
 433          *
 434          * @brief        <i> [Deprecated] </i>
 435          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 436          * @since               2.0
 437          *
 438          * @return              An error code
 439          * @param[in]   actionId                The specified @c actionId for this item
 440          * @param[in]   pBadgeIcon          The bitmap for the icon
 441          * @exception   E_SUCCESS       The method is successful.
 442          * @exception   E_OUT_OF_RANGE  The specified @c actionId is out of range.
 443          * @exception   E_SYSTEM                A system error has occurred.
 444          * @remarks         The @c actionId range is @c 0-999. @n
 445          *                              If the size of bitmap is greater than the default size, the bitmap is scaled down.
 446          * @endif
 447          */
 448         result SetBadgeIcon(int actionId, const Tizen::Graphics::Bitmap* pBadgeIcon);
 449
 450         /**
 451          * @if OSPDEPREC
 452          * Gets the number of items in the specified tab.
 453          *
 454          * @brief        <i> [Deprecated] </i>
 455          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 456          * @since               2.0
 457          *
 458          * @return              The number of items in the tab
 459          * @endif
 460          */
 461         int GetItemCount(void) const;
 462
 463         /**
 464          * @if OSPDEPREC
 465          * Gets the index of the item at the specified action ID.
 466          *
 467          * @brief        <i> [Deprecated] </i>
 468          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 469          * @since               2.0
 470          *
 471          * @return              The index of the item, @n
 472          *                          else @c -1 if an error occurs
 473          * @param[in]   actionId                The action ID of the item
 474          * @remarks             The @c actionId range is @c 0-999.
 475          * @endif
 476          */
 477         int GetItemIndexFromActionId(int actionId) const;
 478
 479         /**
 480          * @if OSPDEPREC
 481          * Gets the action ID of the item at the specified index.
 482          *
 483          * @brief        <i> [Deprecated] </i>
 484          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 485          * @since               2.0
 486          *
 487          * @return              The action ID of the item, @n
 488          *              else @c -1 if @c index is less than @c 0 or greater than the item count of tab
 489          * @param[in]   index           The index of the item
 490          * @endif
 491          */
 492         int GetItemActionIdAt(int index) const;
 493
 494         /**
 495          * @if OSPDEPREC
 496          * Sets the selected item for the specified index.
 497          *
 498          * @brief        <i> [Deprecated] </i>
 499          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 500          * @since               2.0
 501          *
 502          * @param[in]   index   The index of the item
 503          * @endif
 504          */
 505         void SetSelectedItem(int index);
 506
 507         /**
 508          * @if OSPDEPREC
 509          * Gets the index of the selected item from the tab.
 510          *
 511          * @brief        <i> [Deprecated] </i>
 512          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 513          * @since               2.0
 514          *
 515          * @return      The index of the item, @n
 516          *                              else @c -1 if an error occurs
 517          * @endif
 518          */
 519         int GetSelectedItemIndex(void) const;
 520
 521         /**
 522          * @if OSPDEPREC
 523          * Sets the edit-enabled mode.
 524          *
 525          * @brief        <i> [Deprecated] </i>
 526          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 527          * @since               2.0
 528          *
 529          * @param[in]   enable  Set to @c true to enable edit mode, @n
 530          *                                              else @c false
 531          * @endif
 532          */
 533         void SetEditModeEnabled(bool enable);
 534
 535         /**
 536          * @if OSPDEPREC
 537          * Checks whether the edit mode is set.
 538          *
 539          * @brief        <i> [Deprecated] </i>
 540          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 541          * @since               2.0
 542          *
 543          * @return              @c true if the edit mode is set, @n
 544          *                              else @c false
 545          * @endif
 546          */
 547         bool IsEditModeEnabled(void) const;
 548
 549         /**
 550          * @if OSPDEPREC
 551          * Sets the background bitmap of the tab.
 552          *
 553          * @brief        <i> [Deprecated] </i>
 554          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 555          * @since               2.0
 556          *
 557          * @return          An error code
 558          * @param[in]   bitmap                  The background bitmap
 559          * @exception   E_SUCCESS       The method is successful.
 560          * @exception   E_INVALID_ARG   The background bitmap is invalid.
 561          * @exception   E_SYSTEM                A system error has occurred.
 562          * @endif
 563          */
 564         result SetBackgroundBitmap(const Tizen::Graphics::Bitmap& bitmap);
 565
 566         /**
 567          * @if OSPDEPREC
 568          * Sets the background bitmap of the focused item.
 569          *
 570          * @brief        <i> [Deprecated] </i>
 571          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 572          * @since               2.0
 573          *
 574          * @return              An error code
 575          * @param[in]   bitmap                  The background bitmap of the focused item
 576          * @exception   E_SUCCESS       The method is successful.
 577          * @exception   E_INVALID_ARG   The background bitmap is invalid.
 578          * @exception   E_SYSTEM                A system error has occurred.
 579          * @endif
 580          */
 581         result SetFocusedItemBackgroundBitmap(const Tizen::Graphics::Bitmap& bitmap);
 582
 583         /**
 584          * @if OSPDEPREC
 585          * Sets the text color of the tab.
 586          *
 587          * @brief        <i> [Deprecated] </i>
 588          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 589          * @since               2.0
 590          *
 591          * @param[in]   textColor               The color to set
 592          * @endif
 593          */
 594         void SetTextColor(const Tizen::Graphics::Color& textColor);
 595
 596         /**
 597          * @if OSPDEPREC
 598          * Gets the text color of the tab.
 599          *
 600          * @brief        <i> [Deprecated] </i>
 601          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 602          * @since                       2.0
 603          *
 604          * @return                      The text color
 605          * @endif
 606          */
 607         Tizen::Graphics::Color GetTextColor(void) const;
 608
 609         /**
 610          * @if OSPDEPREC
 611          * Sets the text color for the selected item of the tab.
 612          *
 613          * @brief        <i> [Deprecated] </i>
 614          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 615          * @since                       2.0
 616          *
 617          * @param[in]           textColor               The color to set
 618          * @endif
 619          */
 620         void SetSelectedTextColor(const Tizen::Graphics::Color& textColor);
 621
 622         /**
 623          * @if OSPDEPREC
 624          * Gets the text color for the selected item of the tab.
 625          *
 626          * @brief        <i> [Deprecated] </i>
 627          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 628          * @since                       2.0
 629          *
 630          * @return                      The text color
 631          * @endif
 632          */
 633         Tizen::Graphics::Color GetSelectedTextColor(void) const;
 634
 635         /**
 636          * @if OSPDEPREC
 637          * Gets the color of the text when the %Tab item is highlighted.
 638          *
 639          * @brief        <i> [Deprecated] </i>
 640          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 641          * @since           2.0
 642          *
 643          * @return          The highlighted text color
 644          * @remarks         When a user navigates the user interface using the directional keys, the focused UI control is highlighted.
 645          * @endif
 646          */
 647         Tizen::Graphics::Color GetHighlightedTextColor(void) const;
 648
 649         /**
 650          * @if OSPDEPREC
 651          * Sets the color of the text when the tab item is highlighted.
 652          *
 653          * @brief        <i> [Deprecated] </i>
 654          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 655          * @since       2.0
 656          *
 657          * @param[in]   color   The color to set
 658          * @remarks     When a user navigates the user interface using the directional keys, the focused UI control is highlighted.
 659          * @endif
 660          */
 661         void SetHighlightedTextColor(const Tizen::Graphics::Color& color);
 662
 663         /**
 664          * @if OSPDEPREC
 665          * Sets the background bitmap of the highlighted tab item.
 666          *
 667          * @brief        <i> [Deprecated] </i>
 668          * @deprecated  This class is deprecated because the use of the %Tab control is no longer recommended.
 669          * @since               2.0
 670          *
 671          * @return      An error code
 672          * @param[in]   bitmap            The background bitmap of the focused item
 673          * @exception   E_SUCCESS         The method is successful.
 674          * @exception   E_INVALID_ARG     The background bitmap is invalid.
 675          * @exception   E_SYSTEM          A system error has occurred.
 676          * @remarks             The background bitmap must use the 9-patched bitmap.
 677          * @remarks             When a user navigates the user interface using the directional keys, the focused UI control is highlighted.
 678          * @endif
 679          */
 680         result SetHighlightedItemBackgroundBitmap(const Tizen::Graphics::Bitmap& bitmap);
 681
 682
 683         //void SetStyle(int style);
 684
 685 private:
 686         //
 687         // This method is for internal use only.
 688         // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
 689         //
 690         // 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.
 691         // @since         2.0
 692         //
 693         Tab(void);
 694
 695         //
 696         // This method is for internal use only.
 697         // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
 698         //
 699         // 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.
 700         // @since         2.0
 701         //
 702         virtual ~Tab(void);
 703
 704         //
 705         // This method is for internal use only.
 706         // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
 707         //
 708         // Initializes this instance of %Tab with the specified parameter.
 709         //
 710         // @since         2.0
 711         // @return              An error code
 712         // @param[in]   tabHandle               The handle of the tab
 713         // @exception   E_SUCCESS       The method is successful.
 714         // @exception   E_SYSTEM                A system error has occurred.
 715         //
 716         result Construct(void);
 717
 718         //
 719         // Stores __BitmapItem.
 720         //
 721         Tizen::Base::Collection::ArrayList __items;
 722
 723 private:
 724         friend class _TabImpl;
 725
 726 };
 727
 728 }}} //Tizen::Ui::Controls
 729
 730 #endif // _FUI_CTRL_TAB_H_