Android Sites
Support
Languages
| java.lang.Object | |
| ↳ | android.view.Display |
Provides information about the display size and density.
| Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| int | DEFAULT_DISPLAY | The default Display id. | |||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Return the range of display sizes an application can expect to encounter
under normal operation, as long as there is no physical change in screen
size.
| |||||||||||
Returns the index of this display.
| |||||||||||
This method is deprecated.
Use
getSize(Point) instead.
| |||||||||||
Gets display metrics that describe the size and density of this display.
| |||||||||||
This method is deprecated.
use
getRotation() | |||||||||||
Return the native pixel format of the display.
| |||||||||||
Gets the size of the display as a rectangle, in pixels.
| |||||||||||
Return the refresh rate of this display in frames per second.
| |||||||||||
Returns the rotation of the screen from its "natural" orientation.
| |||||||||||
Gets the size of the display, in pixels.
| |||||||||||
This method is deprecated.
Use
getSize(Point) instead.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
The default Display id.
Return the range of display sizes an application can expect to encounter under normal operation, as long as there is no physical change in screen size. This is basically the sizes you will see as the orientation changes, taking into account whatever screen decoration there is in each rotation. For example, the status bar is always at the top of the screen, so it will reduce the height both in landscape and portrait, and the smallest height returned here will be the smaller of the two. This is intended for applications to get an idea of the range of sizes they will encounter while going through device rotations, to provide a stable UI through rotation. The sizes here take into account all standard system decorations that reduce the size actually available to the application: the status bar, navigation bar, system bar, etc. It does not take into account more transient elements like an IME soft keyboard.
| outSmallestSize | Filled in with the smallest width and height
that the application will encounter, in pixels (not dp units). The x
(width) dimension here directly corresponds to
Configuration.smallestScreenWidthDp, except the value here is in raw
screen pixels rather than dp units. Your application may of course
still get smaller space yet if, for example, a soft keyboard is
being displayed. |
|---|---|
| outLargestSize | Filled in with the largest width and height that the application will encounter, in pixels (not dp units). Your application may of course still get larger space than this if, for example, screen decorations like the status bar are being hidden. |
Returns the index of this display. This is currently undefined; do not use.
Gets display metrics that describe the size and density of this display.
The size is adjusted based on the current rotation of the display.
The size returned by this method does not necessarily represent the actual raw size (native resolution) of the display. The returned size may be adjusted to exclude certain system decor elements that are always visible. It may also be scaled to provide compatibility with older applications that were originally designed for smaller displays.
| outMetrics | A DisplayMetrics object to receive the metrics.
|
|---|
Return the native pixel format of the display. The returned value
may be one of the constants int PixelFormat.
Gets the size of the display as a rectangle, in pixels.
| outSize | A Rect object to receive the size information. |
|---|
Return the refresh rate of this display in frames per second.
Returns the rotation of the screen from its "natural" orientation.
The returned value may be Surface.ROTATION_0
(no rotation), Surface.ROTATION_90,
Surface.ROTATION_180, or
Surface.ROTATION_270. For
example, if a device has a naturally tall screen, and the user has
turned it on its side to go into a landscape orientation, the value
returned here may be either Surface.ROTATION_90
or Surface.ROTATION_270 depending on
the direction it was turned. The angle is the rotation of the drawn
graphics on the screen, which is the opposite direction of the physical
rotation of the device. For example, if the device is rotated 90
degrees counter-clockwise, to compensate rendering will be rotated by
90 degrees clockwise and thus the returned value here will be
Surface.ROTATION_90.
Gets the size of the display, in pixels.
Note that this value should not be used for computing layouts, since a device will typically have screen decoration (such as a status bar) along the edges of the display that reduce the amount of application space available from the size returned here. Layouts should instead use the window size.
The size is adjusted based on the current rotation of the display.
The size returned by this method does not necessarily represent the actual raw size (native resolution) of the display. The returned size may be adjusted to exclude certain system decor elements that are always visible. It may also be scaled to provide compatibility with older applications that were originally designed for smaller displays.
| outSize | A Point object to receive the size information.
|
|---|