IT. Expert System.

Android Reference

Display


android.view

Class Display



  • public final class Display
    extends Object
    Provides information about the size and density of a logical display.

    The display area is described in two different ways.

    A logical display does not necessarily represent a particular physical display device such as the built-in screen or an external monitor. The contents of a logical display may be presented on one or more physical displays according to the devices that are currently attached and whether mirroring has been enabled.

    • Field Detail

      • DEFAULT_DISPLAY

        public static final int DEFAULT_DISPLAY
        The default Display id, which is the id of the built-in primary display assuming there is one.
        See Also:
        Constant Field Values
      • FLAG_SUPPORTS_PROTECTED_BUFFERS

        public static final int FLAG_SUPPORTS_PROTECTED_BUFFERS
        Display flag: Indicates that the display supports compositing content that is stored in protected graphics buffers.

        If this flag is set then the display device supports compositing protected buffers.

        If this flag is not set then the display device may not support compositing protected buffers; the user may see a blank region on the screen instead of the protected content.

        Secure (DRM) video decoders may allocate protected graphics buffers to request that a hardware-protected path be provided between the video decoder and the external display sink. If a hardware-protected path is not available, then content stored in protected graphics buffers may not be composited.

        An application can use the absence of this flag as a hint that it should not use protected buffers for this display because the content may not be visible. For example, if the flag is not set then the application may choose not to show content on this display, show an informative error message, select an alternate content stream or adopt a different strategy for decoding content that does not rely on protected buffers.

        See Also:
        getFlags(), Constant Field Values
      • FLAG_SECURE

        public static final int FLAG_SECURE
        Display flag: Indicates that the display has a secure video output and supports compositing secure surfaces.

        If this flag is set then the display device has a secure video output and is capable of showing secure surfaces. It may also be capable of showing protected buffers.

        If this flag is not set then the display device may not have a secure video output; the user may see a blank region on the screen instead of the contents of secure surfaces or protected buffers.

        Secure surfaces are used to prevent content rendered into those surfaces by applications from appearing in screenshots or from being viewed on non-secure displays. Protected buffers are used by secure video decoders for a similar purpose.

        An application creates a window with a secure surface by specifying the WindowManager.LayoutParams.FLAG_SECURE window flag. Likewise, an application creates a SurfaceView with a secure surface by calling SurfaceView#setSecure before attaching the secure view to its containing window.

        An application can use the absence of this flag as a hint that it should not create secure surfaces or protected buffers on this display because the content may not be visible. For example, if the flag is not set then the application may choose not to show content on this display, show an informative error message, select an alternate content stream or adopt a different strategy for decoding content that does not rely on secure surfaces or protected buffers.

        See Also:
        getFlags(), Constant Field Values
      • TYPE_UNKNOWN

        public static final int TYPE_UNKNOWN
        Display type: Unknown display type.
        See Also:
        Constant Field Values
      • TYPE_BUILT_IN

        public static final int TYPE_BUILT_IN
        Display type: Built-in display.
        See Also:
        Constant Field Values
      • TYPE_OVERLAY

        public static final int TYPE_OVERLAY
        Display type: Overlay display.
        See Also:
        Constant Field Values
    • Method Detail

      • getDisplayId

        public int getDisplayId()
        Gets the display id.

        Each logical display has a unique id. The default display has id DEFAULT_DISPLAY.

      • isValid

        public boolean isValid()
        Returns true if this display is still valid, false if the display has been removed. If the display is invalid, then the methods of this class will continue to report the most recently observed display information. However, it is unwise (and rather fruitless) to continue using a Display object after the display's demise. It's possible for a display that was previously invalid to become valid again if a display with the same id is reconnected.
        Returns:
        True if the display is still valid.
      • getDisplayInfo

        public boolean getDisplayInfo(DisplayInfo outDisplayInfo)
        Gets a full copy of the display information.
        Parameters:
        outDisplayInfo - The object to receive the copy of the display information.
        Returns:
        True if the display is still valid.
      • getLayerStack

        public int getLayerStack()
        Gets the display's layer stack. Each display has its own independent layer stack upon which surfaces are placed to be managed by surface flinger.
        Returns:
        The display's layer stack number.
      • getAddress

        public String getAddress()
        Gets the display address, or null if none. Interpretation varies by display type.
        Returns:
        The display address.
      • getCompatibilityInfo

        public CompatibilityInfoHolder getCompatibilityInfo()
        Gets the compatibility info used by this display instance.
        Returns:
        The compatibility info holder, or null if none is required.
      • getName

        public String getName()
        Gets the name of the display.

        Note that some displays may be renamed by the user.

        Returns:
        The display's name.
      • getSize

        public void getSize(Point outSize)
        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 decoration elements that are always visible. It may also be scaled to provide compatibility with older applications that were originally designed for smaller displays.

        Parameters:
        outSize - A Point object to receive the size information.
      • getRectSize

        public void getRectSize(Rect outSize)
        Gets the size of the display as a rectangle, in pixels.
        Parameters:
        outSize - A Rect object to receive the size information.
        See Also:
        getSize(Point)
      • getCurrentSizeRange

        public void getCurrentSizeRange(Point outSmallestSize,
                               Point outLargestSize)
        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.
        Parameters:
        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.
      • getMaximumSizeDimension

        public int getMaximumSizeDimension()
        Return the maximum screen size dimension that will happen. This is mostly for wallpapers.
      • getRotation

        public int getRotation()
        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.
      • getOrientation

        @Deprecated
        public int getOrientation()
        Deprecated. use getRotation()
        Returns:
        orientation of this display.
      • getPixelFormat

        @Deprecated
        public int getPixelFormat()
        Deprecated. This method is no longer supported. The result is always PixelFormat.RGBA_8888.
        Gets the pixel format of the display.
        Returns:
        One of the constants defined in PixelFormat.
      • getRefreshRate

        public float getRefreshRate()
        Gets the refresh rate of this display in frames per second.
      • getMetrics

        public void getMetrics(DisplayMetrics outMetrics)
        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.

        Parameters:
        outMetrics - A DisplayMetrics object to receive the metrics.
      • getRealSize

        public void getRealSize(Point outSize)
        Gets the real size of the display without subtracting any window decor or applying any compatibility scale factors.

        The size is adjusted based on the current rotation of the display.

        The real size may be smaller than the physical size of the screen when the window manager is emulating a smaller display (using adb shell am display-size).

        Parameters:
        outSize - Set to the real size of the display.
      • getRealMetrics

        public void getRealMetrics(DisplayMetrics outMetrics)
        Gets display metrics based on the real size of this display.

        The size is adjusted based on the current rotation of the display.

        The real size may be smaller than the physical size of the screen when the window manager is emulating a smaller display (using adb shell am display-size).

        Parameters:
        outMetrics - A DisplayMetrics object to receive the metrics.
      • toString

        public String toString()
        Description copied from class: Object
        Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:
           getClass().getName() + '@' + Integer.toHexString(hashCode())

        See Writing a useful toString method if you intend implementing your own toString method.

        Overrides:
        toString in class Object
        Returns:
        a printable representation of this object.
      • typeToString

        public static String typeToString(int type)


Content

Android Reference

Java basics

Java Enterprise Edition (EE)

Java Standard Edition (SE)

SQL

HTML

PHP

CSS

Java Script

MYSQL

JQUERY

VBS

REGEX

C

C++

C#

Design patterns

RFC (standard status)

RFC (proposed standard status)

RFC (draft standard status)

RFC (informational status)

RFC (experimental status)

RFC (best current practice status)

RFC (historic status)

RFC (unknown status)

IT dictionary

License.
All information of this service is derived from the free sources and is provided solely in the form of quotations. This service provides information and interfaces solely for the familiarization (not ownership) and under the "as is" condition.
Copyright 2016 © ELTASK.COM. All rights reserved.
Site is optimized for mobile devices.
Downloads: 3386 / . Delta: 0.03278 с