Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Updated API documentation of screenWidthDp and screenHeightDp to include multiple-screen behavior." into tm-dev am: ea8489c0ce

Browse Source 
Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/17836588

Change-Id: I26cce5a1cd54184e52718ab094589f5e6e39e51f
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
This commit is contained in:
Jon Eckenrode
2022-04-20 22:42:42 +00:00
committed by Automerger Merge Worker
parent cc2bfc7f22 ea8489c0ce
commit d0e3b4d155
1 changed files with 16 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
core/java/android/content/res/Configuration.java
View File

@@ -763,6 +763,14 @@ public final class Configuration implements Parcelable, Comparable<Configuration
* (for example, when apps are displayed side by side in split-screen mode * (for example, when apps are displayed side by side in split-screen mode
* in landscape orientation). * in landscape orientation).
* *
* <p>In multiple-screen scenarios, the width measurement can span screens.
* For example, if the app is spanning both screens of a dual-screen device
* (with the screens side by side), {@code screenWidthDp} represents the
* width of both screens, excluding the area occupied by screen decorations.
* When the app is restricted to a single screen in a multiple-screen
* environment, {@code screenWidthDp} is the width of the screen on which
* the app is running.
*
* <p>Differs from {@link android.view.WindowMetrics} by not including * <p>Differs from {@link android.view.WindowMetrics} by not including
* screen decorations in the width measurement and by expressing the * screen decorations in the width measurement and by expressing the
* measurement in dp rather than px. Use {@code screenWidthDp} to obtain the * measurement in dp rather than px. Use {@code screenWidthDp} to obtain the
@@ -792,6 +800,14 @@ public final class Configuration implements Parcelable, Comparable<Configuration
* (for example, when apps are displayed one above another in split-screen * (for example, when apps are displayed one above another in split-screen
* mode in portrait orientation). * mode in portrait orientation).
* *
* <p>In multiple-screen scenarios, the height measurement can span screens.
* For example, if the app is spanning both screens of a dual-screen device
* rotated 90 degrees (one screen above the other), {@code screenHeightDp}
* represents the height of both screens, excluding the area occupied by
* screen decorations. When the app is restricted to a single screen in a
* multiple-screen environment, {@code screenHeightDp} is the height of the
* screen on which the app is running.
*
* <p>Differs from {@link android.view.WindowMetrics} by not including * <p>Differs from {@link android.view.WindowMetrics} by not including
* screen decorations in the height measurement and by expressing the * screen decorations in the height measurement and by expressing the
* measurement in dp rather than px. Use {@code screenHeightDp} to obtain * measurement in dp rather than px. Use {@code screenHeightDp} to obtain