X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=dali-toolkit%2Fpublic-api%2Fcontrols%2Fscrollable%2Fitem-view%2Fitem-factory.h;h=db4825af263710b91f5782a57f9c4514c9e2fe82;hb=fbb1f2f599b2fc1a54b327039ce6111f4b4ba4cf;hp=84ef7b74fa5f37fb38844a08cf26208bce7c7c3b;hpb=5c07fde9dd6a022e2080c871994499e56eff89aa;p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git diff --git a/dali-toolkit/public-api/controls/scrollable/item-view/item-factory.h b/dali-toolkit/public-api/controls/scrollable/item-view/item-factory.h index 84ef7b7..db4825a 100644 --- a/dali-toolkit/public-api/controls/scrollable/item-view/item-factory.h +++ b/dali-toolkit/public-api/controls/scrollable/item-view/item-factory.h @@ -27,13 +27,15 @@ namespace Dali namespace Toolkit { /** - * @addtogroup dali-toolkit-controls-item-view + * @addtogroup dali_toolkit_controls_item_view * @{ */ /** * @brief ItemFactory is for providing actors to ItemView. + * * Each actor is identified by a unique ID, and has a linear order from 0 to GetNumberOfItems()-1. + * @SINCE_1_0.0 */ class ItemFactory { @@ -43,36 +45,41 @@ public: /** * @brief Virtual destructor. + * @SINCE_1_0.0 */ DALI_EXPORT_API virtual ~ItemFactory() {}; /** - * @brief Query the number of items available from the factory. + * @brief Queries the number of items available from the factory. * * The maximum available item has an ID of GetNumberOfItems() - 1. - * @return the number of items + * @SINCE_1_0.0 + * @return The number of items */ virtual unsigned int GetNumberOfItems() = 0; /** - * @brief Create an Actor to represent a visible item. + * @brief Creates an Actor to represent a visible item. * - * @param[in] itemId The ID of the newly visible item. - * @return An actor, or an uninitialized pointer if the ID is out of range. + * @SINCE_1_0.0 + * @param[in] itemId The ID of the newly visible item + * @return An actor, or an uninitialized pointer if the ID is out of range */ virtual Actor NewItem(unsigned int itemId) = 0; /** - * @brief Notify the factory the actor representing the item is removed from ItemView. + * @brief Notifies the factory the actor representing the item is removed from ItemView. * - * @param[in] itemId The ID of the released item. - * @param[in] actor The actor that represents the released item. + * @SINCE_1_0.0 + * @param[in] itemId The ID of the released item + * @param[in] actor The actor that represents the released item */ virtual void ItemReleased(unsigned int itemId, Actor actor) {}; /** - * Retrieve the extension for this control + * @brief Retrieves the extension for this control. * + * @SINCE_1_0.0 * @return The extension if available, NULL otherwise */ virtual Extension* GetExtension()