public:
/**
- * @brief An enumeration of properties belonging to the PanGestureDetector class.
+ * @brief Enumeration for the instance of properties belonging to the PanGestureDetector class.
* @SINCE_1_0.0
*/
struct Property
{
+ /**
+ * @brief Enumeration for the instance of properties belonging to the PanGestureDetector class.
+ * @SINCE_1_0.0
+ */
enum
{
SCREEN_POSITION = DEFAULT_GESTURE_DETECTOR_PROPERTY_START_INDEX, ///< name "screenPosition", type Vector2 @SINCE_1_0.0
public: // Creation & Destruction
/**
- * @brief Create an uninitialized PanGestureDetector; this can be initialized with PanGestureDetector::New().
+ * @brief Creates an uninitialized PanGestureDetector; this can be initialized with PanGestureDetector::New().
*
* Calling member functions with an uninitialized PanGestureDetector handle is not allowed.
* @SINCE_1_0.0
PanGestureDetector();
/**
- * @brief Create an initialized PanGestureDetector.
+ * @brief Creates an initialized PanGestureDetector.
*
* @SINCE_1_0.0
- * @return A handle to a newly allocated Dali resource.
+ * @return A handle to a newly allocated Dali resource
*/
static PanGestureDetector New();
/**
- * @brief Downcast a handle to PanGestureDetector handle.
+ * @brief Downcasts a handle to PanGestureDetector handle.
*
- * If handle points to a PanGestureDetector object the
- * downcast produces valid handle. If not the returned handle is left uninitialized.
+ * If handle points to a PanGestureDetector object, the
+ * downcast produces valid handle. If not, the returned handle is left uninitialized.
* @SINCE_1_0.0
* @param[in] handle Handle to an object
* @return Handle to a PanGestureDetector object or an uninitialized handle
static PanGestureDetector DownCast( BaseHandle handle );
/**
- * @brief Destructor
+ * @brief Destructor.
*
* This is non-virtual since derived Handle types must not contain data or virtual methods.
* @SINCE_1_0.0
* @brief This copy constructor is required for (smart) pointer semantics.
*
* @SINCE_1_0.0
- * @param [in] handle A reference to the copied handle
+ * @param[in] handle A reference to the copied handle
*/
PanGestureDetector(const PanGestureDetector& handle);
* @brief This assignment operator is required for (smart) pointer semantics.
*
* @SINCE_1_0.0
- * @param [in] rhs A reference to the copied handle
+ * @param[in] rhs A reference to the copied handle
* @return A reference to this
*/
PanGestureDetector& operator=(const PanGestureDetector& rhs);
* @brief This is the minimum number of touches required for the pan gesture to be detected.
*
* @SINCE_1_0.0
- * @param[in] minimum Minimum touches required.
+ * @param[in] minimum Minimum touches required
* @pre The gesture detector has been initialized.
* @note The default minimum is '1'.
*/
* @brief This is the maximum number of touches required for the pan gesture to be detected.
*
* @SINCE_1_0.0
- * @param[in] maximum Maximum touches required.
+ * @param[in] maximum Maximum touches required
* @pre The gesture detector has been initialized.
* @note The default maximum is '1'.
*/
* @brief Retrieves the minimum number of touches required for the pan gesture to be detected.
*
* @SINCE_1_0.0
- * @return The minimum touches required.
+ * @return The minimum touches required
* @pre The gesture detector has been initialized.
*/
unsigned int GetMinimumTouchesRequired() const;
* @brief Retrieves the maximum number of touches required for the pan gesture to be detected.
*
* @SINCE_1_0.0
- * @return The maximum touches required.
+ * @return The maximum touches required
* @pre The gesture detector has been initialized.
*/
unsigned int GetMaximumTouchesRequired() const;
* direction range is from -45 to 45 degrees.
*
* @SINCE_1_0.0
- * @param[in] angle The angle that pan should be allowed.
- * @param[in] threshold The threshold around that angle.
+ * @param[in] angle The angle that pan should be allowed
+ * @param[in] threshold The threshold around that angle
*
* @pre The gesture detector has been initialized.
* @note The angle added using this API is only checked when the gesture first starts, after that,
* right scrolling.
*
* @SINCE_1_0.0
- * @param[in] direction The direction of panning required.
- * @param[in] threshold The threshold.
+ * @param[in] direction The direction of panning required
+ * @param[in] threshold The threshold
*
* @pre The gesture detector has been initialized.
*
* @brief Returns the count of angles that this pan gesture detector emits a signal.
*
* @SINCE_1_0.0
- * @return The count.
+ * @return The count
* @pre The gesture detector has been initialized.
*/
size_t GetAngleCount() const;
* @brief Returns the angle by index that this pan gesture detector emits a signal.
*
* @SINCE_1_0.0
- * @return An angle threshold pair, or a zero valued angle pair when index is invalid.
+ * @param[in] index The angle's index
+ * @return An angle threshold pair, or a zero valued angle pair when index is invalid
* @pre The gesture detector has been initialized.
* @pre The index is less than GetAngleCount()
*/
* @brief Removes the angle specified from the container.
*
* @SINCE_1_0.0
- * @param[in] angle The angle to remove.
+ * @param[in] angle The angle to remove
* @pre The gesture detector has been initialized.
* @note This will only remove the first instance of the angle found from the container.
* @note If an angle outside the range in AddAngle() is given, then the value is wrapped within
* @brief Removes the two angles that make up the direction from the container.
*
* @SINCE_1_0.0
- * @param[in] direction The direction to remove.
+ * @param[in] direction The direction to remove
* @pre The gesture detector has been initialized.
* @note If a direction outside the range in AddAngle() is given, then the value is wrapped within
* the range and that is removed.
* void YourCallbackName( Actor actor, const PanGesture& gesture );
* @endcode
* @SINCE_1_0.0
- * @return The signal to connect to.
+ * @return The signal to connect to
* @pre The gesture detector has been initialized.
*/
DetectedSignalType& DetectedSignal();
* @brief Allows setting of the pan properties that are returned in constraints.
*
* @SINCE_1_0.0
- * @param[in] pan The pan gesture to set.
+ * @param[in] pan The pan gesture to set
* @note If a normal pan is taking place, then any value set is ignored.
*/
static void SetPanGestureProperties( const PanGesture& pan );
public: // Not intended for Application developers
/**
+ * @internal
* @brief This constructor is used by PanGestureDetector::New() methods.
*
* @SINCE_1_0.0
- * @param [in] internal A pointer to a newly allocated Dali resource.
+ * @param[in] internal A pointer to a newly allocated Dali resource
*/
explicit DALI_INTERNAL PanGestureDetector(Internal::PanGestureDetector* internal);