lightbulb_outline Help shape the future of the Google Play Console, Android Studio, and Firebase. Start survey

WindowManager

public interface WindowManager
implements ViewManager

android.view.WindowManager


The interface that apps use to talk to the window manager.

Each window manager instance is bound to a particular Display. To obtain a WindowManager for a different display, use Context.createDisplayContext(Display) to obtain a Context for that display, then use Context.getSystemService(Context.WINDOW_SERVICE) to get the WindowManager.

The simplest way to show a window on another display is to create a Presentation. The presentation will automatically obtain a WindowManager and Context for that display.

Instances of this class must be obtained using Context.getSystemService(Class) with the argument WindowManager.class or Context.getSystemService(String) with the argument Context.WINDOW_SERVICE.

Summary

Nested classes

class WindowManager.BadTokenException

Exception that is thrown when trying to add view whose WindowManager.LayoutParams WindowManager.LayoutParams.token is invalid. 

class WindowManager.InvalidDisplayException

Exception that is thrown when calling ViewManager.addView(View, ViewGroup.LayoutParams) to a secondary display that cannot be found. 

class WindowManager.LayoutParams

 

Public methods

abstract Display getDefaultDisplay()

Returns the Display upon which this WindowManager instance will create new windows.

abstract void removeViewImmediate(View view)

Special variation of ViewManager.removeView(View) that immediately invokes the given view hierarchy's View.onDetachedFromWindow() methods before returning.

Inherited methods

Public methods

getDefaultDisplay

added in API level 1
public abstract Display getDefaultDisplay ()

Returns the Display upon which this WindowManager instance will create new windows.

Despite the name of this method, the display that is returned is not necessarily the primary display of the system (see Display.DEFAULT_DISPLAY). The returned display could instead be a secondary display that this window manager instance is managing. Think of it as the display that this WindowManager instance uses by default.

To create windows on a different display, you need to obtain a WindowManager for that Display. (See the WindowManager class documentation for more information.)

Returns
Display The display that this window manager is managing.

removeViewImmediate

added in API level 1
public abstract void removeViewImmediate (View view)

Special variation of ViewManager.removeView(View) that immediately invokes the given view hierarchy's View.onDetachedFromWindow() methods before returning. This is not for normal applications; using it correctly requires great care.

Parameters
view View: The view to be removed.