Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public interface

WindowManager

implements ViewManager
android.view.WindowManager

Class Overview

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

Use Context.getSystemService(Context.WINDOW_SERVICE) to get one of these.

Each window manager instance is bound to a particular Display . To obtain a WindowManager for a different display, use 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.

Summary

Nested Classes
class WindowManager.BadTokenException Exception that is thrown when trying to add view whose WindowManager.LayoutParams token is invalid. 
class WindowManager.InvalidDisplayException Exception that is thrown when calling 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 removeView(View) that immediately invokes the given view hierarchy's View.onDetachedFromWindow() methods before returning.
[Expand]
Inherited Methods
From interface android.view.ViewManager

Public Methods

public abstract Display getDefaultDisplay ()

Added in API level 1

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 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
  • The display that this window manager is managing.

public abstract void removeViewImmediate ( View view)

Added in API level 1

Special variation of 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 The view to be removed.