Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 8bf356b5 authored by Evan Laird's avatar Evan Laird
Browse files

Update docs for WindowInsets#getPrivacyIndicatorBounds 

Added a paragraph to be more descriptivea bout how the bounds are
loaded, and when they would be expected to change. In particular, added
a clause to state that the bounds should never be null so long as there
is a StatusBar window.

Fixes: 189190379
Test: read docs
Change-Id: I0392310d3a19ea6f6a74010266e90ffe5c1543e9
parent d9ac8b2a

core/java/android/view/WindowInsets.java

+7 −0
Original line number Diff line number Diff line
@@ -517,6 +517,13 @@ public final class WindowInsets { 
    /**

     * Returns the {@link Rect} of the maximum bounds of the system privacy indicator, for the

     * current orientation, in relative coordinates, or null if the bounds have not been loaded yet.

     * <p>

     * The privacy indicator bounds are determined by SystemUI, and subsequently loaded once the

     * StatusBar window has been created and attached. The bounds for all rotations are calculated

     * and loaded at once, and this value is only expected to ever change on display or font scale

     * changes. As long as there is a StatusBar window, this value should not be expected to be

     * null.

     * <p>

     * The privacy indicator shows over apps when an app uses the microphone or camera permissions,

     * while an app is in immersive mode.

     *