Revert "[Tizen] Add screen and client rotation itself function"
[platform/core/uifw/dali-core.git] / dali / integration-api / scene.h
index 8669d82..dca7cbc 100755 (executable)
@@ -257,6 +257,15 @@ public:
   /**
    * @brief The user would connect to this signal to get a KeyEvent when KeyEvent is generated.
    *
+   * If the control already consumed key event, KeyEventProcessor do not need to Emit keyEvent.
+   * Therefore, KeyinputManager first checks whether KeyEvent is generated as KeyEventGeneratedSignal.
+   * After that keyEventProcessor must invoke KeyEvent only if KeyEventGeneratedSignal () is not consumed.
+   *
+   * A callback of the following type may be connected:
+   * @code
+   *   bool YourCallbackName(const KeyEvent& event);
+   * @endcode
+   *
    * @return The return is true if KeyEvent is consumed, otherwise false.
    */
   KeyEventGeneratedSignalType& KeyEventGeneratedSignal();