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." am: ec2121901c

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

Change-Id: I607d3723b0d2855f9b53f30cd4dda058ff3b4d93
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
This commit is contained in:
Jon Eckenrode
2022-04-04 18:00:57 +00:00
committed by Automerger Merge Worker
parent 16aa1bcc9f ec2121901c
commit d697c8b46d
1 changed files with 37 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -751,11 +751,25 @@ public final class Configuration implements Parcelable, Comparable<Configuration
public static final int SCREEN_WIDTH_DP_UNDEFINED = 0; public static final int SCREEN_WIDTH_DP_UNDEFINED = 0;
/** /**
* The current width of the available screen space, in dp units, * The current width of the available screen space in dp units, excluding
* corresponding to * the area occupied by screen decorations at the edges of the display.
* <a href="{@docRoot}guide/topics/resources/providing-resources.html#ScreenWidthQualifier">screen * Corresponds to the
* width</a> resource qualifier. Set to * <a href="{@docRoot}guide/topics/resources/providing-resources.html#AvailableWidthHeightQualifier">
* available width</a> resource qualifier. Defaults to
* {@link #SCREEN_WIDTH_DP_UNDEFINED} if no width is specified. * {@link #SCREEN_WIDTH_DP_UNDEFINED} if no width is specified.
*
* <p>In multi-window mode, equals the width of the available display area
* of the app window, not the available display area of the device screen
* (for example, when apps are displayed side by side in split-screen mode
* in landscape orientation).
*
* <p>Differs from {@link android.view.WindowMetrics} by not including
* screen decorations in the width measurement and by expressing the
* measurement in dp rather than px. Use {@code screenWidthDp} to obtain the
* horizontal display area available to the app, excluding the area occupied
* by screen decorations. Use {@link android.view.WindowMetrics#getBounds()}
* to obtain the width of the display area available to the app, including
* the area occupied by screen decorations.
*/ */
public int screenWidthDp; public int screenWidthDp;
@@ -766,11 +780,26 @@ public final class Configuration implements Parcelable, Comparable<Configuration
public static final int SCREEN_HEIGHT_DP_UNDEFINED = 0; public static final int SCREEN_HEIGHT_DP_UNDEFINED = 0;
/** /**
* The current height of the available screen space, in dp units, * The current height of the available screen space in dp units, excluding
* corresponding to * the area occupied by screen decorations at the edges of the display (such
* <a href="{@docRoot}guide/topics/resources/providing-resources.html#ScreenHeightQualifier">screen * as the status bar, navigation bar, and cutouts). Corresponds to the
* height</a> resource qualifier. Set to * <a href="{@docRoot}guide/topics/resources/providing-resources.html#AvailableWidthHeightQualifier">
* available height</a> resource qualifier. Defaults to
* {@link #SCREEN_HEIGHT_DP_UNDEFINED} if no height is specified. * {@link #SCREEN_HEIGHT_DP_UNDEFINED} if no height is specified.
*
* <p>In multi-window mode, equals the height of the available display area
* of the app window, not the available display area of the device screen
* (for example, when apps are displayed one above another in split-screen
* mode in portrait orientation).
*
* <p>Differs from {@link android.view.WindowMetrics} by not including
* screen decorations in the height measurement and by expressing the
* measurement in dp rather than px. Use {@code screenHeightDp} to obtain
* the vertical display area available to the app, excluding the area
* occupied by screen decorations. Use
* {@link android.view.WindowMetrics#getBounds()} to obtain the height of
* the display area available to the app, including the area occupied by
* screen decorations.
*/ */
public int screenHeightDp; public int screenHeightDp;