管理窗口

若要操作窗口，必须首先获取窗口实例。可以从以下任一位置获取窗口实例：

• 用于创建窗口的本机窗口构造函数：

  var nativeWin = new air.NativeWindow(initOptions);

• 窗口中显示对象的 stage 属性：

  var nativeWin = window.htmlLoader.stage.nativeWindow;

• 由窗口调度的本机窗口事件的 target 属性：

  function onNativeWindowEvent(event) 
  { 
      var nativeWin = event.target; 
  }

• 窗口中显示的 HTML 页的 nativeWindow 属性：

  var nativeWin = window.nativeWindow;

• NativeApplication 对象的 activeWindow 和 openedWindows 属性：

  var win = NativeApplication.nativeApplication.activeWindow; 
  var firstWindow = NativeApplication.nativeApplication.openedWindows[0];

  NativeApplication.nativeApplication.activeWindow 引用应用程序的活动窗口（但如果该活动窗口不是此 AIR 应用程序的窗口，则返回 null ）。 NativeApplication.nativeApplication.openedWindows 数组包含 AIR 应用程序中尚未关闭的所有窗口。

由于 Flex mx:WindowedApplication 和 mx:Window 对象都是显示对象，因此使用 stage 属性即可轻松地在 MXML 文件中引用应用程序窗口，如下所示：

<?xml version="1.0" encoding="utf-8"?> 
<mx:WindowedApplication xmlns:mx="http://www.adobe.com/2006/mxml" applicationComplete="init();"> 
    <mx:Script> 
        <![CDATA[ 
            import flash.display.NativeWindow; 
 
            public function init():void{ 
                var appWindow:NativeWindow = this.stage.nativeWindow; 
                //set window properties 
                appWindow.visible = true; 
            } 
        ]]> 
    </mx:Script> 
</WindowedApplication

若要激活窗口，请调用 NativeWindow activate() 方法。激活窗口会将该窗口置于前面，为其提供键盘和鼠标焦点，并在必要时通过还原窗口或将 visible 属性设置为 true 来使其可见。激活窗口不会更改应用程序中其他窗口的顺序。调用 activate() 方法会导致窗口调度 activate 事件。

若要在不激活的情况下显示隐藏窗口，请将 visible 属性设置为 true 。此操作使该窗口置于前面，但不会向它分配焦点。

若要从视图中隐藏窗口，请将其 visible 属性设置为 false 。隐藏窗口会禁止窗口和任何相关任务栏图标的显示，并且在 Mac OS X 中还会禁止窗口菜单中条目的显示。

更改窗口的可见性时，该窗口所拥有的所有窗口的可见性也将发生更改。例如，如果隐藏窗口，则该窗口所拥有的所有窗口也将隐藏。

AIR 提供几种方法来直接更改窗口的显示顺序。可以将窗口的显示顺序向前或向后移动；可以将窗口移动到其他窗口的前面或后面。同时，用户可以通过激活窗口来对窗口进行重新排序。

可以通过将窗口的 alwaysInFront 属性设置为 true 来使该窗口位于其他窗口的前面。如果多个窗口都具有此设置，则这些窗口的显示顺序是它们相互之间的排序顺序，而且它们始终排序在 alwaysInFront 设置为 false 的窗口前面。

即使 AIR 应用程序未处于活动状态，最上面组中的窗口也显示在其他应用程序中窗口的前面。由于此行为会阻碍用户查看其他窗口，因此应仅在必要和适当时才能将 alwaysInFront 设置为 true 。经调整的使用示例包括：

• 工具提示、弹出列表、自定义菜单或组合框等控件的临时弹出窗口。 由于这些窗口在失去焦点后将关闭，因此可以避免阻碍用户查看其他窗口的不便。

• 极其紧急的错误消息和警告。在可能发生不可撤销的更改时，如果用户未及时响应，则可能调整为将警告窗口置于最前面。但是，可以按正常的窗口显示顺序处理大多数错误消息和警告。

• 短期弹出式窗口。

如果窗口拥有其他窗口，则这些窗口始终按顺序显示在该窗口前面。如果对拥有其他窗口的某个窗口调用 orderToFront() ，或者在该窗口上将 alwaysInFront 设置为 true ，则所有者窗口将显示在其他窗口前面，该窗口所拥有的窗口随该窗口一起重新排序，且所拥有的窗口仍显示在所有者的前面。

在同一窗口所拥有的窗口中，对拥有的窗口调用窗口顺序方法可正常工作，但同时会更改整个拥有的窗口组相对于该组之外的其他窗口的排序顺序。例如，如果对某个拥有的窗口调用 orderToFront() ，则该窗口、其所有者以及同一所有者所拥有的所有其他窗口都将移动到窗口显示列表的前面。

NativeWindow 类提供以下属性和方法来设置一个窗口相对于其他窗口的显示顺序：

在 Linux 操作系统中，不同的窗口管理器对于窗口显示顺序实施不同的规则：

• 在某些窗口管理器中，实用程序窗口始终显示于普通窗口之前。

• 在某些窗口管理器中，将 alwaysInFront 设置为 true 的全屏窗口始终显示于其他同样将 alwaysInFront 设置为 true 的窗口之前。

若要关闭窗口，请使用 NativeWindow.close() 方法。

关闭窗口会卸载该窗口的内容，但如果其他对象引用了此内容，则不会破坏内容对象。 NativeWindow.close() 方法以异步方式执行，该窗口中包含的应用程序在关闭过程中继续运行。该 close 方法在关闭操作完成时调度 close 事件。从技术角度而言，NativeWindow 对象仍然有效，但访问已关闭窗口上的大多数属性和方法会生成 IllegalOperationError。不能重新打开已关闭窗口。检查窗口的 closed 属性以测试窗口是否已关闭。若要仅从视图中隐藏窗口，请将 NativeWindow.visible 属性设置为 false 。

如果 Nativeapplication.autoExit 属性为 true （默认情况），则应用程序在其最后一个窗口关闭后退出。

当所有者关闭时，该所有者所拥有的所有窗口也将同时关闭。所拥有的窗口不会调度关闭事件，因此无法阻止关闭这些窗口。已调度 close 事件。

在窗口使用系统镶边时，可以通过侦听和取消相应事件的默认行为来取消用户与该窗口的交互。例如，在用户单击系统镶边关闭按钮后，将调度 closing 事件。如果任何已注册的侦听器调用了事件的 preventDefault() 方法，则该窗口不会关闭。

在窗口不使用系统镶边时，不会在执行预期更改之前自动调度这些更改的通知事件。因此，如果调用关闭窗口、更改窗口状态的方法，或者设置任何窗口范围属性，则无法取消更改。若要在执行窗口更改前通知应用程序中的组件，则应用程序逻辑可以使用窗口的 dispatchEvent() 方法调度相关的通知事件。

例如，以下逻辑实现窗口关闭按钮的可取消事件处理函数：

function onCloseCommand(event){ 
    var closingEvent = new air.Event(air.Event.CLOSING,true,true); 
    dispatchEvent(closingEvent); 
    if(!closingEvent.isDefaultPrevented()){ 
        win.close(); 
    } 
}

如果侦听器调用事件的 preventDefault() 方法，则 dispatchEvent() 方法返回 false 。但是，由于其他原因，它还可以返回 false ，因此最好明确使用 isDefaultPrevented() 方法来测试是否应取消更改。

若要最大化窗口，请使用 NativeWindow maximize() 方法。

window.nativeWindow.maximize();

若要最小化窗口，请使用 NativeWindow minimize() 方法。

 
window.nativeWindow.minimize();

若要还原窗口（即，使其返回最小化或最大化操作之前的大小），请使用 NativeWindow restore() 方法。

 
window.nativeWindow.restore();

当所有者窗口最小化或还原时，所拥有的窗口也将最小化和还原。所拥有的窗口在最小化时不会调度任何事件，因为是对其所有者执行的最小化操作。

在 Linux 操作系统中，不同的窗口管理器对于设置窗口显示状态实施不同的规则：

• 在某些窗口管理器中无法将实用程序窗口最大化。

• 如果为窗口设置了最大大小，则某些窗口不允许将窗口最大化。某些其他窗口管理器将显示状态设置为最大化，但不调整窗口大小。在这两种情况下，都不会调度显示状态更改事件。

• 某些窗口管理器不遵守窗口的 maximizable 或 minimizable 设置。

以下简短的 HTML 页演示 NativeWindow maximize() 、 minimize() 、 restore() 和 close() 方法：

<html> 
<head> 
<title>Change Window Display State</title> 
<script src="AIRAliases.js"/> 
<script type="text/javascript"> 
     function onMaximize(){ 
         window.nativeWindow.maximize(); 
     } 
     
     function onMinimize(){ 
         window.nativeWindow.minimize(); 
     } 
     
     function onRestore(){ 
         window.nativeWindow.restore(); 
     } 
     
     function onClose(){ 
         window.nativeWindow.close(); 
     } 
</script> 
</head> 
 
<body> 
     <h1>AIR window display state commands</h1> 
         <button onClick="onMaximize()">Maximize</button> 
         <button onClick="onMinimize()">Minimize</button> 
         <button onClick="onRestore()">Restore</button> 
    <button onClick="onClose()">Close</button> 
</body> 
</html>

在窗口使用系统镶边时，该镶边提供用于调整窗口大小和在桌面范围内移动窗口的拖动控件。如果窗口不使用系统镶边，则必须添加您自己的控件以允许用户调整窗口大小和移动窗口。

以下示例说明如何对窗口启动调整大小和移动操作：

<html xmlns="http://www.w3.org/1999/xhtml"> 
<head> 
<script src="AIRAliases.js"/> 
<script type="text/javascript"> 
     function onResize(type){ 
         nativeWindow.startResize(type); 
     } 
     
     function onNativeMove(){ 
         nativeWindow.startMove(); 
     } 
</script> 
<style type="text/css" media="screen"> 
 
.drag { 
    width:200px; 
    height:200px; 
    margin:0px auto; 
    padding:15px; 
    border:1px dashed #333; 
    background-color:#eee; 
    } 
 
.resize { 
    background-color:#FF0000; 
    padding:10px; 
    } 
.left { 
        float:left; 
        }     
.right { 
    float:right; 
}     
 
</style> 
<title>Move and Resize the Window</title> 
</head> 
 
<body> 
<div class="resize left" onmousedown="onResize(air.NativeWindowResize.TOP_LEFT)">Drag to resize</div> 
<div class="resize right" onmousedown="onResize(air.NativeWindowResize.TOP_RIGHT)">Drag to resize</div> 
<div class="drag" onmousedown="onNativeMove()">Drag to move</div> 
<div class="resize left" onmousedown="onResize(air.NativeWindowResize.BOTTOM_LEFT)">Drag to resize</div> 
<div class="resize right" onmousedown="onResize(air.NativeWindowResize.BOTTOM_RIGHT)">Drag to resize</div> 
</body> 
</html>