Android APIs
public abstract class

Window

extends Object
java.lang.Object
   ↳ android.view.Window

Class Overview

Abstract base class for a top-level window look and behavior policy. An instance of this class should be used as the top-level view added to the window manager. It provides standard UI policies such as a background, title area, default key processing, etc.

The only existing implementation of this abstract class is android.policy.PhoneWindow, which you should instantiate when needing a Window. Eventually that class will be refactored and a factory method added for creating Window instances without knowing about a particular implementation.

Summary

Nested Classes
interface Window.Callback API from a Window back to its caller. 
XML Attributes
Attribute Name Related Method Description
android:windowAllowEnterTransitionOverlap setAllowEnterTransitionOverlap(boolean) Flag indicating whether this Window's transition should overlap with the exiting transition of the calling Activity. 
android:windowAllowReturnTransitionOverlap setAllowReturnTransitionOverlap(boolean) Flag indicating whether this Window's transition should overlap with the exiting transition of the called Activity when the called Activity finishes. 
android:windowContentTransitionManager setTransitionManager(TransitionManager) Reference to a TransitionManager XML resource defining the desired transitions between different window content. 
android:windowEnterTransition setEnterTransition(Transition) Reference to a Transition XML resource defining the desired Transition used to move Views into the initial Window's content Scene. 
android:windowExitTransition setExitTransition(Transition) Reference to a Transition XML resource defining the desired Transition used to move Views out of the Window's content Scene when launching a new Activity. 
android:windowReenterTransition setReenterTransition(Transition) Reference to a Transition XML resource defining the desired Transition used to move Views in to the scene when returning from a previously-started Activity. 
android:windowReturnTransition setReturnTransition(Transition) Reference to a Transition XML resource defining the desired Transition used to move Views out of the scene when the Window is preparing to close. 
android:windowSharedElementEnterTransition setSharedElementEnterTransition(Transition) Reference to a Transition XML resource defining the desired Transition used to move shared elements transferred into the Window's initial content Scene. 
android:windowSharedElementExitTransition setSharedElementExitTransition(Transition) Reference to a Transition XML resource defining the desired Transition used when starting a new Activity to move shared elements prior to transferring to the called Activity. 
android:windowSharedElementReenterTransition setSharedElementReenterTransition(Transition) Reference to a Transition XML resource defining the desired Transition used for shared elements transferred back to a calling Activity. 
android:windowSharedElementReturnTransition setSharedElementReturnTransition(Transition) Reference to a Transition XML resource defining the desired Transition used to move shared elements transferred back to a calling Activity. 
android:windowSharedElementsUseOverlay setSharedElementsUseOverlay(boolean) Indicates whether or not shared elements should use an overlay during transitions. 
android:windowTransitionBackgroundFadeDuration setTransitionBackgroundFadeDuration(long) The duration, in milliseconds, of the window background fade duration when transitioning into or away from an Activity when called with an Activity Transition. 
Constants
int DEFAULT_FEATURES This constant is deprecated. use getDefaultFeatures(android.content.Context) instead.
int FEATURE_ACTION_BAR Flag for enabling the Action Bar.
int FEATURE_ACTION_BAR_OVERLAY Flag for requesting an Action Bar that overlays window content.
int FEATURE_ACTION_MODE_OVERLAY Flag for specifying the behavior of action modes when an Action Bar is not present.
int FEATURE_ACTIVITY_TRANSITIONS Enables Activities to run Activity Transitions either through sending or receiving ActivityOptions bundle created with makeSceneTransitionAnimation(android.app.Activity, android.util.Pair[]) or makeSceneTransitionAnimation(android.app.Activity, View, String).
int FEATURE_CONTENT_TRANSITIONS Flag for requesting that window content changes should be animated using a TransitionManager.
int FEATURE_CONTEXT_MENU Flag for the context menu.
int FEATURE_CUSTOM_TITLE Flag for custom title.
int FEATURE_INDETERMINATE_PROGRESS Flag for indeterminate progress
int FEATURE_LEFT_ICON Flag for having an icon on the left side of the title bar
int FEATURE_NO_TITLE Flag for the "no title" feature, turning off the title at the top of the screen.
int FEATURE_OPTIONS_PANEL Flag for the "options panel" feature.
int FEATURE_PROGRESS Flag for the progress indicator feature
int FEATURE_RIGHT_ICON Flag for having an icon on the right side of the title bar
int FEATURE_SWIPE_TO_DISMISS Flag for requesting a decoration-free window that is dismissed by swiping from the left.
int ID_ANDROID_CONTENT The ID that the main layout in the XML layout file should have.
String NAVIGATION_BAR_BACKGROUND_TRANSITION_NAME The transitionName for the navigation bar background View when a custom background is used.
int PROGRESS_END Ending value for the (primary) progress
int PROGRESS_INDETERMINATE_OFF Flag for setting the progress bar's indeterminate mode off
int PROGRESS_INDETERMINATE_ON Flag for setting the progress bar's indeterminate mode on
int PROGRESS_SECONDARY_END Highest possible value for the secondary progress
int PROGRESS_SECONDARY_START Lowest possible value for the secondary progress
int PROGRESS_START Starting value for the (primary) progress
int PROGRESS_VISIBILITY_OFF Flag for setting the progress bar's visibility to GONE
int PROGRESS_VISIBILITY_ON Flag for setting the progress bar's visibility to VISIBLE
String STATUS_BAR_BACKGROUND_TRANSITION_NAME The transitionName for the status bar background View when a custom background is used.
Public Constructors
Window(Context context)
Public Methods
abstract void addContentView(View view, ViewGroup.LayoutParams params)
Variation on setContentView(View, android.view.ViewGroup.LayoutParams) to add an additional content view to the screen.
void addFlags(int flags)
Convenience function to set the flag bits as specified in flags, as per setFlags(int, int).
void clearFlags(int flags)
Convenience function to clear the flag bits as specified in flags, as per setFlags(int, int).
abstract void closeAllPanels()
abstract void closePanel(int featureId)
View findViewById(int id)
Finds a view that was identified by the id attribute from the XML that was processed in onCreate(Bundle).
boolean getAllowEnterTransitionOverlap()
Returns how the transition set in setEnterTransition(android.transition.Transition) overlaps with the exit transition of the calling Activity.
boolean getAllowReturnTransitionOverlap()
Returns how the transition set in setExitTransition(android.transition.Transition) overlaps with the exit transition of the called Activity when reentering after if finishes.
final WindowManager.LayoutParams getAttributes()
Retrieve the current window attributes associated with this panel.
final Window.Callback getCallback()
Return the current Callback interface for this window.
final Window getContainer()
Return the container for this Window.
Scene getContentScene()
Retrieve the Scene representing this window's current content.
final Context getContext()
Return the Context this window policy is running in, for retrieving resources and other information.
abstract View getCurrentFocus()
Return the view in this Window that currently has focus, or null if there are none.
abstract View getDecorView()
Retrieve the top-level window decor view (containing the standard window frame/decorations and the client's content inside of that), which can be added as a window to the window manager.
static int getDefaultFeatures(Context context)
Return the feature bits set by default on a window.
Transition getEnterTransition()
Returns the transition used to move Views into the initial scene.
Transition getExitTransition()
Returns the Transition that will be used to move Views out of the scene when starting a new Activity.
abstract LayoutInflater getLayoutInflater()
Quick access to the LayoutInflater instance that this Window retrieved from its Context.
MediaController getMediaController()
Gets the MediaController that was previously set.
abstract int getNavigationBarColor()
Transition getReenterTransition()
Returns the Transition that will be used to move Views in to the scene when returning from a previously-started Activity.
Transition getReturnTransition()
Returns he Transition that will be used to move Views out of the scene when the Window is preparing to close, for example after a call to finishAfterTransition().
Transition getSharedElementEnterTransition()
Returns the Transition that will be used for shared elements transferred into the content Scene.
Transition getSharedElementExitTransition()
Returns the Transition to use for shared elements in the launching Window prior to transferring to the launched Activity's Window.
Transition getSharedElementReenterTransition()
Returns the Transition that will be used for shared elements reentering from a started Activity after it has returned the shared element to it start location.
Transition getSharedElementReturnTransition()
Returns the Transition that will be used for shared elements transferred back to a calling Activity.
boolean getSharedElementsUseOverlay()
Returns true when shared elements should use an Overlay during shared element transitions or false when they should animate as part of the normal View hierarchy.
abstract int getStatusBarColor()
long getTransitionBackgroundFadeDuration()
Returns the duration, in milliseconds, of the window background fade when transitioning into or away from an Activity when called with an Activity Transition.
TransitionManager getTransitionManager()
Retrieve the TransitionManager responsible for for default transitions in this window.
abstract int getVolumeControlStream()
WindowManager getWindowManager()
Return the window manager allowing this Window to display its own windows.
final TypedArray getWindowStyle()
Return the Window attributes from this window's theme.
final boolean hasChildren()
boolean hasFeature(int feature)
Query for the availability of a certain feature.
void injectInputEvent(InputEvent event)
Inject an event to window locally.
abstract void invalidatePanelMenu(int featureId)
final boolean isActive()
abstract boolean isFloating()
Return whether this window is being displayed with a floating style (based on the windowIsFloating attribute in the style/theme).
abstract boolean isShortcutKey(int keyCode, KeyEvent event)
Is a keypress one of the defined shortcut keys for this window.
final void makeActive()
abstract void onConfigurationChanged(Configuration newConfig)
Should be called when the configuration is changed.
abstract void openPanel(int featureId, KeyEvent event)
abstract View peekDecorView()
Retrieve the current decor view, but only if it has already been created; otherwise returns null.
abstract boolean performContextMenuIdentifierAction(int id, int flags)
abstract boolean performPanelIdentifierAction(int featureId, int id, int flags)
abstract boolean performPanelShortcut(int featureId, int keyCode, KeyEvent event, int flags)
boolean requestFeature(int featureId)
Enable extended screen features.
abstract void restoreHierarchyState(Bundle savedInstanceState)
abstract Bundle saveHierarchyState()
void setAllowEnterTransitionOverlap(boolean allow)
Controls how the transition set in setEnterTransition(android.transition.Transition) overlaps with the exit transition of the calling Activity.
void setAllowReturnTransitionOverlap(boolean allow)
Controls how the transition set in setExitTransition(android.transition.Transition) overlaps with the exit transition of the called Activity when reentering after if finishes.
void setAttributes(WindowManager.LayoutParams a)
Specify custom window attributes.
abstract void setBackgroundDrawable(Drawable drawable)
Change the background of this window to a custom Drawable.
void setBackgroundDrawableResource(int resId)
Change the background of this window to a Drawable resource.
void setCallback(Window.Callback callback)
Set the Callback interface for this window, used to intercept key events and other dynamic operations in the window.
abstract void setChildDrawable(int featureId, Drawable drawable)
abstract void setChildInt(int featureId, int value)
void setClipToOutline(boolean clipToOutline)
Sets whether window content should be clipped to the outline of the window background.
void setContainer(Window container)
Set the container for this window.
abstract void setContentView(int layoutResID)
Convenience for setContentView(View, android.view.ViewGroup.LayoutParams) to set the screen content from a layout resource.
abstract void setContentView(View view)
Convenience for setContentView(View, android.view.ViewGroup.LayoutParams) set the screen content to an explicit view.
abstract void setContentView(View view, ViewGroup.LayoutParams params)
Set the screen content to an explicit view.
void setDimAmount(float amount)
Set the amount of dim behind the window when using FLAG_DIM_BEHIND.
void setElevation(float elevation)
Sets the window elevation.
void setEnterTransition(Transition transition)
Sets the Transition that will be used to move Views into the initial scene.
void setExitTransition(Transition transition)
Sets the Transition that will be used to move Views out of the scene when starting a new Activity.
abstract void setFeatureDrawable(int featureId, Drawable drawable)
Set an explicit Drawable value for feature of this window.
abstract void setFeatureDrawableAlpha(int featureId, int alpha)
Set a custom alpha value for the given drawable feature, controlling how much the background is visible through it.
abstract void setFeatureDrawableResource(int featureId, int resId)
Set the value for a drawable feature of this window, from a resource identifier.
abstract void setFeatureDrawableUri(int featureId, Uri uri)
Set the value for a drawable feature of this window, from a URI.
abstract void setFeatureInt(int featureId, int value)
Set the integer value for a feature.
void setFlags(int flags, int mask)
Set the flags of the window, as per the WindowManager.LayoutParams flags.
void setFormat(int format)
Set the format of window, as per the PixelFormat types.
void setGravity(int gravity)
Set the gravity of the window, as per the Gravity constants.
void setIcon(int resId)
Set the primary icon for this window.
void setLayout(int width, int height)
Set the width and height layout parameters of the window.
void setLocalFocus(boolean hasFocus, boolean inTouchMode)
Set focus locally.
void setLogo(int resId)
Set the logo for this window.
void setMediaController(MediaController controller)
Sets a MediaController to send media keys and volume changes to.
abstract void setNavigationBarColor(int color)
Sets the color of the navigation bar to .
void setReenterTransition(Transition transition)
Sets the Transition that will be used to move Views in to the scene when returning from a previously-started Activity.
void setReturnTransition(Transition transition)
Sets the Transition that will be used to move Views out of the scene when the Window is preparing to close, for example after a call to finishAfterTransition().
void setSharedElementEnterTransition(Transition transition)
Sets the Transition that will be used for shared elements transferred into the content Scene.
void setSharedElementExitTransition(Transition transition)
Sets the Transition that will be used for shared elements after starting a new Activity before the shared elements are transferred to the called Activity.
void setSharedElementReenterTransition(Transition transition)
Sets the Transition that will be used for shared elements reentering from a started Activity after it has returned the shared element to it start location.
void setSharedElementReturnTransition(Transition transition)
Sets the Transition that will be used for shared elements transferred back to a calling Activity.
void setSharedElementsUseOverlay(boolean sharedElementsUseOverlay)
Sets whether or not shared elements should use an Overlay during shared element transitions.
void setSoftInputMode(int mode)
Specify an explicit soft input mode to use for the window, as per WindowManager.LayoutParams.softInputMode.
abstract void setStatusBarColor(int color)
Sets the color of the status bar to .
abstract void setTitle(CharSequence title)
abstract void setTitleColor(int textColor)
void setTransitionBackgroundFadeDuration(long fadeDurationMillis)
Sets the duration, in milliseconds, of the window background fade when transitioning into or away from an Activity when called with an Activity Transition.
void setTransitionManager(TransitionManager tm)
Set the TransitionManager to use for default transitions in this window.
void setType(int type)
Set the type of the window, as per the WindowManager.LayoutParams types.
void setUiOptions(int uiOptions)
Set extra options that will influence the UI for this window.
void setUiOptions(int uiOptions, int mask)
Set extra options that will influence the UI for this window.
abstract void setVolumeControlStream(int streamType)
void setWindowAnimations(int resId)
Specify custom animations to use for the window, as per WindowManager.LayoutParams.windowAnimations.
void setWindowManager(WindowManager wm, IBinder appToken, String appName)
Set the window manager for use by this Window to, for example, display panels.
void setWindowManager(WindowManager wm, IBinder appToken, String appName, boolean hardwareAccelerated)
Set the window manager for use by this Window to, for example, display panels.
abstract boolean superDispatchGenericMotionEvent(MotionEvent event)
Used by custom windows, such as Dialog, to pass the generic motion event further down the view hierarchy.
abstract boolean superDispatchKeyEvent(KeyEvent event)
Used by custom windows, such as Dialog, to pass the key press event further down the view hierarchy.
abstract boolean superDispatchKeyShortcutEvent(KeyEvent event)
Used by custom windows, such as Dialog, to pass the key shortcut press event further down the view hierarchy.
abstract boolean superDispatchTouchEvent(MotionEvent event)
Used by custom windows, such as Dialog, to pass the touch screen event further down the view hierarchy.
abstract boolean superDispatchTrackballEvent(MotionEvent event)
Used by custom windows, such as Dialog, to pass the trackball event further down the view hierarchy.
abstract void takeInputQueue(InputQueue.Callback callback)
Take ownership of this window's InputQueue.
abstract void takeKeyEvents(boolean get)
Request that key events come to this activity.
abstract void takeSurface(SurfaceHolder.Callback2 callback)
Take ownership of this window's surface.
abstract void togglePanel(int featureId, KeyEvent event)
Protected Methods
final int getFeatures()
Return the feature bits that are enabled.
final int getForcedWindowFlags()
Return the window flags that have been explicitly set by the client, so will not be modified by getDecorView().
final int getLocalFeatures()
Return the feature bits that are being implemented by this Window.
final boolean hasSoftInputMode()
Has the app specified their own soft input mode?
abstract void onActive()
void setDefaultWindowFormat(int format)
Set the default format of window, as per the PixelFormat types.
[Expand]
Inherited Methods
From class java.lang.Object

XML Attributes

android:windowAllowEnterTransitionOverlap

Flag indicating whether this Window's transition should overlap with the exiting transition of the calling Activity. Corresponds to setAllowEnterTransitionOverlap(boolean).

Must be a boolean value, either "true" or "false".

This may also be a reference to a resource (in the form "@[package:]type:name") or theme attribute (in the form "?[package:][type:]name") containing a value of this type.

This corresponds to the global attribute resource symbol windowAllowEnterTransitionOverlap.

android:windowAllowReturnTransitionOverlap

Flag indicating whether this Window's transition should overlap with the exiting transition of the called Activity when the called Activity finishes. Corresponds to setAllowReturnTransitionOverlap(boolean).

Must be a boolean value, either "true" or "false".

This may also be a reference to a resource (in the form "@[package:]type:name") or theme attribute (in the form "?[package:][type:]name") containing a value of this type.

This corresponds to the global attribute resource symbol windowAllowReturnTransitionOverlap.

android:windowContentTransitionManager

Reference to a TransitionManager XML resource defining the desired transitions between different window content.

Must be a reference to another resource, in the form "@[+][package:]type:name" or to a theme attribute in the form "?[package:][type:]name".

This corresponds to the global attribute resource symbol windowContentTransitionManager.

android:windowEnterTransition

Reference to a Transition XML resource defining the desired Transition used to move Views into the initial Window's content Scene. Corresponds to setEnterTransition(android.transition.Transition).

Must be a reference to another resource, in the form "@[+][package:]type:name" or to a theme attribute in the form "?[package:][type:]name".

This corresponds to the global attribute resource symbol windowEnterTransition.

android:windowExitTransition

Reference to a Transition XML resource defining the desired Transition used to move Views out of the Window's content Scene when launching a new Activity. Corresponds to setExitTransition(android.transition.Transition).

Must be a reference to another resource, in the form "@[+][package:]type:name" or to a theme attribute in the form "?[package:][type:]name".

This corresponds to the global attribute resource symbol windowExitTransition.

android:windowReenterTransition

Reference to a Transition XML resource defining the desired Transition used to move Views in to the scene when returning from a previously-started Activity. Corresponds to setReenterTransition(android.transition.Transition).

Must be a reference to another resource, in the form "@[+][package:]type:name" or to a theme attribute in the form "?[package:][type:]name".

This corresponds to the global attribute resource symbol windowReenterTransition.

android:windowReturnTransition

Reference to a Transition XML resource defining the desired Transition used to move Views out of the scene when the Window is preparing to close. Corresponds to setReturnTransition(android.transition.Transition).

Must be a reference to another resource, in the form "@[+][package:]type:name" or to a theme attribute in the form "?[package:][type:]name".

This corresponds to the global attribute resource symbol windowReturnTransition.

android:windowSharedElementEnterTransition

Reference to a Transition XML resource defining the desired Transition used to move shared elements transferred into the Window's initial content Scene. Corresponds to setSharedElementEnterTransition(android.transition.Transition).

Must be a reference to another resource, in the form "@[+][package:]type:name" or to a theme attribute in the form "?[package:][type:]name".

This corresponds to the global attribute resource symbol windowSharedElementEnterTransition.

android:windowSharedElementExitTransition

Reference to a Transition XML resource defining the desired Transition used when starting a new Activity to move shared elements prior to transferring to the called Activity. Corresponds to setSharedElementExitTransition(android.transition.Transition).

Must be a reference to another resource, in the form "@[+][package:]type:name" or to a theme attribute in the form "?[package:][type:]name".

This corresponds to the global attribute resource symbol windowSharedElementExitTransition.

android:windowSharedElementReenterTransition

Reference to a Transition XML resource defining the desired Transition used for shared elements transferred back to a calling Activity. Corresponds to setSharedElementReenterTransition(android.transition.Transition).

Must be a reference to another resource, in the form "@[+][package:]type:name" or to a theme attribute in the form "?[package:][type:]name".

This corresponds to the global attribute resource symbol windowSharedElementReenterTransition.

android:windowSharedElementReturnTransition

Reference to a Transition XML resource defining the desired Transition used to move shared elements transferred back to a calling Activity. Corresponds to setSharedElementReturnTransition(android.transition.Transition).

Must be a reference to another resource, in the form "@[+][package:]type:name" or to a theme attribute in the form "?[package:][type:]name".

This corresponds to the global attribute resource symbol windowSharedElementReturnTransition.

android:windowSharedElementsUseOverlay

Indicates whether or not shared elements should use an overlay during transitions. The default value is true.

Must be a boolean value, either "true" or "false".

This may also be a reference to a resource (in the form "@[package:]type:name") or theme attribute (in the form "?[package:][type:]name") containing a value of this type.

This corresponds to the global attribute resource symbol windowSharedElementsUseOverlay.

android:windowTransitionBackgroundFadeDuration

The duration, in milliseconds, of the window background fade duration when transitioning into or away from an Activity when called with an Activity Transition. Corresponds to setTransitionBackgroundFadeDuration(long).

Must be an integer value, such as "100".

This may also be a reference to a resource (in the form "@[package:]type:name") or theme attribute (in the form "?[package:][type:]name") containing a value of this type.

This corresponds to the global attribute resource symbol windowTransitionBackgroundFadeDuration.

Constants

protected static final int DEFAULT_FEATURES

Added in API level 1

This constant is deprecated.
use getDefaultFeatures(android.content.Context) instead.

The default features enabled.

Constant Value: 65 (0x00000041)

public static final int FEATURE_ACTION_BAR

Added in API level 11

Flag for enabling the Action Bar. This is enabled by default for some devices. The Action Bar replaces the title bar and provides an alternate location for an on-screen menu button on some devices.

Constant Value: 8 (0x00000008)

public static final int FEATURE_ACTION_BAR_OVERLAY

Added in API level 11

Flag for requesting an Action Bar that overlays window content. Normally an Action Bar will sit in the space above window content, but if this feature is requested along with FEATURE_ACTION_BAR it will be layered over the window content itself. This is useful if you would like your app to have more control over how the Action Bar is displayed, such as letting application content scroll beneath an Action Bar with a transparent background or otherwise displaying a transparent/translucent Action Bar over application content.

This mode is especially useful with View.SYSTEM_UI_FLAG_FULLSCREEN, which allows you to seamlessly hide the action bar in conjunction with other screen decorations.

As of JELLY_BEAN, when an ActionBar is in this mode it will adjust the insets provided to View.fitSystemWindows(Rect) to include the content covered by the action bar, so you can do layout within that space.

Constant Value: 9 (0x00000009)

public static final int FEATURE_ACTION_MODE_OVERLAY

Added in API level 11

Flag for specifying the behavior of action modes when an Action Bar is not present. If overlay is enabled, the action mode UI will be allowed to cover existing window content.

Constant Value: 10 (0x0000000a)

public static final int FEATURE_ACTIVITY_TRANSITIONS

Added in API level 21

Enables Activities to run Activity Transitions either through sending or receiving ActivityOptions bundle created with makeSceneTransitionAnimation(android.app.Activity, android.util.Pair[]) or makeSceneTransitionAnimation(android.app.Activity, View, String).

Constant Value: 13 (0x0000000d)

public static final int FEATURE_CONTENT_TRANSITIONS

Added in API level 21

Flag for requesting that window content changes should be animated using a TransitionManager.

The TransitionManager is set using setTransitionManager(android.transition.TransitionManager). If none is set, a default TransitionManager will be used.

Constant Value: 12 (0x0000000c)

public static final int FEATURE_CONTEXT_MENU

Added in API level 1

Flag for the context menu. This is enabled by default.

Constant Value: 6 (0x00000006)

public static final int FEATURE_CUSTOM_TITLE

Added in API level 1

Flag for custom title. You cannot combine this feature with other title features.

Constant Value: 7 (0x00000007)

public static final int FEATURE_INDETERMINATE_PROGRESS

Added in API level 1

Flag for indeterminate progress

Constant Value: 5 (0x00000005)

public static final int FEATURE_LEFT_ICON

Added in API level 1

Flag for having an icon on the left side of the title bar

Constant Value: 3 (0x00000003)

public static final int FEATURE_NO_TITLE

Added in API level 1

Flag for the "no title" feature, turning off the title at the top of the screen.

Constant Value: 1 (0x00000001)

public static final int FEATURE_OPTIONS_PANEL

Added in API level 1

Flag for the "options panel" feature. This is enabled by default.

Constant Value: 0 (0x00000000)

public static final int FEATURE_PROGRESS

Added in API level 1

Flag for the progress indicator feature

Constant Value: 2 (0x00000002)

public static final int FEATURE_RIGHT_ICON

Added in API level 1

Flag for having an icon on the right side of the title bar

Constant Value: 4 (0x00000004)

public static final int FEATURE_SWIPE_TO_DISMISS

Added in API level 20

Flag for requesting a decoration-free window that is dismissed by swiping from the left.

Constant Value: 11 (0x0000000b)

public static final int ID_ANDROID_CONTENT

Added in API level 1

The ID that the main layout in the XML layout file should have.

Constant Value: 16908290 (0x01020002)

public static final String NAVIGATION_BAR_BACKGROUND_TRANSITION_NAME

Added in API level 21

The transitionName for the navigation bar background View when a custom background is used.

Constant Value: "android:navigation:background"

public static final int PROGRESS_END

Added in API level 1

Ending value for the (primary) progress

Constant Value: 10000 (0x00002710)

public static final int PROGRESS_INDETERMINATE_OFF

Added in API level 1

Flag for setting the progress bar's indeterminate mode off

Constant Value: -4 (0xfffffffc)

public static final int PROGRESS_INDETERMINATE_ON

Added in API level 1

Flag for setting the progress bar's indeterminate mode on

Constant Value: -3 (0xfffffffd)

public static final int PROGRESS_SECONDARY_END

Added in API level 1

Highest possible value for the secondary progress

Constant Value: 30000 (0x00007530)

public static final int PROGRESS_SECONDARY_START

Added in API level 1

Lowest possible value for the secondary progress

Constant Value: 20000 (0x00004e20)

public static final int PROGRESS_START

Added in API level 1

Starting value for the (primary) progress

Constant Value: 0 (0x00000000)

public static final int PROGRESS_VISIBILITY_OFF

Added in API level 1

Flag for setting the progress bar's visibility to GONE

Constant Value: -2 (0xfffffffe)

public static final int PROGRESS_VISIBILITY_ON

Added in API level 1

Flag for setting the progress bar's visibility to VISIBLE

Constant Value: -1 (0xffffffff)

public static final String STATUS_BAR_BACKGROUND_TRANSITION_NAME

Added in API level 21

The transitionName for the status bar background View when a custom background is used.

Constant Value: "android:status:background"

Public Constructors

public Window (Context context)

Added in API level 1

Public Methods

public abstract void addContentView (View view, ViewGroup.LayoutParams params)

Added in API level 1

Variation on setContentView(View, android.view.ViewGroup.LayoutParams) to add an additional content view to the screen. Added after any existing ones in the screen -- existing views are NOT removed.

Parameters
view The desired content to display.
params Layout parameters for the view.

public void addFlags (int flags)

Added in API level 1

Convenience function to set the flag bits as specified in flags, as per setFlags(int, int).

Parameters
flags The flag bits to be set.

public void clearFlags (int flags)

Added in API level 1

Convenience function to clear the flag bits as specified in flags, as per setFlags(int, int).

Parameters
flags The flag bits to be cleared.

public abstract void closeAllPanels ()

Added in API level 1

public abstract void closePanel (int featureId)

Added in API level 1

public View findViewById (int id)

Added in API level 1

Finds a view that was identified by the id attribute from the XML that was processed in onCreate(Bundle). This will implicitly call getDecorView() for you, with all of the associated side-effects.

Returns
  • The view if found or null otherwise.

public boolean getAllowEnterTransitionOverlap ()

Added in API level 21

Returns how the transition set in setEnterTransition(android.transition.Transition) overlaps with the exit transition of the calling Activity. When true, the transition will start as soon as possible. When false, the transition will wait until the remote exiting transition completes before starting.

Returns
  • true when the enter transition should start as soon as possible or false to when it should wait until the exiting transition completes.

public boolean getAllowReturnTransitionOverlap ()

Added in API level 21

Returns how the transition set in setExitTransition(android.transition.Transition) overlaps with the exit transition of the called Activity when reentering after if finishes. When true, the transition will start as soon as possible. When false, the transition will wait until the called Activity's exiting transition completes before starting.

Returns
  • true when the transition should start when possible or false when it should wait until the called Activity's exiting transition completes.

public final WindowManager.LayoutParams getAttributes ()

Added in API level 1

Retrieve the current window attributes associated with this panel.

Returns
  • WindowManager.LayoutParams Either the existing window attributes object, or a freshly created one if there is none.

public final Window.Callback getCallback ()

Added in API level 1

Return the current Callback interface for this window.

public final Window getContainer ()

Added in API level 1

Return the container for this Window.

Returns
  • Window The containing window, or null if this is a top-level window.

public Scene getContentScene ()

Added in API level 21

Retrieve the Scene representing this window's current content. Requires FEATURE_CONTENT_TRANSITIONS.

This method will return null if the current content is not represented by a Scene.

Returns
  • Current Scene being shown or null

public final Context getContext ()

Added in API level 1

Return the Context this window policy is running in, for retrieving resources and other information.

Returns
  • Context The Context that was supplied to the constructor.

public abstract View getCurrentFocus ()

Added in API level 1

Return the view in this Window that currently has focus, or null if there are none. Note that this does not look in any containing Window.

Returns
  • View The current View with focus or null.

public abstract View getDecorView ()

Added in API level 1

Retrieve the top-level window decor view (containing the standard window frame/decorations and the client's content inside of that), which can be added as a window to the window manager.

Note that calling this function for the first time "locks in" various window characteristics as described in setContentView(View, android.view.ViewGroup.LayoutParams).

Returns
  • Returns the top-level window decor view.

public static int getDefaultFeatures (Context context)

Return the feature bits set by default on a window.

Parameters
context The context used to access resources

public Transition getEnterTransition ()

Added in API level 21

Returns the transition used to move Views into the initial scene. The entering Views will be those that are regular Views or ViewGroups that have isTransitionGroup() return true. Typical Transitions will extend Visibility as entering is governed by changing visibility from INVISIBLE to VISIBLE. If transition is null, entering Views will remain unaffected. Requires FEATURE_ACTIVITY_TRANSITIONS.

Related XML Attributes
Returns
  • the Transition to use to move Views into the initial Scene.

public Transition getExitTransition ()

Added in API level 21

Returns the Transition that will be used to move Views out of the scene when starting a new Activity. The exiting Views will be those that are regular Views or ViewGroups that have isTransitionGroup() return true. Typical Transitions will extend Visibility as exiting is governed by changing visibility from VISIBLE to INVISIBLE. If transition is null, the views will remain unaffected. Requires FEATURE_ACTIVITY_TRANSITIONS.

Related XML Attributes
Returns
  • the Transition to use to move Views out of the scene when calling a new Activity.

public abstract LayoutInflater getLayoutInflater ()

Added in API level 1

Quick access to the LayoutInflater instance that this Window retrieved from its Context.

Returns
  • LayoutInflater The shared LayoutInflater.

public MediaController getMediaController ()

Added in API level 21

Gets the MediaController that was previously set.

Returns
  • The controller which should receive events.

public abstract int getNavigationBarColor ()

Added in API level 21

Returns
  • the color of the navigation bar.

public Transition getReenterTransition ()

Added in API level 21

Returns the Transition that will be used to move Views in to the scene when returning from a previously-started Activity. The entering Views will be those that are regular Views or ViewGroups that have isTransitionGroup() return true. Typical Transitions will extend Visibility as exiting is governed by changing visibility from VISIBLE to INVISIBLE. Requires FEATURE_ACTIVITY_TRANSITIONS.

Related XML Attributes
Returns
  • The Transition to use to move Views into the scene when reentering from a previously-started Activity.

public Transition getReturnTransition ()

Added in API level 21

Returns he Transition that will be used to move Views out of the scene when the Window is preparing to close, for example after a call to finishAfterTransition(). The exiting Views will be those that are regular Views or ViewGroups that have isTransitionGroup() return true. Typical Transitions will extend Visibility as entering is governed by changing visibility from VISIBLE to INVISIBLE.

Related XML Attributes
Returns
  • The Transition to use to move Views out of the Scene when the Window is preparing to close.

public Transition getSharedElementEnterTransition ()

Added in API level 21

Returns the Transition that will be used for shared elements transferred into the content Scene. Requires FEATURE_ACTIVITY_TRANSITIONS.

Returns
  • Transition to use for sharend elements transferred into the content Scene.

public Transition getSharedElementExitTransition ()

Added in API level 21

Returns the Transition to use for shared elements in the launching Window prior to transferring to the launched Activity's Window. Requires FEATURE_ACTIVITY_TRANSITIONS.

Returns
  • the Transition to use for shared elements in the launching Window prior to transferring to the launched Activity's Window.

public Transition getSharedElementReenterTransition ()

Added in API level 21

Returns the Transition that will be used for shared elements reentering from a started Activity after it has returned the shared element to it start location. Requires FEATURE_ACTIVITY_TRANSITIONS.

Returns
  • the Transition that will be used for shared elements reentering from a started Activity after it has returned the shared element to it start location.

public Transition getSharedElementReturnTransition ()

Added in API level 21

Returns the Transition that will be used for shared elements transferred back to a calling Activity. Requires FEATURE_ACTIVITY_TRANSITIONS.

Returns
  • Transition to use for sharend elements transferred into the content Scene.

public boolean getSharedElementsUseOverlay ()

Added in API level 21

Returns true when shared elements should use an Overlay during shared element transitions or false when they should animate as part of the normal View hierarchy. The default value is true.

Returns
  • true when shared elements should use an Overlay during shared element transitions or false when they should animate as part of the normal View hierarchy.

public abstract int getStatusBarColor ()

Added in API level 21

Returns
  • the color of the status bar.

public long getTransitionBackgroundFadeDuration ()

Added in API level 21

Returns the duration, in milliseconds, of the window background fade when transitioning into or away from an Activity when called with an Activity Transition.

When executing the enter transition, the background starts transparent and fades in. This requires FEATURE_ACTIVITY_TRANSITIONS. The default is 300 milliseconds.

Returns
  • The duration of the window background fade to opaque during enter transition.

public TransitionManager getTransitionManager ()

Added in API level 21

Retrieve the TransitionManager responsible for for default transitions in this window. Requires FEATURE_CONTENT_TRANSITIONS.

This method will return non-null after content has been initialized (e.g. by using setContentView(View)) if FEATURE_CONTENT_TRANSITIONS has been granted.

Returns
  • This window's content TransitionManager or null if none is set.

public abstract int getVolumeControlStream ()

Added in API level 1

public WindowManager getWindowManager ()

Added in API level 1

Return the window manager allowing this Window to display its own windows.

Returns
  • WindowManager The ViewManager.

public final TypedArray getWindowStyle ()

Added in API level 1

Return the Window attributes from this window's theme.

public final boolean hasChildren ()

Added in API level 1

public boolean hasFeature (int feature)

Added in API level 11

Query for the availability of a certain feature.

Parameters
feature The feature ID to check
Returns
  • true if the feature is enabled, false otherwise.

public void injectInputEvent (InputEvent event)

Added in API level 19

Inject an event to window locally.

Parameters
event A key or touch event to inject to this window.

public abstract void invalidatePanelMenu (int featureId)

Added in API level 11

public final boolean isActive ()

Added in API level 1

public abstract boolean isFloating ()

Added in API level 1

Return whether this window is being displayed with a floating style (based on the windowIsFloating attribute in the style/theme).

Returns
  • Returns true if the window is configured to be displayed floating on top of whatever is behind it.

public abstract boolean isShortcutKey (int keyCode, KeyEvent event)

Added in API level 1

Is a keypress one of the defined shortcut keys for this window.

Parameters
keyCode the key code from KeyEvent to check.
event the KeyEvent to use to help check.

public final void makeActive ()

Added in API level 1

public abstract void onConfigurationChanged (Configuration newConfig)

Added in API level 1

Should be called when the configuration is changed.

Parameters
newConfig The new configuration.

public abstract void openPanel (int featureId, KeyEvent event)

Added in API level 1

public abstract View peekDecorView ()

Added in API level 1

Retrieve the current decor view, but only if it has already been created; otherwise returns null.

Returns
  • Returns the top-level window decor or null.
See Also

public abstract boolean performContextMenuIdentifierAction (int id, int flags)

Added in API level 1

public abstract boolean performPanelIdentifierAction (int featureId, int id, int flags)

Added in API level 1

public abstract boolean performPanelShortcut (int featureId, int keyCode, KeyEvent event, int flags)

Added in API level 1

public boolean requestFeature (int featureId)

Added in API level 1

Enable extended screen features. This must be called before setContentView(). May be called as many times as desired as long as it is before setContentView(). If not called, no extended features will be available. You can not turn off a feature once it is requested. You canot use other title features with FEATURE_CUSTOM_TITLE.

Parameters
featureId The desired features, defined as constants by Window.
Returns
  • The features that are now set.

public abstract void restoreHierarchyState (Bundle savedInstanceState)

Added in API level 1

public abstract Bundle saveHierarchyState ()

Added in API level 1

public void setAllowEnterTransitionOverlap (boolean allow)

Added in API level 21

Controls how the transition set in setEnterTransition(android.transition.Transition) overlaps with the exit transition of the calling Activity. When true, the transition will start as soon as possible. When false, the transition will wait until the remote exiting transition completes before starting.

Parameters
allow true to start the enter transition when possible or false to wait until the exiting transition completes.

public void setAllowReturnTransitionOverlap (boolean allow)

Added in API level 21

Controls how the transition set in setExitTransition(android.transition.Transition) overlaps with the exit transition of the called Activity when reentering after if finishes. When true, the transition will start as soon as possible. When false, the transition will wait until the called Activity's exiting transition completes before starting.

Parameters
allow true to start the transition when possible or false to wait until the called Activity's exiting transition completes.

public void setAttributes (WindowManager.LayoutParams a)

Added in API level 1

Specify custom window attributes. PLEASE NOTE: the layout params you give here should generally be from values previously retrieved with getAttributes(); you probably do not want to blindly create and apply your own, since this will blow away any values set by the framework that you are not interested in.

Parameters
a The new window attributes, which will completely override any current values.

public abstract void setBackgroundDrawable (Drawable drawable)

Added in API level 1

Change the background of this window to a custom Drawable. Setting the background to null will make the window be opaque. To make the window transparent, you can use an empty drawable (for instance a ColorDrawable with the color 0 or the system drawable android:drawable/empty.)

Parameters
drawable The new Drawable to use for this window's background.

public void setBackgroundDrawableResource (int resId)

Added in API level 1

Change the background of this window to a Drawable resource. Setting the background to null will make the window be opaque. To make the window transparent, you can use an empty drawable (for instance a ColorDrawable with the color 0 or the system drawable android:drawable/empty.)

Parameters
resId The resource identifier of a drawable resource which will be installed as the new background.

public void setCallback (Window.Callback callback)

Added in API level 1

Set the Callback interface for this window, used to intercept key events and other dynamic operations in the window.

Parameters
callback The desired Callback interface.

public abstract void setChildDrawable (int featureId, Drawable drawable)

Added in API level 1

public abstract void setChildInt (int featureId, int value)

Added in API level 1

public void setClipToOutline (boolean clipToOutline)

Sets whether window content should be clipped to the outline of the window background.

Parameters
clipToOutline Whether window content should be clipped to the outline of the window background.

public void setContainer (Window container)

Added in API level 1

Set the container for this window. If not set, the DecorWindow operates as a top-level window; otherwise, it negotiates with the container to display itself appropriately.

Parameters
container The desired containing Window.

public abstract void setContentView (int layoutResID)

Added in API level 1

Convenience for setContentView(View, android.view.ViewGroup.LayoutParams) to set the screen content from a layout resource. The resource will be inflated, adding all top-level views to the screen.

Parameters
layoutResID Resource ID to be inflated.

public abstract void setContentView (View view)

Added in API level 1

Convenience for setContentView(View, android.view.ViewGroup.LayoutParams) set the screen content to an explicit view. This view is placed directly into the screen's view hierarchy. It can itself be a complex view hierarhcy.

Parameters
view The desired content to display.

public abstract void setContentView (View view, ViewGroup.LayoutParams params)

Added in API level 1

Set the screen content to an explicit view. This view is placed directly into the screen's view hierarchy. It can itself be a complex view hierarchy.

Note that calling this function "locks in" various characteristics of the window that can not, from this point forward, be changed: the features that have been requested with requestFeature(int), and certain window flags as described in setFlags(int, int).

If FEATURE_CONTENT_TRANSITIONS is set, the window's TransitionManager will be used to animate content from the current content View to view.

Parameters
view The desired content to display.
params Layout parameters for the view.

public void setDimAmount (float amount)

Added in API level 14

Set the amount of dim behind the window when using FLAG_DIM_BEHIND. This overrides the default dim amount of that is selected by the Window based on its theme.

Parameters
amount The new dim amount, from 0 for no dim to 1 for full dim.

public void setElevation (float elevation)

Sets the window elevation.

Changes to this property take effect immediately and will cause the window surface to be recreated. This is an expensive operation and as a result, this property should not be animated.

Parameters
elevation The window elevation.

public void setEnterTransition (Transition transition)

Added in API level 21

Sets the Transition that will be used to move Views into the initial scene. The entering Views will be those that are regular Views or ViewGroups that have isTransitionGroup() return true. Typical Transitions will extend Visibility as entering is governed by changing visibility from INVISIBLE to VISIBLE. If transition is null, entering Views will remain unaffected.

Related XML Attributes
Parameters
transition The Transition to use to move Views into the initial Scene.

public void setExitTransition (Transition transition)

Added in API level 21

Sets the Transition that will be used to move Views out of the scene when starting a new Activity. The exiting Views will be those that are regular Views or ViewGroups that have isTransitionGroup() return true. Typical Transitions will extend Visibility as exiting is governed by changing visibility from VISIBLE to INVISIBLE. If transition is null, the views will remain unaffected. Requires FEATURE_ACTIVITY_TRANSITIONS.

Related XML Attributes
Parameters
transition The Transition to use to move Views out of the scene when calling a new Activity.

public abstract void setFeatureDrawable (int featureId, Drawable drawable)

Added in API level 1

Set an explicit Drawable value for feature of this window. You must have called requestFeature(featureId) before calling this function.

Parameters
featureId The desired drawable feature to change. Features are constants defined by Window.
drawable A Drawable object to display.

public abstract void setFeatureDrawableAlpha (int featureId, int alpha)

Added in API level 1

Set a custom alpha value for the given drawable feature, controlling how much the background is visible through it.

Parameters
featureId The desired drawable feature to change. Features are constants defined by Window.
alpha The alpha amount, 0 is completely transparent and 255 is completely opaque.

public abstract void setFeatureDrawableResource (int featureId, int resId)

Added in API level 1

Set the value for a drawable feature of this window, from a resource identifier. You must have called requestFeauture(featureId) before calling this function.

Parameters
featureId The desired drawable feature to change, defined as a constant by Window.
resId Resource identifier of the desired image.
See Also

public abstract void setFeatureDrawableUri (int featureId, Uri uri)

Added in API level 1

Set the value for a drawable feature of this window, from a URI. You must have called requestFeature(featureId) before calling this function.

The only URI currently supported is "content:", specifying an image in a content provider.

Parameters
featureId The desired drawable feature to change. Features are constants defined by Window.
uri The desired URI.
See Also

public abstract void setFeatureInt (int featureId, int value)

Added in API level 1

Set the integer value for a feature. The range of the value depends on the feature being set. For FEATURE_PROGRESS, it should go from 0 to 10000. At 10000 the progress is complete and the indicator hidden.

Parameters
featureId The desired feature to change. Features are constants defined by Window.
value The value for the feature. The interpretation of this value is feature-specific.

public void setFlags (int flags, int mask)

Added in API level 1

Set the flags of the window, as per the WindowManager.LayoutParams flags.

Note that some flags must be set before the window decoration is created (by the first call to setContentView(View, android.view.ViewGroup.LayoutParams) or getDecorView(): FLAG_LAYOUT_IN_SCREEN and FLAG_LAYOUT_INSET_DECOR. These will be set for you based on the windowIsFloating attribute.

Parameters
flags The new window flags (see WindowManager.LayoutParams).
mask Which of the window flag bits to modify.

public void setFormat (int format)

Added in API level 1

Set the format of window, as per the PixelFormat types. This overrides the default format that is selected by the Window based on its window decorations.

Parameters
format The new window format (see PixelFormat). Use PixelFormat.UNKNOWN to allow the Window to select the format.
See Also

public void setGravity (int gravity)

Added in API level 1

Set the gravity of the window, as per the Gravity constants. This controls how the window manager is positioned in the overall window; it is only useful when using WRAP_CONTENT for the layout width or height.

Parameters
gravity The desired gravity constant.

public void setIcon (int resId)

Added in API level 19

Set the primary icon for this window.

Parameters
resId resource ID of a drawable to set

public void setLayout (int width, int height)

Added in API level 1

Set the width and height layout parameters of the window. The default for both of these is MATCH_PARENT; you can change them to WRAP_CONTENT or an absolute value to make a window that is not full-screen.

Parameters
width The desired layout width of the window.
height The desired layout height of the window.
See Also

public void setLocalFocus (boolean hasFocus, boolean inTouchMode)

Added in API level 19

Set focus locally. The window should have the FLAG_LOCAL_FOCUS_MODE flag set already.

Parameters
hasFocus Whether this window has focus or not.
inTouchMode Whether this window is in touch mode or not.

public void setLogo (int resId)

Added in API level 19

Set the logo for this window. A logo is often shown in place of an icon but is generally wider and communicates window title information as well.

Parameters
resId resource ID of a drawable to set

public void setMediaController (MediaController controller)

Added in API level 21

Sets a MediaController to send media keys and volume changes to. If set, this should be preferred for all media keys and volume requests sent to this window.

Parameters
controller The controller for the session which should receive media keys and volume changes.

public abstract void setNavigationBarColor (int color)

Added in API level 21

Sets the color of the navigation bar to . For this to take effect, the window must be drawing the system bar backgrounds with FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS and FLAG_TRANSLUCENT_NAVIGATION must not be set. If is not opaque, consider setting SYSTEM_UI_FLAG_LAYOUT_STABLE and SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION.

The transitionName for the view background will be "android:navigation:background".

public void setReenterTransition (Transition transition)

Added in API level 21

Sets the Transition that will be used to move Views in to the scene when returning from a previously-started Activity. The entering Views will be those that are regular Views or ViewGroups that have isTransitionGroup() return true. Typical Transitions will extend Visibility as exiting is governed by changing visibility from VISIBLE to INVISIBLE. If transition is null, the views will remain unaffected. If nothing is set, the default will be to use the same transition as setExitTransition(android.transition.Transition). Requires FEATURE_ACTIVITY_TRANSITIONS.

Related XML Attributes
Parameters
transition The Transition to use to move Views into the scene when reentering from a previously-started Activity.

public void setReturnTransition (Transition transition)

Added in API level 21

Sets the Transition that will be used to move Views out of the scene when the Window is preparing to close, for example after a call to finishAfterTransition(). The exiting Views will be those that are regular Views or ViewGroups that have isTransitionGroup() return true. Typical Transitions will extend Visibility as entering is governed by changing visibility from VISIBLE to INVISIBLE. If transition is null, entering Views will remain unaffected. If nothing is set, the default will be to use the same value as set in setEnterTransition(android.transition.Transition).

Related XML Attributes
Parameters
transition The Transition to use to move Views out of the Scene when the Window is preparing to close.

public void setSharedElementEnterTransition (Transition transition)

Added in API level 21

Sets the Transition that will be used for shared elements transferred into the content Scene. Typical Transitions will affect size and location, such as ChangeBounds. A null value will cause transferred shared elements to blink to the final position. Requires FEATURE_ACTIVITY_TRANSITIONS.

Parameters
transition The Transition to use for shared elements transferred into the content Scene.

public void setSharedElementExitTransition (Transition transition)

Added in API level 21

Sets the Transition that will be used for shared elements after starting a new Activity before the shared elements are transferred to the called Activity. If the shared elements must animate during the exit transition, this Transition should be used. Upon completion, the shared elements may be transferred to the started Activity. Requires FEATURE_ACTIVITY_TRANSITIONS.

Parameters
transition The Transition to use for shared elements in the launching Window prior to transferring to the launched Activity's Window.

public void setSharedElementReenterTransition (Transition transition)

Added in API level 21

Sets the Transition that will be used for shared elements reentering from a started Activity after it has returned the shared element to it start location. If no value is set, this will default to setSharedElementExitTransition(android.transition.Transition). Requires FEATURE_ACTIVITY_TRANSITIONS.

Parameters
transition The Transition to use for shared elements in the launching Window after the shared element has returned to the Window.

public void setSharedElementReturnTransition (Transition transition)

Added in API level 21

Sets the Transition that will be used for shared elements transferred back to a calling Activity. Typical Transitions will affect size and location, such as ChangeBounds. A null value will cause transferred shared elements to blink to the final position. If no value is set, the default will be to use the same value as setSharedElementEnterTransition(android.transition.Transition). Requires FEATURE_ACTIVITY_TRANSITIONS.

Parameters
transition The Transition to use for shared elements transferred out of the content Scene.

public void setSharedElementsUseOverlay (boolean sharedElementsUseOverlay)

Added in API level 21

Sets whether or not shared elements should use an Overlay during shared element transitions. The default value is true.

Parameters
sharedElementsUseOverlay true indicates that shared elements should be transitioned with an Overlay or false to transition within the normal View hierarchy.

public void setSoftInputMode (int mode)

Added in API level 3

Specify an explicit soft input mode to use for the window, as per WindowManager.LayoutParams.softInputMode. Providing anything besides "unspecified" here will override the input mode the window would normally retrieve from its theme.

public abstract void setStatusBarColor (int color)

Added in API level 21

Sets the color of the status bar to . For this to take effect, the window must be drawing the system bar backgrounds with FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS and FLAG_TRANSLUCENT_STATUS must not be set. If is not opaque, consider setting SYSTEM_UI_FLAG_LAYOUT_STABLE and SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN.

The transitionName for the view background will be "android:status:background".

public abstract void setTitle (CharSequence title)

Added in API level 1

public abstract void setTitleColor (int textColor)

Added in API level 1

public void setTransitionBackgroundFadeDuration (long fadeDurationMillis)

Added in API level 21

Sets the duration, in milliseconds, of the window background fade when transitioning into or away from an Activity when called with an Activity Transition.

When executing the enter transition, the background starts transparent and fades in. This requires FEATURE_ACTIVITY_TRANSITIONS. The default is 300 milliseconds.

Parameters
fadeDurationMillis The duration of the window background fade to or from opaque during enter transition.

public void setTransitionManager (TransitionManager tm)

Added in API level 21

Set the TransitionManager to use for default transitions in this window. Requires FEATURE_CONTENT_TRANSITIONS.

Parameters
tm The TransitionManager to use for scene changes.

public void setType (int type)

Added in API level 1

Set the type of the window, as per the WindowManager.LayoutParams types.

Parameters
type The new window type (see WindowManager.LayoutParams).

public void setUiOptions (int uiOptions)

Added in API level 14

Set extra options that will influence the UI for this window.

Parameters
uiOptions Flags specifying extra options for this window.

public void setUiOptions (int uiOptions, int mask)

Added in API level 14

Set extra options that will influence the UI for this window. Only the bits filtered by mask will be modified.

Parameters
uiOptions Flags specifying extra options for this window.
mask Flags specifying which options should be modified. Others will remain unchanged.

public abstract void setVolumeControlStream (int streamType)

Added in API level 1

public void setWindowAnimations (int resId)

Added in API level 3

Specify custom animations to use for the window, as per WindowManager.LayoutParams.windowAnimations. Providing anything besides 0 here will override the animations the window would normally retrieve from its theme.

public void setWindowManager (WindowManager wm, IBinder appToken, String appName)

Added in API level 1

Set the window manager for use by this Window to, for example, display panels. This is not used for displaying the Window itself -- that must be done by the client.

Parameters
wm The window manager for adding new windows.

public void setWindowManager (WindowManager wm, IBinder appToken, String appName, boolean hardwareAccelerated)

Added in API level 11

Set the window manager for use by this Window to, for example, display panels. This is not used for displaying the Window itself -- that must be done by the client.

Parameters
wm The window manager for adding new windows.

public abstract boolean superDispatchGenericMotionEvent (MotionEvent event)

Added in API level 12

Used by custom windows, such as Dialog, to pass the generic motion event further down the view hierarchy. Application developers should not need to implement or call this.

public abstract boolean superDispatchKeyEvent (KeyEvent event)

Added in API level 1

Used by custom windows, such as Dialog, to pass the key press event further down the view hierarchy. Application developers should not need to implement or call this.

public abstract boolean superDispatchKeyShortcutEvent (KeyEvent event)

Added in API level 11

Used by custom windows, such as Dialog, to pass the key shortcut press event further down the view hierarchy. Application developers should not need to implement or call this.

public abstract boolean superDispatchTouchEvent (MotionEvent event)

Added in API level 1

Used by custom windows, such as Dialog, to pass the touch screen event further down the view hierarchy. Application developers should not need to implement or call this.

public abstract boolean superDispatchTrackballEvent (MotionEvent event)

Added in API level 1

Used by custom windows, such as Dialog, to pass the trackball event further down the view hierarchy. Application developers should not need to implement or call this.

public abstract void takeInputQueue (InputQueue.Callback callback)

Added in API level 9

Take ownership of this window's InputQueue. The window will no longer read and dispatch input events from the queue; it is your responsibility to do so.

public abstract void takeKeyEvents (boolean get)

Added in API level 1

Request that key events come to this activity. Use this if your activity has no views with focus, but the activity still wants a chance to process key events.

public abstract void takeSurface (SurfaceHolder.Callback2 callback)

Added in API level 9

Take ownership of this window's surface. The window's view hierarchy will no longer draw into the surface, though it will otherwise continue to operate (such as for receiving input events). The given SurfaceHolder callback will be used to tell you about state changes to the surface.

public abstract void togglePanel (int featureId, KeyEvent event)

Added in API level 1

Protected Methods

protected final int getFeatures ()

Added in API level 1

Return the feature bits that are enabled. This is the set of features that were given to requestFeature(), and are being handled by this Window itself or its container. That is, it is the set of requested features that you can actually use.

To do: add a public version of this API that allows you to check for features by their feature ID.

Returns
  • int The feature bits.

protected final int getForcedWindowFlags ()

Added in API level 1

Return the window flags that have been explicitly set by the client, so will not be modified by getDecorView().

protected final int getLocalFeatures ()

Added in API level 1

Return the feature bits that are being implemented by this Window. This is the set of features that were given to requestFeature(), and are being handled by only this Window itself, not by its containers.

Returns
  • int The feature bits.

protected final boolean hasSoftInputMode ()

Added in API level 3

Has the app specified their own soft input mode?

protected abstract void onActive ()

Added in API level 1

protected void setDefaultWindowFormat (int format)

Added in API level 1

Set the default format of window, as per the PixelFormat types. This is the format that will be used unless the client specifies in explicit format with setFormat();

Parameters
format The new window format (see PixelFormat).