アクティブなアプリケーションウィンドウです。

アクティブなデスクトップウィンドウがこのアプリケーションに属していない場合、またはアクティブなウィンドウがない場合、activeWindow は null です。

この AIR アプリケーション用のアプリケーション記述子ファイルの内容です。

var appDescriptor:XML = NativeApplication.nativeApplication.applicationDescriptor;
var ns:Namespace = appDescriptor.namespace();
var appCopyright:String = appDescriptor.ns::copyright;
var appVersion:String = appDescriptor.ns::version;
trace("appId:", appCopyright);
trace("version:", appVersion);

このアプリケーションのアプリケーション ID です。

この ID の値は、アプリケーション記述子ファイルに設定されます。

すべてのウィンドウを閉じたときにアプリケーションを自動的に終了するかどうかを指定します。

autoExit がデフォルトの true の場合、すべてのウィンドウを閉じるとアプリケーションが終了します。exiting イベントと exit イベントの両方が送出されます。autoExit が false の場合、NativeApplication.nativeApplication.exit() を呼び出してアプリケーションを終了する必要があります。

アプリケーションアイコンです。

NativeApplication.supportsDockIcon と NativeApplication.supportsSystemTrayIcon を使用して、icon クラスを判別します。タイプは、InteractiveIcon のいずれかのサブクラスです。Mac^® OS X では、NativeApplication.icon は DockIcon タイプのオブジェクトです。Windows^® の場合、NativeApplication.icon はタイプが SystemTrayIcon のオブジェクトです。Linux では、アプリケーションアイコンはサポートされない場合があります。この場合、icon プロパティは null です。

icon オブジェクトは自動的に作成されますが、イメージデータで初期化されません。Mac OS X などの一部のオペレーティングシステムでは、デフォルトのイメージが提供されます。Windows など、その他のオペレーティングシステムでは、イメージデータが割り当てられていないとアイコンは表示されません。アイコンイメージを割り当てるには、少なくとも 1 つの BitmapData オブジェクトが格納されている配列を icon.bitmaps プロパティに設定します。配列に複数の BitmapData オブジェクトが格納されている場合、サイズがアイコンの表示サイズに最も近いイメージをオペレーティングシステムが選択し、必要に応じてイメージを伸縮します。

関連項目

キーボード入力またはマウス入力が行われなくなってから userIdle イベントを送出するまでの秒数です。

デフォルトでは、アイドル時間のしきい値は 300 秒 (5 分) に設定されています。許容される値の範囲は、5（5 秒）以上 86,400（1 日）以下です。

関連項目

アプリケーションメニューです。

アプリケーションメニューは、NativeApplication.nativeApplication.supportsMenu が true のときにサポートされます。アプリケーションメニューをサポートしないオペレーティングシステムもあります。例えば、Mac OS X ではアプリケーションメニューがサポートされますが、Windows または Linux ではサポートされません。NativeApplication.nativeApplication.supportsMenu が false の場合も、このプロパティに NativeMenu オブジェクトを割り当てることはできますが、効果はありません。使用しているオペレーティングシステムでアプリケーションメニューがサポートされているか確認するには、必ず NativeApplication.nativeApplication.supportsMenu プロパティを使用してください。その他の方法（Capabilities.os など）でサポートの有無を判断すると、プログラミングエラーの原因になる可能性があります（ターゲットとなり得るオペレーティングシステムの種類についての配慮が完全でない場合）。

注意：Mac OS X の場合、menu プロパティはオペレーティングシステムで指定されたデフォルトのアプリケーションメニューを参照します。アイテムやサブメニューを追加および削除したり、イベントリスナーを追加することで、既存のメニュー構造を変更できます。新しい NativeMenu オブジェクトをこの menu プロパティに割り当てることによって、デフォルトのメニュー全体を置き換えることもできます。

関連項目

NativeApplication オブジェクトのシングルトンインスタンスです。

このアプリケーションの開いているすべてのネイティブウィンドウを格納する配列です。

このアプリケーションの発行者 ID です。

この ID の値は、アプリケーションの発行者 ID ファイルに設定されます。このファイルは、インストール時に、アプリケーションの署名に使用される証明書チェーンから生成されます。

このアプリケーションをホストするランタイムのパッチレベルです。

このアプリケーションをホストするランタイムのバージョン番号です。

現在のユーザーがログインしたときは常にこのアプリケーションを自動的に起動するかどうかを指定します。

startAtLogin プロパティは、ユーザーがログインするとアプリケーションを自動的に開始することを指定するためにオペレーティングシステムに定義されたメカニズムのステータスを反映します。ユーザーは、オペレーティングシステムのユーザーインターフェイスを使用して、手動でステータスを変更できます。このプロパティは、ステータスを最後に変更したのが AIR アプリケーションとオペレーティングシステムのどちらであるかを示す現在のステータスを反映します。

AIR が現在のオペレーティングシステムのアプリケーションドックアイコンをサポートするかどうかを示します。

true の場合は、NativeApplication.icon プロパティのタイプは DockIcon です。

Mac OS X および各種の Linux^® のユーザーインターフェイスには、実行中または頻繁に使用するアプリケーション用のアイコンが含まれた、アプリケーション "ドック" が用意されています。

使用しているオペレーティングシステムでアプリケーションのドックアイコンがサポートされているか確認するには、必ず NativeApplication.supportsDockIcon プロパティを使用してください。その他の方法（Capabilities.os など）でサポートの有無を判断すると、プログラミングエラーの原因になる可能性があります（ターゲットとなり得るオペレーティングシステムの種類についての配慮が完全でない場合）。

関連項目

現在のオペレーティングシステムがグローバルアプリケーションメニューバーをサポートするかどうかを指定します。

true の場合、NativeApplication.menu プロパティを使用してネイティブアプリケーションメニューを定義 (またはネイティブアプリケーションメニューにアクセス) できます。

使用しているオペレーティングシステムでアプリケーションメニューバーがサポートされているか確認するには、必ず NativeApplication.supportsMenu プロパティを使用してください。その他の方法（Capabilities.os など）でサポートの有無を判断すると、プログラミングエラーの原因になる可能性があります（ターゲットとなり得るオペレーティングシステムの種類についての配慮が完全でない場合）。

関連項目

AIR が現在のオペレーティングシステムのシステムトレイアイコンをサポートするかどうかを指定します。

true の場合は、NativeApplication.icon プロパティのタイプは SystemTrayIcon です。

使用しているオペレーティングシステムでシステムトレイアイコンがサポートされているか確認するには、必ず NativeApplication.supportsSystemTrayIcon プロパティを使用してください。その他の方法（Capabilities.os など）でサポートの有無を判断すると、プログラミングエラーの原因になる可能性があります（ターゲットとなり得るオペレーティングシステムの種類についての配慮が完全でない場合）。

メモ : Windows では、タスクバーのシステムトレイ領域は正式には通知領域と呼ばれています。

関連項目

最後のマウス入力またはキーボード入力からの経過時間 (秒単位) です。

関連項目

このアプリケーションをアクティブ化します。

オペレーティングシステムによって決められた一部の環境下では、このメソッドでアプリケーションはアクティブになりません。ほとんどのオペレーティングシステムは、アプリケーション自体でアクティブになる機能を制限することにより、誤った操作や悪意のある操作によってユーザーが他のアプリケーションを使用できなくなることを防止しています。

オペレーティングシステムでアクティブ化が許可されている場合は、指定したウィンドウがアクティブになり、デスクトップのフォアグラウンド、つまり他のアプリケーションのウィンドウよりも手前に表示されます(window パラメータが null の場合、このアプリケーションの可視状態のウィンドウが選択されます)。

アプリケーションに表示ウィンドウがない場合、activate() メソッドは無効です。

アクティブ化の処理は同期的に実行されます。

パラメータ

イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。イベントリスナーは、特定のタイプのイベント、段階、および優先度に関する表示リスト内のすべてのノードに登録できます。

イベントリスナーが正常に登録された後に、addEventListener() () をさらに呼び出して優先度を変更することはできません。リスナーの優先度を変更するには、最初に removeListener() () を呼び出す必要があります。その後、同じリスナーを新しい優先度レベルで再度登録できます。

リスナーが登録された後に、addEventListener()（type または useCapture に別の値を設定）を再度呼び出すと、別のリスナー登録が作成されることに注意してください。たとえば、最初にリスナーを登録するときに useCapture を true に設定すると、そのリスナーはキャプチャ段階のみでリスニングします。同じリスナーオブジェクトを使用して再度 addEventListener() を呼び出すと（このとき、useCapture を false に設定）、異なる 2 つのリスナーが登録されます。1 つはキャプチャ段階でリスニングするリスナーで、もう 1 つはターゲット段階とバブリング段階でリスニングするリスナーです。

ターゲット段階またはバブリング段階のみを対象とするイベントリスナーを登録することはできません。登録時にこれらの段階が組み合わされるのは、バブリングはターゲットノードの祖先にしか適用されないためです。

イベントリスナーが不要になった場合は、removeEventListener() を呼び出して、イベントリスナーを削除します。削除しない場合、メモリの問題が発生する可能性があります。ガベージコレクターは参照を有するオブジェクトを削除しないため、登録されているイベントリスナーに関係したオブジェクトはメモリから自動的に除去されません。

EventDispatcher インスタンスをコピーしても、それに関連付けられているイベントリスナーはコピーされません。新しく作成したノードにイベントリスナーが必要な場合は、ノードを作成した後に、リスナーを関連付ける必要があります。ただし、EventDispatcher インスタンスを移動した場合は、関連付けられているイベントリスナーも一緒に移動されます。

イベントがノードで処理されるときに、イベントリスナーがそのノードに登録中であれば、イベントリスナーは現在の段階ではトリガされません。ただし、バブリング段階など、イベントフローの後の段階でトリガすることができます。

イベントがノードで処理されているときにイベントリスナーがノードから削除された場合でも、イベントは現在のアクションによってトリガされます。削除された後は、その後の処理で再び登録されない限り、イベントリスナーは二度と呼び出されません。

パラメータ

function(evt:Event):void

フォーカスがある表示オブジェクトで内部 delete コマンドを起動します。

この関数呼び出しは、フォーカスがあるオブジェクトがコマンドを実装しない場合には無視されます。現在このコマンドを実装しているのは、TextField クラスまたは HTMLLoader クラスの下位にある表示オブジェクトのみです。

メモ：clear() コマンドは、選択したテキストを削除します。何も選択されていない場合、すべてのテキストがクリアされるわけではありません。

フォーカスがある表示オブジェクトで内部 copy コマンドを起動します。

この関数呼び出しは、コンポーネントがコマンドを実装していない場合、無視されます。現在このコマンドを実装しているのは、TextField クラスまたは HTMLLoader クラスの下位にある表示オブジェクトのみです。

フォーカスがある表示オブジェクトで内部 cut コマンドを起動します。

この関数呼び出しは、コンポーネントがコマンドを実装していない場合、無視されます。現在このコマンドを実装しているのは、TextField クラスまたは HTMLLoader クラスの下位にある表示オブジェクトのみです。

イベントをイベントフローに送出します。イベントターゲットは EventDispatcher オブジェクトです。これに対して dispatchEvent() メソッドが呼び出されます。

パラメータ

このアプリケーションを終了します。

exit() メソッドの呼び出しによって返されます。現在実行中のコード（現在のイベントハンドラなど）が完了するまで、シャットダウンシーケンスは開始されません。 保留中の非同期操作はキャンセルされ、操作が完了しない場合もあります。

exiting イベントは送出されません。アプリケーションのロジックで exiting イベントが必要な場合は、NativeApplication.nativeApplication.dispatchEvent() を呼び出し、タイプが exiting の Event オブジェクトを渡します。同様に、アプリケーションウィンドウが閉じるまで closing イベントおよび close イベントは送出されません。アプリケーションを終了する前にウィンドウに通知する必要がある場合は、開いている各ウィンドウに対して closing イベントを送出します。ウィンドウの close イベントが必要な場合は、終了する前にウィンドウの close() メソッドを呼び出します。

パラメータ

指定された拡張子を持つ開始ファイル用のデフォルトのアプリケーションを取得します。

注意：このメソッドは、アプリケーション記述子の fileTypes ステートメントに宣言されたファイルタイプでのみ使用できます。

パラメータ

関連項目

現在このアプリケーションが、指定された拡張子を持つ開始ファイル用のデフォルトのアプリケーションかどうかを指定します。

パラメータ

関連項目

フォーカスがある表示オブジェクトで内部 paste コマンドを起動します。

この関数呼び出しは、コンポーネントがコマンドを実装していない場合、無視されます。現在このコマンドを実装しているのは、TextField クラスまたは HTMLLoader クラスの下位にある表示オブジェクトのみです。

このアプリケーションを、指定された拡張子を持つ開始ファイルに対するデフォルト指定から解除します。

注意：このメソッドは、アプリケーション記述子の fileTypes ステートメントに示されたファイルタイプでのみ使用できます。

パラメータ

関連項目

EventDispatcher オブジェクトからリスナーを削除します。対応するリスナーが EventDispatcher オブジェクトに登録されていない場合は、このメソッドを呼び出しても効果はありません。

パラメータ

フォーカスがある表示オブジェクトで内部 selectAll コマンドを起動します。

この関数呼び出しは、コンポーネントがコマンドを実装していない場合、無視されます。現在このコマンドを実装しているのは、TextField クラスまたは HTMLLoader クラスの下位にある表示オブジェクトのみです。

このアプリケーションを、指定された拡張子を持つ開始ファイル用のデフォルトのアプリケーションとして設定します。

注意：このメソッドは、アプリケーション記述子の fileTypes ステートメントに宣言されたファイルタイプでのみ使用できます。

パラメータ

関連項目

このアプリケーションがアクティブデスクトップアプリケーションになると送出されます。

注意：このイベントには「キャプチャ段階」と「バブリング段階」はありません。したがって、ターゲットが表示リストにあるかないかに関わらず、潜在的なターゲットにはイベントリスナーを直接追加する必要があります。

このイベントには、次のプロパティがあります。

ユーザーのブラウザで実行する SWF ファイルによってアプリケーションが起動された場合に送出されます。

ブラウザ呼び出しが許可されるのは、アプリケーション記述ファイルで次のように指定されている場合のみです。

<allowBrowserInvocation>true</allowBrowserInvocation>

デスクトップのフォーカスが別のアプリケーションに切り替わると送出されます。

注意：このイベントには「キャプチャ段階」と「バブリング段階」はありません。したがって、ターゲットが表示リストにあるかないかに関わらず、潜在的なターゲットにはイベントリスナーを直接追加する必要があります。

このイベントには、次のプロパティがあります。

アプリケーションの終了シーケンスが開始されると送出されます。

例えば、ユーザーが Mac OS X で Cmd-Q キーシーケンスを発行したり、NativeApplication オブジェクトの autoExit プロパティが true であるときに最後のアプリケーションウィンドウを閉じたりした場合に、オペレーティングシステムによってアプリケーションの終了が開始されると終了イベントが送出されます。このイベントをキャンセルすると、アプリケーションは終了しません。

メモ：NativeApplication の exit() メソッドを呼び出しても、exiting イベントは送出されません。間もなくコンポーネントを終了することを警告する場合は、exiting イベントを送出した後で exit() () を呼び出します。

このイベントには、次のプロパティがあります。

アプリケーションが起動されたときに送出されます。

1 つのアプリケーションを 2 回起動しても、そのアプリケーションの別のインスタンスは起動しません。代わりに、最初のインスタンスが追加の invoke イベントを受け取ります。アプリケーションで後続の invoke イベントを適切に処理する必要があります。

注意：invoke イベントはすべてキューに置かれます。このイベントのリスナーは、登録されると、新しいイベントおよびキュー内のすべてのイベントを受け取ります。キューに置かれたイベントは、新しい invoke イベントの前または後に配信されます。

InvokeEvent オブジェクトには、次のプロパティがあります。

新しいネットワーク接続が使用可能になるか、既存のネットワーク接続が失われると送出されます。

networkChange イベントは、ホストコンピュータがオンラインまたはオフラインになったことを示しているとは限りません。接続がある種類から別の種類に移行したことを示している場合もあります。アプリケーションはこのイベントを使用して、リモートリソースの可用性を監視するタスクを最適化できます。networkChange イベントが送出されたときに、リモートリソースの可用性を確認することをお勧めします。

メモ : ネットワークに変更が発生してからこのイベントが送出されるまでに少し時間がかかることがあります。

このイベントには、次のプロパティがあります。

idleThreshold プロパティに指定された期間にわたってユーザーのアイドル状態が継続したときに送出されます。

ユーザーがアイドル状態になってからの経過時間は、timeSinceLastUserInput プロパティで判断できます。

このイベントには、次のプロパティがあります。

関連項目

アイドル期間の後にオペレーティングシステムがマウスまたはキーボードの操作を検出すると送出されます。

idleThreshold プロパティを使用すると、アイドル状態にあると見なす時間の長さを設定できます。ユーザーがアイドル状態になってからの経過時間は、timeSinceLastUserInput プロパティで判断できます。

このイベントには、次のプロパティがあります。

関連項目