Revise the javadoc and rename the constant
Bug: 147804256
Test: The API Builds, there is no executable code here.
Change-Id: I452f8bcbedb7422878a1cfc7245c33f6e38b57e3
diff --git a/api/current.txt b/api/current.txt
index c8a7956..899766d 100644
--- a/api/current.txt
+++ b/api/current.txt
@@ -56012,7 +56012,7 @@
field public static final String ACTION_ARGUMENT_MOVEMENT_GRANULARITY_INT = "ACTION_ARGUMENT_MOVEMENT_GRANULARITY_INT";
field public static final String ACTION_ARGUMENT_MOVE_WINDOW_X = "ACTION_ARGUMENT_MOVE_WINDOW_X";
field public static final String ACTION_ARGUMENT_MOVE_WINDOW_Y = "ACTION_ARGUMENT_MOVE_WINDOW_Y";
- field public static final String ACTION_ARGUMENT_PRESS_HOLD_DURATION_MILLIS_INT = "android.view.accessibility.action.ARGUMENT_PRESS_HOLD_DURATION_MILLIS_INT";
+ field public static final String ACTION_ARGUMENT_PRESS_AND_HOLD_DURATION_MILLIS_INT = "android.view.accessibility.action.ARGUMENT_PRESS_AND_HOLD_DURATION_MILLIS_INT";
field public static final String ACTION_ARGUMENT_PROGRESS_VALUE = "android.view.accessibility.action.ARGUMENT_PROGRESS_VALUE";
field public static final String ACTION_ARGUMENT_ROW_INT = "android.view.accessibility.action.ARGUMENT_ROW_INT";
field public static final String ACTION_ARGUMENT_SELECTION_END_INT = "ACTION_ARGUMENT_SELECTION_END_INT";
diff --git a/core/java/android/view/accessibility/AccessibilityNodeInfo.java b/core/java/android/view/accessibility/AccessibilityNodeInfo.java
index eb4f9db..1b6ef4a 100644
--- a/core/java/android/view/accessibility/AccessibilityNodeInfo.java
+++ b/core/java/android/view/accessibility/AccessibilityNodeInfo.java
@@ -552,8 +552,8 @@
*
* @see AccessibilityAction#ACTION_PRESS_AND_HOLD
*/
- public static final String ACTION_ARGUMENT_PRESS_HOLD_DURATION_MILLIS_INT =
- "android.view.accessibility.action.ARGUMENT_PRESS_HOLD_DURATION_MILLIS_INT";
+ public static final String ACTION_ARGUMENT_PRESS_AND_HOLD_DURATION_MILLIS_INT =
+ "android.view.accessibility.action.ARGUMENT_PRESS_AND_HOLD_DURATION_MILLIS_INT";
/**
* Argument to represent the IME action Id to press the returning key on a node.
@@ -4912,10 +4912,13 @@
* held. Nodes having a single action for long press should use {@link #ACTION_LONG_CLICK}
* instead of this action, and nodes should not expose both actions.
* <p>
- * Use {@link #ACTION_ARGUMENT_PRESS_HOLD_DURATION_MILLIS_INT} to specify how long the
- * node is pressed. To ensure reasonable behavior, the first value of this argument should
- * be 0 and the others should greater than 0 and less than 10,000. UIs requested to hold for
- * times outside of this range should ignore the action.
+ * When calling {@code performAction(ACTION_PRESS_AND_HOLD, bundle}, use
+ * {@link #ACTION_ARGUMENT_PRESS_AND_HOLD_DURATION_MILLIS_INT} to specify how long the
+ * node is pressed. The first time an accessibility service performs ACTION_PRES_AND_HOLD
+ * on a node, it must specify 0 as ACTION_ARGUMENT_PRESS_AND_HOLD, so the application is
+ * notified that the held state has started. To ensure reasonable behavior, the values
+ * must be increased incrementally and may not exceed 10,000. UIs requested
+ * to hold for times outside of this range should ignore the action.
* <p>
* The total time the element is held could be specified by an accessibility user up-front,
* or may depend on what happens on the UI as the user continues to request the hold.
