NativeApplication  - AS3

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

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

このプロパティは、NativeWindow クラスをサポートしていないプラットフォームでは無効です。

この 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() を呼び出してアプリケーションを終了する必要があります。

このプロパティは、NativeWindow クラスをサポートしていないプラットフォームでは無効です。

アプリケーションをバックグラウンドで実行するかどうかを指定します。

executeInBackground が false の場合（デフォルト）、アプリケーションが中断状態のままバックグラウンドに切り替わります。executeInBackground が true の場合は、アプリケーションをバックグラウンドで実行できます。

注意：swf バージョン 21 以前では、レンダリングモードがダイレクトに設定されている場合、AIR は iOS と Android でのバックグラウンドでの実行をサポートしません。この制約から、Stage3D ベースのアプリでは、オーディオ再生、位置の更新、ネットワークアップロードまたはダウンロードなどのバックグラウンドタスクを実行できません。iOS ではバックグラウンドで OpenGLES またはレンダリングを呼び出すことはできません。バックグラウンドで OpenGL を呼び出そうとしたアプリケーションは、iOS によって終了されます。Android では、バックグラウンドでの OpenGLES の呼び出し、またはその他のバックグラウンドタスク（オーディオ再生など）の実行について、アプリケーションへの制約はありません。swf バージョン 22 以降では、レンダリングモードがダイレクトに設定されている場合、AIR モバイルアプリケーションはバックグラウンドで実行できます。OpenGLES の呼び出しがバックグラウンドで実行されると、AIR iOS ランタイムでは ActionScript エラー（3768 - バックグラウンドでの実行中、Stage3D API は使用できません）が発生します。ただし、Android ではネイティブアプリケーションがバックグラウンドで OpenGLES を呼び出すことが可能なので、エラーは発生しません。モバイルリソースを最適に利用するため、アプリケーションがバックグラウンドで実行されている間はレンダリングの呼び出しを行わないでください。

このプロパティは AIR iOS と Android でサポートされています。

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

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

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

関連する API エレメント

ユーザー入力が行われなくなってから userIdle イベントを送出するまでの秒数です。

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

関連する API エレメント

アプリケーションが目的のプラットフォーム用にコンパイルまたは解釈されているかどうかを示します。この API は、ターゲットとなる iOS（ipa-app-store、ipa-test、ipa-debug、ipa-ad-hoc）の場合のみ（true）を返します。その他の AIR プラットフォームの場合は（false）を返します。

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

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

AIR プロファイルのサポート：この機能はモバイルデバイスまたは AIR for TV デバイスではサポートされません。複数のプロファイル間での API サポートについて詳しくは、AIR プロファイルのサポートを参照してください。

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

関連する API エレメント

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

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

このプロパティは、NativeWindow クラスをサポートしていないプラットフォームでは無効です。

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

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

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

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

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

AIR プロファイルのサポート：この機能はすべてのデスクトップオペレーティングシステムでサポートされますが、モバイルデバイスまたは AIR for TV デバイスではサポートされません。NativeApplication.supportsStartAtLogin プロパティを使用して、サポートされているかどうかを実行時にテストすることができます。複数のプロファイル間での API サポートについて詳しくは、AIR プロファイルのサポートを参照してください。

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

関連する API エレメント

setAsDefaultApplication()、removeAsDefaultApplication()、isSetAsDefaultApplication() が現在のプラットフォームでサポートされているかどうかを示します。

true の場合、これらのメソッドは、説明のとおりに機能します。false の場合、setAsDefaultApplication() およびremoveDefaultApplication() は何もしません。isSetAsDefaultApplication() は false を返します。

関連する API エレメント

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

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

Mac OS X ユーザーインターフェイスには、実行中または頻繁に使用されるアプリケーションのアイコンが入っているアプリケーション「ドック」が用意されています。

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

関連する API エレメント

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

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

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

関連する API エレメント

現在のプラットフォームで、startAtLogin がサポートされているかどうかを示します。

true の場合、startAtLogin は説明どおりに機能します。false の場合、startAtLogin には効果はありません。

関連する API エレメント

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

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

Windows ユーザーインターフェイスには、タスクバーの「システムトレイ」領域が用意されています。正式には「通知領域」と呼ばれ、この領域にアプリケーションアイコンが表示されます。表示されるデフォルトのアイコンはありません。アイコンを表示するには、icon オブジェクトの bitmaps 配列を設定する必要があります。

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

関連する API エレメント

ユーザーインターフェイスが「アイドル」モードに入るのを妨げる手段をアプリケーションに提供します。

SystemIdleMode クラスの値です。ホストシステムのアイドルモード動作に影響します。このプロパティは、入力フォーカスのあるアプリケーションにのみ影響し、アプリケーションサンドボックス内で実行されるコンテンツからのみアクセスできます。

AIR プロファイルのサポート：この機能はモバイルデバイスでサポートされますが、デスクトップオペレーティングシステムまたは AIR for TV デバイスではサポートされません。複数のプロファイル間での API サポートについて詳しくは、AIR プロファイルのサポートを参照してください。

関連する API エレメント

最後のユーザー入力が行われてからの時間（秒）を示します。

関連する API エレメント

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

このメソッドは、NativeWindow クラスをサポートしていないプラットフォームでは無効です。

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

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

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

アクティブ化操作は、同期的です。

パラメーター

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

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

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

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

イベントリスナーが不要になった場合は、removeEventListener() を呼び出して、イベントリスナーを削除します。削除しない場合、メモリの問題が発生する可能性があります。ガベージコレクションでは、オブジェクトの送出が行われている限り、リスナーを削除しないので、イベントリスナーは自動的には削除されません（useWeakReference パラメーターが true に設定されていない場合）。

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 オブジェクトを渡します。開いているウィンドウに対して、NativeWindow オブジェクトは closing イベントと close イベントを送出します。closing イベントオブジェクトの preventDefault() メソッドを呼び出すと、アプリケーションが終了できなくなります。

注意：このメソッドは iOS オペレーティングシステムでサポートされていません。

パラメーター

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

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

このメソッドは AIR for TV デバイスでは使用できません。アプリケーション記述子で宣言したファイルタイプを指定して呼び出すと、null が返されます。

パラメーター

関連する API エレメント

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

AIR プロファイルのサポート：この機能はすべてのデスクトップオペレーティングシステムでサポートされますが、モバイルデバイスまたは AIR for TV デバイスではサポートされません。NativeApplication.supportsDefaultApplication プロパティを使用して、サポートされているかどうかを実行時にテストすることができます。複数のプロファイル間での API サポートについて詳しくは、AIR プロファイルのサポートを参照してください。

パラメーター

関連する API エレメント

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

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

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

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

パラメーター

関連する API エレメント

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

パラメーター

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

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

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

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

パラメーター

関連する API エレメント

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

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

AIR for TV デバイスでは、このイベントが自動的に送出されることはありません。手動での送出は可能です。

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

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

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

<allowBrowserInvocation>true</allowBrowserInvocation>

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

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

AIR for TV デバイスでは、このイベントが自動的に送出されることはありません。手動での送出は可能です。

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

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

オペレーティングシステムによってアプリケーションの終了が開始されると、exiting イベントが送出されます。例えば、Command+Q キーが押された場合や（Mac OS X）、NativeApplication オブジェクトの autoExit プロパティが true に設定されているとき最後のアプリケーションウィンドウが閉じられた場合などがこれに該当します。このイベントをキャンセルすると、アプリケーションは終了しません。

AIR for TV デバイスでは、exiting イベントが送出されることはありません。

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

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

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

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

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

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

ユーザーがキーを押したときに送出されます。NativeApplication インスタンスは、キーボードアクセラレーターをサポートするためにこのイベントを提供します。このキーボードイベントは最初に NativeApplication に送出されます。このイベントをキャンセルすると、NativeWindow メニューアクセラレーターもキャンセルされます。このイベントは、keyUp イベントの前に発生します。

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

関連する API エレメント

ユーザーがキーを離したときに送出されます。NativeApplication インスタンスは、キーボードアクセラレーターをサポートするためにこのイベントを提供します。このキーボードイベントは最初に NativeApplication に送出されます。このイベントをキャンセルしても、他のオブジェクト（NativeWindow メニューアクセラレーターなど）には何の影響もありません。このイベントは、keyDown イベントの後に発生します。

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

関連する API エレメント

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

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

注意：

• ネットワークに変更が発生してからこのイベントが送出されるまでに少し時間がかかることがあります。
• Android では、ネットワーク接続に変化があるたびに、NativeApplication オブジェクトから複数の networkChange イベントが送出されます。

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

アプリケーションがオペレーティングシステムによって中断される直前に送出されます。

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

ユーザーがアイドル状態になっているときに送出されます。

idleThreshold プロパティを使用してこのイベントが送出される前に、ユーザーをアイドル状態にする必要がある期間を指定します。ユーザーがアイドル状態になってからの経過時間は、timeSinceLastUserInput プロパティで判断できます。

注意：このイベントはモバイルデバイスまたは AIR for TV デバイスでは送出されません。

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

関連する API エレメント

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

注意：このイベントはモバイルデバイスまたは AIR for TV デバイスでは送出されません。

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

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

関連する API エレメント