ウィンドウの管理

ウィンドウを操作するには、最初にウィンドウインスタンスを取得する必要があります。ウィンドウインスタンスは、次のいずれかの場所から取得できます。

• ウィンドウの作成に使用されるネイティブウィンドウコンストラクター：

  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 に設定します。ウィンドウを非表示にすると、ウィンドウ、関連するタスクバーアイコン、および MacOS X ではウィンドウメニューのエントリが表示されなくなります。

ウィンドウの可視性を変更すると、このウィンドウが所有するすべてのウィンドウの可視性も同様に変更されます。例えば、ウィンドウを非表示にすると、そのウィンドウが所有しているウィンドウもすべて非表示になります。

AIR では、ウィンドウの表示順序を複数の方法で直接変更できます。ウィンドウの表示順序の前面は背面に移動したり、ウィンドウを別のウィンドウの前や後に移動したりできます。同時に、ウィンドウをアクティブ化することでウィンドウの順序を変更することもできます。

alwaysInFront プロパティを true に設定することで、あるウィンドウを他のウィンドウより前面に保つことができます。このように設定されたウィンドウが複数ある場合、同じ設定のウィンドウ間で表示順序が並べ替えられます。ただし、それらのウィンドウは、 alwaysInFront が false に設定されたウィンドウよりは常に前面に配置されます。

また、最上位グループのウィンドウは、AIR アプリケーションがアクティブではない場合でも、他のアプリケーションのウィンドウより前面に表示されます。この動作はユーザーにとっては迷惑である場合があるので、 alwaysInFront を true に設定するのは、それが必要であって適切である場合にのみ行う必要があります。例えば、次のような場合には使用が正当化されます。

• ツールチップ、ポップアップリスト、カスタムメニュー、コンボボックスなどのコントロール用の一時的なポップアップウィンドウ。これらのウィンドウはフォーカスを失ったときに閉じる必要があるので、別のウィンドウの表示の邪魔になるのを避けることができます。

• 特に緊急を要するエラーメッセージと警告。ユーザーが直ちに応答しないと元に戻すことのできない変更が発生する可能性がある場合は、警告ウィンドウを最前面に移動してもかまいません。ただし、ほとんどのエラーと警告は、通常のウィンドウ表示順序で処理できます。

• 短時間だけ表示されるトーストスタイルのウィンドウ。

ウィンドウが他のウィンドウを所有している場合、所有下にあるウィンドウは常に所有者のウィンドウより前に配置されるように並べ替えられます。他のウィンドウを所有するウィンドウで orderToFront() を呼び出したり、 alwaysInFront を true に設定した場合、所有下にあるウィンドウも所有者ウィンドウと一緒に並べ替えられ、他のウィンドウの前面に配置されます。ただし、所有下にあるウィンドウは、所有者ウィンドウの前面に引き続き表示されます。

所有下にあるウィンドウからウィンドウの並べ替えメソッドを呼び出した場合、所有者ウィンドウが同じであるウィンドウ間では通常通り動作します。ただし、所有下にあるウィンドウのグループ全体が、そのグループ以外のウィンドウと比較され、並べ替えられることがあります。例えば、所有下にあるウィンドウから orderToFront() を呼び出すと、そのウィンドウ自身、その所有者、所有者が同じであるその他すべてのウィンドウが、ウィンドウ表示順序の前面に移動します。

NativeWindow クラスには、ウィンドウ間の相対的な表示順序を設定する次のプロパティとメソッドが用意されています。

Linux オペレーティングシステムでは、別のウィンドウマネージャーにより、ウィンドウの表示順序に関する別の規則が適用されます。

• 一部のウィンドウマネージャーでは、normal ウィンドウの前面にユーティリティウィンドウが常に表示されます。

• 一部のウィンドウマネージャーでは、 alwaysInFront が true に設定されているフルスクリーンウィンドウが、 alwaysInFront が true に設定されている他のウィンドウの前面に常に表示されます。

ウィンドウを閉じるには、 NativeWindow.close() メソッドを使用します。

ウィンドウを閉じると、ウィンドウのコンテンツの読み込みは解除されますが、他のオブジェクトがそのコンテンツを参照している場合は、コンテンツオブジェクトは破棄されません。 NativeWindow.close() メソッドは非同期に実行するので、ウィンドウに含まれるアプリケーションは、閉じる処理が行われている間も実行を続けます。閉じる操作が完了すると、close メソッドは close イベントを送出します。NativeWindow オブジェクトは技術的にはまだ有効な状態ですが、閉じられたウィンドウのほとんどのプロパティとメソッドは、アクセスすると IllegalOperationError が生成されます。閉じられたウィンドウを再び開くことはできません。ウィンドウが閉じられているかどうかを確認するには、ウィンドウの closed プロパティを調べます。単にウィンドウを非表示にするには、 NativeWindow.visible プロパティを false に設定します。

Nativeapplication.autoExit プロパティが true の場合は（デフォルト）、最後のウィンドウが閉じるとアプリケーションは終了します。

所有下にあるウィンドウは、所有者が閉じられたときに一緒に閉じます。所有下にあるウィンドウからは closing イベントが送出されないため、閉じる処理を取り消すことはできません。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>