flash.display.Screen - Adobe® AIR® API Reference for HTML Developers

window.runtime property	window.runtime.flash.display.Screen

Inheritance	Screen EventDispatcher Object

Runtime Versions:

1.0

The Screen class provides information about the display screens available to this application.

Screens are independent desktop areas within a possibly larger "virtual desktop." The origin of the virtual desktop is the top-left corner of the operating-system-designated main screen. Thus, the coordinates for the bounds of an individual display screen may be negative. There may also be areas of the virtual desktop that are not within any of the display screens.

The Screen class includes static class members for accessing the available screen objects and instance members for accessing the properties of an individual screen. Screen information should not be cached since it can be changed by a user at any time.

Note that there is not necessarily a one-to-one correspondance between screens and the physical monitors attached to a computer. For example, two monitors may display the same screen.

You cannot instantiate the Screen class directly. Calls to the new Screen() constructor throw an ArgumentError exception.

See also

Display screens in AIR

Properties

Hide Inherited Public Properties

Show Inherited Properties

	Property		Defined By
		bounds : Rectangle [read-only] The bounds of this screen.	Screen
		colorDepth : int [read-only] The color depth of this screen (expressed in number of bits).	Screen
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		mainScreen : Screen [static] [read-only] The primary display.	Screen
		prototype : Object [static] A reference to the prototype object of a class or function object.	Object
		screens : Array [static] [read-only] The array of the currently available screens.	Screen
		visibleBounds : Rectangle [read-only] The bounds of the area on this screen in which windows can be visible.	Screen

Public Methods

Hide Inherited Public Methods

Show Inherited Methods

	Method		Defined By
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.	EventDispatcher
		dispatchEvent(event:Event):Boolean Dispatches an event into the event flow.	EventDispatcher
		getScreensForRectangle(rect:Rectangle):Array [static] Returns the (possibly empty) set of screens that intersect the provided rectangle.	Screen
		hasEventListener(type:String):Boolean Checks whether the EventDispatcher object has any listeners registered for a specific type of event.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Removes a listener from the EventDispatcher object.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns the string representation of the specified object.	Object
		valueOf():Object Returns the primitive value of the specified object.	Object
		willTrigger(type:String):Boolean Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.	EventDispatcher

Events

Hide Inherited Events

Show Inherited Events

	Event		Summary	Defined By
		activate	[broadcast event] Dispatched when the Flash Player or AIR application gains operating system focus and becomes active.	EventDispatcher
		deactivate	[broadcast event] Dispatched when the Flash Player or AIR application operating loses system focus and is becoming inactive.	EventDispatcher

Property Detail

bounds

property

bounds:Rectangle [read-only]

Runtime Versions:

1.0

The bounds of this screen.

The screen location is relative to the virtual desktop.

On Linux systems that use certain window managers, this property returns the desktop bounds, not the screen's visible bounds.

Example ( How to use this example )

The following example shows how to get the bounds of a screen (in this case, the primary display screen):


var screenBounds = air.Screen.mainScreen.bounds;

colorDepth

property

colorDepth:int [read-only]

Runtime Versions:

1.0

The color depth of this screen (expressed in number of bits).

Example ( How to use this example )

The following example shows how to get the color depth of a screen (in this case, the primary display screen):


var colors = air.Screen.mainScreen.colorDepth;

mainScreen

property

mainScreen:Screen [read-only]

Runtime Versions:

1.0

The primary display.

Example ( How to use this example )

The following example shows how to get the Screen object representing the "main" screen of this computer:


var primaryScreen = air.Screen.mainScreen;

screens

property

screens:Array [read-only]

Runtime Versions:

1.0

The array of the currently available screens.

Modifying the returned array has no effect on the available screens.

Example ( How to use this example )

The following example shows how to get the array containing the available screens:


var screenArray = air.Screen.screens;

visibleBounds

property

visibleBounds:Rectangle [read-only]

Runtime Versions:

1.0

The bounds of the area on this screen in which windows can be visible.

The visibleBounds of a screen excludes the task bar (and other docked desk bars) on Windows, and excludes the menu bar and, depending on system settings, the dock on Mac OS X. On some Linux configurations, it is not possible to determine the visible bounds. In these cases, the visibleBounds property returns the same value as the screenBounds property.

Example ( How to use this example )

The following example shows how to get the usable bounds of a screen (in this case, the primary display screen):


var screenBounds = air.Screen.mainScreen.visibleBounds;

Method Detail

getScreensForRectangle

()

method

public function getScreensForRectangle(rect:Rectangle):Array

Runtime Versions:

1.0

Returns the (possibly empty) set of screens that intersect the provided rectangle.

Parameters

rect:Rectangle — A rectangle with coordinates relative to the origin of the virtual desktop, which is the top-left corner of the primary screen.

Returns

Array — An array of Screen objects containing the screens that contain any part of the area defined by the rect parameter.

Example ( How to use this example )

The following example shows how to get the array of screens containing at least part of a given rectangle:


var rect = new air.Rectangle(-200, 100, 1000, 600);
var intersectedScreens = air.Screen.getScreensForRectangle(rect);

[an error occurred while processing this directive][an error occurred while processing this directive]

Legal Notices | Online Privacy Policy