NativeProcess クラスとその機能は、ネイティブインストーラー(拡張デスクトッププロファイルアプリケーション)を使用してインストールされた AIR アプリケーションでのみ使用できます。デバッグ時に、ADL に対して
AIR プロファイルのサポート:この機能は、ネイティブインストーラーを使用してデスクトップオペレーティングシステムにデプロイされたアプリケーションでサポートされます。この機能はモバイルデバイスまたはテレビ用 AIR デバイスではサポートされません。
ネイティブインストーラー(拡張デスクトッププロファイルアプリケーション)を使用してインストールされた AIR アプリケーションでは、
注意:
#!/usr/bin/python # ------------------------------------------------------------------------------ # Sample Python script # ------------------------------------------------------------------------------ import sys for word in sys.argv: #echo the command line arguments print word print "HI FROM PYTHON" print "Enter user name" line = sys.stdin.readline() sys.stdout.write("hello," + line)
NativeProcess が正常に終了すると、
基礎となるオペレーティングシステム上の単一プロセスに対応する NativeProcess インスタンスです。同じオペレーティングシステムプロセスの複数のインスタンスを同時に実行する場合は、子プロセスごとに NativeProcess インスタンスを作成します。
NativeProcess オブジェクトの
NativeProcess クラスとその機能は、ネイティブインストーラーを使用してインストールされた AIR アプリケーションでのみ使用できます。デバッグ時に、ADL に対して
セキュリティに関する重要な考慮事項:
ネイティブプロセス API は、ユーザーのシステム上で任意の実行可能ファイルを実行できます。コマンドの構築時および実行時には、十分に注意を払ってください。実行されるコマンドが一部でも外部ソースから発行されている場合には、そのコマンドを実行しても安全であるかどうかを慎重に検証してください。同様に、AIR アプリケーションは、実行中のプロセスに渡されるデータを検証する必要があります。
ただし、入力を検証することは難しい場合があります。このような問題を回避するには、特定の API を含むネイティブアプリケーション(Windows 上の EXE ファイルなど)を作成することが最適です。これらの API は、AIR アプリケーションによって明示的に要求される場合にのみこれらのコマンドを処理します。例えば、ネイティブアプリケーションは、標準入力ストリームを通じて、限定された命令セットのみを受け付ける場合があります。
Windows 上の AIR は、ユーザーが .bat ファイルを直接実行することを許可しません。Windows .bat ファイルは、コマンドインタープリターアプリケーション(cmd.exe)によって実行されます。.bat ファイルを呼び出すとき、このコマンドアプリケーションは、コマンドに渡される引数を、起動する追加のアプリケーションとして解釈することができます。引数のストリングに悪質な意図で不要な文字が挿入されている場合、有害または安全ではないアプリケーションを cmd.exe が実行するおそれがあります。例えば、妥当なデータ検証が行われない場合、AIR アプリケーションが
.bat ファイルで
子プロセスの出力ストリームであっても、現在のプロセスから見れば入力データになるので、タイプは IDataInput です。
子プロセスの入力ストリームであっても、現在のプロセスから見れば出力データになるので、タイプは IDataOutput です。
子プロセスの出力ストリームであっても、現在のプロセスから見れば入力データになるので、タイプは IDataInput です。
アプリケーションアイコンのインスタンスを取得するには、NativeApplication オブジェクトの
InteractiveIcon クラスを直接インスタンス化することはできません。
指定されたオペレーティングシステムのコンテキストでアイコンを表示する場合、表示するサイズに最も近い配列のビットマップが使用されます(必要に応じて伸縮)。一般的なサイズには、16x16、32x32、48x48 および 128x128 があります (512x512 ピクセルのアイコンは、近い将来にいくつかのオペレーティングシステムアイコンで使用される可能性があります)。
一部のコンテキストでは、
アイコンの外観を設定または変更するには、BitmapData オブジェクトの配列を
アイコンイメージを消去するには、
注意:アイコン用のイメージファイルを読み込む場合、通常、最も適切なアルファブレンドが提供されるのは PNG ファイル形式です。GIF 形式は透明度のオンまたはオフのみをサポートし、ブレンドは行いません。JPG 形式は、透明度をまったくサポートしません。
一部のアイコンのコンテキストでは、動的なサイズ調整がサポートされます。
一部のアイコンのコンテキストでは、動的なサイズ調整がサポートされます。
NativeDragActions 定数は、NativeDragManager クラスおよび NativeDragEvent クラスの
NativeApplication クラスは、アプリケーション情報とアプリケーション全体の関数を提供し、アプリケーションレベルのイベントを送出します。
NativeApplication オブジェクトは、起動時に自動的に作成されるシングルトンオブジェクトです。静的な
注意:このイベントはモバイルデバイスまたはテレビ用 AIR デバイスでは送出されません。
注意:このイベントはモバイルデバイスまたはテレビ用 AIR デバイスでは送出されません。
注意:
オペレーティングシステムによってアプリケーションの終了が開始されると、
テレビ用 AIR デバイスでは、
注意:NativeApplication の
ブラウザー呼び出しが許可されるのは、アプリケーション記述ファイルで次のように指定されている場合のみです。
1 つのアプリケーションを 2 回起動しても、そのアプリケーションの別のインスタンスは起動しません。代わりに、最初のインスタンスが追加の invoke イベントを受け取ります。アプリケーションで後続の
注意:
このメソッドは、NativeWindow クラスをサポートしていないプラットフォームでは無効です。
オペレーティングシステムによって決められた一部の環境下では、このメソッドでアプリケーションはアクティブになりません。ほとんどのオペレーティングシステムでは、アプリケーション自体でアクティブになる機能を制限することにより、誤った操作や悪意のある操作によってユーザーが他のアプリケーションを使用できなくなることを防止しています。
オペレーティングシステムでアクティブ化が許可されている場合は、指定したウィンドウがアクティブになり、デスクトップのフォアグラウンド、つまり他のアプリケーションのウィンドウよりも手前に表示されます(
アプリケーションに表示ウィンドウがない場合、
アクティブ化操作は、同期的です。
関数の名前は任意に付けられます。
クラスレベルメンバー関数はガベージコレクションの対象外であるため、クラスレベルメンバー関数の
イベントリスナーが正常に登録された後に、
リスナーが登録された後に、
ターゲット段階またはバブリング段階のみを対象とするイベントリスナーを登録することはできません。登録時にこれらの段階が組み合わされるのは、バブリングはターゲットノードの祖先にしか適用されないためです。
イベントリスナーが不要になった場合は、
EventDispatcher インスタンスをコピーしても、それに関連付けられているイベントリスナーはコピーされません。新しく作成したノードにイベントリスナーが必要な場合は、ノードを作成した後に、リスナーを関連付ける必要があります。ただし、EventDispatcher インスタンスを移動した場合は、関連付けられているイベントリスナーも一緒に移動されます。
イベントがノードで処理されるときに、イベントリスナーがそのノードに登録中であれば、イベントリスナーは現在の段階ではトリガーされません。ただし、バブリング段階など、イベントフローの後の段階でトリガーすることができます。
イベントがノードで処理されているときにイベントリスナーがノードから削除された場合でも、イベントは現在のアクションによってトリガーされます。削除された後は、その後の処理で再び登録されない限り、イベントリスナーは二度と呼び出されません。
この関数呼び出しは、フォーカスがあるオブジェクトがコマンドを実装しない場合には無視されます。現在このコマンドを実装しているのは、TextField クラスまたは HTMLLoader クラスの下位にある表示コマンドのみです。
注意:
この関数呼び出しは、コンポーネントがコマンドを実装しない場合には無視されます。現在このコマンドを実装しているのは、TextField クラスまたは HTMLLoader クラスの下位にある表示コマンドのみです。
この関数呼び出しは、コンポーネントがコマンドを実装しない場合には無視されます。現在このコマンドを実装しているのは、TextField クラスまたは HTMLLoader クラスの下位にある表示コマンドのみです。
注意:このメソッドは iOS オペレーティングシステムでサポートされていません。
注意:このメソッドは、アプリケーション記述子の
このメソッドはテレビ用 AIR デバイスでは使用できません。アプリケーション記述子で宣言したファイルタイプを指定して呼び出すと、
AIR プロファイルのサポート:この機能はすべてのデスクトップオペレーティングシステムでサポートされますが、モバイルデバイスまたはテレビ用 AIR デバイスではサポートされません。
この関数呼び出しは、コンポーネントがコマンドを実装しない場合には無視されます。現在このコマンドを実装しているのは、TextField クラスまたは HTMLLoader クラスの下位にある表示コマンドのみです。
注意:このメソッドは、アプリケーション記述子の
この関数呼び出しは、コンポーネントがコマンドを実装しない場合には無視されます。現在このコマンドを実装しているのは、TextField クラスまたは HTMLLoader クラスの下位にある表示コマンドのみです。
注意:このメソッドは、アプリケーション記述子の
アクティブなデスクトップウィンドウがこのアプリケーションに属していない場合、またはアクティブなウィンドウがない場合、
このプロパティは、NativeWindow クラスをサポートしていないプラットフォームでは無効です。
この ID の値は、アプリケーション記述ファイルに設定されます。
このプロパティは、NativeWindow クラスをサポートしていないプラットフォームでは無効です。
デフォルトでは、アイドル時間のしきい値は 300 秒(5 分)に設定されています。許容される値の範囲は、5(5 秒)以上 86,400(1 日)以下です。
アプリケーションメニューは、
AIR プロファイルのサポート:この機能はモバイルデバイスまたはテレビ用 AIR デバイスではサポートされません。複数のプロファイル間での API サポートについて詳しくは、
注意:Mac OS X の場合、
このプロパティは、NativeWindow クラスをサポートしていないプラットフォームでは無効です。
この ID の値は、アプリケーションの発行者 ID ファイルに設定されます。このファイルは、インストール時に、アプリケーションの署名に使用される証明書チェーンから生成されます。
AIR プロファイルのサポート:この機能はすべてのデスクトップオペレーティングシステムでサポートされますが、モバイルデバイスまたはテレビ用 AIR デバイスではサポートされません。
Mac OS X ユーザーインターフェイスには、実行中または頻繁に使用されるアプリケーションのアイコンが入っているアプリケーション「ドック」が用意されています。
使用しているオペレーティングシステムでアプリケーションのドックアイコンがサポートされているか確認するには、必ず
使用しているオペレーティングシステムでアプリケーションメニューバーがサポートされているか確認するには、必ず
Windows ユーザーインターフェイスには、タスクバーの「システムトレイ」領域が用意されています。正式には「通知領域」と呼ばれ、この領域にアプリケーションアイコンが表示されます。表示されるデフォルトのアイコンはありません。アイコンを表示するには、icon オブジェクトの
使用しているオペレーティングシステムでシステムトレイアイコンがサポートされているか確認するには、必ず
SystemIdleMode クラスの値です。ホストシステムのアイドルモード動作に影響します。このプロパティは、入力フォーカスのあるアプリケーションにのみ影響し、アプリケーションサンドボックス内で実行されるコンテンツからのみアクセスできます。
AIR プロファイルのサポート:この機能はモバイルデバイスでサポートされますが、デスクトップオペレーティングシステムまたはテレビ用 AIR デバイスではサポートされません。複数のプロファイル間での API サポートについて詳しくは、
Updater クラスは、デスクトッププロファイルでのみサポートされます。拡張デスクトップアプリケーション(ネイティブインストーラーによってインストールされるアプリケーション)ではサポートされません。また、AIR モバイルプロファイルまたは AIR for TV プロファイルではサポートされません。
拡張デスクトップアプリケーション(ネイティブインストーラーでインストールされたアプリケーション)は、新しいバージョンのネイティブインストーラーをダウンロードし、
このメソッドを呼び出すと、(
更新処理は更新が成功したかどうかにかかわらずアプリケーションを再起動します。更新は、ユーザーがアプリケーションをインストールする十分な権限を持っていないといったアプリケーションが制御できないなどのさまざまな理由で失敗する可能性があります。アプリケーションでは、失敗を検出し、同じ失敗の更新を繰り返し行わないようにする必要があります。失敗の結果として発生する無限ループは、アプリケーションを事実上無効にすることになります。更新が成功したことを確認する 1 つの方法として、更新を開始する前に現在のバージョン番号をファイルに書き込み、その後、アプリケーションが再起動されるときにそのバージョン番号と比較することがあります。
AIR Debug Launcher(ADL)アプリケーションを使用してアプリケーションをテストしているときに、
Mac OS の場合、アプリケーションの更新されたバージョンをインストールするには、適切なシステム権限を持ってアプリケーションディレクトリにインストールする必要があります。Windows または Linux の場合、管理権限を持っている必要があります。
アプリケーションの更新されたバージョンがランタイムの更新されたバージョンを必要とする場合、新しいランタイムバージョンがインストールされます。ランタイムを更新するには、コンピューターの管理権限を持っている必要があります。
注意:セキュリティ上の理由から、
AIR プロファイルのサポート:この機能はデスクトップオペレーティングシステムでサポートされますが、モバイルデバイスまたはテレビ用 AIR デバイスではサポートされません。複数のプロファイル間での API サポートについて詳しくは、
デスクトップオペレーティングシステムの種類によっては、システムトレイアイコンがないこともあります。現在のシステムでシステムトレイアイコンがサポートされているかどうかを確認するには、
SystemTrayIcon クラスのインスタンスは作成できません。"グローバルな" NativeApplication オブジェクトの
システムトレイアイコンがサポートされている場合は、icon プロパティのタイプが SystemTrayIcon に設定されています。サポートされていない場合、
重要:AIR がシステムトレイアイコンをサポートしていないオペレーティングシステムで
指定されたオペレーティングシステムのコンテキストでアイコンを表示する場合、表示するサイズに最も近い配列のビットマップが使用されます(必要に応じて伸縮)。一般的なサイズには、16x16、32x32、48x48 および 128x128 があります (512x512 ピクセルのアイコンは、近い将来にいくつかのオペレーティングシステムアイコンで使用される可能性があります)。
一部のコンテキストでは、
アイコンの外観を設定または変更するには、BitmapData オブジェクトの配列を
アイコンイメージを消去するには、
注意:アイコン用のイメージファイルを読み込む場合、通常、最も適切なアルファブレンドが提供されるのは PNG ファイル形式です。GIF 形式は透明度のオンまたはオフのみをサポートし、ブレンドは行いません。JPG 形式は、透明度をまったくサポートしません。
一部のアイコンのコンテキストでは、動的なサイズ調整がサポートされます。
一部のアイコンのコンテキストでは、動的なサイズ調整がサポートされます。
Clipboard オブジェクトには、同じ情報を複数の形式で格納できます。情報を複数の形式で提供することにより、別のアプリケーションでその情報を使用できる可能性が高くなります。
標準形式は次のとおりです。
ClipboardFormats クラスに標準形式の名前のこれらの定数が定義されます。
オペレーティングシステムとの間で転送が行われると、
アプリケーションで定義された形式を使用して、
転送する情報を特定の形式に変換するための計算の負荷が大きい場合は、変換を実行する関数の名前を指定できます。この関数は、特定の形式が受信側のコンポーネントまたはアプリケーションによって読み取られた場合にのみ呼び出されます。
AIR アプリケーションに関する注意:HTML のドラッグ&ドロップイベントおよびコピー&ペーストイベントに対して送出されるイベントオブジェクトによって参照されるクリップボードオブジェクトは、AIR Clipboard オブジェクトと同じタイプではありません。JavaScript クリップボードオブジェクトについては、AIR 開発者ガイドを参照してください。
Flash Player アプリケーションに関する注意:Flash Player 10 では、クリップボードからのペースト操作には最初に「ペースト」コマンドに対応するショートカットキーを押すかコンテキストメニューの「ペースト」コマンドをマウスでクリックするなどのユーザーイベントが必要です。
Linux の場合、クリップボードのデータは AIR アプリケーションが終了すると失われます。
注意:クリップボードのデータアクセスに対するセキュリティ上の制限により、この例は Flash Player では機能しません。Flash Player の場合、
Clipboard オブジェクトを作成し、Adobe AIR でのネイティブなドラッグ&ドロップジェスチャのデータを保持します。Clipboard オブジェクトは 1 つのドラッグ&ドロップジェスチャにのみ使用できます。再利用することはできません。
コピー&ペースト操作用に Clipboard オブジェクトを作成しないでください。代わりに単一の
注意:オペレーティングシステムのクリップボードを使用するコピー & ペースト操作に対しては、新しいクリップボードを作成する代わりに
Flash Playerでは、
標準のデータ形式にアクセスすると、対応する Flash データタイプの新しいオブジェクトとしてデータが返されます。
アプリケーションで定義された形式にアクセスする場合、
ClipboardFormats クラスの定数を使用して、標準の形式名を参照します。
ハンドラー関数を使用して、実際にデータにアクセスするまで、データの作成またはレンダリングを遅らせます。
ハンドラー関数は、指定された形式に適合するデータ型を返す必要があります。
指定された形式のデータを読み取る場合にのみ、ハンドラー関数が呼び出されます。場合によっては、ドロップ操作が行われる前に、オペレーティングシステムが関数を呼び出すことがあります。例えば、ハンドラー関数を使用して、AIR アプリケーションからファイルシステムにドラッグされたファイルのデータを提供する場合、オペレーティングシステムでは、ドラッグジェスチャが AIR アプリケーションを離れるとすぐに、データハンドラー関数を呼び出します。その結果、通常はファイルデータのダウンロード中または作成中に、予期せず停止する場合があります。この目的では、URLFilePromise を代わりに使用できます。
基になるデータは、アプリケーションでそのデータを保護する手順を実行しない場合、ハンドラーを追加した時点からデータを読み取る時点までの間変更できます。ハンドラー関数によって表されるクリップボード上のデータが複数回読み取られた場合の動作は保証されません。クリップボードからは、最初の関数呼び出しによって作成されたデータが返される場合もあれば、関数が再度呼び出される場合もあります。いずれの動作にも依存しないでください。
Adobe AIR のアプリケーションサンドボックスでは、いつでも
この Clipboard オブジェクトにデータを直接追加するには、代わりに
注意:Mac OS で
Adobe AIR のアプリケーションサンドボックスでは、いつでも
同じ情報の別の表現を、異なる形式でクリップボードに追加できます。これにより、他の多くのコンポーネントまたはアプリケーションでもデータを利用できるようになります。例えば、イメージ編集アプリケーション用のビットマップデータ、URL およびネイティブファイルシステムへの転送用のエンコードされた PNG ファイルとしてイメージを追加できます。
data パラメーターは、指定された形式に適合するデータ型にする必要があります。
カスタムの形式名の先頭を "air:" または "flash:" にすることはできません。カスタムの形式を使用するときに名前が競合するのを避けるために、アプリケーション ID やパッケージ名を接頭辞として使用して、「com.example.applicationName.dataPacket」のような形式にすることができます。
アプリケーション内または AIR アプリケーション間で転送する場合、
注意:標準形式は、サポートされているアプリケーションの外部にデータをペーストまたはドラッグする場合、常にネイティブ形式に変換されます。そのため、
ある形式でのデータのレンダリングを遅らせるには、代わりに
注意:Mac OS で
ClipboardFormats クラスに標準形式の名前のストリング定数が定義されます。この他の、アプリケーションで定義されたストリングは、データをオブジェクトとして転送する場合、形式名として使用することもできます。
システムのクリップボードにペーストされたデータは、他のアプリケーションからも利用できます。それには Web ブラウザー内で実行される保護されていないリモートコードも含まれます。
注意:Flash Player 10 アプリケーションでは、クリップボードからのペースト操作には最初に「ペースト」コマンドに対応するショートカットキーを押すかコンテキストメニューの「ペースト」コマンドをマウスでクリックするなどのユーザーイベントが必要です。
クリップボードは、新しいデータを書き込む前に必ずクリアして、すべての形式の古いデータを確実に消去する必要があります。
ファイルプロミスはドラッグ&ドロップクリップボード形式です。これにより、ユーザーは、まだ存在しないファイルを AIR アプリケーションからドラッグできます。AIR は、IFilePromise インターフェイスで定義されたメソッドおよびプロパティを使用して、ファイルプロミスがドロップされたときに書き込まれるデータにアクセスします。
ファイルプロミスが適切なターゲットにドロップされると、AIR は IFilePromise の
ByteArray などを使用して、データプロバイダーからのデータに同期的にアクセスする場合、AIR は IDataInput の
Socket などを使用して、データプロバイダーからのデータに非同期的にアクセスする場合、AIR はプロバイダーが送出したイベントを使用し、データの読み取り処理を規制して、データをファイルに書き込みます。データは、complete イベントまたは close イベントを受信するまで、progress イベントごとに読み取られます。実行時に以下のイベントを監視します(ただし、データプロバイダーは必ずしもすべてのイベントを送出する必要はありません)。
カスタムデータプロバイダーのクラスは、データが使用できるようになると、
IFilePromise で定義されたメソッドは、ドラッグ&ドロップ操作の完了後に AIR ランタイムによって呼び出されることを意図しています。通常、開発者がこれらのメソッドをコードから呼び出すことはありません。
注意:air.desktop の URLFilePromise クラスは IFilePromise インターフェイスを実装し、URLStream をデータプロバイダーとして使用します。air.desktop ライブラリは個別の SWF ファイルおよび SWC ファイルとして、AIR SDK に含まれています。
データプロバイダーオブジェクトは、データの読み取りメソッドを定義する IDataInput インターフェイスを実装している必要があります。IFilePromise の
必要なインターフェイスを実装している(または、別のクラスを拡張してインターフェイスを実装する)カスタムクラスのオブジェクトも提供できます。
このプロパティでは、有効なパスを提供する必要があります。パスが有効でないと、ファイルプロミスがドロップされたときに、引数エラーがスローされます。
パスにはサブディレクトリを含めることができ、このサブディレクトリは、ドロップ先に基づいて解決されます。サブディレクトリは必要に応じて作成されます。サブディレクトリを含める場合は、
注意:クライアントコードでパスを設定できるようにするには、署名付きの setter 関数(
ネイティブプロセスには、ネイティブインストーラーを使用してインストールされた AIR アプリケーション(拡張デスクトッププロファイル内のアプリケーション)のみがアクセスできます。
注意:Mac OS で、アプリケーションバンドル内の実行可能ファイルを起動する場合、File オブジェクトのパスには、app ファイルへのパスではなく、(バンドル内の)実行可能ファイルへのフルパスを含むようにしてください。
Android のアプリケーションでは、アプリケーション記述子の DISABLE_KEYGUARD および WAKE_LOCK に Android 権限を指定する必要があります。そうしないと、Android ではこの設定が無視されます。
転送モードでは、クリップボードに格納されているオブジェクトにアクセスするときに、参照またはコピーを返すかどうかについてのヒントが提供されます。
次の種類のデータを転送できます。
注意:すべての NativeDragManager メンバーが静的メンバーです。このクラスのインスタンスを作成する必要はありません。
ドラッグ&ドロップ操作は、ユーザーが表示されたアイテムをクリックして別の場所にドラッグすると開始される、ユーザーインターフェイスのジェスチャです。ドラッグジェスチャを実行している間、AIR アプリケーションウィンドウ内を移動するにつれて、表示リスト上のインタラクティブオブジェクトによってネイティブドラッグイベントが送出されます。これらのイベントのハンドラーで NativeDragManager クラスのメソッドを呼び出すと、ドラッグしたアイテムをオブジェクトにドロップできるかどうかを示すことができます。これに応答してマウスポインターが変わり、ユーザーにフィードバックが提供されます。
AIR プロファイルのサポート:この機能はテレビ用 AIR デバイスではサポートされません。また、すべてのモバイルデバイスでサポートされません。
ドラッグアクション
通常、ドラッグ & ドロップジェスチャは、アクションと呼ばれる 3 種類の操作に使用されます。これらのアクションの意味はアプリケーションのコンテキストに応じて異なるため、ランタイムではアクションに対して特定の動作は適用されません。ただし、アクションを適切に実装すると、アプリケーションに対するユーザーの操作性が向上します。
実行可能なアクションは次のとおりです。
ドロップターゲットが単一のアクションのみを実装している場合、オブジェクトは NativeDragManager の
ドロップを受け入れる場合は、
NativeDragActions クラスにアクション名のストリング定数が定義されます。
イベントの順序
アプリケーション間のジェスチャ
ドラッグジェスチャが AIR 以外のアプリケーションから AIR アプリケーションウィンドウに入った場合、
ドラッグジェスチャが AIR アプリケーションウィンドウの外に移動すると、
ドラッグジェスチャがある AIR アプリケーションから別の AIR アプリケーションに移動すると、開始元オブジェクトとターゲット表示オブジェクトは、それぞれのアプリケーション内で通常と同じイベントを送出します。
情報の転送
ドラッグ & ドロップジェスチャの実行中に転送されるデータは Clipboard オブジェクトに格納されます。このデータオブジェクトは、
セキュリティについての考慮事項
開始元オブジェクトおよびターゲットオブジェクトのセキュリティサンドボックスに応じて、ドラッグされているデータへのアクセス方法が決まります。両方のオブジェクトが同じサンドボックス内にある場合は、すべての NativeDragEvent オブジェクトからデータにアクセスできます。一方、開始元オブジェクトとターゲットオブジェクトが異なるサンドボックス内にある場合、データにアクセスできるのは
このメソッドは、指定されたターゲットオブジェクトに、ドラッグしたアイテムの少なくとも 1 つのデータ形式および少なくとも 1 つの許可されたアクションを処理できる
この機能は、
ドラッグ操作を開始するには
開始元オブジェクトは、このメソッドが呼び出された後に
このメソッドは、
ドラッグアクションは、開始オブジェクトとターゲットオブジェクトをドラッグ&ドロップ操作で連動して処理できるようにする、フィードバックメカニズムの一部です。これらのアクションは、オペレーティングシステムに対する単なるヒントに過ぎません。適切なビヘイビアーの実装は、トランザクションに含まれる、ドラッグの開始元オブジェクトとターゲットオブジェクトが行います。
開始オブジェクトは、そのオブジェクトがサポートするアクションのみを許可します。例えば、開始オブジェクトの内部ロジックで、ターゲットが move アクションでドロップ操作を受け入れてソースデータを削除するように指定されている場合にのみ、そのオブジェクトは move アクションを許可します。
新しい NativeDragOptions オブジェクトでは、すべてのプロパティが
AIR プロファイルのサポート:この機能はすべてのデスクトップオペレーティングシステムでサポートされますが、モバイルデバイスまたはテレビ用 AIR デバイスではサポートされません。
DockIcon クラスを使用すると、例えば、アイコンをアニメーション化したり内容を表すグラフィックを追加して、標準のアイコンの外観を変更できます。また、ドックアイコンメニューにアイテムを追加することもできます。追加したメニューアイテムは、標準メニューアイテムの上に表示されます。
DockIcon クラスのインスタンスは作成できません。
ドックアイコンのないオペレーティングシステムもあります。現在のシステムでドックアイコンがサポートされているかどうかを確認するには、
重要: AIR がドックアイコンをサポートしていないオペレーティングシステムで
アプリケーションがバックグラウンドで動作している場合にのみ、このメソッドを呼び出すとドックアイコンがバウンドします。
指定されたオペレーティングシステムのコンテキストでアイコンを表示する場合、表示するサイズに最も近い配列のビットマップが使用されます(必要に応じて伸縮)。一般的なサイズには、16x16、32x32、48x48 および 128x128 があります (512x512 ピクセルのアイコンは、近い将来にいくつかのオペレーティングシステムアイコンで使用される可能性があります)。
一部のコンテキストでは、
アイコンの外観を設定または変更するには、BitmapData オブジェクトの配列を
アイコンイメージを消去するには、
注意:アイコン用のイメージファイルを読み込む場合、通常、最も適切なアルファブレンドが提供されるのは PNG ファイル形式です。GIF 形式は透明度のオンまたはオフのみをサポートし、ブレンドは行いません。JPG 形式は、透明度をまったくサポートしません。
一部のアイコンのコンテキストでは、動的なサイズ調整がサポートされます。
メニューのすべてのアイテムが、標準アイテムの上に表示されます。標準アイテムは変更および削除できません。
一部のアイコンのコンテキストでは、動的なサイズ調整がサポートされます。
Icon オブジェクトには、BitmapData オブジェクトの配列の、
指定されたオペレーティングシステムのコンテキストでアイコンを表示する場合、表示するサイズに最も近い配列のビットマップが使用されます(必要に応じて伸縮)。一般的なサイズには、16x16、32x32、48x48 および 128x128 があります (512x512 ピクセルのアイコンは、近い将来にいくつかのオペレーティングシステムアイコンで使用される可能性があります)。
一部のコンテキストでは、
アイコンの外観を設定または変更するには、BitmapData オブジェクトの配列を
アイコンイメージを消去するには、
注意:アイコン用のイメージファイルを読み込む場合、通常、最も適切なアルファブレンドが提供されるのは PNG ファイル形式です。GIF 形式は透明度のオンまたはオフのみをサポートし、ブレンドは行いません。JPG 形式は、透明度をまったくサポートしません。