Merge "Clarify when View#getWindowToken can return null" into main

1 files changed, 3 insertions, 0 deletions

diff --git a/core/java/android/view/View.java b/core/java/android/view/View.java
index e781f3cdee2f..3dfd68af5aaa 100644
--- a/core/java/android/view/View.java
+++ b/core/java/android/view/View.java
@@ -22299,6 +22299,9 @@ public class View implements Drawable.Callback, KeyEvent.Callback,
      * Retrieve a unique token identifying the window this view is attached to.
      * @return Return the window's token for use in
      * {@link WindowManager.LayoutParams#token WindowManager.LayoutParams.token}.
+     * This token maybe null if this view is not attached to a window.
+     * @see #isAttachedToWindow() for current window attach state
+     * @see OnAttachStateChangeListener to listen to window attach/detach state changes
      */
     public IBinder getWindowToken() {
         return mAttachInfo != null ? mAttachInfo.mWindowToken : null;