atspi: enhance elm_atspi_gesture_cb_set document

Change-Id: I887c08230b1de0404357d1b3717f4b3e14c08365

diff --git a/src/lib/elm_interface_atspi_accessible.eo b/src/lib/elm_interface_atspi_accessible.eo
index 2a5d4f386a649838001486cb204b82218e22bc4c..03c0c62ab43ae66f121b13f2924cadce3d3bf516 100644 (file)
--- a/src/lib/elm_interface_atspi_accessible.eo
+++ b/src/lib/elm_interface_atspi_accessible.eo
@@ -226,6 +226,10 @@ mixin Elm_Interface_Atspi_Accessible ()
          set {
             [[Sets gesture callback to give widget.
 
+              Warning: Please do not abuse this API. The purpose of this API is
+              to support special application such as screen-reader guidance.
+              Before using this API, please check if there is another way.
+
               \@if WEARABLE \@since_tizen 3.0
               \@endif
             ]]

diff --git a/src/lib/elm_interface_atspi_accessible.h b/src/lib/elm_interface_atspi_accessible.h
index 550667ce2819a63f91ead2c24581edecfcd16ca8..e3cf86fcda33ce537c54c2a9ec8a4a3544aac458 100644 (file)
--- a/src/lib/elm_interface_atspi_accessible.h
+++ b/src/lib/elm_interface_atspi_accessible.h
@@ -77,6 +77,13 @@ enum _Elm_Atspi_Gesture_Type
 /**
  * Type of gesture that is emitted on assistive technology client side.
  *
+ * @warning do not use ELM_ATSPI_GESTURE_TWO_FINGERS_FLICK_*, and
+ * ELM_ATSPI_GESTURE_TWO_FINGERS_HOVER. These gestures are not emitted on
+ * assistive technology client side. The window manager emits mouse event
+ * directly. So if you need to check these gestures, you have to handle mouse
+ * events. If you want to make highlighted object to get mouse events directly,
+ * then please use elm_atspi_accessible_attribute_append as below.
+ *
  * @if WEARABLE @since_tizen 3.0
  * @endif
  */