WindowManager.LayoutParams


public static class WindowManager.LayoutParams
extends ViewGroup.LayoutParams implements Parcelable

java.lang.Object
   ↳ android.view.ViewGroup.LayoutParams
     ↳ android.view.WindowManager.LayoutParams


Summary

XML attributes

android:windowNoMoveAnimation Flag indicating whether this window should skip movement animations. 

Inherited XML attributes

Constants

int ALPHA_CHANGED

int ANIMATION_CHANGED

float BRIGHTNESS_OVERRIDE_FULL

Value for screenBrightness and buttonBrightness indicating that the screen or button backlight brightness should be set to the hightest value when this window is in front.

float BRIGHTNESS_OVERRIDE_NONE

Default value for screenBrightness and buttonBrightness indicating that the brightness value is not overridden for this window and normal brightness policy should be used.

float BRIGHTNESS_OVERRIDE_OFF

Value for screenBrightness and buttonBrightness indicating that the screen or button backlight brightness should be set to the lowest value when this window is in front.

int DIM_AMOUNT_CHANGED

int DISPLAY_FLAG_DISABLE_HDR_CONVERSION

Indicates whether this window wants the HDR conversion is disabled.

int FIRST_APPLICATION_WINDOW

Start of window types that represent normal application windows.

int FIRST_SUB_WINDOW

Start of types of sub-windows.

int FIRST_SYSTEM_WINDOW

Start of system-specific window types.

int FLAGS_CHANGED

int FLAG_ALLOW_LOCK_WHILE_SCREEN_ON

Window flag: as long as this window is visible to the user, allow the lock screen to activate while the screen is on.

int FLAG_ALT_FOCUSABLE_IM

Window flag: when set, inverts the input method focusability of the window.

int FLAG_BLUR_BEHIND

Window flag: enable blur behind for this window.

int FLAG_DIM_BEHIND

Window flag: everything behind this window will be dimmed.

int FLAG_DISMISS_KEYGUARD

This constant was deprecated in API level 26. Use FLAG_SHOW_WHEN_LOCKED or KeyguardManager#requestDismissKeyguard instead. Since keyguard was dismissed all the time as long as an activity with this flag on its window was focused, keyguard couldn't guard against unintentional touches on the screen, which isn't desired.

int FLAG_DITHER

This constant was deprecated in API level 17. This flag is no longer used.

int FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS

Flag indicating that this Window is responsible for drawing the background for the system bars.

int FLAG_FORCE_NOT_FULLSCREEN

This constant was deprecated in API level 30. This value became API "by accident", and shouldn't be used by 3rd party applications.

int FLAG_FULLSCREEN

This constant was deprecated in API level 30. Use WindowInsetsController#hide(int) with Type#statusBars() instead.

int FLAG_HARDWARE_ACCELERATED

Indicates whether this window should be hardware accelerated.

int FLAG_IGNORE_CHEEK_PRESSES

Window flag: intended for windows that will often be used when the user is holding the screen against their face, it will aggressively filter the event stream to prevent unintended presses in this situation that may not be desired for a particular window, when such an event stream is detected, the application will receive a CANCEL motion event to indicate this so applications can handle this accordingly by taking no action on the event until the finger is released.

int FLAG_KEEP_SCREEN_ON

Window flag: as long as this window is visible to the user, keep the device's screen turned on and bright.

int FLAG_LAYOUT_ATTACHED_IN_DECOR

This constant was deprecated in API level 30. Use setFitInsetsTypes(int) to determine whether the attached window will overlap with system bars.

int FLAG_LAYOUT_INSET_DECOR

This constant was deprecated in API level 30. Insets will always be delivered to your application.

int FLAG_LAYOUT_IN_OVERSCAN

This constant was deprecated in API level 30. Overscan areas aren't set by any Android product anymore as of Android 11.

int FLAG_LAYOUT_IN_SCREEN

Window flag for attached windows: Place the window within the entire screen, ignoring any constraints from the parent window.

int FLAG_LAYOUT_NO_LIMITS

Window flag: allow window to extend outside of the screen.

int FLAG_LOCAL_FOCUS_MODE

Flag for a window in local focus mode.

int FLAG_NOT_FOCUSABLE

Window flag: this window won't ever get key input focus, so the user can not send key or other button events to it.

int FLAG_NOT_TOUCHABLE

Window flag: this window can never receive touch events.

int FLAG_NOT_TOUCH_MODAL

Window flag: even when this window is focusable (its FLAG_NOT_FOCUSABLE is not set), allow any pointer events outside of the window to be sent to the windows behind it.

int FLAG_SCALED

Window flag: a special mode where the layout parameters are used to perform scaling of the surface when it is composited to the screen.

int FLAG_SECURE

Window flag: treat the content of the window as secure, preventing it from appearing in screenshots or from being viewed on non-secure displays.

int FLAG_SHOW_WALLPAPER

Window flag: ask that the system wallpaper be shown behind your window.

int FLAG_SHOW_WHEN_LOCKED

This constant was deprecated in API level 27. Use R.attr.showWhenLocked or Activity.setShowWhenLocked(boolean) instead to prevent an unintentional double life-cycle event.

int FLAG_SPLIT_TOUCH

Window flag: when set the window will accept for touch events outside of its bounds to be sent to other windows that also support split touch.

int FLAG_TOUCHABLE_WHEN_WAKING

This constant was deprecated in API level 20. This flag has no effect.

int FLAG_TRANSLUCENT_NAVIGATION

This constant was deprecated in API level 30. Use Window#setNavigationBarColor(int) with a half-translucent color instead.

int FLAG_TRANSLUCENT_STATUS

This constant was deprecated in API level 30. Use Window#setStatusBarColor(int) with a half-translucent color instead.

int FLAG_TURN_SCREEN_ON

This constant was deprecated in API level 27. Use R.attr.turnScreenOn or Activity.setTurnScreenOn(boolean) instead to prevent an unintentional double life-cycle event.

int FLAG_WATCH_OUTSIDE_TOUCH

Window flag: if you have set FLAG_NOT_TOUCH_MODAL, you can set this flag to receive a single special MotionEvent with the action MotionEvent.ACTION_OUTSIDE for touches that occur outside of your window.

int FORMAT_CHANGED

int LAST_APPLICATION_WINDOW

End of types of application windows.

int LAST_SUB_WINDOW

End of types of sub-windows.

int LAST_SYSTEM_WINDOW

End of types of system windows.

int LAYOUT_CHANGED

int LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS

The window is always allowed to extend into the DisplayCutout areas on the all edges of the screen.

int LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT

The window is allowed to extend into the DisplayCutout area, only if the DisplayCutout is fully contained within a system bar or the DisplayCutout is not deeper than 16 dp, but this depends on the OEM choice.

int LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER

The window is never allowed to overlap with the DisplayCutout area.

int LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES

The window is always allowed to extend into the DisplayCutout areas on the short edges of the screen.

int MEMORY_TYPE_CHANGED

int MEMORY_TYPE_GPU

This constant was deprecated in API level 15. this is ignored, this value is set automatically when needed.

int MEMORY_TYPE_HARDWARE

This constant was deprecated in API level 15. this is ignored, this value is set automatically when needed.

int MEMORY_TYPE_NORMAL

This constant was deprecated in API level 15. this is ignored, this value is set automatically when needed.

int MEMORY_TYPE_PUSH_BUFFERS

This constant was deprecated in API level 15. this is ignored, this value is set automatically when needed.

int ROTATION_ANIMATION_CHANGED

int ROTATION_ANIMATION_CROSSFADE

Value for rotationAnimation which specifies that this window will fade in or out following a rotation.

int ROTATION_ANIMATION_JUMPCUT

Value for rotationAnimation which specifies that this window will immediately disappear or appear following a rotation.

int ROTATION_ANIMATION_ROTATE

Value for rotationAnimation which specifies that this window will visually rotate in or out following a rotation.

int ROTATION_ANIMATION_SEAMLESS

Value for rotationAnimation to specify seamless rotation mode.

int SCREEN_BRIGHTNESS_CHANGED

int SCREEN_ORIENTATION_CHANGED

int SOFT_INPUT_ADJUST_NOTHING

Adjustment option for softInputMode: set to have a window not adjust for a shown input method.

int SOFT_INPUT_ADJUST_PAN

Adjustment option for softInputMode: set to have a window pan when an input method is shown, so it doesn't need to deal with resizing but just panned by the framework to ensure the current input focus is visible.

int SOFT_INPUT_ADJUST_RESIZE

This constant was deprecated in API level 30. Call Window#setDecorFitsSystemWindows(boolean) with false and install an OnApplyWindowInsetsListener on your root content view that fits insets of type Type#ime().

int SOFT_INPUT_ADJUST_UNSPECIFIED

Adjustment option for softInputMode: nothing specified.

int SOFT_INPUT_IS_FORWARD_NAVIGATION

Bit for softInputMode: set when the user has navigated forward to the window.

int SOFT_INPUT_MASK_ADJUST

Mask for softInputMode of the bits that determine the way that the window should be adjusted to accommodate the soft input window.

int SOFT_INPUT_MASK_STATE

Mask for softInputMode of the bits that determine the desired visibility state of the soft input area for this window.

int SOFT_INPUT_MODE_CHANGED

int SOFT_INPUT_STATE_ALWAYS_HIDDEN

Visibility state for softInputMode: please always hide any soft input area when this window receives focus.

int SOFT_INPUT_STATE_ALWAYS_VISIBLE

Visibility state for softInputMode: please always make the soft input area visible when this window receives input focus.

int SOFT_INPUT_STATE_HIDDEN

Visibility state for softInputMode: please hide any soft input area when normally appropriate (when the user is navigating forward to your window).

int SOFT_INPUT_STATE_UNCHANGED

Visibility state for softInputMode: please don't change the state of the soft input area.

int SOFT_INPUT_STATE_UNSPECIFIED

Visibility state for softInputMode: no state has been specified.

int SOFT_INPUT_STATE_VISIBLE

Visibility state for softInputMode: please show the soft input area when normally appropriate (when the user is navigating forward to your window).

int TITLE_CHANGED

int TYPE_ACCESSIBILITY_OVERLAY

Window type: Windows that are overlaid only by a connected AccessibilityService for interception of user interactions without changing the windows an accessibility service can introspect.

int TYPE_APPLICATION

Window type: a normal application window.

int TYPE_APPLICATION_ATTACHED_DIALOG

Window type: like TYPE_APPLICATION_PANEL, but layout of the window happens as that of a top-level window, not as a child of its container.

int TYPE_APPLICATION_MEDIA

Window type: window for showing media (such as video).

int TYPE_APPLICATION_OVERLAY

Window type: Application overlay windows are displayed above all activity windows (types between FIRST_APPLICATION_WINDOW and LAST_APPLICATION_WINDOW) but below critical system windows like the status bar or IME.

int TYPE_APPLICATION_PANEL

Window type: a panel on top of an application window.

int TYPE_APPLICATION_STARTING

Window type: special application window that is displayed while the application is starting.

int TYPE_APPLICATION_SUB_PANEL

Window type: a sub-panel on top of an application window.

int TYPE_BASE_APPLICATION

Window type: an application window that serves as the "base" window of the overall application; all other application windows will appear on top of it.

int TYPE_CHANGED

int TYPE_DRAWN_APPLICATION

Window type: a variation on TYPE_APPLICATION that ensures the window manager will wait for this window to be drawn before the app is shown.

int TYPE_INPUT_METHOD

Window type: internal input methods windows, which appear above the normal UI.

int TYPE_INPUT_METHOD_DIALOG

Window type: internal input methods dialog windows, which appear above the current input method window.

int TYPE_KEYGUARD_DIALOG

Window type: dialogs that the keyguard shows In multiuser systems shows on all users' windows.

int TYPE_PHONE

This constant was deprecated in API level 26. for non-system apps. Use TYPE_APPLICATION_OVERLAY instead.

int TYPE_PRIORITY_PHONE

This constant was deprecated in API level 26. for non-system apps. Use TYPE_APPLICATION_OVERLAY instead.

int TYPE_PRIVATE_PRESENTATION

Window type: Window for Presentation on top of private virtual display.

int TYPE_SEARCH_BAR

Window type: the search bar.

int TYPE_STATUS_BAR

Window type: the status bar.

int TYPE_SYSTEM_ALERT

This constant was deprecated in API level 26. for non-system apps. Use TYPE_APPLICATION_OVERLAY instead.

int TYPE_SYSTEM_DIALOG

Window type: panel that slides out from the status bar In multiuser systems shows on all users' windows.

int TYPE_SYSTEM_ERROR

This constant was deprecated in API level 26. for non-system apps. Use TYPE_APPLICATION_OVERLAY instead.

int TYPE_SYSTEM_OVERLAY

This constant was deprecated in API level 26. for non-system apps. Use TYPE_APPLICATION_OVERLAY instead.

int TYPE_TOAST

This constant was deprecated in API level 26. for non-system apps. Use TYPE_APPLICATION_OVERLAY instead.

int TYPE_WALLPAPER

Window type: wallpaper window, placed behind any window that wants to sit on top of the wallpaper.

Inherited constants

Fields

public static final Creator<WindowManager.LayoutParams> CREATOR

public float alpha

An alpha value to apply to this entire window.

public float buttonBrightness

This can be used to override the standard behavior of the button and keyboard backlights.

public float dimAmount

When FLAG_DIM_BEHIND is set, this is the amount of dimming to apply.

public int flags

Various behavioral options/flags.

public int format

The desired bitmap format.

public int gravity

Placement of window within the screen as per Gravity.

public float horizontalMargin

The horizontal margin, as a percentage of the container's width, between the container and the widget.

public float horizontalWeight

Indicates how much of the extra space will be allocated horizontally to the view associated with these LayoutParams.

public int layoutInDisplayCutoutMode

Controls how the window is laid out if there is a DisplayCutout.

public int memoryType

This field was deprecated in API level 15. this is ignored

public String packageName

Name of the package owning this window.

public boolean preferMinimalPostProcessing

Indicates whether this window wants the connected display to do minimal post processing on the produced image or video frames.

public int preferredDisplayModeId

Id of the preferred display mode for the window.

public float preferredRefreshRate

The preferred refresh rate for the window.

public int rotationAnimation

Define the exit and entry animations used on this window when the device is rotated.

public float screenBrightness

This can be used to override the user's preferred brightness of the screen.

public int screenOrientation

Specific orientation value for a window.

public int softInputMode

Desired operating mode for any soft input area.

public int systemUiVisibility

This field was deprecated in API level 30. SystemUiVisibility flags are deprecated. Use WindowInsetsController instead.

public IBinder token

Identifier for this window.

public int type

The general type of window.

public float verticalMargin

The vertical margin, as a percentage of the container's height, between the container and the widget.

public float verticalWeight

Indicates how much of the extra space will be allocated vertically to the view associated with these LayoutParams.

public int windowAnimations

A style resource defining the animations to use for this window.

public int x

X position for this window.

public int y

Y position for this window.

Inherited fields

Public constructors

LayoutParams()
LayoutParams(int _type)
LayoutParams(int _type, int _flags)
LayoutParams(int _type, int _flags, int _format)
LayoutParams(int w, int h, int _type, int _flags, int _format)
LayoutParams(int w, int h, int xpos, int ypos, int _type, int _flags, int _format)
LayoutParams(Parcel in)

Public methods

boolean areWallpaperTouchEventsEnabled()

Returns whether sending touch events to the system wallpaper (which can be provided by a third-party application) is enabled for windows that show wallpaper in background.

boolean canPlayMoveAnimation()
final int copyFrom(WindowManager.LayoutParams o)
String debug(String output)
int describeContents()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.

int getBlurBehindRadius()

Returns the blur behind radius of the window.

int getColorMode()

Returns the color mode of the window, one of ActivityInfo#COLOR_MODE_DEFAULT, ActivityInfo#COLOR_MODE_WIDE_COLOR_GAMUT or ActivityInfo#COLOR_MODE_HDR.

float getDesiredHdrHeadroom()

Get the desired amount of HDR headroom as set by setDesiredHdrHeadroom(float)

int getFitInsetsSides()
int getFitInsetsTypes()
boolean getFrameRateBoostOnTouchEnabled()

Get the value whether we should enable touch boost as set by setFrameRateBoostOnTouchEnabled(boolean)

final CharSequence getTitle()
boolean isFitInsetsIgnoringVisibility()
boolean isFrameRatePowerSavingsBalanced()

Get the value whether frameratepowersavingsbalance is enabled for this Window.

boolean isHdrConversionEnabled()

Returns whether the HDR conversion is enabled for the window

static boolean mayUseInputMethod(int flags)

Given a particular set of window manager flags, determine whether such a window may be a target for an input method when it has focus.

void setBlurBehindRadius(int blurBehindRadius)

Blurs the screen behind the window.

void setCanPlayMoveAnimation(boolean enable)

Set whether animations can be played for position changes on this window.

void setColorMode(int colorMode)

Set the color mode of the window.

void setDesiredHdrHeadroom(float desiredHeadroom)

Sets the desired about of HDR headroom to be used when rendering as a ratio of targetHdrPeakBrightnessInNits / targetSdrWhitePointInNits.

void setFitInsetsIgnoringVisibility(boolean ignore)

Specifies if this window should fit the window insets no matter they are visible or not.

void setFitInsetsSides(int sides)

Specifies sides of insets that this window should avoid overlapping during layout.

void setFitInsetsTypes(int types)

Specifies types of insets that this window should avoid overlapping during layout.

void setFrameRateBoostOnTouchEnabled(boolean enabled)

Set the value whether we should enable Touch Boost

void setFrameRatePowerSavingsBalanced(boolean enabled)

Set the value whether frameratepowersavingsbalance is enabled for this Window.

void setHdrConversionEnabled(boolean enabled)

Enables/disables the HDR conversion for the window.

final void setTitle(CharSequence title)
void setWallpaperTouchEventsEnabled(boolean enable)

Set whether sending touch events to the system wallpaper (which can be provided by a third-party application) should be enabled for windows that show wallpaper in background.

String toString()

Returns a string representation of the object.

void writeToParcel(Parcel out, int parcelableFlags)

Flatten this object in to a Parcel.

Inherited methods

XML attributes

android:windowNoMoveAnimation

Flag indicating whether this window should skip movement animations. See also WindowManager.LayoutParams.setCanPlayMoveAnimation(boolean)

May be a boolean value, such as "true" or "false".

Related methods:

Constants

ALPHA_CHANGED

Added in API level 1
public static final int ALPHA_CHANGED

Constant Value: 128 (0x00000080)

ANIMATION_CHANGED

Added in API level 1
public static final int ANIMATION_CHANGED

Constant Value: 16 (0x00000010)

BRIGHTNESS_OVERRIDE_FULL

Added in API level 8
public static final float BRIGHTNESS_OVERRIDE_FULL

Value for screenBrightness and buttonBrightness indicating that the screen or button backlight brightness should be set to the hightest value when this window is in front.

Constant Value: 1.0

BRIGHTNESS_OVERRIDE_NONE

Added in API level 8
public static final float BRIGHTNESS_OVERRIDE_NONE

Default value for screenBrightness and buttonBrightness indicating that the brightness value is not overridden for this window and normal brightness policy should be used.

Constant Value: -1.0

BRIGHTNESS_OVERRIDE_OFF

Added in API level 8
public static final float BRIGHTNESS_OVERRIDE_OFF

Value for screenBrightness and buttonBrightness indicating that the screen or button backlight brightness should be set to the lowest value when this window is in front.

Constant Value: 0.0

DIM_AMOUNT_CHANGED

Added in API level 1
public static final int DIM_AMOUNT_CHANGED

Constant Value: 32 (0x00000020)

DISPLAY_FLAG_DISABLE_HDR_CONVERSION

Added in API level 34
public static final int DISPLAY_FLAG_DISABLE_HDR_CONVERSION

Indicates whether this window wants the HDR conversion is disabled.

Constant Value: 1 (0x00000001)

FIRST_APPLICATION_WINDOW

Added in API level 1
public static final int FIRST_APPLICATION_WINDOW

Start of window types that represent normal application windows.

Constant Value: 1 (0x00000001)

FIRST_SUB_WINDOW

Added in API level 1
public static final int FIRST_SUB_WINDOW

Start of types of sub-windows. The token of these windows must be set to the window they are attached to. These types of windows are kept next to their attached window in Z-order, and their coordinate space is relative to their attached window.

Constant Value: 1000 (0x000003e8)

FIRST_SYSTEM_WINDOW

Added in API level 1
public static final int FIRST_SYSTEM_WINDOW

Start of system-specific window types. These are not normally created by applications.

Constant Value: 2000 (0x000007d0)

FLAGS_CHANGED

Added in API level 1
public static final int FLAGS_CHANGED

Constant Value: 4 (0x00000004)

FLAG_ALLOW_LOCK_WHILE_SCREEN_ON

Added in API level 8
public static final int FLAG_ALLOW_LOCK_WHILE_SCREEN_ON

Window flag: as long as this window is visible to the user, allow the lock screen to activate while the screen is on. This can be used independently, or in combination with FLAG_KEEP_SCREEN_ON and/or FLAG_SHOW_WHEN_LOCKED

Constant Value: 1 (0x00000001)

FLAG_ALT_FOCUSABLE_IM

Added in API level 3
public static final int FLAG_ALT_FOCUSABLE_IM

Window flag: when set, inverts the input method focusability of the window. The effect of setting this flag depends on whether FLAG_NOT_FOCUSABLE is set:

If FLAG_NOT_FOCUSABLE is not set, i.e. when the window is focusable, setting this flag prevents this window from becoming the target of the input method. Consequently, it will not be able to interact with the input method, and will be layered above the input method (unless there is another input method target above it).

If FLAG_NOT_FOCUSABLE is set, setting this flag requests for the window to be the input method target even though the window is not focusable. Consequently, it will be layered below the input method. Note: Windows that set FLAG_NOT_FOCUSABLE cannot interact with the input method, regardless of this flag.

Constant Value: 131072 (0x00020000)

FLAG_BLUR_BEHIND

Added in API level 1
public static final int FLAG_BLUR_BEHIND

Window flag: enable blur behind for this window.

Constant Value: 4 (0x00000004)

FLAG_DIM_BEHIND

Added in API level 1
public static final int FLAG_DIM_BEHIND

Window flag: everything behind this window will be dimmed. Use dimAmount to control the amount of dim.

Constant Value: 2 (0x00000002)

FLAG_DISMISS_KEYGUARD

Added in API level 5
Deprecated in API level 26
public static final int FLAG_DISMISS_KEYGUARD

This constant was deprecated in API level 26.
Use FLAG_SHOW_WHEN_LOCKED or KeyguardManager#requestDismissKeyguard instead. Since keyguard was dismissed all the time as long as an activity with this flag on its window was focused, keyguard couldn't guard against unintentional touches on the screen, which isn't desired.

Window flag: when set the window will cause the keyguard to be dismissed, only if it is not a secure lock keyguard. Because such a keyguard is not needed for security, it will never re-appear if the user navigates to another window (in contrast to FLAG_SHOW_WHEN_LOCKED, which will only temporarily hide both secure and non-secure keyguards but ensure they reappear when the user moves to another UI that doesn't hide them). If the keyguard is currently active and is secure (requires an unlock credential) than the user will still need to confirm it before seeing this window, unless FLAG_SHOW_WHEN_LOCKED has also been set.

Constant Value: 4194304 (0x00400000)

FLAG_DITHER

Added in API level 1
Deprecated in API level 17
public static final int FLAG_DITHER

This constant was deprecated in API level 17.
This flag is no longer used.

Window flag: turn on dithering when compositing this window to the screen.

Constant Value: 4096 (0x00001000)

FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS

Added in API level 21
public static final int FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS

Flag indicating that this Window is responsible for drawing the background for the system bars. If set, the system bars are drawn with a transparent background and the corresponding areas in this window are filled with the colors specified in Window#getStatusBarColor() and Window#getNavigationBarColor().

Constant Value: -2147483648 (0x80000000)

FLAG_FORCE_NOT_FULLSCREEN

Added in API level 1
Deprecated in API level 30
public static final int FLAG_FORCE_NOT_FULLSCREEN

This constant was deprecated in API level 30.
This value became API "by accident", and shouldn't be used by 3rd party applications.

Window flag: override FLAG_FULLSCREEN and force the screen decorations (such as the status bar) to be shown.

Constant Value: 2048 (0x00000800)

FLAG_FULLSCREEN

Added in API level 1
Deprecated in API level 30
public static final int FLAG_FULLSCREEN

This constant was deprecated in API level 30.
Use WindowInsetsController#hide(int) with Type#statusBars() instead.

Window flag: hide all screen decorations (such as the status bar) while this window is displayed. This allows the window to use the entire display space for itself -- the status bar will be hidden when an app window with this flag set is on the top layer. A fullscreen window will ignore a value of SOFT_INPUT_ADJUST_RESIZE for the window's softInputMode field; the window will stay fullscreen and will not resize.

This flag can be controlled in your theme through the R.attr.windowFullscreen attribute; this attribute is automatically set for you in the standard fullscreen themes such as R.style.Theme_NoTitleBar_Fullscreen, R.style.Theme_Black_NoTitleBar_Fullscreen, R.style.Theme_Light_NoTitleBar_Fullscreen, R.style.Theme_Holo_NoActionBar_Fullscreen, R.style.Theme_Holo_Light_NoActionBar_Fullscreen, R.style.Theme_DeviceDefault_NoActionBar_Fullscreen, and R.style.Theme_DeviceDefault_Light_NoActionBar_Fullscreen.

Constant Value: 1024 (0x00000400)

FLAG_HARDWARE_ACCELERATED

Added in API level 11
public static final int FLAG_HARDWARE_ACCELERATED

Indicates whether this window should be hardware accelerated. Requesting hardware acceleration does not guarantee it will happen.

This flag can be controlled programmatically only to enable hardware acceleration. To enable hardware acceleration for a given window programmatically, do the following:

 Window w = activity.getWindow(); // in Activity's onCreate() for instance
 w.setFlags(WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED,
         WindowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED);
 

It is important to remember that this flag must be set before setting the content view of your activity or dialog.

This flag cannot be used to disable hardware acceleration after it was enabled in your manifest using R.attr.hardwareAccelerated. If you need to selectively and programmatically disable hardware acceleration (for automated testing for instance), make sure it is turned off in your manifest and enable it on your activity or dialog when you need it instead, using the method described above.

This flag is automatically set by the system if the android:hardwareAccelerated XML attribute is set to true on an activity or on the application.

Constant Value: 16777216 (0x01000000)

FLAG_IGNORE_CHEEK_PRESSES

Added in API level 1
public static final int FLAG_IGNORE_CHEEK_PRESSES

Window flag: intended for windows that will often be used when the user is holding the screen against their face, it will aggressively filter the event stream to prevent unintended presses in this situation that may not be desired for a particular window, when such an event stream is detected, the application will receive a CANCEL motion event to indicate this so applications can handle this accordingly by taking no action on the event until the finger is released.

Constant Value: 32768 (0x00008000)

FLAG_KEEP_SCREEN_ON

Added in API level 1
public static final int FLAG_KEEP_SCREEN_ON

Window flag: as long as this window is visible to the user, keep the device's screen turned on and bright.

Constant Value: 128 (0x00000080)

FLAG_LAYOUT_ATTACHED_IN_DECOR

Added in API level 22
Deprecated in API level 30
public static final int FLAG_LAYOUT_ATTACHED_IN_DECOR

This constant was deprecated in API level 30.
Use setFitInsetsTypes(int) to determine whether the attached window will overlap with system bars.

Window flag: When requesting layout with an attached window, the attached window may overlap with the screen decorations of the parent window such as the navigation bar. By including this flag, the window manager will layout the attached window within the decor frame of the parent window such that it doesn't overlap with screen decorations.

Constant Value: 1073741824 (0x40000000)

FLAG_LAYOUT_INSET_DECOR

Added in API level 1
Deprecated in API level 30
public static final int FLAG_LAYOUT_INSET_DECOR

This constant was deprecated in API level 30.
Insets will always be delivered to your application.

Window flag: a special option only for use in combination with FLAG_LAYOUT_IN_SCREEN. When requesting layout in the screen your window may appear on top of or behind screen decorations such as the status bar. By also including this flag, the window manager will report the inset rectangle needed to ensure your content is not covered by screen decorations. This flag is normally set for you by Window as described in Window#setFlags

Constant Value: 65536 (0x00010000)

FLAG_LAYOUT_IN_OVERSCAN

Added in API level 18
Deprecated in API level 30
public static final int FLAG_LAYOUT_IN_OVERSCAN

This constant was deprecated in API level 30.
Overscan areas aren't set by any Android product anymore as of Android 11.

Window flag: allow window contents to extend in to the screen's overscan area, if there is one. The window should still correctly position its contents to take the overscan area into account.

This flag can be controlled in your theme through the R.attr.windowOverscan attribute; this attribute is automatically set for you in the standard overscan themes such as R.style.Theme_Holo_NoActionBar_Overscan, R.style.Theme_Holo_Light_NoActionBar_Overscan, R.style.Theme_DeviceDefault_NoActionBar_Overscan, and R.style.Theme_DeviceDefault_Light_NoActionBar_Overscan.

When this flag is enabled for a window, its normal content may be obscured to some degree by the overscan region of the display. To ensure key parts of that content are visible to the user, you can use View.setFitsSystemWindows(boolean) to set the point in the view hierarchy where the appropriate offsets should be applied. (This can be done either by directly calling this function, using the R.attr.fitsSystemWindows attribute in your view hierarchy, or implementing you own View.fitSystemWindows(Rect) method).

This mechanism for positioning content elements is identical to its equivalent use with layout and View.setSystemUiVisibility(int); here is an example layout that will correctly position its UI elements with this overscan flag is set:

<!-- This layout is designed for use with FLAG_LAYOUT_IN_OVERSCAN, so its window will
     be placed into the overscan region of the display (if there is one).  Thus the contents
     of the top-level view may be obscured around the edges by the display, leaving the
     edge of the box background used here invisible. -->
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/box_white">

    <!-- This is still in the same position as the top-level FrameLayout, so the contentx
        of this TextView may also be obscured. -->
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="3dp"
        android:layout_marginLeft="3dp"
        android:textAppearance="?android:attr/textAppearanceMedium"
        android:text="Overscan" />

    <!-- This FrameLayout uses android:fitsSystemWindows to have its padding adjusted so
         that within that space its content is offset to not be obscured by the overscan
         region (or also system decors that are covering its UI. -->
    <FrameLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:fitsSystemWindows="true">

        <!-- Now that we are within the padding region of the parent FrameLayout, we can
             safely place content that will be visible to the user. -->
        <ImageView
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:src="@drawable/frantic"
            android:scaleType="fitXY" />
        <ImageView
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:background="@drawable/box_white" />
        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginTop="3dp"
            android:layout_marginLeft="3dp"
            android:textAppearance="?android:attr/textAppearanceMedium"
            android:text="Content" />

    </FrameLayout>

</FrameLayout>

Constant Value: 33554432 (0x02000000)

FLAG_LAYOUT_IN_SCREEN

Added in API level 1
public static final int FLAG_LAYOUT_IN_SCREEN

Window flag for attached windows: Place the window within the entire screen, ignoring any constraints from the parent window.

Note: on displays that have a DisplayCutout, the window may be placed such that it avoids the DisplayCutout area if necessary according to the layoutInDisplayCutoutMode.

Constant Value: 256 (0x00000100)

FLAG_LAYOUT_NO_LIMITS

Added in API level 1
public static final int FLAG_LAYOUT_NO_LIMITS

Window flag: allow window to extend outside of the screen.

Constant Value: 512 (0x00000200)

FLAG_LOCAL_FOCUS_MODE

Added in API level 19
public static final int FLAG_LOCAL_FOCUS_MODE

Flag for a window in local focus mode. Window in local focus mode can control focus independent of window manager using Window#setLocalFocus(boolean, boolean). Usually window in this mode will not get touch/key events from window manager, but will get events only via local injection using Window#injectInputEvent(InputEvent).

Constant Value: 268435456 (0x10000000)

FLAG_NOT_FOCUSABLE

Added in API level 1
public static final int FLAG_NOT_FOCUSABLE

Window flag: this window won't ever get key input focus, so the user can not send key or other button events to it. Those will instead go to whatever focusable window is behind it. This flag will also enable FLAG_NOT_TOUCH_MODAL whether or not that is explicitly set.

Setting this flag also implies that the window will not need to interact with a soft input method, so it will be Z-ordered and positioned independently of any active input method (typically this means it gets Z-ordered on top of the input method, so it can use the full screen for its content and cover the input method if needed. You can use FLAG_ALT_FOCUSABLE_IM to modify this behavior.

Constant Value: 8 (0x00000008)

FLAG_NOT_TOUCHABLE

Added in API level 1
public static final int FLAG_NOT_TOUCHABLE

Window flag: this window can never receive touch events.

The intention of this flag is to leave the touch to be handled by some window below this window (in Z order).

Starting from Android Build.VERSION_CODES#S, for security reasons, touch events that pass through windows containing this flag (ie. are within the bounds of the window) will only be delivered to the touch-consuming window if one (or more) of the items below are true:

  1. Same UID: This window belongs to the same UID that owns the touch-consuming window.
  2. Trusted windows: This window is trusted. Trusted windows include (but are not limited to) accessibility windows (TYPE_ACCESSIBILITY_OVERLAY), the IME (TYPE_INPUT_METHOD) and assistant windows (TYPE_VOICE_INTERACTION). Windows of type TYPE_APPLICATION_OVERLAY are not trusted, see below.
  3. Invisible windows: This window is View#GONE or View#INVISIBLE.
  4. Fully transparent windows: This window has LayoutParams#alpha equal to 0.
  5. One SAW window with enough transparency: This window is of type TYPE_APPLICATION_OVERLAY, has LayoutParams#alpha below or equal to the maximum obscuring opacity (see below) and it's the only window of type TYPE_APPLICATION_OVERLAY from this UID in the touch path.
  6. Multiple SAW windows with enough transparency: The multiple overlapping TYPE_APPLICATION_OVERLAY windows in the touch path from this UID have a combined obscuring opacity below or equal to the maximum obscuring opacity. See section Combined obscuring opacity below on how to compute this value.

If none of these cases hold, the touch will not be delivered and a message will be logged to logcat.

Maximum obscuring opacity

This value is 0.8. Apps that want to gather this value from the system rather than hard-coding it might want to use InputManager.getMaximumObscuringOpacityForTouch().

Combined obscuring opacity

The combined obscuring opacity of a set of windows is obtained by combining the opacity values of all windows in the set using the associative and commutative operation defined as:

 opacity({A,B}) = 1 - (1 - opacity(A))*(1 - opacity(B))
 

where opacity(X) is the LayoutParams#alpha of window X. So, for a set of windows {W1, .., Wn}, the combined obscuring opacity will be:

 opacity({W1, .., Wn}) = 1 - (1 - opacity(W1)) * ... * (1 - opacity(Wn))
 

Constant Value: 16 (0x00000010)

FLAG_NOT_TOUCH_MODAL

Added in API level 1
public static final int FLAG_NOT_TOUCH_MODAL

Window flag: even when this window is focusable (its FLAG_NOT_FOCUSABLE is not set), allow any pointer events outside of the window to be sent to the windows behind it. Otherwise it will consume all pointer events itself, regardless of whether they are inside of the window.

Constant Value: 32 (0x00000020)

FLAG_SCALED

Added in API level 1
public static final int FLAG_SCALED

Window flag: a special mode where the layout parameters are used to perform scaling of the surface when it is composited to the screen.

Constant Value: 16384 (0x00004000)

FLAG_SECURE

Added in API level 1
public static final int FLAG_SECURE

Window flag: treat the content of the window as secure, preventing it from appearing in screenshots or from being viewed on non-secure displays.

See View.setContentSensitivity(int), a window hosting a sensitive view will be marked as secure during media projection, preventing it from being viewed on non-secure displays and during screen share.

See Display.FLAG_SECURE for more details about secure surfaces and secure displays.

Constant Value: 8192 (0x00002000)

FLAG_SHOW_WALLPAPER

Added in API level 5
public static final int FLAG_SHOW_WALLPAPER

Window flag: ask that the system wallpaper be shown behind your window. The window surface must be translucent to be able to actually see the wallpaper behind it; this flag just ensures that the wallpaper surface will be there if this window actually has translucent regions.

This flag can be controlled in your theme through the R.attr.windowShowWallpaper attribute; this attribute is automatically set for you in the standard wallpaper themes such as R.style.Theme_Wallpaper, R.style.Theme_Wallpaper_NoTitleBar, R.style.Theme_Wallpaper_NoTitleBar_Fullscreen, R.style.Theme_Holo_Wallpaper, R.style.Theme_Holo_Wallpaper_NoTitleBar, R.style.Theme_DeviceDefault_Wallpaper, and R.style.Theme_DeviceDefault_Wallpaper_NoTitleBar.

When this flag is set, all touch events sent to this window is also sent to the wallpaper, which is used to interact with live wallpapers. Check LayoutParams#areWallpaperTouchEventsEnabled(), which is set to true by default. When showing sensitive information on the window, if you want to disable sending the touch events to the wallpaper, use LayoutParams#setWallpaperTouchEventsEnabled(boolean).

Constant Value: 1048576 (0x00100000)

FLAG_SHOW_WHEN_LOCKED

Added in API level 5
Deprecated in API level 27
public static final int FLAG_SHOW_WHEN_LOCKED

This constant was deprecated in API level 27.
Use R.attr.showWhenLocked or Activity.setShowWhenLocked(boolean) instead to prevent an unintentional double life-cycle event.

Window flag: special flag to let windows be shown when the screen is locked. This will let application windows take precedence over key guard or any other lock screens. Can be used with FLAG_KEEP_SCREEN_ON to turn screen on and display windows directly before showing the key guard window. Can be used with FLAG_DISMISS_KEYGUARD to automatically fully dismisss non-secure keyguards. This flag only applies to the top-most full-screen window.

Constant Value: 524288 (0x00080000)

FLAG_SPLIT_TOUCH

Added in API level 11
public static final int FLAG_SPLIT_TOUCH

Window flag: when set the window will accept for touch events outside of its bounds to be sent to other windows that also support split touch. When this flag is not set, the first pointer that goes down determines the window to which all subsequent touches go until all pointers go up. When this flag is set, each pointer (not necessarily the first) that goes down determines the window to which all subsequent touches of that pointer will go until that pointer goes up thereby enabling touches with multiple pointers to be split across multiple windows.

Constant Value: 8388608 (0x00800000)

FLAG_TOUCHABLE_WHEN_WAKING

Added in API level 1
Deprecated in API level 20
public static final int FLAG_TOUCHABLE_WHEN_WAKING

This constant was deprecated in API level 20.
This flag has no effect.

Window flag: when set, if the device is asleep when the touch screen is pressed, you will receive this first touch event. Usually the first touch event is consumed by the system since the user can not see what they are pressing on.

Constant Value: 64 (0x00000040)

FLAG_TRANSLUCENT_NAVIGATION

Added in API level 19
Deprecated in API level 30
public static final int FLAG_TRANSLUCENT_NAVIGATION

This constant was deprecated in API level 30.
Use Window#setNavigationBarColor(int) with a half-translucent color instead.

Window flag: request a translucent navigation bar with minimal system-provided background protection.

This flag can be controlled in your theme through the R.attr.windowTranslucentNavigation attribute; this attribute is automatically set for you in the standard translucent decor themes such as R.style.Theme_Holo_NoActionBar_TranslucentDecor, R.style.Theme_Holo_Light_NoActionBar_TranslucentDecor, R.style.Theme_DeviceDefault_NoActionBar_TranslucentDecor, and R.style.Theme_DeviceDefault_Light_NoActionBar_TranslucentDecor.

When this flag is enabled for a window, it automatically sets the system UI visibility flags View#SYSTEM_UI_FLAG_LAYOUT_STABLE and View#SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION.

Note: For devices that support PackageManager.FEATURE_AUTOMOTIVE this flag can be disabled by the car manufacturers.

Constant Value: 134217728 (0x08000000)

FLAG_TRANSLUCENT_STATUS

Added in API level 19
Deprecated in API level 30
public static final int FLAG_TRANSLUCENT_STATUS

This constant was deprecated in API level 30.
Use Window#setStatusBarColor(int) with a half-translucent color instead.

Window flag: request a translucent status bar with minimal system-provided background protection.

This flag can be controlled in your theme through the R.attr.windowTranslucentStatus attribute; this attribute is automatically set for you in the standard translucent decor themes such as R.style.Theme_Holo_NoActionBar_TranslucentDecor, R.style.Theme_Holo_Light_NoActionBar_TranslucentDecor, R.style.Theme_DeviceDefault_NoActionBar_TranslucentDecor, and R.style.Theme_DeviceDefault_Light_NoActionBar_TranslucentDecor.

When this flag is enabled for a window, it automatically sets the system UI visibility flags View#SYSTEM_UI_FLAG_LAYOUT_STABLE and View#SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN.

Note: For devices that support PackageManager.FEATURE_AUTOMOTIVE this flag may be ignored.

Constant Value: 67108864 (0x04000000)

FLAG_TURN_SCREEN_ON

Added in API level 5
Deprecated in API level 27
public static final int FLAG_TURN_SCREEN_ON

This constant was deprecated in API level 27.
Use R.attr.turnScreenOn or Activity.setTurnScreenOn(boolean) instead to prevent an unintentional double life-cycle event.

Window flag: when set as a window is being added or made visible, once the window has been shown then the system will poke the power manager's user activity (as if the user had woken up the device) to turn the screen on.

Constant Value: 2097152 (0x00200000)

FLAG_WATCH_OUTSIDE_TOUCH

Added in API level 3
public static final int FLAG_WATCH_OUTSIDE_TOUCH

Window flag: if you have set FLAG_NOT_TOUCH_MODAL, you can set this flag to receive a single special MotionEvent with the action MotionEvent.ACTION_OUTSIDE for touches that occur outside of your window. Note that you will not receive the full down/move/up gesture, only the location of the first down as an ACTION_OUTSIDE.

Constant Value: 262144 (0x00040000)

FORMAT_CHANGED

Added in API level 1
public static final int FORMAT_CHANGED

Constant Value: 8 (0x00000008)

LAST_APPLICATION_WINDOW

Added in API level 1
public static final int LAST_APPLICATION_WINDOW

End of types of application windows.

Constant Value: 99 (0x00000063)

LAST_SUB_WINDOW

Added in API level 1
public static final int LAST_SUB_WINDOW

End of types of sub-windows.

Constant Value: 1999 (0x000007cf)

LAST_SYSTEM_WINDOW

Added in API level 1
public static final int LAST_SYSTEM_WINDOW

End of types of system windows.

Constant Value: 2999 (0x00000bb7)

LAYOUT_CHANGED

Added in API level 1
public static final int LAYOUT_CHANGED

Constant Value: 1 (0x00000001)

LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS

Added in API level 30
public static final int LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS

The window is always allowed to extend into the DisplayCutout areas on the all edges of the screen.

The window must make sure that no important content overlaps with the DisplayCutout.

In this mode, the window extends under cutouts on the all edges of the display in both portrait and landscape, regardless of whether the window is hiding the system bars.

Note: Android might not allow the content view to overlap the system bars in view level. To override this behavior and allow content to be able to extend into the cutout area, call Window#setDecorFitsSystemWindows(boolean) with false.

Constant Value: 3 (0x00000003)

LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT

Added in API level 28
public static final int LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT

The window is allowed to extend into the DisplayCutout area, only if the DisplayCutout is fully contained within a system bar or the DisplayCutout is not deeper than 16 dp, but this depends on the OEM choice. Otherwise, the window is laid out such that it does not overlap with the DisplayCutout area.

In practice, this means that if the window did not set FLAG_FULLSCREEN or View#SYSTEM_UI_FLAG_FULLSCREEN, it can extend into the cutout area in portrait if the cutout is at the top edge. Similarly for View#SYSTEM_UI_FLAG_HIDE_NAVIGATION and a cutout at the bottom of the screen. Otherwise (i.e. fullscreen or landscape) it is laid out such that it does not overlap the cutout area.

The usual precautions for not overlapping with the status and navigation bar are sufficient for ensuring that no important content overlaps with the DisplayCutout.

Note: OEMs can have an option to allow the window to always extend into the DisplayCutout area, no matter the cutout flag set, when the DisplayCutout is on the different side from system bars, only if the DisplayCutout overlaps at most 16dp with the windows. In such case, OEMs must provide an opt-in/out affordance for users.

Constant Value: 0 (0x00000000)

LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER

Added in API level 28
public static final int LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER

The window is never allowed to overlap with the DisplayCutout area.

This should be used with windows that transiently set View#SYSTEM_UI_FLAG_FULLSCREEN or View#SYSTEM_UI_FLAG_HIDE_NAVIGATION to avoid a relayout of the window when the respective flag is set or cleared.

Constant Value: 2 (0x00000002)

LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES

Added in API level 28
public static final int LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES

The window is always allowed to extend into the DisplayCutout areas on the short edges of the screen.

The window will never extend into a DisplayCutout area on the long edges of the screen, unless the DisplayCutout is not deeper than 16 dp, but this depends on the OEM choice.

Note: OEMs can have an option to allow the window to extend into the DisplayCutout area on the long edge side, only if the cutout overlaps at most 16dp with the windows. In such case, OEMs must provide an opt-in/out affordance for users.

The window must make sure that no important content overlaps with the DisplayCutout.

In this mode, the window extends under cutouts on the short edge of the display in both portrait and landscape, regardless of whether the window is hiding the system bars:
Screenshot of a fullscreen activity on a display with a cutout at the top edge in
         portrait, no letterbox is applied. Screenshot of an activity on a display with a cutout at the top edge in landscape,
         no letterbox is applied.

A cutout in the corner can be considered to be on different edge in different device rotations. This behavior may vary from device to device. Use this flag is possible to letterbox your app if the display cutout is at corner.

On the other hand, should the cutout be on the long edge of the display, a letterbox will be applied such that the window does not extend into the cutout on either long edge:
Screenshot of an activity on a display with a cutout on the long edge in portrait,
         letterbox is applied.

Note: Android might not allow the content view to overlap the system bars in view level. To override this behavior and allow content to be able to extend into the cutout area, call Window#setDecorFitsSystemWindows(boolean) with false.

Constant Value: 1 (0x00000001)

MEMORY_TYPE_CHANGED

Added in API level 1
public static final int MEMORY_TYPE_CHANGED

Constant Value: 256 (0x00000100)

MEMORY_TYPE_GPU

Added in API level 1
Deprecated in API level 15
public static final int MEMORY_TYPE_GPU

This constant was deprecated in API level 15.
this is ignored, this value is set automatically when needed.

Constant Value: 2 (0x00000002)

MEMORY_TYPE_HARDWARE

Added in API level 1
Deprecated in API level 15
public static final int MEMORY_TYPE_HARDWARE

This constant was deprecated in API level 15.
this is ignored, this value is set automatically when needed.

Constant Value: 1 (0x00000001)

MEMORY_TYPE_NORMAL

Added in API level 1
Deprecated in API level 15
public static final int MEMORY_TYPE_NORMAL

This constant was deprecated in API level 15.
this is ignored, this value is set automatically when needed.

Constant Value: 0 (0x00000000)

MEMORY_TYPE_PUSH_BUFFERS

Added in API level 1
Deprecated in API level 15
public static final int MEMORY_TYPE_PUSH_BUFFERS

This constant was deprecated in API level 15.
this is ignored, this value is set automatically when needed.

Constant Value: 3 (0x00000003)

ROTATION_ANIMATION_CHANGED

Added in API level 18
public static final int ROTATION_ANIMATION_CHANGED

Constant Value: 4096 (0x00001000)

ROTATION_ANIMATION_CROSSFADE

Added in API level 18
public static final int ROTATION_ANIMATION_CROSSFADE

Value for rotationAnimation which specifies that this window will fade in or out following a rotation.

Constant Value: 1 (0x00000001)

ROTATION_ANIMATION_JUMPCUT

Added in API level 18
public static final int ROTATION_ANIMATION_JUMPCUT

Value for rotationAnimation which specifies that this window will immediately disappear or appear following a rotation.

Constant Value: 2 (0x00000002)

ROTATION_ANIMATION_ROTATE

Added in API level 18
public static final int ROTATION_ANIMATION_ROTATE

Value for rotationAnimation which specifies that this window will visually rotate in or out following a rotation.

Constant Value: 0 (0x00000000)

ROTATION_ANIMATION_SEAMLESS

Added in API level 26
public static final int ROTATION_ANIMATION_SEAMLESS

Value for rotationAnimation to specify seamless rotation mode. This works like JUMPCUT but will fall back to CROSSFADE if rotation can't be applied without pausing the screen. For example, this is ideal for Camera apps which don't want the viewfinder contents to ever rotate or fade (and rather to be seamless) but also don't want ROTATION_ANIMATION_JUMPCUT during app transition scenarios where seamless rotation can't be applied.

Constant Value: 3 (0x00000003)

SCREEN_BRIGHTNESS_CHANGED

Added in API level 3
public static final int SCREEN_BRIGHTNESS_CHANGED

Constant Value: 2048 (0x00000800)

SCREEN_ORIENTATION_CHANGED

Added in API level 3
public static final int SCREEN_ORIENTATION_CHANGED

Constant Value: 1024 (0x00000400)

SOFT_INPUT_ADJUST_NOTHING

Added in API level 11
public static final int SOFT_INPUT_ADJUST_NOTHING

Adjustment option for softInputMode: set to have a window not adjust for a shown input method. The window will not be resized, and it will not be panned to make its focus visible.

Constant Value: 48 (0x00000030)

SOFT_INPUT_ADJUST_PAN

Added in API level 3
public static final int SOFT_INPUT_ADJUST_PAN

Adjustment option for softInputMode: set to have a window pan when an input method is shown, so it doesn't need to deal with resizing but just panned by the framework to ensure the current input focus is visible. This can not be combined with SOFT_INPUT_ADJUST_RESIZE; if neither of these are set, then the system will try to pick one or the other depending on the contents of the window.

Constant Value: 32 (0x00000020)

SOFT_INPUT_ADJUST_RESIZE

Added in API level 3
Deprecated in API level 30
public static final int SOFT_INPUT_ADJUST_RESIZE

This constant was deprecated in API level 30.
Call Window#setDecorFitsSystemWindows(boolean) with false and install an OnApplyWindowInsetsListener on your root content view that fits insets of type Type#ime().

Adjustment option for softInputMode: set to allow the window to be resized when an input method is shown, so that its contents are not covered by the input method. This can not be combined with SOFT_INPUT_ADJUST_PAN; if neither of these are set, then the system will try to pick one or the other depending on the contents of the window. If the window's layout parameter flags include FLAG_FULLSCREEN, this value for softInputMode will be ignored; the window will not resize, but will stay fullscreen.

Constant Value: 16 (0x00000010)

SOFT_INPUT_ADJUST_UNSPECIFIED

Added in API level 3
public static final int SOFT_INPUT_ADJUST_UNSPECIFIED

Adjustment option for softInputMode: nothing specified. The system will try to pick one or the other depending on the contents of the window.

Constant Value: 0 (0x00000000)

SOFT_INPUT_IS_FORWARD_NAVIGATION

Added in API level 3
public static final int SOFT_INPUT_IS_FORWARD_NAVIGATION

Bit for softInputMode: set when the user has navigated forward to the window. This is normally set automatically for you by the system, though you may want to set it in certain cases when you are displaying a window yourself. This flag will always be cleared automatically after the window is displayed.

Constant Value: 256 (0x00000100)

SOFT_INPUT_MASK_ADJUST

Added in API level 3
public static final int SOFT_INPUT_MASK_ADJUST

Mask for softInputMode of the bits that determine the way that the window should be adjusted to accommodate the soft input window.

Constant Value: 240 (0x000000f0)

SOFT_INPUT_MASK_STATE

Added in API level 3
public static final int SOFT_INPUT_MASK_STATE

Mask for softInputMode of the bits that determine the desired visibility state of the soft input area for this window.

Constant Value: 15 (0x0000000f)

SOFT_INPUT_MODE_CHANGED

Added in API level 3
public static final int SOFT_INPUT_MODE_CHANGED

Constant Value: 512 (0x00000200)

SOFT_INPUT_STATE_ALWAYS_HIDDEN

Added in API level 3
public static final int SOFT_INPUT_STATE_ALWAYS_HIDDEN

Visibility state for softInputMode: please always hide any soft input area when this window receives focus.

Constant Value: 3 (0x00000003)

SOFT_INPUT_STATE_ALWAYS_VISIBLE

Added in API level 3
public static final int SOFT_INPUT_STATE_ALWAYS_VISIBLE

Visibility state for softInputMode: please always make the soft input area visible when this window receives input focus.

Applications that target Build.VERSION_CODES.P and later, this flag is ignored unless there is a focused view that returns true from View#onCheckIsTextEditor() when the window is focused.

Constant Value: 5 (0x00000005)

SOFT_INPUT_STATE_HIDDEN

Added in API level 3
public static final int SOFT_INPUT_STATE_HIDDEN

Visibility state for softInputMode: please hide any soft input area when normally appropriate (when the user is navigating forward to your window).

Constant Value: 2 (0x00000002)

SOFT_INPUT_STATE_UNCHANGED

Added in API level 3
public static final int SOFT_INPUT_STATE_UNCHANGED

Visibility state for softInputMode: please don't change the state of the soft input area.

Constant Value: 1 (0x00000001)

SOFT_INPUT_STATE_UNSPECIFIED

Added in API level 3
public static final int SOFT_INPUT_STATE_UNSPECIFIED

Visibility state for softInputMode: no state has been specified. The system may show or hide the software keyboard for better user experience when the window gains focus.

Constant Value: 0 (0x00000000)

SOFT_INPUT_STATE_VISIBLE

Added in API level 3
public static final int SOFT_INPUT_STATE_VISIBLE

Visibility state for softInputMode: please show the soft input area when normally appropriate (when the user is navigating forward to your window).

Applications that target Build.VERSION_CODES.P and later, this flag is ignored unless there is a focused view that returns true from View#onCheckIsTextEditor() when the window is focused.

Constant Value: 4 (0x00000004)

TITLE_CHANGED

Added in API level 1
public static final int TITLE_CHANGED

Constant Value: 64 (0x00000040)

TYPE_ACCESSIBILITY_OVERLAY

Added in API level 22
public static final int TYPE_ACCESSIBILITY_OVERLAY

Window type: Windows that are overlaid only by a connected AccessibilityService for interception of user interactions without changing the windows an accessibility service can introspect. In particular, an accessibility service can introspect only windows that a sighted user can interact with which is they can touch these windows or can type into these windows. For example, if there is a full screen accessibility overlay that is touchable, the windows below it will be introspectable by an accessibility service even though they are covered by a touchable window.

Constant Value: 2032 (0x000007f0)

TYPE_APPLICATION

Added in API level 1
public static final int TYPE_APPLICATION

Window type: a normal application window. The token must be an Activity token identifying who the window belongs to. In multiuser systems shows only on the owning user's window.

Constant Value: 2 (0x00000002)

TYPE_APPLICATION_ATTACHED_DIALOG

Added in API level 3
public static final int TYPE_APPLICATION_ATTACHED_DIALOG

Window type: like TYPE_APPLICATION_PANEL, but layout of the window happens as that of a top-level window, not as a child of its container.

Constant Value: 1003 (0x000003eb)

TYPE_APPLICATION_MEDIA

Added in API level 1
public static final int TYPE_APPLICATION_MEDIA

Window type: window for showing media (such as video). These windows are displayed behind their attached window.

Constant Value: 1001 (0x000003e9)

TYPE_APPLICATION_OVERLAY

Added in API level 26
public static final int TYPE_APPLICATION_OVERLAY

Window type: Application overlay windows are displayed above all activity windows (types between FIRST_APPLICATION_WINDOW and LAST_APPLICATION_WINDOW) but below critical system windows like the status bar or IME.

The system may change the position, size, or visibility of these windows at anytime to reduce visual clutter to the user and also manage resources.

Requires Manifest.permission.SYSTEM_ALERT_WINDOW permission.

The system will adjust the importance of processes with this window type to reduce the chance of the low-memory-killer killing them.

In multi-user systems shows only on the owning user's screen.

Constant Value: 2038 (0x000007f6)

TYPE_APPLICATION_PANEL

Added in API level 1
public static final int TYPE_APPLICATION_PANEL

Window type: a panel on top of an application window. These windows appear on top of their attached window.

Constant Value: 1000 (0x000003e8)

TYPE_APPLICATION_STARTING

Added in API level 1
public static final int TYPE_APPLICATION_STARTING

Window type: special application window that is displayed while the application is starting. Not for use by applications themselves; this is used by the system to display something until the application can show its own windows. In multiuser systems shows on all users' windows.

Constant Value: 3 (0x00000003)

TYPE_APPLICATION_SUB_PANEL

Added in API level 1
public static final int TYPE_APPLICATION_SUB_PANEL

Window type: a sub-panel on top of an application window. These windows are displayed on top their attached window and any TYPE_APPLICATION_PANEL panels.

Constant Value: 1002 (0x000003ea)

TYPE_BASE_APPLICATION

Added in API level 1
public static final int TYPE_BASE_APPLICATION

Window type: an application window that serves as the "base" window of the overall application; all other application windows will appear on top of it. In multiuser systems shows only on the owning user's window.

Constant Value: 1 (0x00000001)

TYPE_CHANGED

Added in API level 1
public static final int TYPE_CHANGED

Constant Value: 2 (0x00000002)

TYPE_DRAWN_APPLICATION

Added in API level 25
public static final int TYPE_DRAWN_APPLICATION

Window type: a variation on TYPE_APPLICATION that ensures the window manager will wait for this window to be drawn before the app is shown. In multiuser systems shows only on the owning user's window.

Constant Value: 4 (0x00000004)

TYPE_INPUT_METHOD

Added in API level 3
public static final int TYPE_INPUT_METHOD

Window type: internal input methods windows, which appear above the normal UI. Application windows may be resized or panned to keep the input focus visible while this window is displayed. In multiuser systems shows only on the owning user's window.

Constant Value: 2011 (0x000007db)

TYPE_INPUT_METHOD_DIALOG

Added in API level 3
public static final int TYPE_INPUT_METHOD_DIALOG

Window type: internal input methods dialog windows, which appear above the current input method window. In multiuser systems shows only on the owning user's window.

Constant Value: 2012 (0x000007dc)

TYPE_KEYGUARD_DIALOG

Added in API level 1
public static final int TYPE_KEYGUARD_DIALOG

Window type: dialogs that the keyguard shows In multiuser systems shows on all users' windows.

Constant Value: 2009 (0x000007d9)

TYPE_PHONE

Added in API level 1
Deprecated in API level 26
public static final int TYPE_PHONE

This constant was deprecated in API level 26.
for non-system apps. Use TYPE_APPLICATION_OVERLAY instead.

Window type: phone. These are non-application windows providing user interaction with the phone (in particular incoming calls). These windows are normally placed above all applications, but behind the status bar. In multiuser systems shows on all users' windows.

Constant Value: 2002 (0x000007d2)

TYPE_PRIORITY_PHONE

Added in API level 1
Deprecated in API level 26
public static final int TYPE_PRIORITY_PHONE

This constant was deprecated in API level 26.
for non-system apps. Use TYPE_APPLICATION_OVERLAY instead.

Window type: priority phone UI, which needs to be displayed even if the keyguard is active. These windows must not take input focus, or they will interfere with the keyguard. In multiuser systems shows on all users' windows.

Constant Value: 2007 (0x000007d7)

TYPE_PRIVATE_PRESENTATION

Added in API level 19
public static final int TYPE_PRIVATE_PRESENTATION

Window type: Window for Presentation on top of private virtual display.

Constant Value: 2030 (0x000007ee)

Added in API level 1
public static final int TYPE_SEARCH_BAR

Window type: the search bar. There can be only one search bar window; it is placed at the top of the screen. In multiuser systems shows on all users' windows.

Constant Value: 2001 (0x000007d1)

TYPE_STATUS_BAR

Added in API level 1
public static final int TYPE_STATUS_BAR

Window type: the status bar. There can be only one status bar window; it is placed at the top of the screen, and all other windows are shifted down so they are below it. In multiuser systems shows on all users' windows.

Constant Value: 2000 (0x000007d0)

TYPE_SYSTEM_ALERT

Added in API level 1
Deprecated in API level 26
public static final int TYPE_SYSTEM_ALERT

This constant was deprecated in API level 26.
for non-system apps. Use TYPE_APPLICATION_OVERLAY instead.

Window type: system window, such as low power alert. These windows are always on top of application windows. In multiuser systems shows only on the owning user's window.

Constant Value: 2003 (0x000007d3)

TYPE_SYSTEM_DIALOG

Added in API level 1
public static final int TYPE_SYSTEM_DIALOG

Window type: panel that slides out from the status bar In multiuser systems shows on all users' windows.

Constant Value: 2008 (0x000007d8)

TYPE_SYSTEM_ERROR

Added in API level 1
Deprecated in API level 26
public static final int TYPE_SYSTEM_ERROR

This constant was deprecated in API level 26.
for non-system apps. Use TYPE_APPLICATION_OVERLAY instead.

Window type: internal system error windows, appear on top of everything they can. In multiuser systems shows only on the owning user's window.

Constant Value: 2010 (0x000007da)

TYPE_SYSTEM_OVERLAY

Added in API level 1
Deprecated in API level 26
public static final int TYPE_SYSTEM_OVERLAY

This constant was deprecated in API level 26.
for non-system apps. Use TYPE_APPLICATION_OVERLAY instead.

Window type: system overlay windows, which need to be displayed on top of everything else. These windows must not take input focus, or they will interfere with the keyguard. In multiuser systems shows only on the owning user's window.

Constant Value: 2006 (0x000007d6)

TYPE_TOAST

Added in API level 1
Deprecated in API level 26
public static final int TYPE_TOAST

This constant was deprecated in API level 26.
for non-system apps. Use TYPE_APPLICATION_OVERLAY instead.

Window type: transient notifications. In multiuser systems shows only on the owning user's window.

Constant Value: 2005 (0x000007d5)

TYPE_WALLPAPER

Added in API level 5
public static final int TYPE_WALLPAPER

Window type: wallpaper window, placed behind any window that wants to sit on top of the wallpaper. In multiuser systems shows only on the owning user's window.

Constant Value: 2013 (0x000007dd)

Fields

CREATOR

Added in API level 1
public static final Creator<WindowManager.LayoutParams> CREATOR

alpha

Added in API level 1
public float alpha

An alpha value to apply to this entire window. An alpha of 1.0 means fully opaque and 0.0 means fully transparent

buttonBrightness

Added in API level 8
public float buttonBrightness

This can be used to override the standard behavior of the button and keyboard backlights. A value of less than 0, the default, means to use the standard backlight behavior. 0 to 1 adjusts the brightness from dark to full bright.

dimAmount

Added in API level 1
public float dimAmount

When FLAG_DIM_BEHIND is set, this is the amount of dimming to apply. Range is from 1.0 for completely opaque to 0.0 for no dim.

flags

Added in API level 1
public int flags

Various behavioral options/flags. Default is none.
Value is either 0 or a combination of FLAG_ALLOW_LOCK_WHILE_SCREEN_ON, FLAG_DIM_BEHIND, FLAG_BLUR_BEHIND, FLAG_NOT_FOCUSABLE, FLAG_NOT_TOUCHABLE, FLAG_NOT_TOUCH_MODAL, FLAG_TOUCHABLE_WHEN_WAKING, FLAG_KEEP_SCREEN_ON, FLAG_LAYOUT_IN_SCREEN, FLAG_LAYOUT_NO_LIMITS, FLAG_FULLSCREEN, FLAG_FORCE_NOT_FULLSCREEN, FLAG_DITHER, FLAG_SECURE, FLAG_SCALED, FLAG_IGNORE_CHEEK_PRESSES, FLAG_LAYOUT_INSET_DECOR, FLAG_ALT_FOCUSABLE_IM, FLAG_WATCH_OUTSIDE_TOUCH, FLAG_SHOW_WHEN_LOCKED, FLAG_SHOW_WALLPAPER, FLAG_TURN_SCREEN_ON, FLAG_DISMISS_KEYGUARD, FLAG_SPLIT_TOUCH, FLAG_HARDWARE_ACCELERATED, FLAG_LAYOUT_IN_OVERSCAN, FLAG_TRANSLUCENT_STATUS, FLAG_TRANSLUCENT_NAVIGATION, FLAG_LOCAL_FOCUS_MODE, android.view.WindowManager.LayoutParams.FLAG_SLIPPERY, FLAG_LAYOUT_ATTACHED_IN_DECOR, and FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS

format

Added in API level 1
public int format

The desired bitmap format. May be one of the constants in PixelFormat. The choice of format might be overridden by setColorMode(int). Default is OPAQUE.

gravity

Added in API level 1
public int gravity

Placement of window within the screen as per Gravity. Both Gravity.apply and Gravity.applyDisplay are used during window layout, with this value given as the desired gravity. For example you can specify Gravity.DISPLAY_CLIP_HORIZONTAL and Gravity.DISPLAY_CLIP_VERTICAL here to control the behavior of Gravity.applyDisplay.
Value is either 0 or a combination of Gravity.FILL, Gravity.FILL_HORIZONTAL, Gravity.FILL_VERTICAL, Gravity.START, Gravity.END, Gravity.LEFT, Gravity.RIGHT, Gravity.TOP, Gravity.BOTTOM, Gravity.CENTER, Gravity.CENTER_HORIZONTAL, Gravity.CENTER_VERTICAL, Gravity.DISPLAY_CLIP_HORIZONTAL, Gravity.DISPLAY_CLIP_VERTICAL, Gravity.CLIP_HORIZONTAL, Gravity.CLIP_VERTICAL, and Gravity.NO_GRAVITY

See also:

horizontalMargin

Added in API level 1
public float horizontalMargin

The horizontal margin, as a percentage of the container's width, between the container and the widget. See Gravity.apply for how this is used. This field is added with x to supply the xAdj parameter.

horizontalWeight

Added in API level 1
public float horizontalWeight

Indicates how much of the extra space will be allocated horizontally to the view associated with these LayoutParams. Specify 0 if the view should not be stretched. Otherwise the extra pixels will be pro-rated among all views whose weight is greater than 0.

memoryType

Added in API level 1
Deprecated in API level 15
public int memoryType

This field was deprecated in API level 15.
this is ignored

packageName

Added in API level 1
public String packageName

Name of the package owning this window.

preferMinimalPostProcessing

Added in API level 30
public boolean preferMinimalPostProcessing

Indicates whether this window wants the connected display to do minimal post processing on the produced image or video frames. This will only be requested if the window is visible on the screen.

This setting should be used when low latency has a higher priority than image enhancement processing (e.g. for games or video conferencing).

If the Display sink is connected via HDMI, the device will begin to send infoframes with Auto Low Latency Mode enabled and Game Content Type. This will switch the connected display to a minimal image processing mode (if available), which reduces latency, improving the user experience for gaming or video conferencing applications. For more information, see HDMI 2.1 specification.

If the Display sink has an internal connection or uses some other protocol than HDMI, effects may be similar but implementation-defined.

The ability to switch to a mode with minimal post proessing may be disabled by a user setting in the system settings menu. In that case, this field is ignored and the display will remain in its current mode.

preferredDisplayModeId

Added in API level 23
public int preferredDisplayModeId

Id of the preferred display mode for the window.

This must be one of the supported modes obtained for the display(s) the window is on. A value of 0 means no preference.

preferredRefreshRate

Added in API level 21
public float preferredRefreshRate

The preferred refresh rate for the window.

Before API 34, this must be one of the supported refresh rates obtained for the display(s) the window is on. The selected refresh rate will be applied to the display's default mode.

Starting API 34, this value is not limited to the supported refresh rates obtained from the display(s) for the window: it can be any refresh rate the window intends to run at. Any refresh rate can be provided as the preferred window refresh rate. The OS will select the refresh rate that best matches the preferredRefreshRate.

Setting this value is the equivalent of calling Surface#setFrameRate with ( preferred_frame_rate, Surface#FRAME_RATE_COMPATIBILITY_DEFAULT, Surface#CHANGE_FRAME_RATE_ONLY_IF_SEAMLESS). This should be used in favor of LayoutParams#preferredDisplayModeId for applications that want to specify the refresh rate, but do not want to specify a preference for any other displayMode properties (e.g., resolution).

This value is ignored if preferredDisplayModeId is set.

rotationAnimation

Added in API level 18
public int rotationAnimation

Define the exit and entry animations used on this window when the device is rotated. This only has an affect if the incoming and outgoing topmost opaque windows have the #FLAG_FULLSCREEN bit set and are not covered by other windows. All other situations default to the ROTATION_ANIMATION_ROTATE behavior.

screenBrightness

Added in API level 3
public float screenBrightness

This can be used to override the user's preferred brightness of the screen. A value of less than 0, the default, means to use the preferred screen brightness. 0 to 1 adjusts the brightness from dark to full bright.

screenOrientation

Added in API level 3
public int screenOrientation

Specific orientation value for a window. May be any of the same values allowed for ActivityInfo.screenOrientation. If not set, a default value of ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED will be used.
Value is android.content.pm.ActivityInfo.SCREEN_ORIENTATION_UNSET, ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED, ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE, ActivityInfo.SCREEN_ORIENTATION_PORTRAIT, ActivityInfo.SCREEN_ORIENTATION_USER, ActivityInfo.SCREEN_ORIENTATION_BEHIND, ActivityInfo.SCREEN_ORIENTATION_SENSOR, ActivityInfo.SCREEN_ORIENTATION_NOSENSOR, ActivityInfo.SCREEN_ORIENTATION_SENSOR_LANDSCAPE, ActivityInfo.SCREEN_ORIENTATION_SENSOR_PORTRAIT, ActivityInfo.SCREEN_ORIENTATION_REVERSE_LANDSCAPE, ActivityInfo.SCREEN_ORIENTATION_REVERSE_PORTRAIT, ActivityInfo.SCREEN_ORIENTATION_FULL_SENSOR, ActivityInfo.SCREEN_ORIENTATION_USER_LANDSCAPE, ActivityInfo.SCREEN_ORIENTATION_USER_PORTRAIT, ActivityInfo.SCREEN_ORIENTATION_FULL_USER, or ActivityInfo.SCREEN_ORIENTATION_LOCKED

softInputMode

Added in API level 3
public int softInputMode

Desired operating mode for any soft input area. May be any combination of:

This flag can be controlled in your theme through the R.attr.windowSoftInputMode attribute.


Value is either 0 or a combination of SOFT_INPUT_STATE_UNSPECIFIED, SOFT_INPUT_STATE_UNCHANGED, SOFT_INPUT_STATE_HIDDEN, SOFT_INPUT_STATE_ALWAYS_HIDDEN, SOFT_INPUT_STATE_VISIBLE, SOFT_INPUT_STATE_ALWAYS_VISIBLE, SOFT_INPUT_ADJUST_UNSPECIFIED, SOFT_INPUT_ADJUST_RESIZE, SOFT_INPUT_ADJUST_PAN, SOFT_INPUT_ADJUST_NOTHING, and SOFT_INPUT_IS_FORWARD_NAVIGATION

systemUiVisibility

Added in API level 11
Deprecated in API level 30
public int systemUiVisibility

This field was deprecated in API level 30.
SystemUiVisibility flags are deprecated. Use WindowInsetsController instead.

Control the visibility of the status bar.
Value is either 0 or a combination of View.SYSTEM_UI_FLAG_VISIBLE, View.SYSTEM_UI_FLAG_LOW_PROFILE, View.SYSTEM_UI_FLAG_HIDE_NAVIGATION, View.SYSTEM_UI_FLAG_FULLSCREEN, View.SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR, View.SYSTEM_UI_FLAG_LAYOUT_STABLE, View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION, View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN, View.SYSTEM_UI_FLAG_IMMERSIVE, View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY, View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR, android.view.View.STATUS_BAR_DISABLE_EXPAND, android.view.View.STATUS_BAR_DISABLE_NOTIFICATION_ICONS, android.view.View.STATUS_BAR_DISABLE_NOTIFICATION_ALERTS, android.view.View.STATUS_BAR_DISABLE_NOTIFICATION_TICKER, android.view.View.STATUS_BAR_DISABLE_SYSTEM_INFO, android.view.View.STATUS_BAR_DISABLE_HOME, android.view.View.STATUS_BAR_DISABLE_BACK, android.view.View.STATUS_BAR_DISABLE_CLOCK, android.view.View.STATUS_BAR_DISABLE_RECENT, and android.view.View.STATUS_BAR_DISABLE_SEARCH

token

Added in API level 1
public IBinder token

Identifier for this window. This will usually be filled in for you.

type

Added in API level 1
public int type

The general type of window. There are three main classes of window types:

  • Application windows (ranging from FIRST_APPLICATION_WINDOW to LAST_APPLICATION_WINDOW) are normal top-level application windows. For these types of windows, the token must be set to the token of the activity they are a part of (this will normally be done for you if token is null).
  • Sub-windows (ranging from FIRST_SUB_WINDOW to LAST_SUB_WINDOW) are associated with another top-level window. For these types of windows, the token must be the token of the window it is attached to.
  • System windows (ranging from FIRST_SYSTEM_WINDOW to LAST_SYSTEM_WINDOW) are special types of windows for use by the system for specific purposes. They should not normally be used by applications, and a special permission is required to use them.

Value is TYPE_BASE_APPLICATION, TYPE_APPLICATION, TYPE_APPLICATION_STARTING, TYPE_DRAWN_APPLICATION, TYPE_APPLICATION_PANEL, TYPE_APPLICATION_MEDIA, TYPE_APPLICATION_SUB_PANEL, TYPE_APPLICATION_ATTACHED_DIALOG, android.view.WindowManager.LayoutParams.TYPE_APPLICATION_MEDIA_OVERLAY, android.view.WindowManager.LayoutParams.TYPE_APPLICATION_ABOVE_SUB_PANEL, TYPE_STATUS_BAR, TYPE_SEARCH_BAR, TYPE_PHONE, TYPE_SYSTEM_ALERT, android.view.WindowManager.LayoutParams.TYPE_KEYGUARD, TYPE_TOAST, TYPE_SYSTEM_OVERLAY, TYPE_PRIORITY_PHONE, TYPE_SYSTEM_DIALOG, TYPE_KEYGUARD_DIALOG, TYPE_SYSTEM_ERROR, TYPE_INPUT_METHOD, TYPE_INPUT_METHOD_DIALOG, TYPE_WALLPAPER, android.view.WindowManager.LayoutParams.TYPE_STATUS_BAR_PANEL, android.view.WindowManager.LayoutParams.TYPE_SECURE_SYSTEM_OVERLAY, android.view.WindowManager.LayoutParams.TYPE_DRAG, android.view.WindowManager.LayoutParams.TYPE_STATUS_BAR_SUB_PANEL, android.view.WindowManager.LayoutParams.TYPE_POINTER, android.view.WindowManager.LayoutParams.TYPE_NAVIGATION_BAR, android.view.WindowManager.LayoutParams.TYPE_VOLUME_OVERLAY, android.view.WindowManager.LayoutParams.TYPE_BOOT_PROGRESS, android.view.WindowManager.LayoutParams.TYPE_INPUT_CONSUMER, android.view.WindowManager.LayoutParams.TYPE_NAVIGATION_BAR_PANEL, android.view.WindowManager.LayoutParams.TYPE_DISPLAY_OVERLAY, android.view.WindowManager.LayoutParams.TYPE_MAGNIFICATION_OVERLAY, TYPE_PRIVATE_PRESENTATION, android.view.WindowManager.LayoutParams.TYPE_VOICE_INTERACTION, TYPE_ACCESSIBILITY_OVERLAY, android.view.WindowManager.LayoutParams.TYPE_VOICE_INTERACTION_STARTING, android.view.WindowManager.LayoutParams.TYPE_DOCK_DIVIDER, android.view.WindowManager.LayoutParams.TYPE_QS_DIALOG, android.view.WindowManager.LayoutParams.TYPE_SCREENSHOT, android.view.WindowManager.LayoutParams.TYPE_PRESENTATION, TYPE_APPLICATION_OVERLAY, android.view.WindowManager.LayoutParams.TYPE_ACCESSIBILITY_MAGNIFICATION_OVERLAY, android.view.WindowManager.LayoutParams.TYPE_NOTIFICATION_SHADE, or android.view.WindowManager.LayoutParams.TYPE_STATUS_BAR_ADDITIONAL

verticalMargin

Added in API level 1
public float verticalMargin

The vertical margin, as a percentage of the container's height, between the container and the widget. See Gravity.apply for how this is used. This field is added with y to supply the yAdj parameter.

verticalWeight

Added in API level 1
public float verticalWeight

Indicates how much of the extra space will be allocated vertically to the view associated with these LayoutParams. Specify 0 if the view should not be stretched. Otherwise the extra pixels will be pro-rated among all views whose weight is greater than 0.

windowAnimations

Added in API level 1
public int windowAnimations

A style resource defining the animations to use for this window. This must be a system resource; it can not be an application resource because the window manager does not have access to applications.

x

Added in API level 1
public int x

X position for this window. With the default gravity it is ignored. When using Gravity#LEFT or Gravity#START or Gravity#RIGHT or Gravity#END it provides an offset from the given edge.

y

Added in API level 1
public int y

Y position for this window. With the default gravity it is ignored. When using Gravity#TOP or Gravity#BOTTOM it provides an offset from the given edge.

Public constructors

LayoutParams

Added in API level 1
public LayoutParams ()

LayoutParams

Added in API level 1
public LayoutParams (int _type)

Parameters
_type int

LayoutParams

Added in API level 1
public LayoutParams (int _type, 
                int _flags)

Parameters
_type int

_flags int

LayoutParams

Added in API level 1
public LayoutParams (int _type, 
                int _flags, 
                int _format)

Parameters
_type int

_flags int

_format int

LayoutParams

Added in API level 1
public LayoutParams (int w, 
                int h, 
                int _type, 
                int _flags, 
                int _format)

Parameters
w int

h int

_type int

_flags int

_format int

LayoutParams

Added in API level 1
public LayoutParams (int w, 
                int h, 
                int xpos, 
                int ypos, 
                int _type, 
                int _flags, 
                int _format)

Parameters
w int

h int

xpos int

ypos int

_type int

_flags int

_format int

LayoutParams

Added in API level 1
public LayoutParams (Parcel in)

Parameters
in Parcel

Public methods

areWallpaperTouchEventsEnabled

Added in API level 34
public boolean areWallpaperTouchEventsEnabled ()

Returns whether sending touch events to the system wallpaper (which can be provided by a third-party application) is enabled for windows that show wallpaper in background. Check FLAG_SHOW_WALLPAPER for more information on showing system wallpaper behind the window.

Returns
boolean whether sending touch events to the system wallpaper is enabled.

canPlayMoveAnimation

Added in API level 34
public boolean canPlayMoveAnimation ()

Related XML Attributes:

Returns
boolean whether playing an animation during a position change is allowed on this window. This does not guarantee that an animation will be played in all such situations. For example, drag-resizing may move the window but not play an animation.

copyFrom

Added in API level 1
public final int copyFrom (WindowManager.LayoutParams o)

Parameters
o WindowManager.LayoutParams

Returns
int

debug

Added in API level 1
public String debug (String output)

Parameters
output String

Returns
String

describeContents

Added in API level 1
public int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(android.os.Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or CONTENTS_FILE_DESCRIPTOR

getBlurBehindRadius

Added in API level 31
public int getBlurBehindRadius ()

Returns the blur behind radius of the window.

Returns
int

getColorMode

Added in API level 26
public int getColorMode ()

Returns the color mode of the window, one of ActivityInfo#COLOR_MODE_DEFAULT, ActivityInfo#COLOR_MODE_WIDE_COLOR_GAMUT or ActivityInfo#COLOR_MODE_HDR.

Returns
int Value is ActivityInfo.COLOR_MODE_DEFAULT, ActivityInfo.COLOR_MODE_WIDE_COLOR_GAMUT, ActivityInfo.COLOR_MODE_HDR, or android.content.pm.ActivityInfo.COLOR_MODE_A8

See also:

getDesiredHdrHeadroom

Added in API level 35
public float getDesiredHdrHeadroom ()

Get the desired amount of HDR headroom as set by setDesiredHdrHeadroom(float)

Returns
float The amount of HDR headroom set, or 0 for automatic/default behavior.

getFitInsetsSides

Added in API level 30
public int getFitInsetsSides ()

Returns
int the sides that this window is avoiding overlapping. Value is either 0 or a combination of WindowInsets.Side.LEFT, WindowInsets.Side.TOP, WindowInsets.Side.RIGHT, and WindowInsets.Side.BOTTOM

getFitInsetsTypes

Added in API level 30
public int getFitInsetsTypes ()

Returns
int the WindowInsets.Types that this window is avoiding overlapping. Value is either 0 or a combination of android.view.WindowInsets.Type.STATUS_BARS, android.view.WindowInsets.Type.NAVIGATION_BARS, android.view.WindowInsets.Type.CAPTION_BAR, android.view.WindowInsets.Type.IME, android.view.WindowInsets.Type.WINDOW_DECOR, android.view.WindowInsets.Type.SYSTEM_GESTURES, android.view.WindowInsets.Type.MANDATORY_SYSTEM_GESTURES, android.view.WindowInsets.Type.TAPPABLE_ELEMENT, android.view.WindowInsets.Type.DISPLAY_CUTOUT, and android.view.WindowInsets.Type.SYSTEM_OVERLAYS

getFrameRateBoostOnTouchEnabled

Added in API level 35
public boolean getFrameRateBoostOnTouchEnabled ()

Get the value whether we should enable touch boost as set by setFrameRateBoostOnTouchEnabled(boolean)

Returns
boolean A boolean value to indicate whether we should enable touch boost

getTitle

Added in API level 1
public final CharSequence getTitle ()

Returns
CharSequence

isFitInsetsIgnoringVisibility

Added in API level 30
public boolean isFitInsetsIgnoringVisibility ()

Returns
boolean true if this window fits the window insets no matter they are visible or not.

isFrameRatePowerSavingsBalanced

Added in API level 35
public boolean isFrameRatePowerSavingsBalanced ()

Get the value whether frameratepowersavingsbalance is enabled for this Window. This allows device to adjust refresh rate as needed and can be useful for power saving. by setFrameRatePowerSavingsBalanced(boolean)

Returns
boolean Whether we should enable frameratepowersavingsbalance.

isHdrConversionEnabled

Added in API level 34
public boolean isHdrConversionEnabled ()

Returns whether the HDR conversion is enabled for the window

Returns
boolean

mayUseInputMethod

Added in API level 3
public static boolean mayUseInputMethod (int flags)

Given a particular set of window manager flags, determine whether such a window may be a target for an input method when it has focus. In particular, this checks the FLAG_NOT_FOCUSABLE and FLAG_ALT_FOCUSABLE_IM flags and returns true if the combination of the two corresponds to a window that can use the input method.

Parameters
flags int: The current window manager flags.

Returns
boolean Returns true if a window with the given flags would be able to use the input method, false if not.

setBlurBehindRadius

Added in API level 31
public void setBlurBehindRadius (int blurBehindRadius)

Blurs the screen behind the window. The effect is similar to that of dimAmount, but instead of dimmed, the content behind the window will be blurred (or combined with the dim amount, if such is specified).

The density of the blur is set by the blur radius. The radius defines the size of the neighbouring area, from which pixels will be averaged to form the final color for each pixel. The operation approximates a Gaussian blur. A radius of 0 means no blur. The higher the radius, the denser the blur.

Note the difference with Window.setBackgroundBlurRadius(int), which blurs only within the bounds of the window. Blur behind blurs the whole screen behind the window.

Requires FLAG_BLUR_BEHIND to be set.

Cross-window blur might not be supported by some devices due to GPU limitations. It can also be disabled at runtime, e.g. during battery saving mode, when multimedia tunneling is used or when minimal post processing is requested. In such situations, no blur will be computed or drawn, resulting in there being no depth separation between the window and the content behind it. To avoid this, the app might want to use more dimAmount on its window. To listen for cross-window blur enabled/disabled events, use WindowManager.addCrossWindowBlurEnabledListener(Executor, Consumer).

Parameters
blurBehindRadius int: The blur radius to use for blur behind in pixels Value is 0 or greater

setCanPlayMoveAnimation

Added in API level 34
public void setCanPlayMoveAnimation (boolean enable)

Set whether animations can be played for position changes on this window. If disabled, the window will move to its new position instantly without animating.

Related XML Attributes:

Parameters
enable boolean

setColorMode

Added in API level 26
public void setColorMode (int colorMode)

Set the color mode of the window. Setting the color mode might override the window's pixel format.

The color mode must be one of ActivityInfo#COLOR_MODE_DEFAULT, ActivityInfo#COLOR_MODE_WIDE_COLOR_GAMUT or ActivityInfo#COLOR_MODE_HDR.

Parameters
colorMode int: Value is ActivityInfo.COLOR_MODE_DEFAULT, ActivityInfo.COLOR_MODE_WIDE_COLOR_GAMUT, ActivityInfo.COLOR_MODE_HDR, or android.content.pm.ActivityInfo.COLOR_MODE_A8

See also:

setDesiredHdrHeadroom

Added in API level 35
public void setDesiredHdrHeadroom (float desiredHeadroom)

Sets the desired about of HDR headroom to be used when rendering as a ratio of targetHdrPeakBrightnessInNits / targetSdrWhitePointInNits. Only applies when setColorMode(int) is ActivityInfo#COLOR_MODE_HDR

Parameters
desiredHeadroom float: Desired amount of HDR headroom. Must be in the range of 1.0 (SDR) to 10,000.0, or 0.0 to reset to default. Value is between 0.0f and 10000.0f inclusive

setFitInsetsIgnoringVisibility

Added in API level 30
public void setFitInsetsIgnoringVisibility (boolean ignore)

Specifies if this window should fit the window insets no matter they are visible or not.

Parameters
ignore boolean: if true, this window will fit the given types even if they are not visible.

setFitInsetsSides

Added in API level 30
public void setFitInsetsSides (int sides)

Specifies sides of insets that this window should avoid overlapping during layout.

Parameters
sides int: which sides that this window should avoid overlapping with the types specified. The initial value of this object includes all sides. Value is either 0 or a combination of WindowInsets.Side.LEFT, WindowInsets.Side.TOP, WindowInsets.Side.RIGHT, and WindowInsets.Side.BOTTOM

setFitInsetsTypes

Added in API level 30
public void setFitInsetsTypes (int types)

Specifies types of insets that this window should avoid overlapping during layout.

Parameters
types int: which WindowInsets.Types of insets that this window should avoid. The initial value of this object includes all system bars. Value is either 0 or a combination of android.view.WindowInsets.Type.STATUS_BARS, android.view.WindowInsets.Type.NAVIGATION_BARS, android.view.WindowInsets.Type.CAPTION_BAR, android.view.WindowInsets.Type.IME, android.view.WindowInsets.Type.WINDOW_DECOR, android.view.WindowInsets.Type.SYSTEM_GESTURES, android.view.WindowInsets.Type.MANDATORY_SYSTEM_GESTURES, android.view.WindowInsets.Type.TAPPABLE_ELEMENT, android.view.WindowInsets.Type.DISPLAY_CUTOUT, and android.view.WindowInsets.Type.SYSTEM_OVERLAYS

setFrameRateBoostOnTouchEnabled

Added in API level 35
public void setFrameRateBoostOnTouchEnabled (boolean enabled)

Set the value whether we should enable Touch Boost

Parameters
enabled boolean: Whether we should enable Touch Boost

setFrameRatePowerSavingsBalanced

Added in API level 35
public void setFrameRatePowerSavingsBalanced (boolean enabled)

Set the value whether frameratepowersavingsbalance is enabled for this Window. This allows device to adjust refresh rate as needed and can be useful for power saving.

Parameters
enabled boolean: Whether we should enable frameratepowersavingsbalance.

setHdrConversionEnabled

Added in API level 34
public void setHdrConversionEnabled (boolean enabled)

Enables/disables the HDR conversion for the window. By default, the HDR conversion is enabled for the window.

Parameters
enabled boolean

setTitle

Added in API level 1
public final void setTitle (CharSequence title)

Parameters
title CharSequence

setWallpaperTouchEventsEnabled

Added in API level 34
public void setWallpaperTouchEventsEnabled (boolean enable)

Set whether sending touch events to the system wallpaper (which can be provided by a third-party application) should be enabled for windows that show wallpaper in background. By default, this is set to true. Check FLAG_SHOW_WALLPAPER for more information on showing system wallpaper behind the window.

Parameters
enable boolean: whether to enable sending touch events to the system wallpaper.

toString

Added in API level 1
public String toString ()

Returns a string representation of the object.

Returns
String a string representation of the object.

writeToParcel

Added in API level 1
public void writeToParcel (Parcel out, 
                int parcelableFlags)

Flatten this object in to a Parcel.

Parameters
out Parcel: The Parcel in which the object should be written. This value cannot be null.

parcelableFlags int: Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of Parcelable.PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES