window.runtime 属性window.runtime.flash.display.Screen
继承Screen Inheritance EventDispatcher Inheritance Object

Screen 类提供此应用程序的可用显示屏幕的相关信息。

屏幕是位于可能更大的“虚拟桌面”内的独立桌面区域。虚拟桌面的原点是操作系统指定的主屏幕的左上角。因此,个别显示屏幕范围的坐标可能是负数。虚拟桌面也可能有一些不在任何显示屏幕内的区域。

Screen 类包括用于访问可用屏幕对象的静态类成员和用于访问个别屏幕属性的实例成员。屏幕信息不应进行缓存,因为这些信息可能会由用户随时更改。

请注意,屏幕和连接到计算机的物理监视器之间不一定有一对一的对应关系。例如,两台监视器可以显示同一个屏幕。

无法直接实例化 Screen 类。调用 new Screen() 构造函数将引发 ArgumentError 异常。



属性
 属性定义方
  bounds : Rectangle
[只读 (read-only)] 此屏幕的范围。
Screen
  colorDepth : int
[只读 (read-only)] 此屏幕的颜色深度(以位数为单位)。
Screen
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  mainScreen : Screen
[静态] [只读 (read-only)] 主显示器。
Screen
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  screens : Array
[静态] [只读 (read-only)] 当前可用的屏幕的数组。
Screen
  visibleBounds : Rectangle
[只读 (read-only)] 此屏幕上窗口可见区域的范围。
Screen
公共方法
 方法定义方
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
dispatchEvent(event:Event):Boolean
将事件调度到事件流中。
EventDispatcher
  
[静态] 返回一组与提供的矩形相交的屏幕(可能为空)。
Screen
 Inherited
hasEventListener(type:String):Boolean
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。
Object
 Inherited
toString():String
返回指定对象的字符串表示形式。
Object
 Inherited
valueOf():Object
返回指定对象的原始值。
Object
 Inherited
willTrigger(type:String):Boolean
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件 摘要 定义方
 InheritedFlash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时调度。EventDispatcher
 InheritedFlash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时调度。EventDispatcher
属性详细信息
bounds属性
bounds:Rectangle  [只读 (read-only)]

此屏幕的范围。

屏幕位置相对于虚拟桌面。


示例
下面的示例显示如何获取屏幕(在本例中为主显示屏幕)的范围:

var screenBounds = air.Screen.mainScreen.bounds;
colorDepth属性 
colorDepth:int  [只读 (read-only)]

此屏幕的颜色深度(以位数为单位)。


示例
下面的示例显示如何获取屏幕(在本例中为主显示屏幕)的颜色深度:

var colors = air.Screen.mainScreen.colorDepth;
mainScreen属性 
mainScreen:Screen  [只读 (read-only)]

主显示器。


示例
下面的示例显示如何获取表示此计算机的“主”屏幕的 Screen 对象。

var primaryScreen = air.Screen.mainScreen;
screens属性 
screens:Array  [只读 (read-only)]

当前可用的屏幕的数组。

修改返回的数组对可用的屏幕没有任何效果。


示例
下面的示例显示如何获取包含可用屏幕的数组:

var screenArray = air.Screen.screens;
visibleBounds属性 
visibleBounds:Rectangle  [只读 (read-only)]

此屏幕上窗口可见区域的范围。在 Windows 中,屏幕的 visibleBounds 不包括任务栏(和其他停靠的桌面搜索栏);在 Mac OS X 中,则不包括菜单栏和停靠,具体取决于系统设置。


示例
下面的示例显示如何获取屏幕(在本例中为主显示屏幕)的可用范围:

var screenBounds = air.Screen.mainScreen.visibleBounds;
方法详细信息
getScreensForRectangle()方法
function getScreensForRectangle(rect:Rectangle):Array

返回一组与提供的矩形相交的屏幕(可能为空)。

参数

rect:Rectangle — 一个具有相对于虚拟桌面原点(主屏幕的左上角)的坐标的矩形。

返回
Array — 包含屏幕的 Screen 对象的数组,这些屏幕包含由 rect 参数定义的区域的任何部分。

示例

下面的示例显示如何获取至少包含给定矩形一部分的屏幕的数组:

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