Merge "Ensure BaseHandle class move noexcept (core public-api)" into devel/master
[platform/core/uifw/dali-core.git] / dali / public-api / actors / actor.h
index 71fa8c7..8d3e9b6 100644 (file)
@@ -2,7 +2,7 @@
 #define DALI_ACTOR_H
 
 /*
- * Copyright (c) 2020 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2022 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.
@@ -724,6 +724,15 @@ public:
        * @SINCE_1_9.17
        */
       KEYBOARD_FOCUSABLE,
+
+      /**
+       * @brief Sets the update area hint of the actor.
+       * @details Name "updateAreaHint", type Property::VECTOR4 (x, y, width, height).
+       * @note Overrides the area - the position and the size - used for the actor damaged area calculation. Affected by the actor model view matrix.
+       * The position is relative to the center of the actor and it is also the center of the damaged area.
+       * @SINCE_2_1.33
+       */
+      UPDATE_AREA_HINT
     };
   };
 
@@ -798,7 +807,7 @@ public:
    * @SINCE_1_9.22
    * @param[in] rhs A reference to the actor to move
    */
-  Actor(Actor&& rhs);
+  Actor(Actor&& rhs) noexcept;
 
   /**
    * @brief Move assignment operator.
@@ -807,7 +816,7 @@ public:
    * @param[in] rhs A reference to the actor to move
    * @return A reference to this
    */
-  Actor& operator=(Actor&& rhs);
+  Actor& operator=(Actor&& rhs) noexcept;
 
   // Containment
 
@@ -880,12 +889,12 @@ public:
    * @brief Search through this actor's hierarchy for an actor with the given name.
    *
    * The actor itself is also considered in the search.
-   * @SINCE_1_0.0
+   * @SINCE_2_0.9
    * @param[in] actorName The name of the actor to find
    * @return A handle to the actor if found, or an empty handle if not
    * @pre The Actor has been initialized.
    */
-  Actor FindChildByName(const std::string& actorName);
+  Actor FindChildByName(std::string_view actorName);
 
   /**
    * @brief Search through this actor's hierarchy for an actor with the given unique ID.
@@ -1166,7 +1175,6 @@ public: // Signals
    * @endcode
    * The return value of True, indicates that the touch event has been consumed.
    * Otherwise the signal will be emitted on the next sensitive parent of the actor.
-   * A true return will also cancel any ongoing gestures.
    * @SINCE_1_9.28
    * @return The signal to connect to
    * @pre The Actor has been initialized.