AIR 中的显示屏幕

Adobe AIR 1.0 和更高版本

使用 Adobe® AIR® Screen 类访问关于连接到计算机或设备的显示屏幕的信息。

AIR 中的显示屏幕的基础知识

屏幕 API 只包含单个 Screen 类,该类提供用于获取系统屏幕信息的静态成员以及用于描述特定屏幕的实例成员。

计算机系统可以连接多台监视器或显示器,这些监视器或显示器对应于虚拟空间中排列的多个桌面屏幕。AIR Screen 类提供有关这些屏幕、屏幕的相对排列及其可用空间的信息。如果多台监视器映射到同一屏幕,则只存在一个屏幕。如果屏幕的尺寸大于监视器的显示区域,则无法确定当前可以看到屏幕的哪个部分。

屏幕表示独立的桌面显示区域。屏幕被描述为虚拟桌面内部的矩形。被指定为主显示屏的屏幕的左上角是虚拟桌面坐标系的原点。用于描述屏幕的所有值均以像素为单位提供。

查看完全大小图形
在此屏幕排列中,虚拟桌面中存在两个屏幕。主屏幕 (#1) 左上角的坐标始终是 (0,0)。如果屏幕排列更改为指定屏幕 #2 作为主屏幕,则屏幕 #1 的坐标将变为负值。报告屏幕的可用范围时将排除菜单栏、任务栏和停靠栏。

有关屏幕 API 类、方法、属性和事件的详细信息,请参阅 针对 HTML 开发人员的 Adobe AIR API 参考

枚举屏幕

可以使用以下屏幕方法和属性枚举虚拟桌面的屏幕:

方法或属性

说明

Screen.screens

提供描述可用屏幕的 Screen 对象的数组。数组的顺序不重要。

Screen.mainScreen

提供主屏幕的 Screen 对象。在 Mac OS X 中,主屏幕是指显示菜单栏的屏幕。在 Windows 中,主屏幕是指系统指定的主屏幕。

Screen.getScreensForRectangle()

提供描述与给定矩形相交的屏幕的 Screen 对象的数组。传递给此方法的矩形位于虚拟桌面上的像素坐标中。如果没有屏幕与该矩形相交,则该数组为空。可以使用此方法确定窗口显示在哪些屏幕上。

不要保存 Screen 类方法和属性返回的值。用户或操作系统可随时更改可用屏幕及其排列方式。

以下示例使用屏幕 API 在多个屏幕间移动窗口,以响应箭头键的按键操作。该示例获取 screens 数组并将其在垂直或水平方向排序(取决于所按的箭头键),以便将窗口移动到下一个屏幕。代码随后将遍历排序后的数组,将每个屏幕与当前屏幕的坐标进行比较。该示例调用 Screen.getScreensForRectangle() ,传入窗口范围,以便识别窗口的当前屏幕。

<html> 
    <head> 
        <script src="AIRAliases.js" type="text/javascript"></script> 
        <script type="text/javascript"> 
        function onKey(event){ 
            if(air.Screen.screens.length > 1){ 
                switch(event.keyCode){ 
                    case air.Keyboard.LEFT : 
                        moveLeft(); 
                        break; 
                    case air.Keyboard.RIGHT : 
                        moveRight(); 
                        break; 
                    case air.Keyboard.UP : 
                        moveUp(); 
                        break; 
                    case air.Keyboard.DOWN : 
                        moveDown(); 
                        break; 
                } 
                 
            }     
        }     
                 
        function moveLeft(){ 
            var currentScreen = getCurrentScreen(); 
            var left = air.Screen.screens; 
            left.sort(sortHorizontal); 
            for(var i = 0; i < left.length - 1; i++){ 
                if(left[i].bounds.left < window.nativeWindow.bounds.left){ 
                    window.nativeWindow.x += left[i].bounds.left - currentScreen.bounds.left; 
                    window.nativeWindow.y += left[i].bounds.top - currentScreen.bounds.top; 
                } 
            }  
        } 
         
        function moveRight(){ 
            var currentScreen = getCurrentScreen(); 
            var left = air.Screen.screens; 
            left.sort(sortHorizontal); 
            for(var i = left.length - 1; i > 0; i--){ 
                if(left[i].bounds.left > window.nativeWindow.bounds.left){ 
                    window.nativeWindow.x += left[i].bounds.left - currentScreen.bounds.left; 
                    window.nativeWindow.y += left[i].bounds.top - currentScreen.bounds.top; 
                } 
            }  
        } 
 
        function moveUp(){ 
            var currentScreen = getCurrentScreen(); 
            var top = air.Screen.screens; 
            top.sort(sortVertical); 
            for(var i = 0; i < top.length - 1; i++){ 
                if(top[i].bounds.top < window.nativeWindow.bounds.top){ 
                    window.nativeWindow.x += top[i].bounds.left - currentScreen.bounds.left; 
                    window.nativeWindow.y += top[i].bounds.top - currentScreen.bounds.top; 
                    break; 
                } 
            }  
        } 
 
        function moveDown(){ 
            var currentScreen = getCurrentScreen(); 
             
            var top = air.Screen.screens; 
            top.sort(sortVertical); 
            for(var i = top.length - 1; i > 0; i--){ 
                if(top[i].bounds.top > window.nativeWindow.bounds.top){ 
                    window.nativeWindow.x += top[i].bounds.left - currentScreen.bounds.left; 
                    window.nativeWindow.y += top[i].bounds.top - currentScreen.bounds.top; 
                    break; 
                } 
            }  
        } 
         
        function sortHorizontal(a,b){ 
            if (a.bounds.left > b.bounds.left){ 
                return 1; 
            } else if (a.bounds.left < b.bounds.left){ 
                return -1; 
            } else {return 0;} 
        } 
         
        function sortVertical(a,b){ 
            if (a.bounds.top > b.bounds.top){ 
                return 1; 
            } else if (a.bounds.top < b.bounds.top){ 
                return -1; 
            } else {return 0;} 
        } 
         
        function getCurrentScreen(){ 
            var current; 
            var screens = air.Screen.getScreensForRectangle(window.nativeWindow.bounds); 
            (screens.length > 0) ? current = screens[0] : current = air.Screen.mainScreen; 
            return current; 
        }         
         
        function init(){ 
            window.nativeWindow.stage.addEventListener("keyDown",onKey); 
        } 
        </script> 
        <title>Screen Hopper</title> 
    </head> 
    <body  onload="init()"> 
        <p>Use the arrow keys to move the window between monitors.</p> 
    </body> 
</html>