inc/FUiCtrlListItemBase.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  * @file        FUiCtrlListItemBase.h
  20  * @brief       This is the header file for the %ListItemBase class.
  21  *
  22  * This header file contains the declarations of the %ListItemBase class and its helper classes.
  23  */
  24
  25 #ifndef _FUI_CTRL_LIST_ITEM_BASE_H_
  26 #define _FUI_CTRL_LIST_ITEM_BASE_H_
  27
  28 #include <FBaseObject.h>
  29 #include <FBaseTypes.h>
  30 #include <FGrpBitmap.h>
  31 #include <FGrpRectangle.h>
  32 #include <FUiCtrlListContextItem.h>
  33 #include <FUiCtrlListViewTypes.h>
  34
  35 namespace Tizen { namespace Ui { namespace Controls
  36 {
  37
  38 class _ListItemBaseImpl;
  39
  40 /**
  41  * @class   ListItemBase
  42  * @brief   This class defines common behavior for a %ListItemBase.
  43  *
  44  * @since   2.0
  45  *
  46  * The %ListItemBase class is a base class, which represents a list item which is the unit of handling of the ListView or
  47  * GroupedListView classes.
  48  *
  49  * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/ui/implementing_listviews.htm">ListViews</a>.
  50  */
  51
  52 class _OSP_EXPORT_ ListItemBase
  53         : public Tizen::Base::Object
  54 {
  55 public:
  56         /**
  57          * This destructor overrides Tizen::Base::Object::~Object().
  58          *
  59          * @since       2.0
  60          */
  61         virtual ~ListItemBase(void);
  62
  63         /**
  64          * Sets the background image of the item which is displayed when the item is in specified state.
  65          *
  66          * @since   2.0
  67          *
  68          * @return  An error code
  69          * @param[in] status            The item drawing state
  70          * @param[in] pBitmap           The background bitmap image
  71          * @exception E_SUCCESS         The method is successful.
  72          * @exception E_SYSTEM          A system error has occurred.
  73          * @remarks     The background bitmap has priority over the background color. When both the background bitmap and the background color are specified,
  74          *                      only the bitmap is displayed.
  75          */
  76         result SetBackgroundBitmap(ListItemDrawingStatus status, const Tizen::Graphics::Bitmap* pBitmap);
  77
  78         /**
  79          * Sets the background color of the item which is displayed when the item is in specified state.
  80          *
  81          * @since   2.0
  82          *
  83          * @return  An error code
  84          * @param[in] status            The item drawing state
  85          * @param[in] color             The background color
  86          * @exception E_SUCCESS         The method is successful.
  87          * @exception E_SYSTEM          A system error has occurred.
  88          * @remarks     The background bitmap has priority over the background color. When both the background bitmap and the background color are specified, only the bitmap is displayed. @n
  89          *                      The background color of the item is not applied when the item is inserted into the GroupedListView of section style.
  90          */
  91         result SetBackgroundColor(ListItemDrawingStatus status, const Tizen::Graphics::Color& color);
  92
  93         /**
  94          * Gets the background color of the item that is displayed when the item is in the specified state.
  95          *
  96          * @since   2.0
  97          *
  98          * @return  The background color of the item
  99          * @param[in] status        The item drawing state, @n
 100          *                                                      else RGBA(0, 0, 0, 0) if an error has occurs
 101          * @see     SetBackgroundColor()
 102          */
 103         Tizen::Graphics::Color GetBackgroundColor(ListItemDrawingStatus status) const;
 104
 105         /**
 106          * Sets ContextItem that is displayed when an item is swept.
 107          *
 108          * @since   2.0
 109          *
 110          * @return  An error code
 111          * @param[in] pItem             The %ListContextItem instance
 112          * @exception E_SUCCESS         The method is successful.
 113          * @exception E_INVALID_ARG     A specified input parameter is invalid.
 114          * @exception E_SYSTEM          A system error has occurred.
 115          * @remarks
 116          *                      - If the context item is not set, ListView() or GroupedListView() does not display the context item and an item sweep event is generated when an
 117          *                      item is swept.
 118          *                      - The specified @c pItem should be deleted by the applications when it is no longer used.
 119          */
 120         result SetContextItem(const ListContextItem* pItem);
 121
 122         /**
 123          * Sets the description text.
 124          *
 125          * @since   2.0
 126          *
 127          * @return  An error code
 128          * @param[in] text              Description text
 129          * @exception E_SUCCESS         The method is successful.
 130          * @exception E_SYSTEM          A system error has occurred.
 131          */
 132         result SetDescriptionText(const Tizen::Base::String& text);
 133
 134         /**
 135          * Sets the color of the description text.
 136          *
 137          * @since   2.0
 138          *
 139          * @return  An error code
 140          * @param[in] color             The color of the description text
 141          * @exception E_SUCCESS         The method is successful.
 142          * @exception E_SYSTEM          A system error has occurred.
 143          */
 144         result SetDescriptionTextColor(const Tizen::Graphics::Color& color);
 145
 146         /**
 147          * Gets the width of the annex area.
 148          *
 149          * @since       2.0
 150          *
 151          * @return  The width of the annex
 152          * @param[in] style             The style of the annex
 153          * @remarks  The width of the annex area is different among annex styles.
 154          */
 155         static int GetAnnexWidth(ListAnnexStyle style);
 156
 157         /**
 158          * Gets the width of the annex area.
 159          *
 160          * @since       2.1
 161          *
 162          * @return  The width of the annex
 163          * @param[in] style             The style of the annex
 164          * @remarks  The width of the annex area is different among annex styles.
 165          */
 166         static float GetAnnexWidthF(ListAnnexStyle style);
 167
 168 protected:
 169         friend class _ListItemBaseImpl;
 170
 171 protected:
 172         //
 173         // This default constructor is intentionally declared as private so that only the platform can create an instance.
 174         // @since       2.0
 175         //
 176         ListItemBase(void);
 177
 178         //
 179         // Initializes this instance of ListItem with the specified parameter.
 180         //
 181         // @since   2.0
 182         //
 183         // @return  An error code
 184         //
 185         // @param[in] itemSize          The size of the item
 186         // @param[in] style             The style of Annex
 187         // @exception E_SUCCESS         The method is successful.
 188         // @exception E_SYSTEM          A system error has occurred.
 189         //
 190         result Construct(const Tizen::Graphics::Dimension& itemSize, ListAnnexStyle style);
 191
 192         //
 193         // Initializes this instance of ListItem with the specified parameter.
 194         //
 195         // @since   2.1
 196         //
 197         // @return  An error code
 198         //
 199         // @param[in] itemSize          The size of the item
 200         // @param[in] style             The style of Annex
 201         // @exception E_SUCCESS         The method is successful.
 202         // @exception E_SYSTEM          A system error has occurred.
 203         //
 204         result Construct(const Tizen::Graphics::FloatDimension& itemSize, ListAnnexStyle style);
 205
 206         //
 207         // The following methods are reserved and may change its name at any time without prior notice.
 208         //
 209         virtual void ListItemBase_Reserved1(void) {}
 210         virtual void ListItemBase_Reserved2(void) {}
 211         virtual void ListItemBase_Reserved3(void) {}
 212
 213 private:
 214         //
 215         // The implementation of this copy constructor is intentionally blank and declared as private to prohibit copying of objects.
 216         //
 217         ListItemBase(const ListItemBase& rhs);
 218
 219         //
 220         // The implementation of this copy assignment operator is intentionally blank and declared as private to prohibit copying of objects.
 221         //
 222         ListItemBase& operator =(const ListItemBase& rhs);
 223
 224 protected:
 225         _ListItemBaseImpl* _pImpl;
 226 }; // ListItemBase
 227
 228 }}} // Tizen::Ui::Controls
 229
 230 #endif  // _FUI_CTRL_LIST_ITEM_BASE_H_