Clarify unbuffered dispatch may fail before attached to window

Rephase the docs to to clarify that prior to Android U, the call to
`View::requestUnbufferedDispatch` will do nothing if the View is not
attached to a window.

Bug: 268105812
Test: manual
Change-Id: Ic70ee2fe5467d2471f9f95171b4feff244c6cea0
This commit is contained in:
Arthur Hung
2023-02-14 09:14:54 +00:00
parent 5e8e2206d7
commit 7891181a8b

View File

@@ -17201,8 +17201,8 @@ public class View implements Drawable.Callback, KeyEvent.Callback,
* This is similar to {@link View#requestUnbufferedDispatch(MotionEvent)}, but does not
* automatically terminate, and allows the specification of arbitrary input source classes.
*
* <p>Prior to {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE}, this method will fail
* when this View is not attached to a window.
* <p>Prior to {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE}, calling this method
* will not result in any behavioral changes when this View is not attached to a window.
*
* @param source The combined input source class to request unbuffered dispatch for. All
* events coming from these source classes will not be buffered. Set to