X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=dali%2Fpublic-api%2Fobject%2Fproperty-notification.h;h=77723361708ad90981d882b8bbdfa1e887e2ac39;hb=adae31cf70bdeed19789edc694d4baaf2fc67f21;hp=caa799b50d6682413520790ac6789df21b672514;hpb=cbe6096ae740c4812cf1bc3952542d93724ca898;p=platform%2Fcore%2Fuifw%2Fdali-core.git diff --git a/dali/public-api/object/property-notification.h b/dali/public-api/object/property-notification.h index caa799b..7772336 100644 --- a/dali/public-api/object/property-notification.h +++ b/dali/public-api/object/property-notification.h @@ -1,8 +1,8 @@ -#ifndef __DALI_PROPERTY_NOTIFICATION_H__ -#define __DALI_PROPERTY_NOTIFICATION_H__ +#ifndef DALI_PROPERTY_NOTIFICATION_H +#define DALI_PROPERTY_NOTIFICATION_H /* - * Copyright (c) 2015 Samsung Electronics Co., Ltd. + * Copyright (c) 2020 Samsung Electronics Co., Ltd. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -20,8 +20,8 @@ // INTERNAL INCLUDES #include -#include #include +#include #include namespace Dali @@ -43,25 +43,24 @@ class PropertyNotification; * @SINCE_1_0.0 * @see Dali::PropertyCondition */ -class DALI_IMPORT_API PropertyNotification : public BaseHandle +class DALI_CORE_API PropertyNotification : public BaseHandle { public: /** - * @brief Enumeration to describe how to check condition + * @brief Enumeration for description of how to check condition. * @SINCE_1_0.0 */ enum NotifyMode { - Disabled, ///< Don't notify, regardless of result of Condition @SINCE_1_0.0 - NotifyOnTrue, ///< Notify whenever condition changes from false to true. @SINCE_1_0.0 - NotifyOnFalse, ///< Notify whenever condition changes from true to false. @SINCE_1_0.0 - NotifyOnChanged ///< Notify whenever condition changes (false to true, and true to false) @SINCE_1_0.0 + DISABLED, ///< Don't notify, regardless of result of Condition @SINCE_1_9.28 + NOTIFY_ON_TRUE, ///< Notify whenever condition changes from false to true. @SINCE_1_9.28 + NOTIFY_ON_FALSE, ///< Notify whenever condition changes from true to false. @SINCE_1_9.28 + NOTIFY_ON_CHANGED ///< Notify whenever condition changes (false to true, and true to false) @SINCE_1_9.28 }; public: - /** - * @brief Create an uninitialized PropertyNotification; this can be initialized with PropertyNotification::New(). + * @brief Creates an uninitialized PropertyNotification; this can be initialized with PropertyNotification::New(). * * Calling member functions with an uninitialized Dali::Object is not allowed. * @SINCE_1_0.0 @@ -69,20 +68,20 @@ public: PropertyNotification(); /** - * @brief Downcast a handle to PropertyNotification handle. + * @brief Downcasts a handle to PropertyNotification handle. * - * If handle points to an PropertyNotification object the downcast - * produces valid handle. If not the returned handle is left + * If handle points to a PropertyNotification object, the downcast + * produces valid handle. If not, the returned handle is left * uninitialized. * * @SINCE_1_0.0 * @param[in] handle to An object * @return handle to a PropertyNotification object or an uninitialized handle */ - static PropertyNotification DownCast( BaseHandle handle ); + static PropertyNotification 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 @@ -93,7 +92,7 @@ public: * @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 */ PropertyNotification(const PropertyNotification& handle); @@ -101,13 +100,30 @@ public: * @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 */ PropertyNotification& operator=(const PropertyNotification& rhs); /** - * @brief Get the condition of this notification + * @brief Move constructor. + * + * @SINCE_1_9.22 + * @param[in] rhs A reference to the moved handle + */ + PropertyNotification(PropertyNotification&& rhs) noexcept; + + /** + * @brief Move assignment operator. + * + * @SINCE_1_9.22 + * @param[in] rhs A reference to the moved handle + * @return A reference to this handle + */ + PropertyNotification& operator=(PropertyNotification&& rhs) noexcept; + + /** + * @brief Gets the condition of this notification. * * @SINCE_1_0.0 * @return The condition is returned @@ -115,7 +131,7 @@ public: PropertyCondition GetCondition(); /** - * @brief Get the condition of this notification + * @brief Gets the condition of this notification. * * @SINCE_1_0.0 * @return The condition is returned @@ -123,17 +139,18 @@ public: const PropertyCondition& GetCondition() const; /** - * @brief Get the target handle that this notification is observing. + * @brief Gets the target handle that this notification is observing. * @SINCE_1_0.0 + * @return The target handle */ Dali::Handle GetTarget() const; /** - * @brief Get the target handle's property index that this notification + * @brief Gets the target handle's property index that this notification * is observing. * * @SINCE_1_0.0 - * @return The target property. + * @return The target property */ Property::Index GetTargetProperty() const; @@ -144,21 +161,21 @@ public: * notification should respond to the result of a condition. * * @SINCE_1_0.0 - * @param[in] mode Notification mode (Default is PropertyNotification::NotifyOnTrue) + * @param[in] mode Notification mode (Default is PropertyNotification::NOTIFY_ON_TRUE) */ - void SetNotifyMode( NotifyMode mode ); + void SetNotifyMode(NotifyMode mode); /** * @brief Retrieves the current Notification mode. * * @SINCE_1_0.0 - * @return Notification mode. + * @return Notification mode */ NotifyMode GetNotifyMode(); /** * @brief Gets the result of the last condition check that caused a signal emit, - * useful when using NotifyOnChanged mode and need to know what it changed to. + * useful when using NOTIFY_ON_CHANGED mode and need to know what it changed to. * * @SINCE_1_0.0 * @return whether condition result that triggered last emit was true or false @@ -166,21 +183,20 @@ public: bool GetNotifyResult() const; /** - * @brief Connect to this signal to be notified when the notification has occurred. + * @brief Connects to this signal to be notified when the notification has occurred. * * @SINCE_1_0.0 - * @return A signal object to Connect() with. + * @return A signal object to Connect() with */ PropertyNotifySignalType& NotifySignal(); public: // Not intended for use by Application developers - /// @cond internal /** * @brief This constructor is used by Dali New() methods. * * @SINCE_1_0.0 - * @param [in] propertyNotification A pointer to a newly allocated Dali resource + * @param[in] propertyNotification A pointer to a newly allocated Dali resource */ explicit DALI_INTERNAL PropertyNotification(Internal::PropertyNotification* propertyNotification); /// @endcond @@ -191,4 +207,4 @@ public: // Not intended for use by Application developers */ } // namespace Dali -#endif // __DALI_PROPERTY_NOTIFICATION_H__ +#endif // DALI_PROPERTY_NOTIFICATION_H