diff options
| author | Yohei Yukawa <yukawa@google.com> | 2018-03-27 15:47:45 -0700 |
|---|---|---|
| committer | Yohei Yukawa <yukawa@google.com> | 2018-03-27 15:47:45 -0700 |
| commit | a754785cf949113a7ae09893c101558f4737f3cd (patch) | |
| tree | e7d4ebe5b344620add247de1679027d81206d040 /core/java/android/view/WindowManager.java | |
| parent | b8d8ccf9e44c21a1a8b2492bc66b24de57d38c61 (diff) | |
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
Diffstat (limited to 'core/java/android/view/WindowManager.java')
| -rw-r--r-- | core/java/android/view/WindowManager.java | 4 |
1 files changed, 3 insertions, 1 deletions
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; |