From a754785cf949113a7ae09893c101558f4737f3cd Mon Sep 17 00:00:00 2001 From: Yohei Yukawa Date: Tue, 27 Mar 2018 15:47:45 -0700 Subject: Improve the JavaDoc for SOFT_INPUT_STATE_UNSPECIFIED SOFT_INPUT_STATE_UNSPECIFIED is a tricky mode because its de facto spec is that the system can do whatever it thinks valid. Despite the fact that this is the default value for newly created Windows, unfortunatelly there is no clear spec about what would happen regarding whether the system thinks the software keyboard should be shown or dismissed. This CL doesn't change the behavior, but it just attempts to clarify the behavior in JavaDoc. Bug: 73793727 Bug: 77152727 Test: make -j doc-comment-check-doc Change-Id: I69dab7c7018da89ba57fe2f5c8e718ef95985307 --- core/java/android/view/WindowManager.java | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'core/java/android/view/WindowManager.java') diff --git a/core/java/android/view/WindowManager.java b/core/java/android/view/WindowManager.java index abc19d0e5c7a..f56830c20711 100644 --- a/core/java/android/view/WindowManager.java +++ b/core/java/android/view/WindowManager.java @@ -1833,7 +1833,9 @@ public interface WindowManager extends ViewManager { public static final int SOFT_INPUT_MASK_STATE = 0x0f; /** - * Visibility state for {@link #softInputMode}: no state has been specified. + * Visibility state for {@link #softInputMode}: no state has been specified. The system may + * show or hide the software keyboard for better user experience when the window gains + * focus. */ public static final int SOFT_INPUT_STATE_UNSPECIFIED = 0; -- cgit v1.2.3