オペレーティングシステムで許可されている最大のウィンドウサイズです。サイズ制限は、Point オブジェクトの座標として指定されます。ポイントの x プロパティはウィンドウの幅に相当し、y プロパティはウィンドウの高さに相当します。オペレーティングシステムのサイズ制限に加えて、AIR には 2880 x 2880 ピクセルというウィンドウの最大サイズの制限があります。オペレーティングシステムで許可されている最小のウィンドウサイズです。サイズ制限は、Point オブジェクトの座標として指定されます。ポイントの x プロパティはウィンドウの幅に相当し、y プロパティはウィンドウの高さに相当します。ウィンドウのタイトルです。タイトルを表示する場合は、ウィンドウのシステムクロムに加え、その他のシステムに依存した場所 (タスクバーなど) に表示されます。次の例では、ウィンドウオブジェクトのタイトルを設定します。このウィンドウの作成に使用される透明度設定を報告します。ウィンドウが作成された後で、transparent プロパティを変更することはできません。透明度は、ウィンドウの視覚的な外観とマウス動作に影響します。Windows および Mac OS X の場合、ピクセルのアルファ値が特定のしきい値を下回っている場合、ウィンドウでマウスイベントはキャプチャされません。
この値は、オペレーティングシステムによってはおよそ
01 の間で変わります。Linux の場合、このウィンドウでは完全に透明な領域の上のマウスイベントがキャプチャされます。したがって、ユーザーはデスクトップ上のその他のウィンドウおよびアイテムにアクセスすることができません。注意:ウィンドウの透明度は必ずしもサポートされているとは限りません。ユーザーのオペレーティングシステムの設定で透明度が使用できない場合、ウィンドウは透明度なしで作成されます。透明度を設定されてる領域は、黒と合成されます。このウィンドウの作成に使用されるウィンドウタイプ (type) の設定を報告します。ウィンドウが作成された後で、type 設定を変更することはできません。このウィンドウが可視かどうかを指定します。不可視のウィンドウはデスクトップに表示されませんが、ウィンドウのプロパティとメソッドはすべて有効です。その後、ユーザーがドックアイコンをクリックするとウィンドウは可視状態に戻り、デスクトップに表示されます。次の例は、ウィンドウの visible プロパティにアクセスする方法を示したものです。ウィンドウステージの表示オブジェクトへの参照を使用した場合は、次のようになります。このウィンドウの幅 (ピクセル単位) です。ネイティブウィンドウについて報告されるサイズには、表示されているシステムウィンドウのクロムが含まれます。
ウィンドウ内側の使用可能な表示領域の幅は、Stage
ウィンドウの width プロパティを変更すると、bounds プロパティから幅を変更した場合と同じ動作をします。指定された幅が、設定可能な最小値より小さいか、または最大値より大きい場合、ウィンドウの幅は最も近いリーガルサイズに設定されます。幅の最小値および最大値を決定する要素は以下のとおりです。幅変更の完了を検出するには、resize イベントを監視します。これは、どのプラットフォームでも送出されるイベントです。オペレーティングシステムのデスクトップの原点を基準とした、このウィンドウの左上隅の水平軸座標です。複数のモニタが接続されたシステムでは、x は負の値になる場合があります。ウィンドウを以前の位置に再配置するために値を保存した場合は、位置を復元するときにウィンドウが使用可能な位置に配置されていることを常に確認してください。画面の解像度やモニタの配置を変更した場合、ウィンドウが画面外に配置されることがあります。デスクトップのジオメトリに関する情報を取得するには、Screen クラスを使用します。ウィンドウの x プロパティを変更すると、bounds プロパティから位置を変更した場合と同じ動作をします。Linux の場合、x プロパティを設定する操作は非同期的に実行されます。位置変更の完了を検出するには、move イベントを監視します。これは、どのプラットフォームでも送出されるイベントです。オペレーティングシステムのデスクトップの左上隅を基準とした、このウィンドウの左上隅の垂直軸座標です。複数のモニタが接続されたシステムでは、y は負の値になる場合があります。ウィンドウを以前の位置に再配置するために値を保存した場合は、位置を復元するときにウィンドウが使用可能な位置に配置されていることを常に確認してください。画面の解像度やモニタの配置を変更した場合、ウィンドウが画面外に配置されることがあります。デスクトップのジオメトリに関する情報を取得するには、Screen クラスを使用します。ウィンドウの y プロパティを変更すると、bounds プロパティから位置を変更した場合と同じ動作をします。Linux の場合、y プロパティを設定する操作は非同期的に実行されます。位置変更の完了を検出するには、move イベントを監視します。これは、どのプラットフォームでも送出されるイベントです。
コンストラクタの詳細
NativeWindow インスタンスと、対応するオペレーティングシステムウィンドウを新たに作成します。ウィンドウの作成後は、initOptions パラメータで定義されている設定を変更することはできません。現在のシステムで使用できなくても、設定が有効な場合は、例外はスローされません。デフォルトのウィンドウサイズはオペレーティングシステムによって決定されますが、ウィンドウの境界を設定することで変更できます。
メソッドの詳細
このウィンドウをアクティブ化します。ウィンドウをアクティブ化すると、次のようになります。ウィンドウが可視になります。ウィンドウが前面に移動します。キーボードおよびマウスのフォーカスが、そのウィンドウに移動します。次の例は、ウィンドウをアクティブにする方法を示しています。ウィンドウステージの表示オブジェクトへの参照を使用した場合は、次のようになります。このウィンドウを閉じます。閉じる操作が完了すると、close イベントが直ちに送出されます。閉じる操作のキャンセルを許可する場合は、closing イベントを送出し、登録されているリスナーがデフォルトの動作をキャンセルするかどうかを、close() メソッドを呼び出す前にチェックします。現在ウィンドウに表示されている表示オブジェクトのインスタンスが他から参照されていない場合、ガベージコレクションされ、破棄されます。ただし、AIR によって作成された最初のアプリケーションウィンドウは例外です。最初のウィンドウの表示オブジェクトのガベージコレクションを許可するには、ウィンドウステージからオブジェクトを削除します。閉じられた後でも NativeWindow オブジェクトは有効な参照として残りますが、プロパティやメソッドにアクセスすると、多くの場合は無効な操作エラーがスローされます。閉じたウィンドウを再び開くことはできません。ウィンドウが既に閉じられている場合、アクションは実行されず、イベントも送出されません。次の例は、ウィンドウを閉じる方法を示しています。ウィンドウステージの表示オブジェクトへの参照を使用した場合は、次のようになります。ウィンドウステージの起点を基準としたピクセル単位の座標のポイント (表示リストから見たグローバルポイント) を、仮想デスクトップのポイントに変換します。仮想デスクトップの座標は、主モニタの左上隅を基準としています。Point — デスクトップを基準とした、指定されたグローバルポイントです。このウィンドウを最大化します。ウィンドウが既に最大化されている場合、アクションは実行されず、イベントも送出されません。Mac OS X などのオペレーティングシステムでは、ウィンドウを最大化してもサイズ変更は禁止されません。そのため、maximize() を呼び出すとウィンドウが画面いっぱいに拡大されますが、その後でウィンドウのサイズを変更することができます。拡大されたウィンドウのサイズを変更すると、表示状態も元に戻ります。Mac OS X などの一部のオペレーティングシステムおよび Linux の一部のウィンドウマネージャでは、ウィンドウを最大化しても、maxSize プロパティで指定されている幅と高さより大きくは拡大しません。それ以外では、画面が maxSize より大きい場合でも、ウィンドウは画面いっぱいに拡大します。Linux の一部のウィンドウマネージャでは、ユーティリティウィンドウを最大化できません。次の例は、最大化操作のキャンセルを許可する方法を示したものです。このウィンドウを最小化します。必要に応じて、この動作を最小化ロジックに実装することができます。ウィンドウが既に最小化されている場合、アクションは実行されず、イベントも送出されません。Linux の一部のウィンドウマネージャでは、ユーティリティウィンドウを最小化できません。該当するイベントが発生したオペレーティングシステムを通して、視覚的なキューをトリガします。キューの強度は、type パラメータによって決定されます。情報の通知を目的としたキューは、継続時間が短く設定されています。重要な通知のキューは、ユーザーがこのウィンドウをアクティブ化するまで継続します。Linux のウィンドウマネージャの中には、2 レベルの通知をサポートしないものがあります。そのようなウィンドウマネージャでは、オプションの指定に関係なく、notifyUser() の効果は同じです。ただし、何も実行されません。このウィンドウを、指定されたウィンドウの背面に直接移動します。ウィンドウまたはアプリケーションをアクティブ化したり、フォーカスを取得したりしません。一部の Linux ウィンドウマネージャでは、ユーティリティウィンドウを標準ウィンドウよりも後に順序付けすることはできません。次の例は、NativeWindow インスタンスへの参照を使用して、ウィンドウを他のウィンドウの真下に移動する方法を示したものです。ウィンドウステージの表示オブジェクトへの参照を使用した場合は、次のようになります。このウィンドウを、指定されたウィンドウの前面に直接移動します。ウィンドウまたはアプリケーションをアクティブ化したり、フォーカスを取得したりしません。一部の Linux ウィンドウマネージャでは、標準ウィンドウをユーティリティウィンドウよりも前に順序付けすることはできません。次の例は、NativeWindow インスタンスへの参照を使用して、ウィンドウを他のウィンドウの真上に移動する方法を示したものです。ウィンドウステージの表示オブジェクトへの参照を使用した場合は、次のようになります。このウィンドウを他のすべての可視ウィンドウの背面に移動します。このウィンドウまたはアプリケーションをアクティブ化したり、フォーカスを取得したりしません。一部の Linux ウィンドウマネージャでは、ユーティリティウィンドウを標準ウィンドウよりも後に順序付けすることはできません。次の例は、アプリケーションの他のすべてのウィンドウ (同じ alwaysInFront 設定を持つもの) の背面にウィンドウを移動する方法を示したものです。ウィンドウステージの表示オブジェクトへの参照を使用した場合は、次のようになります。このウィンドウを他の可視ウィンドウの前面に移動します。このウィンドウまたはアプリケーションをアクティブ化したり、フォーカスを取得したりしません。一部の Linux ウィンドウマネージャでは、標準ウィンドウをユーティリティウィンドウよりも前に順序付けすることはできません。次の例は、アプリケーションの他のすべてのウィンドウ (同じ alwaysInFront 設定を持つもの) の前面にウィンドウを移動する方法を示したものです。ウィンドウステージの表示オブジェクトへの参照を使用した場合は、次のようになります。最小化または最大化された状態から、このウィンドウを元の状態に戻します。NORMAL の状態の場合、アクションは実行されず、イベントも送出されません。これは、どのプラットフォームでも送出されるイベントです。次の例は、元に戻す操作のキャンセルを許可する方法を示したものです。このウィンドウのシステム制御による移動を開始します。mouseDown イベントから呼び出された場合、このメソッドはマウス操作による移動シーケンスを開始し、mouseUp イベントが発生するまで続行します。その他のコードから呼び出された場合、このメソッドは、オペレーティングシステムのデフォルトのシーケンスに従い、キーボードまたはマウス操作による移動シーケンスを開始します。移動シーケンスの間、ウィンドウの起点が移動すると、一連のイベントが送出されます。各増分移動について、最初に moving イベントが送出され、moving イベントがキャンセルされなかった場合は、ウィンドウの位置が更新されて move イベントが送出されます。moving イベントがキャンセルされた場合、移動シーケンスは直ちに終了します。次の例は、mouseDown イベントに応答してウィンドウを移動する方法を示したものです。このウィンドウのシステム制御によるサイズ変更操作を開始します。mouseDown イベントハンドラから呼び出された場合、このメソッドはマウス操作によるサイズ変更シーケンスを開始し、mouseUp イベントが発生するまで続行します。その他のコードから呼び出された場合、このメソッドは、オペレーティングシステムのデフォルトのシーケンスに従い、キーボードまたはマウス操作によるサイズ変更シーケンスを開始します。サイズ変更シーケンスの間、ウィンドウのサイズが変化すると、一連のイベントが送出されます。resizing イベントがキャンセルされた場合、サイズ変更シーケンスは直ちに終了します。使用できる値は次のとおりです。
垂直方向の配置
水平方向の配置
次の例は、mouseDown イベントに応答してウィンドウを移動する方法を示したものです。
イベントの詳細
注意:このイベントには「キャプチャ段階」と「バブリング段階」はありません。したがって、ターゲットが表示リストにあるかないかに関わらず、潜在的なターゲットにはイベントリスナーを直接追加する必要があります。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。接続が閉じられたオブジェクトです。このイベントは、ウィンドウが閉じられないようにキャンセルすることができます。このイベントには、次のプロパティがあります。このイベントオブジェクトをキャンセルすると、閉じる操作がキャンセルされます。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。接続が閉じられるオブジェクトです。注意:このイベントには「キャプチャ段階」と「バブリング段階」はありません。したがって、ターゲットが表示リストにあるかないかに関わらず、潜在的なターゲットにはイベントリスナーを直接追加する必要があります。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。このイベントには、次のプロパティがあります。ウィンドウの変更前の表示状態です。ウィンドウの変更後の表示状態です。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトを示します。false は、キャンセルするデフォルトの動作がないことを示します。このイベントは、変更されないようにキャンセルすることができます。このイベントには、次のプロパティがあります。現在実行中の変更が行われる前のウィンドウの表示状態です。現在実行中の変更が行われた後のウィンドウの表示状態です。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトを示します。このイベントをキャンセルすると、変更は起こりません。デスクトップ上でウィンドウが移動されると、この NativeWindow オブジェクトから送出されます。ウィンドウの原点が変更されると、常に move イベントが送出されます。ウィンドウの原点 (x プロパティまたは y プロパティ) の移動は、システムによって制御されたウィンドウの移動の場合、最小化、最大化またはウィンドウのサイズを元に戻した場合、または x、y または bounds の各プロパティを設定して移動した場合に行われます。メモ : NativeWindow オブジェクトの moving イベントと move イベントの両方に対するハンドラ関数でオペレーティングシステムのダイアログボックスを同時に開くようなアクションは避けてください。これは、例えば、両方のハンドラ関数がエラーをスローする場合などに発生します。そのようなアクションが発生した場合、2 番目に開かれるダイアログボックスにはマウスのクリックが登録されないので、キーボードを使って閉じることが必要になります。このイベントには、次のプロパティがあります。ウィンドウの変更後の境界です。ウィンドウの変更前の境界です。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトを示します。false は、キャンセルするデフォルトの動作がないことを示します。デスクトップ上でウィンドウが移動される直前に、NativeWindow オブジェクトから送出されます。このイベントは、移動を中止または変更するためにキャンセルすることができます。メモ : NativeWindow オブジェクトの moving イベントと move イベントの両方に対するハンドラ関数でオペレーティングシステムのダイアログボックスを同時に開くようなアクションは避けてください。これは、例えば、両方のハンドラ関数がエラーをスローする場合などに発生します。そのようなアクションが発生した場合、2 番目に開かれるダイアログボックスにはマウスのクリックが登録されないので、キーボードを使って閉じることが必要になります。このイベントには、次のプロパティがあります。現在実行中の変更が行われた後のウィンドウの境界です。現在実行中の変更が行われる前のウィンドウの境界です。このイベントをキャンセルすると、ウィンドウは移動されません。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトを示します。ウィンドウのサイズが変更されると、常に resize イベントが送出されます。ウィンドウのサイズ (width プロパティまたは height プロパティ) 変更は、システムによって制御されたウィンドウサイズの変更の場合、最小化、最大化またはウィンドウのサイズを元に戻した場合、width、height または bounds の各プロパティを設定して変更した場合に行われます。一方、Stage オブジェクトの resize イベントは、ステージの描画の準備が整っている場合に送出されます。このイベントには、次のプロパティがあります。ウィンドウの変更後の境界です。ウィンドウの変更前の境界です。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトを示します。false は、キャンセルするデフォルトの動作がないことを示します。デスクトップ上でウィンドウのサイズが変更される直前に、この NativeWindow オブジェクトから送出されます。このイベントは、サイズ変更を中止または変更するためにキャンセルすることができます。このイベントには、次のプロパティがあります。現在実行中の変更が行われた後のウィンドウの境界です。現在実行中の変更が行われる前のウィンドウの境界です。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトを示します。このイベントをキャンセルすると、ウィンドウは移動されません。次の例では、resizing イベントをキャンセルする方法を示します。FileStream オブジェクトは、ファイルの読み取りと書き込みに使用されます。ファイルを非同期で開くことの利点は、Adobe AIR がバックグラウンドで読み取りと書き込みの処理を実行している間に、他のコードを実行できることです。非同期で開いた場合は、処理が進むにつれて progress イベントが送出されます。File オブジェクトを同期的に開いた場合、要求されたデータの読み取りまたは書き込みを基になるファイルに対して実行している間、呼び出し元は一時停止します。非同期で開いた場合、ストリームに書き込まれたデータは即時にバッファに格納され、後でファイルに書き込まれます。ファイルからの読み取りが同期的であるか非同期であるかにかかわらず、実際の読み取りメソッドは同期的です。どちらの場合も、現在 "使用可能な" データから読み取られます。違いは、同期的に読み取る場合は常にすべてのデータが使用可能であるのに対して、非同期で読み取る場合はデータストリームが読み取りバッファに読み取られるにつれてデータが徐々に使用可能になる点です。一般に、非同期入力を処理するアプリケーションは progress イベントに登録し、データが使用可能になると、読み取りメソッドを呼び出してデータを処理します。アプリケーションは、complete イベントに登録して、すべてのデータが使用可能になるまで待機し、complete イベントが送出された時点でデータセット全体を処理することもできます。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
[読み取り専用] 入力バッファで読み取ることができるデータのバイト数を返します。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。ファイルでの現在の位置です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。ファイルを非同期で読み取るときに、要求されるデータの量です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。イベントをイベントフローに送出します。EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ファイルストリーム、バイトストリームまたはバイト配列からブール値を読み取ります。ファイルストリーム、バイトストリームまたはバイト配列から符号付きバイトを読み取ります。ファイルストリーム、バイトストリームまたはバイト配列から、length パラメータで指定したデータバイト数を読み取ります。ファイルストリーム、バイトストリームまたはバイト配列から IEEE 754 倍精度浮動小数点数を読み取ります。ファイルストリーム、バイトストリームまたはバイト配列から IEEE 754 単精度浮動小数点数を読み取ります。ファイルストリーム、バイトストリームまたはバイト配列から符号付き 32 ビット整数を読み取ります。指定した文字セットを使用して、ファイルストリーム、バイトストリームまたはバイト配列から指定した長さのマルチバイトストリングを読み取ります。ファイルストリーム、バイトストリームまたはバイト配列から、AMF 直列化形式でエンコードされたオブジェクトを読み取ります。ファイルストリーム、バイトストリームまたはバイト配列から符号付き 16 ビット整数を読み取ります。ファイルストリーム、バイトストリームまたはバイト配列から符号なしバイトを読み取ります。ファイルストリーム、バイトストリームまたはバイト配列から符号なし 32 ビット整数を読み取ります。ファイルストリーム、バイトストリームまたはバイト配列から符号なし 16 ビット整数を読み取ります。ファイルストリーム、バイトストリームまたはバイト配列から UTF-8 ストリングを読み取ります。バイトストリームまたはバイト配列から UTF-8 の バイトのシーケンスを読み取り、ストリングを返します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。ブール値を書き込みます。バイトを書き込みます。指定したバイト配列(bytes)の offset(0 から始まるインデックス値)バイトから開始される length バイトのシーケンスをファイルストリーム、バイトストリームまたはバイト配列に書き込みます。32 ビット符号付き整数を書き込みます。指定した文字セットを使用して、ファイルストリーム、バイトストリームまたはバイト配列にマルチバイトストリングを書き込みます。ファイルストリーム、バイトストリームまたはバイト配列に、AMF 直列化形式でオブジェクトを書き込みます。16 ビット整数を書き込みます。32 ビット符号なし整数を書き込みます。ファイルストリーム、バイトストリームまたはバイト配列に UTF-8 ストリングを書き込みます。継承されるイベントを隠す。
継承されるイベントを表示
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。close() メソッドの明示的な呼び出しによってストリームが閉じられたことを示します。ストリームの終わりに達したことを通知します。[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。非同期のファイル I/O 処理中にエラーが発生したことを示します。バッファに格納されたデータがファイルに書き込まれたことを通知します。ストリーム上で新しいデータが使用可能になったことを通知します。
プロパティの詳細
入力バッファで読み取ることができるデータのバイト数を返します。読み取りメソッドを使用する前に、ユーザーコードで bytesAvailable を呼び出して、読み取るデータが十分にあることを確認します。デフォルトでは、AMF3 フォーマットが使用されます。ファイルでの現在の位置です。この値は、次のいずれかの方法で変更されます。
プロパティを明示的に設定したとき
このプロパティの値は、常に 253 未満の整数です。この値を小数部を持つ数値に設定した場合は、最も近い整数に切り捨てられます。ファイルを非同期で読み取ると、position プロパティを設定した場合、アプリケーションが読み取りバッファに指定された位置から始まるデータの埋め込みを開始し、bytesAvailable プロパティが 0 に設定される可能性があります。次のコードは、ファイルからデータが読み取られると、それに応じて FileStream オブジェクトの position プロパティが更新される様子を示しています。ファイルを非同期で読み取るときに、要求されるデータの量です。このプロパティでは、現在の位置以降、非同期ストリームで読み取るデータの量を指定します。このプロパティのデフォルト値は無限大です。デフォルトでは、読み取りのために非同期で開かれたファイルは、ファイルの末尾に達するまで読み取られます。読み取りバッファからデータを読み取っても、readAhead プロパティの値は変わりません。バッファからデータを読み取ると、読み取りバッファの空いた部分を埋めるために新しいデータが読み取られます。readAhead プロパティは、同期的に開かれたファイルに対しては効果がありません。progress イベントのイベントハンドラメソッドでは、(bytesAvailable プロパティを調べて) 必要なバイト数が利用可能であるかどうかを確認し、読み取りメソッドを使用して読み取りバッファからデータを読み取ります。次のコードは、readAhead プロパティを使用して、ファイルに読み取るデータの量を 100 バイトに制限する方法を示しています。
コンストラクタの詳細
メソッドの詳細
close() メソッドを呼び出した後は、データの読み取りや書き込みを行うことはできません。アプリケーションを閉じると、アプリケーションの FileStream オブジェクトに関連付けられているすべてのファイルが自動的に閉じられます。
ただし、アプリケーションを閉じる前に、非同期で開いた、書き込み保留中のデータのあるすべての FileStream オブジェクトについて closed イベントに登録することをお勧めします (これにより、データが確実に書き込まれます)
これにより、FileStream オブジェクトに関連付けられたすべてのファイルが閉じられますが、このオブジェクトの close イベントは送出されません。つまり、参照されていない FileStream オブジェクトであっても、次のいずれかの可能性がある限りは存在し続けます。
ファイルの読み取り処理で、ファイルの末尾に達していない (complete イベントが送出されていない)
txt という名前のテキストファイルに書き込みます。FileStream オブジェクトが既に開いている場合、このメソッドを呼び出すと、ファイルは、いったん閉じてから開かれます。前に開かれていたファイルに対する追加のイベント(close を含む)は送出されません。UPDATE)で開かれたファイルは、閉じられるまでは読み取り可能になりません。オペレーティングシステムによっては、並行して開いておけるファイルの数に制限があります。IOError — ファイルが存在しないか、ファイルを開くために必要なアクセス権を持っていないか、読み取りアクセスのためにファイルを開こうとしているが読み取りアクセス権を持っていないか、または書き込みアクセスのためにファイルを開こうとしているが書き込みアクセス権を持っていません。txt というファイルを同期的に開き、テキストのエンコーディングとしてシステムの文字セットを使用してファイルをストリングに読み取る方法を示しています。file パラメータで指定されたファイルを読み込み元として、FileStream オブジェクトを非同期的に開きます。FileStream オブジェクトが既に開いている場合、このメソッドを呼び出すと、ファイルは、いったん閉じてから開かれます。前に開かれていたファイルに対する追加のイベント(close を含む)は送出されません。UPDATE に設定されている場合、ファイルが開かれるとすぐに入力バッファへのデータの読み取りが開始され、この読み取り処理中に progress イベントおよび open イベントが送出されます。UPDATE)で開かれたファイルは、閉じられるまでは読み取り可能になりません。オペレーティングシステムによっては、並行して開いておけるファイルの数に制限があります。ioError:IOErrorEvent — ファイルが存在しないか、ファイルを開くために必要なアクセス権を持っていないか、読み取りアクセスのためにファイルを開こうとしているが読み取りアクセス権を持っていないか、または書き込みアクセスのためにファイルを開こうとしているが書き込みアクセス権を持っていません。UPDATE に設定して、ファイルが開かれている必要があります。txt というファイルを非同期的に開き、テキストのエンコーディングとしてシステムの文字セットを使用してファイルをストリングに読み取る方法を示しています。ファイルストリーム、バイトストリームまたはバイト配列からブール値を読み取ります。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列から符号付きバイトを読み取ります。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列から、length パラメータで指定したデータバイト数を読み取ります。デフォルト値の 0 に設定すると、すべてのデータが読み取られます。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列から IEEE 754 倍精度浮動小数点数を読み取ります。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列から IEEE 754 単精度浮動小数点数を読み取ります。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列から符号付き 32 ビット整数を読み取ります。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
指定した文字セットを使用して、ファイルストリーム、バイトストリームまたはバイト配列から指定した長さのマルチバイトストリングを読み取ります。完全な一覧については、サポートする文字セットを参照してください。もう一方のマシンでは、Flash Player または AIR ランタイムがシステムのデフォルトコードページを使用することになります。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列から、AMF 直列化形式でエンコードされたオブジェクトを読み取ります。* — 非直列化されたオブジェクトです。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列から符号付き 16 ビット整数を読み取ります。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列から符号なしバイトを読み取ります。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列から符号なし 32 ビット整数を読み取ります。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列から符号なし 16 ビット整数を読み取ります。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列から UTF-8 ストリングを読み取ります。このストリングには、バイト単位の長さを示す符号なし short が前に付いているものと見なされます。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
バイトストリームまたはバイト配列から UTF-8 の バイトのシーケンスを読み取り、ストリングを返します。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが読み取り機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルは読み取ることができません(例えば、ファイルがないため)
position プロパティで指定された位置からファイルの末尾までのバイトが削除されます。ファイルは書き込み用に開かれている必要があります。txt というファイルを同期的に開き、ファイルの長さが 100 文字を超える場合は 100 文字に切り詰めます。txt というファイルを非同期的に開き、ファイルの長さが 100 文字を超える場合は 100 文字に切り詰めます。ブール値を書き込みます。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが書き込み機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルに書き込むことができません(例えば、ファイルがないため)
バイトを書き込みます。パラメータの下位 8 ビットが使用されます。上位 24 ビットは無視されます。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが書き込み機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルに書き込むことができません(例えば、ファイルがないため)
指定したバイト配列(bytes)の offset(0 から始まるインデックス値)バイトから開始される length バイトのシーケンスをファイルストリーム、バイトストリームまたはバイト配列に書き込みます。length パラメータを省略すると、デフォルトの長さの 0 が使用され、offset から開始されるバッファ全体が書き込まれます。offset パラメータも省略した場合は、バッファ全体が書き込まれます。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが書き込み機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルに書き込むことができません(例えば、ファイルがないため)
このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが書き込み機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルに書き込むことができません(例えば、ファイルがないため)
このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが書き込み機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルに書き込むことができません(例えば、ファイルがないため)
32 ビット符号付き整数を書き込みます。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが書き込み機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルに書き込むことができません(例えば、ファイルがないため)
指定した文字セットを使用して、ファイルストリーム、バイトストリームまたはバイト配列にマルチバイトストリングを書き込みます。完全な一覧については、「サポートする文字セット」を参照してください。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが書き込み機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルに書き込むことができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列に、AMF 直列化形式でオブジェクトを書き込みます。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが書き込み機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルに書き込むことができません(例えば、ファイルがないため)
16 ビット整数を書き込みます。パラメータの下位 16 ビットが使用されます。上位 16 ビットは無視されます。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが書き込み機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルに書き込むことができません(例えば、ファイルがないため)
32 ビット符号なし整数を書き込みます。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが書き込み機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルに書き込むことができません(例えば、ファイルがないため)
ファイルストリーム、バイトストリームまたはバイト配列に UTF-8 ストリングを書き込みます。最初に UTF-8 ストリングの長さがバイト単位で 16 ビット整数として書き込まれ、その後にストリングの文字を表すバイトが続きます。このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが書き込み機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルに書き込むことができません(例えば、ファイルがないため)
このイベントは、(openAsync() メソッドを使用して) 非同期処理のために開かれたファイルに対してのみ送出されます。IOError — ファイルが開かれていないか、ファイルが開かれたが書き込み機能を指定して開かれていません。
または(open() メソッドを使用して)同期処理のために開かれたファイルに書き込むことができません(例えば、ファイルがないため)
イベントの詳細
close() メソッドの明示的な呼び出しによってストリームが閉じられたことを示します。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。接続が閉じられたオブジェクトです。ストリームの終わりに達したことを通知します。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ロードが完了したネットワークオブジェクトです。非同期のファイル I/O 処理中にエラーが発生したことを示します。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
特定のエラーに関連付けられた参照番号です(AIR のみ)
入出力エラーが発生したネットワークオブジェクトです。エラーメッセージとして表示されるテキストです。バッファに格納されたデータがファイルに書き込まれたことを通知します。このイベントには、次のプロパティがあります。リスナーがイベントを処理する時点でまだ書き込まれていないバイト数です。書き込みプロセスが成功した場合に最終的に書き込まれるバイトの総数です。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ストリーム上で新しいデータが使用可能になったことを通知します。このイベントには、次のプロパティがあります。リスナーがイベントを処理しているときにロードされたアイテム数またはバイト数です。ロードプロセスが成功した場合に最終的にロードされるアイテムまたはバイトの総数です。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。進行状況をレポートする オブジェクトです。open() メソッドを呼び出して新しい HTML ウィンドウを作成するときに指定できるオプションを定義します。open() メソッドに渡されるパラメータ)でオプションに対応するプロパティとメソッドを定義します。open() の次の呼び出しが含まれることがあります。この呼び出しでは、features パラメータ(3 番目のパラメータ)により、多数のオプションがリストされます。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。ウィンドウをフルスクリーン表示するかどうかを指定します。新しいウィンドウの目的の初期の高さを指定します。ロケーションバーを表示するかどうかを指定します。メニューバーを表示するかどうかを指定します。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。ウィンドウのサイズ変更を可能にするかどうかを指定します。スクロールバーを表示するかどうかを指定します。ステータスバーを表示するかどうかを指定します。ツールバーを表示するかどうかを指定します。新しいウィンドウの目的の初期の幅を指定します。画面上の新しいウィンドウの目的の初期 x 方向位置を指定します。画面上の新しいウィンドウの目的の初期 y 方向位置を指定します。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。
プロパティの詳細
ウィンドウをフルスクリーン表示するかどうかを指定します。新しいウィンドウの目的の初期の高さを指定します。ロケーションバーを表示するかどうかを指定します。メニューバーを表示するかどうかを指定します。ウィンドウのサイズ変更を可能にするかどうかを指定します。スクロールバーを表示するかどうかを指定します。ステータスバーを表示するかどうかを指定します。ツールバーを表示するかどうかを指定します。新しいウィンドウの目的の初期の幅を指定します。値が NaN(width の値が features ストリングで指定されていない場合のデフォルト値)である場合は、ウィンドウのデフォルトの幅が使用されます。画面上の新しいウィンドウの目的の初期 x 方向位置を指定します。画面上の新しいウィンドウの目的の初期 y 方向位置を指定します。FileReference クラスには、ユーザーのコンピュータとサーバーとの間でファイルをアップロードおよびダウンロードするための手段があります。オペレーティングシステムのダイアログボックスを使用して、アップロードするファイルや、ダウンロード先の場所をユーザーが選択できるようにします。ダウンロード処理の実行中、name プロパティの値は select イベントが送出されたときに設定されます。これ以外のすべてのプロパティの値は、complete イベントが送出されたときに設定されます。browse() メソッドはオペレーティングシステムのダイアログボックスを開いて、ユーザーがアップロード対象のファイルを選択できるようにします。browse() メソッドを使用すると、ユーザーは単一のファイルを選択できます。browse() メソッドを使用すると、複数のファイルを選択できます。download() メソッドは、ファイルの保存先をユーザーに指定させ、リモート URL からのダウンロードを開始します。ダイアログボックスに表示されるデフォルトの場所は、最後に参照されたフォルダ (その場所を決定できる場合) またはデスクトップです。これらのクラスを使って、転送ファイルを読み込んだり、転送ファイルに書き込んだりすることはできません。これらのクラスを使用しても、アップロードまたはダウンロードを開始した SWF ファイルが、アップロードファイルやダウンロードファイル、またはユーザーのディスクのファイルの場所にアクセスすることはできません。認証が必要なサーバーでは、Flash® Player ブラウザプラグインを使ってファイルをダウンロードできますが、すべての Player でのアップロード、およびスタンドアローンまたは外部 Player でのダウンロードは失敗します。FileReference イベントをリッスンして、処理が正常に終了したかどうかを確認して、エラー処理を行います。Flash Player で実行されるコンテンツの場合、またはアプリケーションセキュリティサンドボックス外の、Adobe AIR で実行されるコンテンツの場合、アップロード操作およびダウンロード操作では、それ自身のドメイン内および URL ポリシーファイルが指定するドメイン内のファイルにのみアクセスできます。アップロードまたはダウンロードを開始しているコンテンツが、ファイルサーバーと同じドメインに属していない場合、ファイルサーバーにポリシーファイルを配置します。以前のバージョンの Flash Player については、同時に複数の操作を実行しても、この制限には影響されません。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[読み取り専用] ローカルディスク上に存在するファイルの作成日です。[読み取り専用] ファイル名拡張子です。[読み取り専用] ローカルディスク上に存在するファイルの最終変更日です。[読み取り専用] ローカルディスク上に存在するファイルの名前です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。[読み取り専用] ローカルディスク上に存在するファイルのサイズ (バイト単位) です。[読み取り専用] ファイル形式です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。アップロードするファイルを選択できるファイル参照ダイアログボックスを表示します。この FileReference オブジェクトで進行中のアップロード処理またはダウンロード処理を取り消します。イベントをイベントフローに送出します。リモートサーバーからファイルをダウンロードするためのダイアログボックスを開きます。EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。ユーザーが選択したローカルファイルの読み込みを開始します。指定されたプロパティが存在し、列挙できるかどうかを示します。ローカルファイルシステムにファイルを保存するためのダイアログボックスを開きます。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。ユーザーが選択したファイルをリモートサーバーにアップロードする処理を開始します。ファイルをエンコードせずに URL へのアップロードを開始します。指定されたオブジェクトのプリミティブな値を返します。指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。継承されるイベントを隠す。
継承されるイベントを表示
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。ユーザーがアップロードまたはダウンロードするファイルをファイル参照ダイアログボックスからキャンセルしたときに送出されます。ダウンロードが完了、またはアップロードで HTTP ステータスコード 200 が生成された場合に送出されます。[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。アップロードに失敗し、HTTP ステータスコードを使用して失敗を記述することができない場合に送出されます。アップロードまたはダウンロードが失敗したときに送出されます。アップロード処理またはダウンロード処理が開始するときに送出されます。ファイルのアップロード処理中またはダウンロード処理中に定期的に送出されます。download() メソッドの呼び出しによって、サーバーにファイルをアップロードするか、呼び出し元のセキュリティサンドボックスの外部にあるサーバーからファイルを取得しようとしたときに送出されます。ユーザーがアップロードするファイルまたはダウンロードするファイルをファイル参照ダイアログボックスから選択したときに、送出されます。アップロードの正常終了後、サーバーからデータを受信したときに送出されます。
プロパティの詳細
ローカルディスク上に存在するファイルの作成日です。オブジェクトに値が設定されていない場合に、このプロパティの値を取得する呼び出しが行われると null が返されます。download() メソッドの呼び出しが失敗すると、例外がスローされ、関数の呼び出しシーケンスが正しくないこと、または以前の呼び出しが失敗したことを知らせるメッセージが送信されます。IOError — ファイル情報にアクセスできない場合、I/O エラーを示すメッセージとともにエラーがスローされます。FileReference オブジェクトに値が設定されていない場合に、このプロパティの値を取得する呼び出しが行われると null を返します。download() メソッドの呼び出しが失敗すると、例外がスローされ、関数の呼び出しシーケンスが正しくないこと、または以前の呼び出しが失敗したことを知らせるメッセージが送信されます。IOError — ファイルを開くことや読み取ることができない場合、またはファイルへのアクセスで同様のエラーが発生した場合、例外がスローされ、ファイルの I/O エラーを知らせるメッセージが送信されます。ファイル名拡張子です。ファイルの拡張子は、名前内の最後のドット ("
") の後の部分です (ドットは含みません)
ファイル名内にドットがない場合、拡張子は null です。メモ : ファイルのタイプを確認するには、extension プロパティを使用する必要があります。これらのプロパティは、Mac OS の古いバージョンに適用されます。ローカルディスク上に存在するファイルの最終変更日です。FileReference オブジェクトに値が設定されていない場合に、このプロパティの値を取得する呼び出しが行われると null を返します。download() メソッドの呼び出しが失敗すると、例外がスローされ、関数の呼び出しシーケンスが正しくないこと、または以前の呼び出しが失敗したことを知らせるメッセージが送信されます。IOError — ファイル情報にアクセスできない場合、I/O エラーを示すメッセージとともにエラーがスローされます。ローカルディスク上に存在するファイルの名前です。download() メソッドの呼び出しが失敗すると、例外がスローされ、関数の呼び出しシーケンスが正しくないこと、または以前の呼び出しが失敗したことを知らせるメッセージが送信されます。ローカルディスク上に存在するファイルのサイズ (バイト単位) です。0 の初期のバージョンでは、size プロパティは、4 GB 程度までのサイズのファイルをサポートする uint オブジェクトとして定義されていました。現在では、それよりも大きいファイルをサポートする Number オブジェクトとして実装されています。download() メソッドの呼び出しが失敗すると、例外がスローされ、関数の呼び出しシーケンスが正しくないこと、または以前の呼び出しが失敗したことを知らせるメッセージが送信されます。IOError — ファイルを開くこと、読み取ることができない場合、またはファイルへのアクセスで同様のエラーが発生した場合、例外がスローされ、ファイルの I/O エラーを知らせるメッセージが送信されます。ファイル形式です。)の後の部分)でファイル形式を示します。download() メソッドの呼び出しが失敗すると、例外がスローされ、関数の呼び出しシーケンスが正しくないこと、または以前の呼び出しが失敗したことを知らせるメッセージが送信されます。
コンストラクタの詳細
設定されると、FileReference オブジェクトはユーザーのローカルディスク上のファイルを表します。
メソッドの詳細
アップロードするファイルを選択できるファイル参照ダイアログボックスを表示します。このダイアログボックスは、オペレーティングシステムのネイティブのダイアログボックスです。ユーザーは、例えば Windows の UNC パスを使用して、ローカルコンピュータまたは他のコンピュータからファイルを選択できます。このメソッドを呼び出して、ユーザーが正常にファイルを選択すると、この FileReference オブジェクトのプロパティにそのファイルのプロパティが設定されます。browse() メソッドが呼び出されるたびに、FileReference オブジェクトのプロパティは、ダイアログボックスでユーザーが選択したファイルにリセットされます。これは、一度に 1 つのダイアログボックスしか呼び出せないからです。どのファイルをダイアログボックスに表示するかを決定するために、typeFilter パラメータを使用できます。以前のバージョンの Flash Player については、同時に複数の操作を実行しても、この制限には影響されません。このパラメータを省略すると、すべてのファイルが表示されます。cancel:Event — ユーザーがファイルアップロードの参照ウィンドウをキャンセルすると、送出されます。ファイルブラウズのセッションは、一度に 1 つのみ実行できます。
cfg ファイルの設定により、この操作が禁止されている場合
Error — マウスイベントやキー入力イベントなどのユーザー操作に応じてメソッドが呼び出されない場合
この FileReference オブジェクトで進行中のアップロード処理またはダウンロード処理を取り消します。このメソッドを呼び出しても cancel イベントは送出されません。このイベントは、ユーザーがファイルアップロードまたはダウンロードのダイアログボックスを閉じて処理をキャンセルした場合にのみ送出されます。リモートサーバーからファイルをダウンロードするためのダイアログボックスを開きます。Flash Player ではアップロードまたはダウンロードできるファイルのサイズに制限はありませんが、このプレーヤーが正式にサポートしているアップロードまたはダウンロードのサイズは最大 100 MB です。download() メソッドは、まず、オペレーティングシステムのダイアログボックスを表示して、ユーザーにファイル名を入力してもらった後、ファイル名の保存先となるローカルコンピュータ上の場所を選択してもらいます。ユーザーが保存場所を選択し、[保存] などをクリックして、ファイルをローカルに保存することを確認すると、リモートサーバーからのダウンロードが開始します。リスナーは、ダウンロードが進行中なのか、成功したのか、失敗したのかを示すイベントを受け取ります。これらの関数は呼び出された後、ファイル転送が完了する前に返されます。さらに、FileReference オブジェクトがスコープ外に移動した場合、そのオブジェクトに対して完了していないアップロードまたはダウンロードは、スコープから離れた時点でキャンセルされます。アップロードまたはダウンロードの続行を期待できる限りは、FileReference オブジェクトがスコープ内にあることを確認してください。ファイルが正常にダウンロードされると、FileReference オブジェクトのプロパティにローカルファイルのプロパティが設定されます。ダウンロードが成功した場合、complete イベントが送出されます。これは、一度に 1 つのダイアログボックスしか呼び出せないからです。このメソッドは、どのファイルタイプのダウンロードにも対応しており、HTTP と HTTPS のいずれも使用できます。一般的な予約ポートに接続することはできません。0 のプログラミング』)の「ネットワーク API の制限」を参照してください。メモ : サーバーでユーザー認証が必要な場合、ブラウザ内で実行される、つまり、ブラウザプラグインまたは ActiveX コントロールを使用する SWF ファイルでのみ、認証用のユーザー名とパスワードをユーザーが入力できるダイアログボックスを表示できます。ただし、それはダウンロードの場合のみです。プラグインまたは ActiveX コントロールを使用するアップロードの場合、または、スタンドアローンまたは外部 Player を使用するアップロードとダウンロードの場合、ファイル転送は失敗します。呼び出し元 SWF ファイルが信頼されないコードとしてローカルのサンドボックスに置かれている場合、ロード操作は実行できません。デフォルトの動作では、サンドボックス間のアクセスは拒否されます。URL ポリシーファイルを追加することによって、Web サイトでリソースにアクセスできるようになります。ただし、Adobe AIR では、application セキュリティサンドボックス内のコンテンツ(AIR アプリケーションと共にインストールされたコンテンツ)は、これらのセキュリティ制限による制限を受けません。セキュリティ情報について詳しくは、以下を参照してください。以前のバージョンの Flash Player については、同時に複数の操作を実行しても、この制限には影響されません。このパラメータが null の場合、例外がスローされます。一部のブラウザでは、URL ストリングの長さに制限があるものがあります。長さが 256 文字を超える場合、一部のブラウザまたはサーバーでは失敗する場合があります。を含めないでください。このパラメータを省略すると、リモート URL のファイル名が構文解析されて、デフォルトとして使用されます。select:Event — ダウンロードするファイルをユーザーがダイアログボックスから選択すると、送出されます。
ファイルの読み込み中または転送中に入出力エラーが発生した場合
Flash Player のスタンドアローンバージョンまたは外部バージョンで実行される SWF コンテンツが、認証が必要なサーバーからファイルをダウンロードしようとした場合
ダウンロードする際、スタンドアローンまたは外部 Player には、ユーザーがパスワードを入力する手段がありません。認証が必要なサーバーに対して、これらの Player 内の SWF がファイルをダウンロードしようとすると、ダウンロードは失敗します。
1) 他のブラウズセッションが進行中の場合
ファイルブラウズのセッションは、一度に 1 つのみ実行できます。
2) request に渡された値に、無効なパスまたはプロトコルが含まれている場合
3) ダウンロードするファイルの名前に禁止文字が含まれている場合
cfg ファイルの設定により、この操作が禁止されている場合
この問題を回避するには、この SWF ファイルを、ネットワークアクセスを許可されたローカル SWF ファイル、または信頼できる SWF ファイルとして再分類します。この例外がスローされると、ローカルファイルのセキュリティ制限が原因でアクセスできないファイル名および URL を示すメッセージが送信されます。0 のプログラミング』のセキュリティに関する章の「ネットワーク API の制限」を参照してください。
Error — マウスイベントやキー入力イベントなどのユーザー操作に応じてメソッドが呼び出されない場合
次の例で、download イベントオブジェクトの使用方法を示します。url プロパティを変更して、架空の http://www ではなく実際のドメインとファイルを参照するようにします。[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合があります。ユーザーが選択したローカルファイルの読み込みを開始します。Flash Player ではアップロード、ダウンロード、ロードまたは保存できるファイルのサイズに制限はありませんが、正式にサポートしているサイズは最大 100 MB です。リスナーは、読み込み処理が進行中なのか、成功したのか、失敗したのかを示すイベントを受け取ります。FileReferenceList オブジェクトを使用すると、ユーザーがロードするファイルを複数選択できるようになりますが、ファイルは 1 つずつロードする必要があります。save() 関数はノンブロッキング処理を行います。これらの関数は呼び出された後、ファイル転送が完了する前に返されます。さらに、FileReference オブジェクトがスコープ外に移動した場合、そのオブジェクトに対して完了していないトランザクションは、スコープから離れた時点でキャンセルされます。アップロード、ダウンロード、読み込みまたは保存の続行を期待できる限りは、FileReference オブジェクトがスコープ内にあることを確認してください。次のセキュリティに関する考慮事項が適用されます。呼び出し元 SWF ファイルが信頼されないコードとしてローカルのサンドボックスに置かれている場合、ロード操作は実行できません。デフォルトの動作では、サンドボックス間のアクセスは拒否されます。クロスドメインポリシーファイルを追加することによって、Web サイトでリソースにアクセスできるようになります。ただし、これらの考慮事項はアプリケーションサンドボックス内の AIR コンテンツには適用されません。複数の操作を実行すると、アプリケーションでランタイムエラー(コード 2174)が発生します。5 にのみ適用されます。ioError:IOErrorEvent — アプリケーションによるファイルの読み込み中または書き込み中に入出力エラーによりロードが失敗した場合に呼び出されます。ファイルブラウズのセッションは、一度に 1 つのみ実行できます。
cfg ファイルの設定により、この操作が禁止されている場合
MemoryError — このエラーは、アプリケーションがファイルにメモリを割り当てることができない場合に発生することがあります。ファイルが大きすぎるか、または使用可能なメモリが少なすぎる可能性があります。ローカルファイルシステムにファイルを保存するためのダイアログボックスを開きます。Flash Player ではアップロード、ダウンロード、読み込みまたは保存できるファイルのサイズに制限はありませんが、このプレーヤーが正式にサポートしているサイズは最大 100 MB です。save() メソッドは、まず、オペレーティングシステムのダイアログボックスを表示して、ユーザーにファイル名を入力してもらった後、ファイル名の保存先となるローカルコンピュータ上の場所を選択してもらいます。ユーザーが保存場所を選択し、「保存」などをクリックして、ファイルをローカルに保存することを確認すると、保存処理が開始されます。リスナーは、保存処理が進行中なのか、成功したのか、失敗したのかを示すイベントを受け取ります。save() 関数はノンブロッキング処理を行います。これらの関数は呼び出された後、ファイル転送が完了する前に返されます。さらに、FileReference オブジェクトがスコープ外に移動した場合、そのオブジェクトに対して完了していないトランザクションは、スコープから離れた時点でキャンセルされます。アップロード、ダウンロード、読み込みまたは保存の続行を期待できる限りは、FileReference オブジェクトがスコープ内にあることを確認してください。ファイルが正常に保存されると、FileReference オブジェクトのプロパティにローカルファイルのプロパティが設定されます。これは、一度に 1 つのダイアログボックスしか呼び出せないからです。Flash Player では、このメソッドの呼び出しは、マウスのクリックやキー入力などのユーザーイベントに応じてイベントハンドラで呼び出した場合にのみ成功します。この制限は、アプリケーションサンドボックス内の AIR コンテンツには適用されません。データは複数の形式のうちのいずれかになり、以下のように適切に処理されます。値が XML の場合は、XML 形式でテキストファイルに書き込まれます。形式はすべて保持されます。値が ByteArray オブジェクトの場合は、データファイルにそのまま書き込まれます。値が上記のいずれでもない場合、save() メソッドはオブジェクトの toString() メソッドを呼び出し、データをストリングに変換して、データをテキストファイルとして保存します。を含めないでください。select:Event — ダウンロードするファイルをユーザーがダイアログボックスから選択すると、送出されます。
1)他のブラウズセッションが進行中の場合
ファイルブラウズのセッションは、一度に 1 つのみ実行できます。
2)ダウンロードするファイルの名前に禁止文字が含まれている場合
cfg ファイルの設定により、この操作が禁止されている場合
Error — マウスイベントやキー入力イベントなどのユーザー操作に応じてメソッドが呼び出されない場合
ファイルが大きすぎるか、または使用可能なメモリが少なすぎる可能性があります。ユーザーが選択したファイルをリモートサーバーにアップロードする処理を開始します。Flash Player ではアップロードまたはダウンロードできるファイルのサイズに制限はありませんが、このプレーヤーが正式にサポートしているアップロードまたはダウンロードのサイズは最大 100 MB です。リスナーは、アップロードが進行中なのか、成功したのか、失敗したのかを示すイベントを受け取ります。FileReferenceList オブジェクトを使用すると、ユーザーが複数のファイルを選択してアップロードすることが可能になりますが、ファイルは 1 つずつアップロードする必要があります。これらの関数は呼び出された後、ファイル転送が完了する前に返されます。さらに、FileReference オブジェクトがスコープ外に移動した場合、そのオブジェクトに対して完了していないアップロードまたはダウンロードは、スコープから離れた時点でキャンセルされます。アップロードまたはダウンロードの続行を期待できる限りは、FileReference オブジェクトがスコープ内にあることを確認してください。ファイルは、url パラメータに渡された URL にアップロードされます。URL は、アップロードを許可するよう設定されたサーバースクリプトである必要があります。アップロードを処理するサーバースクリプトは、次のエレメントを持つ POST リクエストを想定しています。
ファイルのバイナリコンテンツ
一般的な予約ポートに接続することはできません。0 のプログラミング』)の「ネットワーク API の制限」を参照してください。メモ : サーバーでユーザー認証が必要な場合、ブラウザ内で実行される、つまり、ブラウザプラグインまたは ActiveX コントロールを使用する SWF ファイルでのみ、認証用のユーザー名とパスワードをユーザーが入力できるダイアログボックスを表示できます。ただし、それはダウンロードの場合のみです。プラグインまたは ActiveX コントロールを使用するアップロードの場合、または、スタンドアローンまたは外部 Player を使用するアップロードとダウンロードの場合、ファイル転送は失敗します。呼び出し元 SWF ファイルが信頼されないコードとしてローカルのサンドボックスに置かれている場合、ロード操作は実行できません。デフォルトの動作では、サンドボックス間のアクセスは拒否されます。URL ポリシーファイルを追加することによって、Web サイトでリソースにアクセスできるようになります。ただし、Adobe AIR では、application セキュリティサンドボックス内のコンテンツ(AIR アプリケーションと共にインストールされたコンテンツ)は、これらのセキュリティ制限による制限を受けません。詳細については、次のトピックを参照してください。以前のバージョンの Flash Player については、同時に複数の操作を実行しても、この制限には影響されません。一部のブラウザでは、URL ストリングの長さに制限があるものがあります。長さが 256 文字を超える場合、一部のブラウザまたはサーバーでは失敗する場合があります。このパラメータが null の場合、例外がスローされます。このテストアップロードでは、実際のファイルのアップロードが成功するかどうか、サーバー認証が必要な場合はそれが成功するかどうかがチェックされます。テストアップロードは、Windows プレーヤーでのみ使用できます。
ユーザー名とパスワードなど、認証が必要なサーバーにファイルをアップロードしようとしたことが原因でアップロードが失敗した場合
アップロード中、ユーザーがパスワードを入力する方法はありません。
url パラメータに無効なプロトコルが含まれることが原因でアップロードが失敗した場合
この問題を回避するには、この SWF ファイルを、ネットワークアクセスを許可されたローカル SWF ファイル、または信頼できる SWF ファイルとして再分類します。この例外がスローされると、アクセスできないローカルファイルの名前および URL を示すメッセージが送信されます。0 のプログラミング』のセキュリティに関する章の「ネットワーク API の制限」を参照してください。ファイルブラウズのセッションは、一度に 1 つのみ実行できます。
2) URL パラメータが有効なパスまたはプロトコルでない場合
ファイルのアップロードでは HTTP を使用し、ファイルのダウンロードでは FTP または HTTP を使用する必要があります。
cfg ファイルの設定により、この操作が禁止されている場合
ファイルをエンコードせずに URL へのアップロードを開始します。送信しようとするデータが、受信するサーバーで理解可能な形式で既にエンコードされている場合、uploadUnencoded() メソッドを使用します。一部のブラウザでは、URL ストリングの長さに制限があるものがあります。長さが 256 文字を超える場合、一部のブラウザまたはサーバーでは失敗する場合があります。このパラメータが null の場合、例外がスローされます。
Adobe AIR によるファイルの読み込み中、書き込み中、または転送中に入出力エラーが発生したために、アップロードが失敗した場合
ユーザー名とパスワードなど、認証が必要なサーバーにファイルをアップロードしようとしたことが原因でアップロードが失敗した場合
アップロード中、ユーザーがパスワードを入力する方法はありません。
url パラメータに無効なプロトコルが含まれることが原因でアップロードが失敗した場合
この問題を回避するには、この SWF ファイルを、ネットワークアクセスを許可されたローカル SWF ファイル、または信頼できる SWF ファイルとして再分類します。この例外がスローされると、アクセスできないローカルファイルの名前および URL を示すメッセージが送信されます。ファイルブラウズのセッションは、一度に 1 つのみ実行できます。
2) URL パラメータが有効なパスまたはプロトコルでない場合
ファイルのアップロードには HTTP を使用する必要があります。
イベントの詳細
ユーザーがアップロードまたはダウンロードするファイルをファイル参照ダイアログボックスからキャンセルしたときに送出されます。ユーザーが他の手段 (ブラウザを閉じたり、現在のアプリケーションを停止したりすること) によってアップロードまたはダウンロードをキャンセルした場合、Flash Player はこのイベントを送出しません。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。操作をキャンセルするオブジェクトへの参照です。次の例で、cancel イベントオブジェクトの使用方法を示します。url プロパティを変更して、架空の http://www ではなく実際のドメインとファイルを参照するようにします。[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合があります。ダウンロードが完了、またはアップロードで HTTP ステータスコード 200 が生成された場合に送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ロードが完了したネットワークオブジェクトです。次の例で、complete イベントオブジェクトの使用方法を示します。url プロパティを変更して、架空の http://www ではなく実際のドメインとファイルを参照するようにします。[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合があります。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。サーバーから返された HTTP ステータスコードです。HTTP ステータスコードを受け取るネットワークオブジェクトです。アップロードに失敗し、HTTP ステータスコードを使用して失敗を記述することができない場合に送出されます。Flash Player で実行されるコンテンツの場合、このイベントはダウンロードの失敗には適用されません。HTTP エラーのためにダウンロードが失敗した場合は、I/O エラーとして通知されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。サーバーから返された HTTP ステータスコードです。HTTP ステータスコードを受け取るネットワークオブジェクトです。アップロードまたはダウンロードが失敗したときに送出されます。次のいずれかの理由により、ファイル転送に失敗することがあります。
Player でファイルの読み込み中、書き込み中、または転送中に入出力エラーが発生した場合
ユーザー名とパスワードなど、認証が必要なサーバーに SWF ファイルがファイルをアップロードしようとした場合
認証が必要なサーバーに対して SWF ファイルがファイルをアップロードしようとすると、アップロードは失敗します。
スタンドアローンまたは外部 Player 内で、認証が必要なサーバーから SWF ファイルがファイルをダウンロードしようとした場合
ダウンロードする際、スタンドアローンまたは外部 Player には、ユーザーがパスワードを入力する手段がありません。認証が必要なサーバーから、これらの Player 内の SWF ファイルがファイルをダウンロードしようとすると、ダウンロードは失敗します。重要:ブラウザ内で実行される、つまり、ブラウザプラグインまたは ActiveX コントロールを使用するアプリケーションと、Adobe AIR で実行されるコンテンツでのみ、認証用のユーザー名とパスワードを入力できるダイアログボックスを表示できます。ただし、それはダウンロードの場合のみです。Flash Player のプラグインまたは ActiveX コントロールバージョンを使用するアップロードの場合、または、スタンドアローンまたは外部 Player を使用するアップロードまたはダウンロードの場合、ファイル転送は失敗します。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
特定のエラーに関連付けられた参照番号です(AIR のみ)
入出力エラーが発生したネットワークオブジェクトです。エラーメッセージとして表示されるテキストです。アップロード処理またはダウンロード処理が開始するときに送出されます。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。接続をオープンしたネットワークオブジェクトです。次の例で、download イベントオブジェクトの使用方法を示します。url プロパティを変更して、架空の http://www ではなく実際のドメインとファイルを参照するようにします。[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合があります。ファイルのアップロード処理中またはダウンロード処理中に定期的に送出されます。progress イベントは、Flash Player がバイトをサーバーに転送しているときに送出され、最終的に転送が成功しなくても、転送の実行中は定期的に送出されます。ファイルの転送が実際に成功して完了したかどうか、およびそのタイミングを確認するには、complete イベントを受け取ります。例えば、転送対象ファイルが非常に小さい場合や、アップロードやダウンロードが非常に短時間に終わる場合、progress イベントは送出されない場合があります。このイベントには、次のプロパティがあります。リスナーがイベントを処理しているときにロードされたアイテム数またはバイト数です。ロードプロセスが成功した場合に最終的にロードされるアイテムまたはバイトの総数です。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。進行状況をレポートする オブジェクトです。次の例では、progress イベントオブジェクトの使用方法を示します。url プロパティを変更して、架空の http://www ではなく実際のドメインとファイルを参照するようにします。[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合があります。download() メソッドの呼び出しによって、サーバーにファイルをアップロードするか、呼び出し元のセキュリティサンドボックスの外部にあるサーバーからファイルを取得しようとすると、送出されます。呼び出し側の SWF ファイルが自分のドメインの外にある SWF ファイルにアクセスしようとして、アクセス権限がないと発生します。URL ポリシーファイルを使用することで、このエラーに対処できます。Adobe AIR では、これらのセキュリティ制限は、アプリケーションセキュリティサンドボックス内のコンテンツには適用されません。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。セキュリティエラーを報告するネットワークオブジェクトです。エラーメッセージとして表示されるテキストです。ユーザーがアップロードするファイルまたはダウンロードするファイルをファイル参照ダイアログボックスから選択したときに、送出されます。ユーザーがファイルを選択し、[OK] などをクリックして操作を確認すると、FileReference オブジェクトのプロパティに値が設定されます。Flash Player または Adobe AIR ランタイムのアプリケーションセキュリティサンドボックス外で実行されるコンテンツの場合、select イベントは、どのメソッドがそのイベントを呼び出したかにより、わずかに異なった動作をします。これは、ユーザーが選択したファイルが、ローカルファイルシステムに存在するためです。これは、select イベントが送出された時点では、ファイルがまだローカルファイルシステムにダウンロードされていないためです。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。アイテムが選択されたオブジェクトです。次の例で、select イベントオブジェクトの使用方法を示します。url プロパティを変更して、架空の http://www ではなく実際のドメインとファイルを参照するようにします。[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合があります。xml ファイルを置いておく必要があります。アップロードの正常終了後、サーバーからデータを受信したときに送出されます。サーバーからデータが返されないと、このイベントは送出されません。このイベントには、次のプロパティがあります。false は、キャンセルするデフォルトの動作がないことを示します。イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。ファイルアップロードが正常に終了した後、サーバーから返された生データです。
例 例の使用法
次の例では、実行時にロードされるファイルのデータフォーマットとステータス情報を表示します。cfm という名前のファイルを参照している必要があります。設定に基づいて、[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルする必要がある場合もあります。または Flash Player のセキュリティ設定を更新して、このファイルのネットワークアクセスを許可する必要がある場合もあります。DRMManager は、DRM で保護されたコンテンツの表示に必要なバウチャーの取得および保存を管理します。DRM で保護されたメディアファイルのメタデータから取得された DRMContentData オブジェクトを使用して、メディア著作権サーバーからバウチャーをプリロードできます。また、すべてのバウチャーをリセットできます。ローカルキャッシュにあるすべてのバウチャーを列挙するためのメソッドは提供されていません。アプリケーションでは DRMManager クラスのインスタンスを新規作成することはできません。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。ユーザーを認証します。イベントをイベントフローに送出します。EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。メディア著作権サーバーまたはローカルバウチャーキャッシュからバウチャーをロードします。指定されたプロパティが存在し、列挙できるかどうかを示します。ローカルにキャッシュされたすべてのDRM(デジタル著作権管理)バウチャーデータを削除します。指定されたサーバーおよびドメインとの通信に使用する認証トークンを設定します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。継承されるイベントを隠す。
継承されるイベントを表示
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。
メソッドの詳細
ユーザーを認証します。保存された認証トークンを使用するか、または他の手段でダウンロードされたトークンを使用して、メディア著作権サーバーで認証された将来のセッションを確立できます。有効期限などのトークンのプロパティは、トークンを生成するサーバーの設定によって決定されます。重要:ユーザーのインターネット接続が認証を必要とするプロキシサーバーを経由する場合、authenticate() メソッドは成功しません。
バウチャーを取得すると、コンテンツをオフラインで表示できます(バウチャーによって表されたライセンスがオフライン再生を許可している場合)
バウチャーは、setting パラメータに従ってロードされます。LOCAL_ONLY:バウチャーはローカルキャッシュからのみロードされます。ALLOW_SERVER:バウチャーをローカルキャッシュからロードできる場合はロードし、ローカルキャッシュからロードできない場合はサーバーからダウンロードします。バウチャーがロードされると、アプリケーションではすぐに再生を開始できます。このバウチャーオブジェクトを使用して、関連付けられたメディア著作権情報をユーザーに表示することができます。メディア著作権サーバーからバウチャーをロードできなかった場合は、DRM エラーイベントが送出されます。一般的なエラーの原因には、オフラインのユーザーが FMRMS サーバーに接続しようとした場合や、ログインしていないユーザーがバウチャーをロードしようとした場合などが含まれます。アプリケーションでこれらのエラーに応答し、対応策を取ることができます。例えば、バウチャーのダウンロードに認証資格情報が必要な場合、ユーザーにアカウントのユーザー名とパスワードを要求し、DRMManager の authenticate() メソッドを呼び出した後、バウチャーのロードを再び試行できます。代わりに、DRM ステータスイベントが送出されます。setting:String — バウチャーをローカルキャッシュまたはメディア著作権サーバーのどちらから取得するかを決定します。ローカルにキャッシュされたすべてのDRM(デジタル著作権管理)バウチャーデータを削除します。ユーザーが暗号化されたコンテンツにアクセスできるようにするには、アプリケーションが必要なバウチャーを再度ダウンロードする必要があります。指定されたサーバーおよびドメインとの通信に使用する認証トークンを設定します。トークンを設定することにより、サーバーおよびドメイン用にキャッシュされている既存のトークンがすべて上書きされます。キャッシュされたトークンを消去するには、token パラメータを null に設定します。
イベントの詳細
イベントリスナーの追加および削除時に型パラメータで認証完了イベントに使用されるストリング定数
イベントリスナーの追加および削除時に型パラメータで認証エラーイベントに使用されるストリング定数
utils パッケージには、コード実行のタイミング調整、クラスおよびオブジェクトに関する情報の取得、およびエスケープ文字の変換を行うためのパッケージレベルの様々な関数が含まれます。useCodePage の値に従って、UTF-8 またはシステムコードページのいずれかにエンコードされた入力ストリングをエスケープしたコピーを返します。name パラメータで指定したクラスのクラスオブジェクトへの参照を返します。オブジェクトの完全修飾クラス名を返します。value パラメータで指定したオブジェクトの基本クラスの完全修飾クラス名を返します。この時間は、相対時間の計算に使用されます。ミリ秒単位で指定した間隔ごとに関数を実行します。ミリ秒単位で指定した遅延時間の経過後に、指定した関数を実行します。useCodePage の値に従って、UTF-8 またはシステムコードページのいずれかからデコードされた入力ストリングをアンエスケープしたコピーを返します。次のように変数を設定します。これは、先に作成された間隔のリファレンス ID です。次のように変数を設定します。次の例では、setTimeout() メソッドを使用して、指定した遅延時間後に別のメソッドを呼び出します。ループが作成され、100 万までカウントされます。このメソッドは、ActionScript 言語に対してリフレクションのプログラミング概念を実装します。value パラメータが特定の型のインスタンスである場合、返される XML オブジェクトにはその型のすべてのインスタンスプロパティが含まれますが、静的プロパティは含まれません。特定の型の静的プロパティを取得するには、型自体を value パラメータに渡します。返される XML オブジェクトには、そのタイプの静的プロパティのみでなく、すべてのインスタンスプロパティも含まれています。インスタンスプロパティは、<factory> というタグ内にネストされ、静的プロパティと区別されます。
次の表は、describeType() によって生成される XML オブジェクトのタグおよび属性のいくつかについて説明したものです(返されるすべてのクラス名およびインターフェイス名は完全修飾名です)
XML オブジェクトのルートタグです。ActionScript オブジェクトを定義しているクラスが拡張しているスーパークラスの名前です。ActionScript オブジェクトを定義しているクラスが実装しているインターフェイスの名前です。アクセサの名前です。プロパティのアクセス権です。プロパティのデータ型です。定数は、const ステートメントで定義されたプロパティです。定数の名前です。定数のデータ型です。メソッドは、クラス定義の一部として宣言された関数です。メソッドの名前です。メソッドの定義が含まれるクラスです。メソッドの戻り値のデータ型です。メソッドによって定義されるパラメータごとに別個の parameter タグが使用されます。メソッドのパラメータリストにパラメータが表示される順序に対応する番号です。最初のパラメータの値は 1 です。パラメータのデータ型です。変数は、var ステートメントで定義されたプロパティです。変数の名前です。変数のデータ型です。ActionScript オブジェクトがクラスオブジェクトまたはコンストラクタ関数の場合、インスタンスのすべてのプロパティおよびメソッドは、このタグ内にネストされます。このタグは、ActionScript オブジェクトがクラスオブジェクトまたはコンストラクタ関数の場合にのみ含まれます。XML — パラメータとして渡されたオブジェクトの詳細が含まれる XML オブジェクトです。オブジェクトに関する次の情報が記述されています。
オブジェクトのクラス
クラスの属性
クラスから基本クラスへの継承ツリー
クラスによって実装されているインターフェイス
クラスの宣言されたインスタンスプロパティ
クラスの宣言された静的プロパティ
クラスのインスタンスメソッド
クラスの静的メソッド
クラスの各メソッドの名前、パラメータ数、戻り値の型、およびパラメータの型
プライベート、パッケージ内部、またはカスタム名前空間にあるプロパティおよびメソッドは表示されません。useCodePage の値に従って、UTF-8 またはシステムコードページのいずれかにエンコードされた入力ストリングをエスケープしたコピーを返します。useCodePage を使用すると、ローカルコードページでエンコードされた古いコンテンツにプレーヤーでアクセスできます。ただし、古いコードページを使用しているシステムでしかアクセスできません。たとえば、Shift-JIS としてエンコードされた日本語データは、日本語のデフォルトコードページを使用した OS でしか正しくエスケープおよびアンエスケープできません。
'ü' 文字が含まれていないラテン語以外のコードページが使用されていると、"Cr
e" という結果になる場合があります。name パラメータで指定したクラスのクラスオブジェクトへの参照を返します。ここでは以下の手順を実行します。オレンジ色の背景色と 80 ピクセルのサイズの変数を宣言します。これらは後で四角形の描画に使用されます。オブジェクトの完全修飾クラス名を返します。value パラメータで指定したオブジェクトの基本クラスの完全修飾クラス名を返します。メモ : この関数はインスタンス階層に制限されています。データ型に対して describeType() を呼び出すと、クラスオブジェクト階層に基づいてスーパークラスが返されます。スーパークラスでは、すべてのクラスオブジェクトが Class から継承されます。つまり、型のインスタンスと型自体のどちらを使用するかに関係なく、結果は同じです。存在しない場合は null が返されます。この時間は、相対時間の計算に使用されます。カレンダー日付 (タイムスタンプ) については、Date オブジェクトを参照してください。Player で SWF ファイルの再生を開始し、後で別の SWF ファイルをロードした場合、戻り値は最初の SWF ファイルがロードされた時刻からの相対時間になります。ミリ秒単位で指定した間隔ごとに関数を実行します。引用符や括弧を使用しないでください。また、呼び出す関数にパラメータを指定しないでください。uint — 時間設定されたプロセスに対する一意の数値識別子です。ミリ秒単位で指定した遅延時間の経過後に、指定した関数を実行します。このメソッドを使用する代わりに、repeatCount パラメータを 1(タイマーを 1 回のみ実行する設定)にして、指定した間隔で Timer オブジェクトを作成することを検討してください。引用符や括弧を使用しないでください。また、呼び出す関数にパラメータを指定しないでください。uint — 時間設定されたプロセスに対する一意の数値識別子です。次の例では、setTimeout() メソッドを使用して、指定した遅延時間後に別のメソッドを呼び出します。useCodePage の値に従って、UTF-8 またはシステムコードページのいずれかからデコードされた入力ストリングをアンエスケープしたコピーを返します。useCodePage を使用すると、ローカルコードページでエンコードされた古いコンテンツにプレーヤーでアクセスできます。ただし、古いコードページを使用しているシステムでしかアクセスできません。例えば、Shift-JIS としてエンコードされた日本語データは、日本語のデフォルトコードページを使用した OS でしか正しくエスケープおよびアンエスケープできません。String — 入力ストリングをアンエスケープしたコピーです。e" などのさまざまな結果が発生する可能性があります。
ローカルデータベースでの SQL サポート
このデータベースエンジンは、オープンソースの SQLite データベースシステムを使用して、多くの標準 SQL 機能を持つローカル SQL データベースをサポートします。ランタイムでは、データベースのデータをファイルシステムのどこに、どのように格納するのかは指定しません。各データベースは、完全に単一ファイル内に格納されます。開発者はファイルシステム内にデータベースファイルを格納する場所を指定できます。また、1 つの AIR アプリケーションで 1 つまたは複数の異なるデータベース(別々のデータベースファイル)にアクセスできます。このドキュメントは、包括的な SQL リファレンスとしての利用を想定したものではなく、Adobe AIR でサポートする SQL ダイアレクトの詳細を説明したものです。SQL 学習用には様々な参考文献、Web サイト、書籍、およびトレーニング資料が存在するので、このドキュメントでは、包括的な SQL のリファレンスまたはチュートリアルの体裁はとらず、Apollo AIR でサポートしている SQL 構文について、また、このダイアレクトと SQL-92 との違いについての説明を主眼としています。ここで取り上げるトピックは次のとおりです。
データ型のサポート
このドキュメントで使用する表記規則
この節では、Adobe AIR SQL データベースエンジンでサポートされている SQL 構文について、文と句の種類、式、ビルトイン関数、および演算子に分けて説明します。ここで取り上げるトピックは次のとおりです。
特殊な文と句
ビルトイン関数(集計関数、スカラ関数、および日付/時刻書式設定関数)
サポートされていない SQL 機能
各種の文と式に関する具体的な構文に加えて、SQL 構文には一般に次のような規則があります。大文字と小文字の区別:SQL 文(オブジェクト名を含む)では、大文字と小文字は区別されません。ただし、SQL 文では SQL キーワードが大文字で表記されることが多いので、このドキュメントでもこの表記規則を使用します。SQL シンタックスでは大文字と小文字が区別されませんが、SQL のリテラルテキスト値は大文字と小文字が区別され、比較およびソート操作では、列または操作に対して定義されている照合シーケンスの指定に従って大文字と小文字を区別できます。空白:SQL 文では、個々の単語を区切るために空白文字(スペース、タブ、改行など)を使用する必要があります。ただし、単語と記号の間の空白はオプションです。SQL ステートメントに含まれる空白文字の種類と個数は意味を持ちません。インデントや改行などの空白文字を使用して SQL 文を読みやすいように整形できます。書式を整形しても、SQL 文の意味は変わりません。データ操作文は最もよく使用する SQL 文です。データ操作文は、データベーステーブルのデータの取得、追加、変更、および削除に使用します。次のデータ操作文がサポートされています。SELECT 文は、データベースに問い合わせるときに使用します。SELECT 文の結果は、それぞれ固定数の列を持つ 0 行以上のデータ行です。結果の式が * の場合は、その 1 つの式がすべてのテーブルのすべての列に置き換えられます。
テーブル名の後に
* を続けて指定すると、その 1 つのテーブルのすべての列が返されます。DISTINCT キーワードを指定すると、結果行の重複しないサブセットが返されます。NULL 値はすべて同じものとして扱われます。デフォルトでは、すべての結果行が返されます。これを明示的に指定するには、キーワード ALL を使用します。クエリは FROM キーワードの後に指定した 1 つ以上のテーブルに対して実行されます。複数のテーブル名をカンマで区切ると、各テーブルがクロス結合されます。JOIN 構文を使用して、テーブルの結合方法を指定することもできます。FROM 句のテーブルとして、括弧で囲んだサブクエリを使用できます。FROM 句全体を省略することもできます。この場合は、result 式リストの値で構成された 1 つの行が返されます。WHERE 句は、クエリで取得する行数を限定する場合に使用します。WHERE 句の式はブール値に解決される必要があります。WHERE 句によるフィルタリングはグループ化の前に行われるので、WHERE 句の式に集計関数を含めることはできません。GROUP BY 句は、結果に集約関数が含まれている場合に特に役立ちます。したがって、HAVING 式は、集約関数を含む値を参照できます。各ソートキーの後にはオプションで sort-order 句を付けることができます。この句には、COLLATE キーワードとテキストの並べ替えに使用する照合関数の名前、およびソート順序を指定するキーワード ASC(昇順)または DESC(降順)を指定できます。LIMIT 句は、結果で返される行数の上限を設定します。LIMIT の後にオプションの OFFSET を付けると、結果セットの先頭から指定した行数がスキップされます。OFFSET キーワードの代わりにカンマを使用すると、最初の数がオフセットになり、2 番目の数が上限になります。この見かけの違いは意図的なもので、古い SQL データベースシステムとの互換性を最大限確保することを目的としています。3 つ以上の SELECT 文を接続すると、最初から順に結果が結合されます。使用できる式の定義については、「式」を参照してください。VALUES キーワードを使用する最初の形式では、既存のテーブルに新しい行が 1 行作成されます。column-list を指定しない場合は、テーブルの列と同じ数の値を指定する必要があります。column-list を指定する場合は、指定した列と同じ数の値を指定する必要があります。列リストに含まれないテーブルの列には、テーブルの作成時に定義されたデフォルト値が格納されます。デフォルト値が定義されていない場合は NULL が格納されます。SELECT 文の結果行ごとに、テーブル内に新しいエントリが 1 つ作成されます。形式を使用する)のと同じです。UPDATE 文は、テーブルの特定の行セットに含まれる列の値を変更するときに使用します。式では他の列の値を使用できます。式はすべて、割り当てが行われる前に評価されます。指定可能な式の定義については、「式」を参照してください。WHERE 句を使用すると、更新する行を限定できます。WHERE 句の式はブール値に解決される必要があります。DELETE 文は、テーブルからレコードを削除するときに使用します。このコマンドでは、DELETE FROM キーワードの後に、レコードを削除する対象のテーブルの名前を指定します。WHERE 句を省略すると、テーブルのすべての行が削除されます。WHERE 句を指定すると、式に一致する行のみが削除されます。WHERE 句の式はブール値に解決される必要があります。指定可能な式の定義については、「式」を参照してください。データ定義文は、テーブル、ビュー、インデックス、トリガなどのデータベースオブジェクトを作成、変更、および削除するときに使用します。次のデータ定義文がサポートされています。テーブル名には、識別子またはストリングを使用できます。各列定義は、列名とその列のデータ型、およびオプションで 1 つ以上の列制約を並べたものです。列のデータ型は、その列に格納できるデータを制限します。異なるデータ型の列に値を格納しようとすると、可能な場合にはランタイムによって値が適切な型に変換され、可能でない場合にはエラーが発生します。詳しくは、「データ型のサポート」を参照してください。UNIQUE 制約を指定すると、指定された 1 つまたは複数の列にインデックスが作成されます。このインデックスには、一意キーが含まれている必要があります。つまり、任意の行と任意の別の行の間で、指定された列の値、または指定された複数列の値の組み合わせが必ず異なっていなくてはなりません。列定義内の複数の列に UNIQUE 制約を指定できるほか、複数テーブルレベルで UNIQUE 制約を設定することもできます。CHECK 制約では、行のデータを挿入または更新する際の条件となる式を定義します。この式が true に評価された場合のみ、行のデータが挿入または更新されます。CHECK 制約の式の結果はブール値として解決される必要があります。列定義内の COLLATE 句は、列のテキストエントリを比較するときに使用するテキスト照合関数を指定します。値は、NULL、ストリング定数、または数値にすることができます。値が NULL、ストリング定数、または数値の場合は、INSERT ステートメントで列の値が指定されていない場合に、これらがそのまま列に挿入されます。これは、その列に一意の整数値しか格納できないことを意味します。これは、ある列の定義の一部または単一のテーブルレベル PRIMARY KEY 制約にすることができます。いくつかの制約の後にオプションの conflict-clause を続けると、その制約に対するデフォルトの制約競合解決アルゴリズムを指定できます。同じテーブル内の異なる制約に対して、異なるデフォルト競合解決アルゴリズムを指定することも可能です。FOREIGN KEY 制約などの追加の制約を指定してもエラーにはなりませんが、実行時に無視されます。データベース接続が終了すると、自動的に削除されます。一時テーブルでは、作成されたインデックスも一時的です。一時テーブルと一時インデックスは、メインのデータベースファイルとは別のファイルに格納されます。列数またはテーブル内の制約数に恣意的な制限はありません。1 行のデータ量にも恣意的な制限はありません。結果に含まれる列の名前がテーブル列の名前になります。ALTER TABLE コマンドを使用すると、テーブルの名前を変更したり、既存のテーブルに新しい列を追加したりできます。テーブルから列を削除することはできません。このコマンドはあくまでも同じデータベース内でテーブル名を変更するためのもので、アタッチされたデータベース間でテーブルを移動することはできません。名前変更されるテーブルにトリガまたはインデックスがある場合、それらはテーブル名が変更された後もテーブルにアタッチされたままになります。ただし、名前変更されるテーブルを参照するトリガによって実行されたビュー定義またはステートメントがある場合は、新しいテーブル名を使用するように自動的に変更されることはありません。名前変更されたテーブルにビューまたはトリガが関連付けられている場合は、新しいテーブル名を使用してトリガまたはビュー定義を手動で削除し、再作成する必要があります。新しい列は常に、既存の列リストの最後に追加されます。指定したテーブルは、データベースおよびディスクファイルから完全に削除されます。テーブルを復元することはできません。テーブルに関連付けられたインデックスもすべて削除されます。デフォルトでは、DROP TABLE 文を実行してもデータベースファイルのサイズは小さくなりません。データベース内に空の領域が保持され、後続の INSERT 操作でその領域が使用されます。データベースが最初に作成されたときに autoClean パラメータが true に設定された場合は、領域が自動的に解放されます。オプションの IF EXISTS 句を指定すると、テーブルが存在しない場合に通常発生するエラーが抑制されます。CREATE INDEX コマンドでは、キーワード CREATE INDEX の後に新しいインデックスの名前、キーワード ON、およびインデックスを作成する既に作成済みのテーブルの名前を指定し、その後にインデックスキーに使用するテーブル内の列名のリストを括弧で囲んで記述します。各列名の後にはソート順序を指定する ASC または DESC キーワードを続けることができますが、ソート順序の指定はランタイムでは無視されます。ソートは常に昇順で行われます。各列の後の COLLATE 句は、その列のテキスト値で使用する照合順序を定義します。照合順序が指定されていない場合は、BINARY 照合順序が使用されます。1 つのテーブルにアタッチできるインデックス数に恣意的な制限はありません。インデックス内の列数にも制限はありません。指定したインデックスは、データベースファイルから完全に削除されます。インデックスを復元する唯一の方法は、適切な CREATE INDEX コマンドを再度発行することです。デフォルトでは、DROP INDEX 文を実行してもデータベースファイルのサイズは小さくなりません。データベース内に空の領域が保持され、後続の INSERT 操作でその領域が使用されます。データベースが最初に作成されたときに autoClean パラメータが true に設定された場合は、領域が自動的に解放されます。この新しく割り当てた名前は、別の SELECT 文の FROM 句でテーブル名の代わりに使用できます。通常、ビューは、複雑な(および最近使用された)データのセットを他の操作で使用できる構造に結合することで、クエリーを単純化するために使用されます。ビューは読み取り専用です。ビューはデータベースから削除されますが、基になるテーブルのデータは変更されません。その場合、トリガは、SQLConnection インスタンスのメインデータベース接続が終了すると削除されます。WHEN 句を指定しなければ、すべての行に対して SQL 文が実行されます。OLD テーブルと NEW テーブルの構造は、トリガを作成するテーブルの構造と一致します。OLD テーブルには、トリガを発生させた文によって変更または削除された行の、操作が行われる前の状態が含まれます。NEW テーブルには、トリガを発生させた文によって変更または作成された行の、操作が行われた後の状態が含まれます。テーブルのトリガに加えて、INSTEAD OF トリガをビューに対して作成できます。トリガは INSTEAD OF トリガなので、ビューの基礎となるテーブルは、トリガが起動する原因となったステートメントによって変更されません。ただし、トリガは、基礎となるテーブルに対して変更操作を実行するために使用できます。テーブルまたはビューが削除されると、そのテーブルまたはビューに関連付けられたトリガもすべて自動的に削除されます。この関数の構文は次のとおりです。ERROR)イベントがディスパッチされます。RAISE(IGNORE) を呼び出すと、現在のトリガの残りの部分、トリガを発生させた文、および通常であれば引き続き実行されるはずの別のトリガがすべて中止されます。データベースの変更はロールバックされません。トリガを発生させた文自体がトリガの一部である場合、そのトリガプログラムは次のステップの最初から再開されます。トリガはデータベースから削除されます。関連付けられたテーブルが削除されたときにも、トリガは自動的に削除されます。
特殊な文と句
この節では、SQL の拡張機能としてランタイムによって提供されるいくつかの句と、多くの文で使用できる 2 つの言語要素(コメントと式)について説明します。この節で説明する要素は次のとおりです。TEXT 格納クラスの値で BINARY 照合を使用すると、テキストがどのようにしてエンコードされているかにかかわらず、値を表すメモリ内のバイトを比較することによってバイナリ照合が行われます。NOCASE 照合を使用すると、大文字と小文字を区別せずに比較されます。2 つの TEXT 値を比較するときは常に、照合順序を使用し、次の規則に従って比較結果が決定されます。二項比較演算子(=、<、>、<=、および >=)では、一方のオペランドが列である場合、その列のデフォルトの照合タイプによって、比較で使用される照合順序が決まります。両方のオペランドが列である場合は、左のオペランドの照合タイプによって、使用される照合順序が決まります。どちらのオペランドも列でない場合は、BINARY 照合順序が使用されます。AND 演算子も上記の規則に従って照合順序が決定されます。IN 演算子は、使用する照合順序を決定するという点では、= 演算子と同じように動作します。その場合は、明示的に指定した照合順序が常に使用されます。それ以外の場合は、ORDER BY 句によってソートされる式が列の場合には、その列のデフォルトの照合タイプを使用してソート順序が決定されます。式が列でない場合は、BINARY 照合順序が使用されます。SQL ステートメントの前に EXPLAIN キーワードを付けると、コマンドを実際に実行する代わりに、EXPLAIN キーワードを指定せずにコマンドを実行した場合に使用される一連の仮想マシン命令が報告されます。この高度な EXPLAIN 機能を使用すると、SQL ステートメントのテキストを調整してパフォーマンスを最適化したり、適切に機能しない SQL ステートメントをデバッグしたりできます。これは他の多くの SQL コマンドで使用できる非標準の句です。キーワードは異なりますが、句の意味はどちらの形式でも同じです。これら 5 種類の競合アルゴリズムについて以下に説明します。トランザクションがアクティブでない場合(すべてのコマンドについて作成される暗黙的なトランザクションを除く)、このアルゴリズムは ABORT と同じです。ROLLBACK は実行されないので、トランザクション内の前のコマンドで行われた変更はそのまま残ります。ただし、制約違反が発生する前にそのステートメントによってデータベースに加えられた変更は取り消されずにそのまま残ります。例えば、UPDATE 文の実行時に更新対象の 100 行目で制約違反が発生した場合、それまでの 99 行の変更はそのまま残りますが、100 行目以降の変更は行われません。IGNORE - 制約違反が発生したとき、制約違反を含む 1 行は挿入も変更もされません。行が無視されるという点を除き、コマンドは通常どおり続行されます。制約違反が発生した行の前後の行は通常どおり挿入または更新されます。エラーは返されません。REPLACE - UNIQUE 制約違反が発生すると、制約違反の原因となる既存の行が削除された後で、現在の行が挿入または更新されます。したがって、挿入または更新は常に実行され、コマンドは通常どおり続行されます。エラーは返されません。列にデフォルト値がない場合は、ABORT アルゴリズムが使用されます。この競合解決方法により、制約を満たすために行が削除されたときは、それらの行に対する削除トリガは呼び出されません。REINDEX コマンドは、1 つ以上のインデックスを削除して再作成するときに使用します。このコマンドは、照合シーケンスの定義が変更されたときに便利です。最初の形式では、アタッチされたデータベース内の指定された照合順序を使用するすべてのインデックスが再作成されます。2 番目の形式では、table-name を指定した場合、そのテーブルに関連付けられたすべてのインデックスが再構築されます。index-name を指定した場合は、指定したインデックスのみが削除され、再作成されます。コメントは SQL コマンドではありませんが、SQL クエリの中に記述できます。コメントはランタイムでは空白として扱われます。コメントは、空白が許可される任意の場所(複数行にわたる式の内部など)に記述できます。単一行のコメントには 2 つのダッシュを使用します。単一行コメントでは、その行の末尾までがコメントになります。ブロックコメントは、任意の行数にわたることも、単一行に埋め込むこともできます。コメントの終わりを示す区切り記号がない場合は、入力の最後までがコメントになります。これはエラーとして扱われません。新しい SQL 文は、ブロックコメントが終了した後の行から開始できます。ブロックコメントは、空白が許可される任意の場所(式の内部など)のほか、他の SQL 文の中にも埋め込むことができます。ブロックコメントはネストされません。ブロックコメントの中に単一行コメントを記述しても無視されます。式は他の SQL ブロック内のサブコマンドです。SQL 文で使用する式の有効な構文を次に示します。式とは、単一の値に解決できる値と演算子の任意の組み合わせを指します。式はブール値(true または false)に解決されるものと、非ブール値に解決されるものの 2 種類に大別されます。この条件を満たす式の種類は次のとおりです。
いくつかの関数
いくつかの演算子(具体的には比較演算子)
リテラルの数値は、整数または浮動小数点数として記述します。科学的表記法もサポートされます。
小数点には常に
(ピリオド)を使用します。ストリングリテラルを示すときは、ストリングを一重引用符(')で囲みます。ストリングの中に一重引用符を含めるには、'' のように一重引用符を行で 2 つ重ねます。リテラルブール値は、列のデータ型が Boolean の場合に使用します。リテラル値にはトークン NULL も使用できます。これらの特殊識別子はすべて、各テーブルのすべての行に関連付けられた一意のランダムな整数キー("行キー")を表します。特殊識別子は、CREATE TABLE 文で同じ名前を持つ実際の列が定義されていない場合のみ、行キーを参照します。行キーは読み取り専用列のように動作します。行キーは通常の列が使用できる場所であればどこでも使用できますが、行キーの値を UPDATE 文または INSERT 文で変更することはできません。スカラ量または IN 演算子のオペランドとして使用する場合、SELECT ステートメントで返すことができるのは 1 つの列のみです。SELECT 式のどの項も外側のクエリの値を参照しない場合、式は他の処理が実行される前に 1 回だけ評価され、その結果が必要に応じて再利用されます。SELECT 式に外部クエリからの変数が含まれる場合(これを相関サブクエリと呼びます)、SELECT ステートメントは必要になるたびに再評価されます。IN 演算子の前に NOT キーワードを付けると、テストの意味が逆になります。IN 演算子の右オペランド以外の式で SELECT ステートメントを使用する場合は、SELECT ステートメントの結果の 1 行目が値として使用されます。SELECT ステートメントが複数行の結果を返す場合、2 行目以降の行はすべて無視されます。CAST 式は、指定された値のデータ型を別の指定されたデータ型に変更します。指定できるデータ型は、CREATE TABLE 文の列定義でデータ型として使用できる空でない型名です。詳しくは、「データ型のサポート」を参照してください。
その他の式要素
以降の節では、式で使用できるその他の SQL 要素について説明します。ビルトイン関数は次の 3 種類に大別されます。これは、トリガの実行時にエラー通知を提供するために使用します。SQL のすべてのキーワードと同様に、関数名も大文字と小文字は区別されません。集計関数は、複数行の値に対して演算を実行します。グループ内の NULL でないすべての X の平均値を返します。数値に見えないストリング値および BLOB 値は 0 と見なされます。AVG() の結果は、入力がすべて整数であっても、常に浮動小数点値です。* 引数の付いた 2 番目の形式は、グループ内の行の総数を返します。グループ内のすべての値の最大値を返します。通常のソート順序を使用して最大値が決定されます。グループ内のすべての値のうち NULL でない最小の値を返します。通常のソート順序を使用して最小値が決定されます。グループ内の NULL でないすべての値の合計を返します。0 を返します。SUM() への入力に整数でも NULL でもない値が含まれている場合、SUM() は浮動小数点値を返しますが、この値は正確な合計の近似値である場合があります。上記の集計関数のうち引数を 1 つ受け取るものはいずれも、その引数の前にキーワード DISTINCT を付けることができます。その場合は、重複した要素が除外されてから集計関数に渡されます。スカラ関数は一度に 1 つの行の値に作用します。スカラ関数の一覧を次に示します。引数 X の絶対値を返します。NULL でない最初の引数のコピーを返します。引数は 2 つ以上指定する必要があります。NULL でない最初の引数のコピーを返します。引数は BLOB 格納型の値と解釈されます。その値の内容の 16 進数表現が返されます。現在の SQLConnection を通じてデータベースに最後に挿入された行の行識別子(生成された主キー)を返します。X のストリングの長さ(文字数)を返します。オプションの ESCAPE 句を指定すると、3 つの引数を使用して関数が呼び出されます。それ以外の場合は、2 つの引数のみを使用して関数が呼び出されます。ストリング X の、すべての文字が小文字に変換されたコピーを返します。X の左側からスペースを除去したストリングを返します。Y 引数を指定すると、Y に含まれるいずれかの文字が X の左側から除去されます。引数の中の最大値を返します。引数には、数字だけでなくストリングも指定できます。最大値は、定義されたソート順序に従って決定されます。MAX() は、引数が 2 個以上ある場合は単純な関数ですが、引数が 1 つだけの場合は集計関数になります。引数の中の最小値を返します。引数には、数字だけでなくストリングも指定できます。最小値は、定義されたソート順序に従って決定されます。MIN() は、引数が 2 個以上ある場合は単純な関数ですが、引数が 1 つだけの場合は集計関数になります。引数が異なる場合は最初の引数を返し、それ以外の場合は NULL を返します。このルーチンは、引数の値を別の SQL 文に挿入するのに適した形に変更したストリングを返します。ストリングは一重引用符で囲まれ、必要に応じて内部引用符がエスケープされます。BLOB 格納クラスは 16 進数のリテラルとしてエンコードされます。この関数は、元に戻す/繰り返し機能を実装するためのトリガを記述する場合に役立ちます。これは暗号的に強い乱数ではありません。疑似ランダムバイトを含む N バイトの BLOB を返します。N は正の整数である必要があります。これは暗号的に強いランダム値ではありません。N の値が負の場合は、単一のバイトが返されます。数値 X を小数第 Y 位に四捨五入します。Y 引数を省略すると、0 が使用されます。X の右側からスペースを除去したストリングを返します。Y 引数を指定すると、Y に含まれるいずれかの文字が X の右側から除去されます。入力ストリング X の Y 番目の文字から Z 個の文字を取り出したサブストリングを返します。X の一番左の文字のインデックス位置は 1 です。Y が負の場合は、サブストリングの開始位置が左からではなく右からカウントされます。X の左右両側からスペースを除去したストリングを返します。Y 引数を指定すると、Y に含まれるいずれかの文字が X の左右両側から除去されます。式 X の型を返します。データ型について詳しくは、「データ型のサポート」を参照してください。ストリング X の、すべての文字が大文字に変換されたコピーを返します。日付/時刻書式設定関数は、書式設定された日付および時刻データの作成に使用するスカラ関数のグループです。これらはストリング値および数値を引数とし、ストリング値および数値を返します。DATE データ型に対して使用するものではありません。DATE データ型で宣言された列のデータを使用する場合、これらの関数は期待どおりに動作しません。最初のパラメータ(T)では、「時刻書式」で示された書式の時刻ストリングを指定します。時刻ストリングの後に任意の数の修飾子を指定できます。修飾子については、「修飾子」を参照してください。最初のパラメータ(T)では、「時刻書式」で示された書式の時刻ストリングを指定します。時刻ストリングの後に任意の数の修飾子を指定できます。修飾子については、「修飾子」を参照してください。最初のパラメータ(T)では、「時刻書式」で示された書式の時刻ストリングを指定します。時刻ストリングの後に任意の数の修飾子を指定できます。修飾子については、「修飾子」を参照してください。最初のパラメータ(T)では、「時刻書式」で示された書式の時刻ストリングを指定します。時刻ストリングの後に任意の数の修飾子を指定できます。修飾子については、「修飾子」を参照してください。STRFTIME() ルーチンは、最初の引数 F で指定された書式ストリングに従って書式設定された日付を返します。書式ストリングでは、次の置換がサポートされます。2 番目のパラメータ(T)では、「時刻書式」で示された書式の時刻ストリングを指定します。時刻ストリングの後に任意の数の修飾子を指定できます。修飾子については、「修飾子」を参照してください。時刻ストリングには、次のいずれかの書式を使用できます。
現在の日時(世界標準時)
上記の書式に含まれる T は、日付と時間を区切るリテラル文字の "T" です。時刻ストリングの後に修飾子を 0 個以上続けることで、日付または日付の解釈を変更できます。使用できる修飾子は次のとおりです。時刻に加算する日数です。時刻に加算する時間数です。時刻に加算する分数です。時刻に加算する秒数およびミリ秒数です。時刻に加算する月数です。時刻に加算する年数です。時刻を月の初めに戻します。時刻を年の初めに戻します。時刻を日の初めに戻します。日付をローカル時間に変換します。日付を世界標準時に変換します。SQL は様々な演算子をサポートしており、ほとんどのプログラミング言語に存在する一般的な演算子のほか、SQL に固有の演算子もあります。
一般的な演算子
次のリストは、SQL ブロックで使用できる二項演算子を優先順位の高い順に並べたものです。単項前置演算子は次のものがサポートされています。COLLATE 演算子は単項後置演算子と見なすことができます。COLLATE 演算子は優先順位が最も高く、常に他のどの前置単項演算子や二項演算子よりも強く結び付きます。等号演算子と不等号演算子はそれぞれ 2 種類あります。|| はストリングを連結する演算子で、そのオペランドである 2 つのストリングを 1 つにつなげます。% 演算子は、右オペランドを法とする左オペランドの剰余を返します。二項演算子の結果は数値です。ただし、|| 連結演算子だけは例外で、結果がストリングになります。LIKE 演算子は、パターンマッチングによる比較を行います。LIKE 演算子の右オペランドにはパターンを指定し、左オペランドにはそのパターンと照合するストリングを指定します。パターン内のパーセント記号(%)はワイルドカード文字で、ストリング内の 0 個以上連続した文字に一致します。パターン内のアンダースコア(_)はストリング内の任意の 1 文字に一致します。その他の文字はすべて、その文字そのものとして、大文字と小文字を区別せずに照合されます(メモ:データベースエンジンでは、7 ビットラテン文字の大文字と小文字のみが理解されます。オプションの ESCAPE 句を指定する場合、ESCAPE キーワードの後に続く式は、1 文字で構成されるストリングに評価される必要があります。この文字は、LIKE パターンの中で、リテラルのパーセントまたはアンダースコア文字を照合するために使用できます。パターン内でエスケープ文字の後にパーセント記号、アンダースコア、またはエスケープ文字自体を記述すると、それらはそれぞれ、ストリング内のリテラルのパーセント記号、アンダースコア、またはエスケープ文字に一致します。IN 演算子は、左オペランドが、右オペランド(括弧で囲まれた値のリスト)内のいずれかの値と等しいかどうかを返します。右オペランドには複数のリテラル値をカンマで区切って記述するか、SELECT 文を記述します。
GLOB、LIKE、および IN 演算子の前に NOT キーワードを付けると、テストの意味が逆になります(つまり、値が指定のパターンと一致しないことが確認されます)
パラメータは、式の中でリテラル値を表すためのプレースホルダーを指定します。パラメータは次の 3 つの形式をとります。疑問符はインデックス付きのパラメータを示します。この形式のパラメータには、SQL ステートメントに登場した順に数値インデックス値が割り当てられます。インデックス値は 0 から始まります。コロンの後に識別名が付いた形式は、AAAA という名前の名前付きパラメータ用の場所を保持します。名前付きパラメータにも、SQL 文に登場した順に数値インデックスが付けられます。混乱を避けるために、名前付きパラメータとインデックス付きパラメータを混在させないことをお勧めします。
サポートされていない SQL 機能
再帰トリガ(自分自身をトリガするトリガ)はサポートされていません。ネストされたトランザクション - 単一のアクティブトランザクションのみが許可されます。更新可能なビュー - ビューは読み取り専用です。つまり、アクセス許可として適用できるのは、基になるオペレーティングシステムの通常のファイルアクセス許可のみです。COPY:この文はサポートされていません。システムテーブルにはアクセスできません。ランタイムには、オブジェクト指向的な方法でスキーマデータにアクセスできるスキーマ API が含まれています。ステートメントパラメータのインデックス:多くの実装では、ステートメントパラメータのインデックスは 1 から始まります。
それに対して、Adobe AIR の場合、ステートメントパラメータのインデックスは 0 から始まります(最初のパラメータのインデックス値は 0、2 番目のパラメータのインデックス値は 1 というようになります)
OBJECT: OBJECT:Object クラスまたは AMF3 を使用して直列化および非直列化することが可能なすべてのサブクラスに対応します(これには、カスタムクラスを含む多くのクラスが含まれますが、表示オブジェクトまたは表示オブジェクトをプロパティとして持つオブジェクトは含まれません)
データ型のサポート
ほとんどの SQL データベースとは異なり、Adobe AIR の SQL データベースエンジンでは、テーブルの列に特定の型の値を格納する必要はなく、特定の型が強制されることもありません。その代わりに、格納クラスと列親和型という 2 つの概念を使用してデータ型が管理されます。この節では、格納クラスと列親和型について説明し、様々な条件下でデータ型の違いがどのように解決されるのかを示します。
データ型と比較演算子
データ型と数値演算子
データ型とソート
データ型とグループ化
格納クラスは、データベースへの値の格納に使用される実際のデータ型を表します。次の格納クラスが使用できます。SQL 文に埋め込まれたリテラルとしてデータベースに渡される値、またはパラメータを使用して SQL 文にバインドされた値はすべて、SQL 文が実行される前に格納クラスに割り当てられます。SQL 文に含まれるリテラルは、一重引用符または二重引用符で囲まれている場合は格納クラス TEXT に、引用符で囲まれておらず、小数点または指数のない数字として指定されている場合は INTEGER に、引用符で囲まれておらず、小数点または指数の付いた数字として指定されている場合は REAL に、値が NULL の場合は NULL に、それぞれ割り当てられます。詳しくは、「式」の「リテラル値」を参照してください。parameters 結合配列を使用してパラメータとして提供された値は、バインドされたネイティブのデータ型に最も近い格納クラスに割り当てられます。列の親和型は、その列に格納するデータに推奨される型です。INSERT ステートメントまたは UPDATE ステートメントで値を列に格納すると、ランタイムはその値のデータ型を指定された親和型に変換しようとします。これは、データベースに格納する前にオブジェクトの toString() メソッドを呼び出した場合に相当します。値を指定された親和型に変換できない場合はエラーが発生し、処理は行われません。SELECT ステートメントを使用してデータベースから値を取得すると、格納時に別のデータ型から変換されているかどうかに関係なく、親和型に対応するクラスのインスタンスが返されます。データベースの各列には、次のいずれかの親和型が割り当てられます。数値データを TEXT 親和型の列に挿入すると、データがテキスト形式に変換されてから格納されます。テキストデータを NUMERIC 列に挿入すると、データを格納する前に整数または実数への変換が試みられます。変換できない場合は、エラーが発生します。NUMERIC 列から取得した値は、値に適した最も具体的な数値型のインスタンスとして返されます。つまり、値が正の整数または 0 の場合、uint インスタンスが返され、負の整数の場合、int インスタンスが返されます。また、値に浮動小数点部分(非整数)がある場合、Number インスタンスが返されます。相違点は、浮動小数点部分のない実数値(Number インスタンスなど)または浮動小数点部分のない実数値に変換できるテキスト値を挿入した場合に、値が整数に変換され、INTEGER 記憶クラスを使用して格納される点のみです。浮動小数点部分のある実数値を格納しようとすると、エラーが発生します。REAL 親和型または NUMBER 親和型の列も NUMERIC 親和型の列と同じように動作しますが、整数値が強制的に浮動小数点表現に変更される点が異なります。DATE 親和型の列には、日付と時刻の値が格納されます。変換に失敗するとエラーが発生します。コードで Number、int、または uint の値を格納しようとした場合、日付の検証は行われず、有効なユリウス日付値と見なされます。DATE 値は REAL 記憶クラスを使用してユリウス日付値として格納されるので、ソート操作や比較操作も期待どおりに動作します。値を有効な XML に変換できない場合、エラーが発生します。無効な値を格納した場合、その値の取得時に空の XML オブジェクトが返されます。値の取得時に AMF3 形式から非直列化され、格納されていたクラスのインスタンスとして返されます。表示オブジェクトなど一部の ActionScript クラスは、元のデータ型のインスタンスとして非直列化できません。
カスタムクラスインスタンスの場合、格納する前に flash
また、このデータを取得する前に、クラスに対して同じエイリアスを登録する必要があります。本質的に非直列化できないクラスであるため、あるいはクラスのエイリアスが未指定または不一致であるために適切に非直列化できないデータは、格納されている元のインスタンスに対応するプロパティと値を持つ匿名オブジェクト(Object クラスインスタンス)として返されます。NONE 親和型の列には、優先される格納クラスはありません。データを挿入する前にデータの変換は行われません。
親和型の決定
親和型を決定する際は、次の規則が適用されます。列のデータ型にストリング "BLOB" が含まれている場合、またはデータ型が指定されていない場合、NONE 親和型になります。ステートメントを使用してテーブルを作成する場合は、どの列にもデータ型が指定されていないので、すべての列が NONE 親和型になります。
データ型と比較演算子
= がサポートされています。また、複数の値のいずれかに一致するかどうかをチェックする IN 演算子と、三項比較演算子の BETWEEN も使用できます。これらの演算子について詳しくは、「演算子」を参照してください。比較の結果は、比較する 2 つの値の格納クラスによって異なります。2 つの値を比較するときは、次の規則が適用されます。格納クラス NULL の値は、他のどの値(格納クラス NULL の別の値も含む)よりも小さいと見なされます。2 つの TEXT 値を比較するときは、二項比較が行われます。2 つの BLOB 値を比較した結果は、常に二項比較を使用して決定されます。数値記憶クラスとテキスト記憶クラスの間で二項比較を行うとき、データベースで比較が実行される前に必要に応じて値の変換が試みられます。数値格納クラスとテキスト格納クラスを比較するときは、次の規則が適用されます(メモ:次の規則で使用されている「式」という用語には、列値以外の SQL スカラ式やリテラルも含まれます。
Z は式と見なされます)
列の値を式の結果と比較する場合は、比較が行われる前に、その列の親和型が式の結果に適用されます。2 つの式の結果を比較するときには、変換は行われません。結果がそのまま比較されます。ストリングと数値を比較する場合は、常に数値がストリングより小さくなります。三項演算子 BETWEEN は常に、同等の二項表現として再構成されます。この処理は、この式を評価するために必要なそれぞれの比較において a に異なる親和型が適用される場合でも変わりません。) という形式の式も、上記の二項比較に関する 3 つの規則に従って(つまり、a = b と同じように)処理されます。例えば、b が列の値で a が式の場合は、比較が行われる前に、b の親和型が a に適用されます。IN 演算子の右の値(この例では x、y、および z の値)は、たとえそれが列の値であっても、式と見なされます。IN 演算子の左の値が列の場合は、その列の親和型が使用されます。左の値が式の場合は、変換は行われません。また、COLLATE 句を使用して比較方法を変更することもできます。
データ型と数値演算子
サポートされている数値演算子(*、/、%、+、および -)のいずれを使用するときも、式を評価する前に演算子の各オペランドに数値親和型が適用されます。連結演算子 || を使用するときは、式が評価される前に各オペランドが TEXT 格納クラスに変換されます。どのオペランドも TEXT 記憶クラスに変換できない場合、その式の結果は NULL になります。このように、値を変換できない状況は次の 2 つの場合に起こります。
データ型とソート
ソートの前に格納クラスの変換は行われません。
データ型とグループ化
GROUP BY 句を使用して値をグループ化するとき、記憶クラスの異なる値は別のものと見なされます。GROUP BY 句の結果として、値に親和型が適用されることはありません。これらの比較が行われる前に、それぞれの値に親和型が適用される場合があります。可能であれば、複合 SELECT 文の結果セットの 1 つの列で返されるすべての値に同じ親和型が適用されます。適用される親和型は、その位置に(他の種類の式ではなく)列値を持つ最初の構成 SELECT 文によって返される列の親和型です。特定の複合 SELECT 列について、どの構成 SELECT 文も列値を返さない場合、その列では親和型を適用せずに値の比較が行われます。
このドキュメントで使用する表記規則
このドキュメントに記載された SQL 文の定義では、次の表記規則を使用しています。
テキストの大文字と小文字
lower case - プレースホルダー項または句の名前はすべて小文字で表記されています。
グループおよび置換可能を示す文字
| - パイプ文字は置換可能なオプションの間で使用されており、"または" に読み替えることができます。[] - 角括弧で囲まれた項目はオプション項目です。角括弧の中には、単一の項目、または互いに置換可能な複数の項目が記載されています。() - 置換可能な複数の項目(パイプ文字で区切られた項目)が丸括弧で囲まれている場合は、必須の項目グループ(つまり、単一の必須項目に対して有効な値を示す項目のセット)を示します。
繰り返し制御文字
+ - 丸括弧で囲まれた項目の後にプラス文字が付いている場合は、前の項目を 1 回以上繰り返すことができることを示します。* - 角括弧で囲まれた項目の後にアスタリスク文字が付いている場合は、前の(角括弧で囲まれた)項目を 0 回以上繰り返すことができることを示します。* - 列名、または関数名の後の丸括弧の中でアスタリスク文字が使用されている場合は、0 回以上の繰り返しではなく、リテラルのアスタリスク文字を示します。- ピリオド文字はリテラルのピリオドを表します。, - カンマ文字はリテラルのカンマを表します。() - 単一の句または項目を囲む 1 組の丸括弧は、その丸括弧が必須のリテラル丸括弧文字であることを示します。その他の文字 - 特に記載されていない限り、その他の文字はそのリテラル文字を表します。DataGrid コントロールは、List に似ていますが、複数の列のデータを表示でき、したがって複数のプロパティを持つオブジェクトの表示に適している点が異なります。
複数幅の列、または同一固定幅の列
実行時にユーザーがサイズ変更可能な列
実行時にユーザーが順序変更可能な列
オプションでカスタマイズ可能な列ヘッダー
任意の列にカスタムアイテムレンダラーを使用して、テキスト以外のデータを表示できる機能
列のクリックによるデータソートのサポート
DataGrid コントロールは、HTML テーブルのようなレイアウトツールではなく、データの表示を目的としています。DataGrid コントロールには、次のデフォルトのサイズ設定特性があります。列が空の場合、デフォルトの幅は 300 ピクセルです。列に情報が格納されていて明示的に幅が定義されていない場合、デフォルトの幅は 100 ピクセルです。DataGrid の幅は、可能であれば、すべての列が収まる幅に調整されます。デフォルトで表示される行数はヘッダー行を含めて 7、各行のデフォルトの高さは 20 ピクセルです。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
この表示オブジェクトの現在のアクセシビリティオプションです。ドラッグによる選択が有効かどうかを示すフラグです。複数のアイテムを同時に選択できるかどうかを示すフラグです。指定されたオブジェクトのアルファ透明度値を示します。
オートメーション関連機能を処理する委譲オブジェクト
このオブジェクトの識別子として使用できる名前です。[読み取り専用] この値はオブジェクトのレンダリング表示に対応しています。また、アプリケーションでの視覚表示と同じにするために、識別子とオブジェクトを関連付けるのに使用できます。[読み取り専用] コンポーネントのテキストにおける 1 行目のベースラインの y 座標です。[書き込み専用] 前景と背景のブレンドに使用するシェーダを設定します。このスプライトのボタンモードを指定します。[書き込み専用] オブジェクトのビットマップキャッシュを促すために Flex によって使用されます。このオブジェクトのビットマップキャッシュポリシーを指定します。[読み取り専用] このインスタンスのクラス名です。コントロールの列の幅です。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[読み取り専用] コンテンツ座標系におけるマウスの x 位置を返します。[読み取り専用] コンテンツ座標系におけるマウスの y 位置を返します。このオブジェクトに関連付けられたコンテキストメニューを指定します。コンポーネントの現在のビューステートです。このコンポーネントをアイテムレンダラーまたはアイテムエディタとして使用したときに、このコンポーネントによってレンダリングされるデータプロバイダ内のアイテムです。表示するデータのセットです。データヒントとして表示するデータプロバイダアイテム内のフィールドの名前です。dataTip を決定するために各アイテムで実行されるユーザー指定の関数です。このコントロールの外にアイテムをドラッグし、他のコントロールにドロップできるかどうかを示すフラグです。列の順序をユーザーが変更できるかどうかを示すフラグです。ドラッグ & ドロップ操作でコントロールからアイテムを単にコピーするのではなく、移動できるかどうかを示すフラグです。ドラッグしたアイテムをコントロールにドロップできるかどうかを示すフラグです。[読み取り専用] スプライトのドラッグ先またはスプライトがドロップされた先の表示オブジェクトを指定します。データプロバイダ内のアイテムをユーザーが編集できるかどうかを示すフラグです。
編集中のデータプロバイダアイテムに対応するアイテムレンダラの列と行のインデックスです(存在する場合)
[読み取り専用] 編集中のアイテムが存在する DataGrid コントロール内のアイテムレンダラーへの参照です。コンポーネントがユーザーの操作を受け入れることができるかどうかを指定します。バリデータによってコンポーネントを監視しているとき、検証が失敗した場合に、そのコンポーネントのエラーヒントに表示されるテキストです。コンポーネントの座標内におけるコンポーネントの明示的な高さ(ピクセル単位)を指定する数値です。レイアウト中に親によって考慮されるコンポーネントの最大推奨高さです。レイアウト中に親によって考慮されるコンポーネントの最大推奨幅です。レイアウト中に親によって考慮されるコンポーネントの最小推奨高さです。レイアウト中に親によって考慮されるコンポーネントの最小推奨幅です。コンポーネントの座標内におけるコンポーネントの明示的な幅(ピクセル単位)を指定する数値です。表示オブジェクトに現在関連付けられている各フィルタオブジェクトが格納されているインデックス付きの配列です。コンポーネントが、タブで選択されたときにフォーカスを受け付けることができるかどうかを示します。このコンポーネントとそのピアーに対するフォーカスを制御する FocusManager を取得します。このオブジェクトに関連付けられたフォーカスペインです。このオブジェクトがフォーカス矩形を表示するかどうかを指定します。このコンポーネントのフォントコンテキストを提供するモジュールファクトリです。[読み取り専用] ベクターの描画コマンドが発生するこのスプライトに属する Graphics オブジェクトを指定します。列のヘッダセルの高さ(ピクセル単位)です。[override] 親の座標内におけるコンポーネントの高さ(ピクセル単位)を指定する数値です。スプライトのヒット領域となる別のスプライトを指定します。水平スクロールバーを常にオンにするか、常にオフにするか、または setScrollBarProperties() メソッドに渡されるパラメータに基づいて自動的に変更するかを示すプロパティです。コンポーネントの ID です。IME(入力メソッドエディタ)のモードを指定します。このコンポーネントを親コンテナのレイアウトに含めるかどうかを指定します。このコンポーネントの継承スタイルのチェーンの始まりです。
オブジェクトがレイアウトの 3 つの段階(処理、測定、レイアウト)すべてを完了したものであるかどうかを示すフラグです(いずれかが必須であった場合)
[読み取り専用] 繰り返しコンポーネントのインデックスです。この UIComponent オブジェクトを親ドキュメントから参照するために必要なインデックスを含む配列です。
現在アクティブなアイテムエディタのインスタンスへの参照です(存在する場合)
コントロールのカスタムアイテムレンダラーです。ラベルを決定するために各アイテムで実行されるユーザー指定の関数です。コンポーネントをドロップインアイテムレンダラーまたはドロップインアイテムエディタとして使用すると、コンポーネントの listData プロパティがリストコントロールの追加データで初期化されます。サムの移動に合わせてスクロールするか、サムが離されるまで表示を更新しないかを示すフラグです。[読み取り専用] この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。スクロールするコントロール内の最初の列のインデックスです。スクロールするコントロール内の最初の行のインデックスです。呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。レイアウト中に親によって考慮されるコンポーネントの最大推奨高さです。レイアウト中に親によって考慮されるコンポーネントの最大推奨幅です。コンポーネントのデフォルトの高さ(ピクセル単位)です。コンポーネントのデフォルトの最小の高さ(ピクセル単位)です。コンポーネントのデフォルトの最小幅(ピクセル単位)です。コンポーネントのデフォルトの幅(ピクセル単位)です。メニュー選択方式を使用するかどうかを示すフラグです。
列の最小幅です(ピクセル単位)
レイアウト中に親によって考慮されるコンポーネントの最小推奨高さです。レイアウト中に親によって考慮されるコンポーネントの最小推奨幅です。オブジェクトの子に対してマウスが有効かどうかを調べます。このオブジェクトがマウスメッセージを受け取るかどうかを指定します。クリックしたとき、フォーカスを取得できるかどうかを示します。
[読み取り専用] マウス位置の x 座標を示します(ピクセル単位)
[読み取り専用] マウス位置の y 座標を示します(ピクセル単位)
オブジェクト階層におけるこのオブジェクトの深度を表します。このコンポーネントの非継承スタイルのチェーンの始まりです。コントロールのカスタムアイテムレンダラーです。[読み取り専用] このコンテナに含まれるオートメーションの子の数です。[読み取り専用] このオブジェクトの子の数を返します。表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。[override] [読み取り専用] このコンポーネントの親コンテナまたは親コンポーネントです。コンポーネントの高さを親のサイズに対する比率(パーセンテージ)で指定する数値です。コンポーネントの幅を親のサイズに対する比率(パーセンテージ)で指定する数値です。子をすぐに生成するか、遅延生成した後、このいずれかの発生に応じて、true に設定されます。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。列のサイズをユーザーが変更できるかどうかを示すフラグです。[読み取り専用] 読み込まれた SWF ファイル内の表示オブジェクトの場合、root プロパティはその SWF ファイルが表す表示リストのツリー構造部分の一番上にある表示オブジェクトとなります。表示する行の数です。ピクセル単位で表した行の高さです。現在有効な拡大 / 縮小グリッドです。オブジェクトの基準点から適用されるオブジェクトの奥行きスケール(パーセンテージ)を示します。[読み取り専用] このオブジェクトの基本的な描画面のサイズと位置を含むオブジェクトを返します。表示オブジェクトのスクロール矩形の境界です。選択されたアイテムを選択状態でリストに表示するかどうかを示すフラグです。選択されたアイテムのデータプロバイダ内のインデックスです。選択されたアイテムのデータプロバイダ内のインデックスの配列です。データプロバイダ内の選択されたアイテムへの参照です。データプロバイダ内の選択されたアイテムへの参照の配列です。コントロールに列ヘッダを表示するかどうかを示すフラグです。オートメーションオブジェクトがオートメーション階層に表示されているかどうかを示すフラグです。スクロールサムをドラッグしたときに、その近くにツールヒントを表示するかどうかを示すフラグです。ユーザーが列ヘッダーセルをクリックすることでデータプロバイダアイテムをソートできるかどうかを示すフラグです。このスプライト内のサウンドを制御します。[読み取り専用] 表示オブジェクトのステージです。
このコンポーネントに対して定義されたビューステート
このオブジェクトのインラインの継承スタイルの記憶域です。
このコンポーネントで使用するクラススタイル
オブジェクトの子に対してタブが有効かどうかを調べます。このオブジェクトがタブ順序に含まれるかどうかを指定します。SWF ファイル内のオブジェクトのタブ順序を指定します。ツールヒントに表示するテキストです。表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。各 Transition オブジェクトには、ビューステートが変化したときに再生されるエフェクトのセットが定義されます。
このオブジェクトに対して現在トゥイーンされているプロパティの配列
オブジェクトの一意の識別子です。
オブジェクトが 3 段階のレイアウト検証をすべて完了したものであるかどうかを示すフラグです(いずれかの検証が必須であった場合)
buttonMode プロパティが true に設定されたスプライト上にマウスが移動したときに、指差しハンドポインタ (ハンドカーソル) を表示するかどうかを示すブール値です。このコンポーネントにサブフィールドを関連付けるためにバリデータによって使用されます。[読み取り専用] 選択されたアイテム、または選択されたアイテムのデータフィールドまたはラベルフィールドです。行ごとに異なる高さを設定できるかどうかを示すフラグです。垂直スクロールバーを常にオンにするか、常にオフにするか、または setScrollBarProperties() メソッドに渡されるパラメータに基づいて自動的に変更するかを示すプロパティです。上端からコンテンツへのオフセットです。[override] 親の座標内におけるコンポーネントの幅(ピクセル単位)を指定する数値です。行内のテキストを折り返すかどうかを示すフラグです。[override] 親コンテナ内におけるコンポーネントの水平位置(ピクセル単位)を指定する数値です。[override] 親コンテナ内におけるコンポーネントの垂直位置(ピクセル単位)を指定する数値です。継承されるプロテクトプロパティを隠す。
継承されるプロテクトプロパティを表示
データ変更エフェクトの実行中に使用する collection に通常格納される値のコピーです。データ変更エフェクトの実行中に使用する iterator に通常格納される値のコピーです。アンカーであるアイテムのブックマークです。選択アンカーポイントとなるデータプロバイダ内のアイテムのオフセットです。境界線オブジェクトです。コントロールのデータプロバイダ内で変更が発生したときに再生するエフェクトです。キャレットの位置にあるアイテムのブックマークです。選択キャレットポイントとなるデータプロバイダ内のアイテムのオフセットです。キャレットの位置にあるアイテムのレンダラーです。キャレットの位置にあるアイテムの UID です。アイテムレンダラーを列に対応付けるマップです。データ変更エフェクトが完了したことを示すフラグです。デフォルトで表示する列の数です。デフォルトで表示する行の数です。[読み取り専用] ドラッグ & ドロップ操作中にビジュアルオブジェクトを表示するクラスのインスタンスを取得します。[読み取り専用] ドラッグ & ドロップのドラッグイメージのオフセットを取得します。columnCount プロパティを明示的に設定することによって要求された列数です。rowCount を明示的に設定することによって要求された行数です。rowHeight を明示的に設定することによって要求された行の高さです。ファクトリ単位のアイテムレンダラーのマップです。未使用のアイテムレンダラーのスタックです。ファクトリ単位のフリーアイテムレンダラーのマップです。未使用のアイテムレンダラーの列ごとのテーブルです。ヘッダサブコンポーネントです。ハイライト表示されているレンダラーを示すグラフィックを格納している DisplayObject です。現在マウスが置かれているか、キャレットの位置にあるレンダラーです。現在マウスが置かれているか、キャレットの位置にあるアイテムの UID です。水平スクロールバーです。レンダラーのサイズが変更されている可能性があることを示すフラグです。データプロバイダからアイテムを取得し、そのアイテムをレンダラーに渡すために使用されるメイン IViewCursor です。ページフォルトが発生したこと、およびイテレータの位置が有効でないこと(一番上に表示されているアイテムに配置されていないこと)を示すフラグです。キーボードによる選択がページフォルトによって中断されたかどうかを示すフラグです。ドロップターゲットに追加するドラッグアイテムの位置を示す、最新の計算済みインデックスです。ページフォルトの原因となった最後のシークです。すべてのアイテムレンダラー、選択およびハイライトの各インジケータ、および他のサポートグラフィックの親となる内部表示オブジェクトです。[読み取り専用] 各データプロバイダアイテムをレンダリングする itemRenderer インスタンスを格納する配列の配列です。固定列の固定行を含むサブコンポーネントです。固定列を含むサブコンポーネントです。固定列のヘッダサブコンポーネントです。固定行を含むサブコンポーネントです。データプロバイダの以前の状態を一時的に保存して、データ変更エフェクトの実行を容易にするコレクションビューです。レンダラーが変更されたことを示すフラグです。近いうちに再び使用される可能性のある現在未使用のアイテムレンダラーのハッシュマップです。[読み取り専用] アプリケーションのローカライズされたすべてのリソースを管理するオブジェクトへの参照です。アイテムレンダラーをそれぞれの ListRowInfo オブジェクトに対応付けるハッシュマップです。次回表示を更新するときに、データエフェクトを開始するかどうかを示すフラグです。データ変更エフェクトが現在実行されているかどうかを示すフラグです。スクロールバーの表示または非表示のため、スクロール領域が変更されたことを示すフラグです。選択のインジケータのハッシュテーブルです。選択およびハイライトのすべてのインジケータが描画される listContent 内のレイヤーです。選択のトゥイーンのハッシュテーブルです。キャレットを表示するかどうかを示すフラグです。リストのレイアウトアルゴリズムの対象ではないアイテムレンダラーのハッシュマップです。[読み取り専用] 伸縮されていないコンポーネントの高さを求めるために使用する便利なメソッドです。[読み取り専用] 伸縮されていないコンポーネントの幅を求めるために使用する便利なメソッドです。コンポーネントの描画および子のレイアウトはすべて、この幅の四角い枠内で行う必要があります。垂直スクロールバーです。[読み取り専用] ビューに現在含まれているデータプロバイダアイテムレンダラーのハッシュテーブルです。表示リストの前回の更新以降に、wordWrap プロパティの値が変更されているかどうかを示すフラグです。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
コンストラクタです。データ変更エフェクトが実行されている場合に、アイテムレンダラーを追加します。イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。ドロップされたアイテムをドロップターゲットに追加する位置のインデックスを返します。後で呼び出す関数をキューに格納します。このコンポーネントインスタンスからスタイルプロパティを削除します。Point オブジェクトをコンテンツ座標からグローバル座標に変換します。Point オブジェクトをコンテンツ座標からローカル座標に変換します。このコンテナの子を識別するプロパティのセットを返します。列のセルまたは列ヘッダーのアイテムレンダラーを返します。データオブジェクトが指定されたアイテムレンダラーを作成します。このメソッドは、アイテムレンダラーに対して現在開いているアイテムエディタを閉じます。このコンポーネントを囲むフォーカスインジケータを表示するか、または非表示にします。このスキンの Graphics オブジェクトに矩形をプログラムにより描画します。コンポーネントでの再生の停止時にエフェクトインスタンスによって呼び出されます。コンポーネントでの再生の開始時にエフェクトインスタンスによって呼び出されます。現在コンポーネントで再生中のすべてのエフェクトを終了します。ストリングに基づいてリスト内のアイテムを検索し、選択をそのアイテムに移動します。印刷の完了後に呼び出されます。指定されたインデックス位置でオートメーションオブジェクトを提供します。指定のインデックス位置にある子表示オブジェクトインスタンスを返します。指定された名前に一致する子表示オブジェクトを返します。レイアウト制約値を返します。これは、このコンポーネントの制約スタイルを取得することと同じです。明示的に指定された高さを使用するのか、それとも測定された高さを使用するのかを決定するための便利なメソッドです。明示的に指定された幅を使用するのか、それとも測定された幅を使用するのかを決定するための便利なメソッドです。現在フォーカスを持っているオブジェクトを取得します。適切なファクトリを返します。ファクトリが指定されていない場合は、デフォルトのファクトリを使用します。true または false を返して、エフェクトがターゲットで再生されるかどうかを示します。このコンポーネントのスタイル参照チェーンのいずれかの場所に設定されたスタイルプロパティを取得します。Point オブジェクトをグローバル座標からコンテンツ座標に変換します。point オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。ステージ(グローバル)座標の 2 次元のポイントを 3 次元の表示オブジェクトの(ローカル)座標に変換します。EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。ドラッグ & ドロップ操作が可能であることを示す、マウスポインタの下のドロップインジケータを非表示にします。表示オブジェクトの境界ボックスを評価して、obj 表示オブジェクトの境界ボックスと重複または交差するかどうかを調べます。表示オブジェクトを評価して、x および y パラメータで指定されたポイントと重複または交差するかどうかを調べます。
データプロバイダ内のアイテムのインデックスに対応するアイテムレンダラーを取得します(存在する場合)
このコンポーネントの内部構造を初期化します。このコンポーネントの繰り返しインスタンスを追跡する各種プロパティを初期化します。次回の更新ですべての行を更新します。後で画面更新時に measure() メソッドが呼び出されるように、コンポーネントをマークします。データプロバイダアイテムのアイテムレンダラーがハイライト表示されているかどうか (アイテムレンダラーがマウスの位置にあるかどうか、またはキーボード操作によりキャレットの位置にあるかどうか) を判別します。データプロバイダアイテムのアイテムレンダラーが選択可能かどうかを判別します。データプロバイダアイテムのアイテムレンダラーが選択されているかどうかを判別します。アイテムがレンダラーによって表示されているかどうかを判別します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。レンダラーが表示オブジェクトを含んでいる(または所有している)かどうかを判別します。このアイテムレンダラーによってレンダリングされているアイテムのデータプロバイダ内のインデックスを返します。
データプロバイダ内の指定のアイテムに対応するアイテムレンダラーを返します(存在する場合)
3 次元の表示オブジェクトの(ローカル)座標の 3 次元のポイントをステージ(グローバル)座標の 2 次元のポイントに変換します。Point オブジェクトをローカル座標からコンテンツ座標に変換します。point オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。現在のアイテムレンダラーを使用して、データプロバイダのアイテムのセットを測定し、それらのアイテムの高さの合計を返します。現在のアイテムレンダラーを使用して、データプロバイダのアイテムのセットを測定し、見つかった最大幅を返します。親の内部の指定された位置にコンポーネントを移動します。スタイルの変更を子に通知します。指定されたプロパティが存在し、列挙できるかどうかを示します。このコンポーネントの CSS スタイルキャッシュを作成または再作成します。データ変更エフェクトが実行されている場合、アイテムレンダラーを削除します。指定されたイベントを再生します。提供された ID を使用して子を解決します。指定のインデックス位置にあるデータプロバイダアイテムを表示状態にします。オブジェクトのサイズを設定します。表示オブジェクトコンテナの既存の子の位置を変更します。レイアウト制約値を設定します。これは、このコンポーネントの制約スタイルを設定することと同じです。現在の状態を設定します。現在扱っているコンポーネントにフォーカスを設定します。ループ処理に対するダイナミックプロパティの可用性を設定します。このコンポーネントインスタンスのスタイルプロパティを設定します。visible プロパティが変更されたときに呼び出されます。マウスポインタの下にドロップインジケータを表示して、ドラッグ & ドロップ操作が可能であること、およびアイテムのドロップ先を示します。指定されたスプライトをユーザーがドラッグできるようにします。スタイルプロパティの変更を検出します。指定された 2 つの子オブジェクトの z 順序(重ね順)を入れ替えます。子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。特定のデータアイテムに対応するアイテムレンダラーが、コントロール内のアイテムレンダラーの通常の位置の外側に移動する必要がある場合、データ変更エフェクトの一部として UnconstrainItemAction エフェクトによって呼び出されます。子の位置とサイズを検証し、その他のビジュアルオブジェクトを描画します。必要に応じて、このオブジェクトのプロパティとレイアウトを検証および更新し、それを再描画します。commitProperties() メソッドを呼び出してコンポーネントのプロパティを検証するために、レイアウトロジックによって使用されます。コンポーネントの測定サイズを検証します。このコンポーネントに割り当てられたバリデータからの valid と invalid の両方のイベントを処理します。指定されたオブジェクトのプリミティブな値を返します。指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
継承されるプロテクトメソッドを表示
ドラッグ & ドロップ操作の一部として、選択されたアイテムを DragSource オブジェクトに追加します。レンダラーを非表示にし、レンダラーへの参照をクリーンアップして、レンダラーをリサイクルレンダラーリストに追加します。行への参照を格納している配列の先頭に空白行を追加します。フォーカス矩形を調整します。レンダラーのサイズと位置を、指定された rowNum、行位置、高さに従って調整します。選択のインジケータを適用するためのエフェクトを設定します。これは、Flex フレームワークが Dissolve エフェクトをサポートするために使用する内部メソッドです。ドラッグ & ドロップ操作の実行時に、ドロップインジケータの y 位置を計算します。1 行の中にある列の行の高さを計算します。子オブジェクトの作成後に行われる最終処理を実行します。指定の Sprite へのキャレットのインジケータをクリアします。指定の Sprite のハイライトのインジケータをクリアします。選択、ハイライトおよびキャレットの各インジケータをすべて削除します。rowNum で指定された空にする必要がある行からレンダラーを削除します。選択されたアイテムのセットをクリアし、それらのアイテムの選択状態を表すすべてのグラフィックを削除します。列のサイズ変更時にユーザーが通常使用する列ヘッダセパレータを削除します。選択されたアイテムを選択順にコピーします。このコンポーネントの境界線を作成します。この場合、すべてのアイテムレンダラーを保持する listContent オブジェクトになります。使用中の埋め込みフォントに基づくコンテキストで、新しいオブジェクトを作成します。不要になった行をリサイクルし、インジケータを削除します。マウスをリストの上または下に移動した場合に、リストを上または下にスクロールするインターバル関数です。指定の Sprite に、指定された位置、幅、高さおよび色でキャレットのインジケータを描画します。示されたカラーを使用して列の背景を描画します。指定の Sprite に、指定された位置、幅、高さおよび色でハイライトのインジケータを描画します。行間に線を描画します。ハイライト、選択、またはキャレットの各インジケータと共にレンダラーを描画します。列の間の線と、列の背景を描画します。位置、高さ、色の指定に従って行の背景を描画します。行の色、境界線および背景が交互に異なるように描画します。指定の Sprite に、指定された位置、幅、高さおよび色で選択のインジケータを描画します。列のサイズ変更時にユーザーが通常使用する列ヘッダセパレータを作成して表示します。列間に線を描画します。アイテムが表示される場合、そのアイテムを描画します。eventCode パラメータの文字で始まる次のアイテムをデータプロバイダ内で検索します。データ変更エフェクトの実行終了後に、元のコレクションとイテレータを復元し、エフェクトで使用したキャッシュされたすべての値を削除することによってクリーンアップします。UIComponent オブジェクトがフォーカスを取得したときに呼び出されるイベントハンドラです。UIComponent オブジェクトがフォーカスを失ったときに呼び出されるイベントハンドラです。現在使用されていない作成済みのアイテムレンダラーを取得します。指定のインデックス位置にあるデータプロバイダアイテムの列です。指定のインデックス位置にあるデータプロバイダアイテムの行です。このコンポーネントの初期化を完了させます。このコンポーネントのアクセシビリティコードを初期化します。データプロバイダで変更が発生したときに、データ変更エフェクトを開始します。通常、UITextField オブジェクトが含まれているコンポーネントのうち、UITextField オブジェクトがフォーカスを取得したコンポーネントによってオーバーライドされます。データプロバイダアイテムの UID を決定します。keyDown イベントに対して呼び出されるイベントハンドラです。keyUp イベントに対して呼び出されたイベントハンドラです。サイズ変更に応答して、このコントロールの境界線の位置およびサイズを設定します。新しい DataGridListData インスタンスを作成し、入力されたデータプロバイダアイテムに基づいてフィールドに値を格納します。
レンダラーを含め、リストに含まれている任意のマウスターゲットの MouseEvent
マウスの位置にあるアイテムレンダラーを判別します。
レンダラーを含め、リストに含まれている任意のマウスターゲットの MouseEvent
選択を移動し、インジケータを水平方向にハイライト表示します。選択を移動し、インジケータを垂直方向にハイライト表示します。左矢印キー、右矢印キー、または Shift キーや Ctrl キーなどの修飾子を使用してアイテムを選択するユーザー操作に応答して、選択を水平方向に移動します。ソート矢印グラフィックを、現在のソートキーとなっている列に描画します。コレクションイベントのデータエフェクトを準備します。指定された行番号の行の配列内にスロットがあることを確認します。既存のアイテムレンダラーを削除し、レンダラーが変更されたときのさまざまなキャッシュ構造をクリーンアップするために、updateDisplayList() メソッドによって呼び出されます。行への参照を格納している配列から行を削除します。データプロバイダ内の指定のアイテムについて、選択ハイライトおよびその他の関連グラフィックをクリーンアップします。行への参照を格納している配列の先頭から、要求された数の行を削除します。特定のスクロールバーを表示するための十分な領域がこのコンポーネントにあるかどうかを判断します。scroll イベントのデフォルトのイベントハンドラです。スクロール位置の変化に応じてレンダラーを調整します。[override] 指定のスクロール位置で最初に表示される行と列のアイテムに対応するデータプロバイダインデックスを返します。ページフォルトが原因でシークが失敗したときに使用されるデフォルトの失敗ハンドラです。ページフォルトが原因でシークが失敗したときに使用されるデフォルトの結果ハンドラです。提供されているアイテムレンダラーがマウスで既にクリックされており、キーボード修飾子が指定の状態になっていれば、選択されたアイテムのセットを更新します。列に対してアイテムレンダラーを設定し、listItems 配列の指定された位置に配置します。行を参照する配列内の行を移動します。要求された行のセットの高さを決定します。行への参照を格納している配列の末尾から残りのすべての行を削除します。アイテムレンダラーが表示されている場合、UID に基づいてそのレンダラーを検索します。[override] 表示可能なアイテムの数が変更された場合に、アイテムレンダラーを追加または削除します。すべての行を更新します。レンダラーを同期的に再描画します。継承されるイベントを隠す。
継承されるイベントを表示
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。表示オブジェクトが表示リストに追加されたときに送出されます。表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの追加により、ステージ上の表示リストに追加されたときに送出されます。ユーザーがコンテキストメニューから「削除」を選択した場合に送信されます。ユーザーが列の幅を変更したときに送出され、その列に表示されるデータ量が変化したことを示します。ユーザージェスチャが AIR アプリケーションでこのインタラクティブオブジェクトに関連付けられたコンテキストメニューをトリガすると、送出されます。ユーザーがコピー操作のためにプラットフォーム固有のアクセラレータキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「コピー」を選択した場合に送信されます。コンポーネントの構築、プロパティ処理、測定、レイアウト、および描画が完了したときに送出されます。ビューステートの変更後に送出されます。currentState プロパティが変更された後、ビューステートが変更される前に送出されます。ユーザーがカット操作のためにプラットフォーム固有のアクセラレータキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「カット」を選択した場合に送信されます。data プロパティが変更されたときに送出されます。[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。ドラッグ操作が完了したとき(ドラッグデータをドロップターゲットにドロップするか、ドロップを実行せずにドラッグ&ドロップ操作を終了したときのいずれか)、ドラッグイニシエータ(ドラッグしたデータのソースであるコンポーネント)によって送出されます。ユーザーがドロップターゲット上でマウスを離したとき、ドロップターゲットによって送出されます。ドラッグ操作時に、コンポーネント上でマウスを移動したとき、コンポーネントによって送出されます。ユーザーがデータをコンポーネントの外部にドラッグし、ターゲットにドロップしなかったとき、コンポーネントによって送出されます。ドラッグ操作時に、コンポーネント上でマウスを移動したとき、コンポーネントによって送出されます。ドラッグ操作を開始したときにドラッグイニシエータによって送出されます。エフェクトの終了後に送出されます。エフェクトが開始される直前に送出されます。[ブロードキャストイベント] 再生ヘッドが新しいフレームに入るときに送出されます。コンポーネントがルートビューステートに戻った後に送出されます。[ブロードキャストイベント] 再生ヘッドが現在のフレームを終了するときに送出されます。コンポーネントがルートビューステートを終了する前に送出されます。表示オブジェクトがフォーカスを取得した後に送出されます。表示オブジェクトがフォーカスを失った後に送出されます。[ブロードキャストイベント] フレーム表示オブジェクトのコンストラクタが実行した後で、かつフレームスクリプトが実行される前に送出されます。ユーザーが列のコンテンツに基づいてグリッドコンテンツをソートするようにコントロールに要求するために、列ヘッダーの上でマウスボタンを離したときに送出されます。ユーザーが列を新しい位置にドラッグした後、列ヘッダーの上でマウスボタンを離し、新しいインデックスに列が移動したときに送出されます。オブジェクトの状態が可視から不可視に変化したときに送出されます。コンポーネントの構築と初期化プロパティの設定が完了したときに送出されます。Validator によってコンポーネントが監視されており、検証が失敗した場合に送出されます。ユーザーがコントロール内のアイテムをクリックしたときに送出されます。ユーザーがコントロール内のアイテムをダブルクリックしたときに送出されます。ユーザーが、アイテムレンダラー上、DataGrid コントロールのタブ上、または DataGrid コントロール内でマウスボタンを離したとき、またはその他の方法でアイテムを編集しようとしたときに送出されます。何らかの理由でアイテム編集セッションが終了するときに送出されます。アイテムレンダラーがフォーカスを得たときに送出されます。フォーカスを得るのは、ユーザーが DataGrid コントロールのアイテムをクリックしたときや、キーボードを使用してアイテムに移動したときなどです。アイテムレンダラーがフォーカスを失ったときに送出されます。フォーカスを失うのは、ユーザーが DataGrid コントロールの内部または外部にある別のアイテムをクリックしたときや、キーボードを使用して DataGrid コントロールの内部または外部にある別のアイテムに移動したときなどです。ユーザーがコントロール内のアイテムの外にマウスポインタを移動したときに送出されます。ユーザーがコントロール内のアイテムの上にマウスポインタを置いたときに送出されます。ユーザーがキーを押したときに送出されます。ユーザーがキーボード操作によってフォーカスを変更しようとすると送出されます。ユーザーがキーを離したときに送出されます。PopUpManager を使用して開かれたコンポーネントの外側でユーザーがマウスをクリックしたときに、そのコンポーネントから送出されます。ユーザーがポインティングデバイスでフォーカスを変更しようとすると送出されます。PopUpManager を使用して開かれたコンポーネントの外側にユーザーがマウスホイールをスクロールしたときに、そのコンポーネントから送出されます。オブジェクトが移動したときに送出されます。
ドラッグされたオブジェクトがターゲットにドロップされ、そのドロップ操作が DragManager
ユーザーがペースト操作のためにプラットフォーム固有のアクセラレータキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「ペースト」を選択した場合に送信されます。コンポーネントの初期化シーケンスの始めに送出されます。表示オブジェクトが表示リストから削除されようとしているときに送出されます。表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの削除により、表示リストから削除されようとしているときに送出されます。[ブロードキャストイベント] 表示リストが更新およびレンダリングされようとしているときに送出されます。コンポーネントのサイズが変更されたときに送出されます。コンテンツがスクロールされたときに送出されます。ユーザーがすべて選択操作のためにプラットフォーム固有のアクセラレータキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「すべて選択」を選択した場合に送信されます。オブジェクトの状態が不可視から可視に変化したときに送出されます。オブジェクトの tabIndex プロパティの値が変更されたときに送出されます。ツールヒントを作成するときにコンポーネントによって送出されます。コンポーネントのツールヒントが非表示にされており、まもなく破棄されるときに、コンポーネントによって送出されます。コンポーネントのツールヒントが非表示にされる前に、コンポーネントによって送出されます。コンポーネントのツールヒントが表示される前に、コンポーネントによって送出されます。コンポーネントのツールヒントが表示された後に、コンポーネントによって送出されます。toolTip プロパティが設定されているコンポーネント上にユーザーがマウスを移動すると同時に、そのコンポーネントによって送出されます。Validator によってコンポーネントが監視されており、検証が成功した場合に送出されます。プログラムまたはユーザー操作のいずれかによって、値が変更されたときに送出されます。継承されるスタイルを隠す。
継承されるスタイルを表示
リスト内のアイテムの背景に使用する色です。値は複数の色の配列です。リストアイテムの背景には、この配列内の色が交替で使用されます。DataGrid コントロールの場合、1 つの行内のアイテムはすべて同じ背景色となり、各行の背景色は色の配列の中から決定されます。単一のリストを使用して 2 次元表示を設定する TileList コントロールでは、スタイルはリストの列数と行数および指定した色の数に基づいて、格子縞模様やストライプなどのさまざまなパターンになります。TileList では、レイアウトの方向に従って個々のアイテムの背景色を配置することで色が周期的に切り替わります。色数と列数が偶数である TileList を水平方向にレイアウトすると、ストライプになります。列数が奇数の場合は、格子縞模様になります。
有効な値の範囲は、0
コンポーネントの背景色です。一部のコンポーネントには背景色がありません。Application コンテナの場合、このスタイルはアプリケーションのロード時の背景色と、アプリケーションの実行時の背景のグラデーションを指定します。指定された色よりもわずかに濃い色とわずかに薄い色の間でグラデーションパターンが計算されます。ほとんどの Flex コントロールのデフォルトスキンは、部分的に透明です。この結果、コンテナの背景色が、そのコンテナの中のコントロールに部分的ににじみ出るように表示されます。コントロールの fillAlphas プロパティのアルファ値を 1 に設定することで、これを避けることができます。次に例を示します。コンポーネントが無効になっている場合のコンポーネント背景色です。コンテナが無効になっている場合は、背景がグレー表示されます。コンポーネントの背景イメージです。これには、絶対 URL、相対 URL、絶対クラス、または相対クラスを指定できます。背景色の前面に背景イメージを表示します。ほとんどの Flex コントロールのデフォルトスキンは、部分的に透明です。この結果、コンテナの背景イメージが、そのコンテナの中のコントロールに部分的ににじみ出るように表示されます。コントロールの fillAlphas プロパティのアルファ値を 1 に設定することで、これを避けることができます。次に例を示します。"100%" に設定すると、コンポーネント全体に収まるサイズにイメージを伸縮します。パーセント値で指定する場合は、パーセント記号(%)付きで指定する必要があります。他のすべてのコンテナのデフォルト値は auto で、イメージの元のサイズが維持されます。コンテンツ領域の上端からコントロールのベースライン位置までの垂直距離(ピクセル単位)を表します。このスタイルが設定されている場合、コンポーネントのベースラインはそのコンテンツ領域の上端に対して固定されます。コンテナのサイズが変更されても、コンポーネントのベースラインとそのコンテンツ領域の上端の垂直距離は維持されます。境界線の色です。デフォルト値はコンポーネントのクラスに応じて異なります。境界ボックスの境界線のうち、どれが表示されるかを示します。表示する境界線をスペース区切りのストリングで指定します。この場合、4 辺のすべての境界を表示します。コンポーネントの境界線のスキンクラスです。
明示的にデフォルト値が設定されている場合を除き、mx
境界ボックスのスタイルです。デフォルト値はコンポーネントのクラスに応じて異なります。クラスでオーバーライドされない場合は "inset" になります。境界ボックスの境界線の幅です。コンポーネントの下端からコンテンツ領域の下端までの垂直距離(ピクセル単位)を表します。このスタイルが設定されている場合、コンポーネントの下端はそのコンテンツ領域の下端に対して固定されます。コンテナのサイズが変更されても、2 つの下端の垂直距離は維持されます。コンポーネントのラベルを含めたコンポーネント内のテキストの色です。列を現在の位置にドロップできることを示すスキンとして使用するクラスです。サイズ変更中の列のスキンとして使用するクラスです。コンポーネントが無効な場合のテキストの色です。無効なスキンにあるアイコンの色です。デフォルト値はコンポーネントのクラスに応じて異なります。ドラッグしたアイテムをドロップできる場所を示すために使用するスキンです。ここでアイテムをドロップすると、ドロップしたアイテムはこのアイテムの 1 つ上になります。ドロップシャドウの色です。コンポーネントのドロップシャドウの表示または非表示を指定するブール型プロパティです。設定しない場合、コンテナのデフォルトの背景は透明なので、シャドウはコンテナの背後に表示されます。検証が失敗した場合のコンポーネントのハイライトの色です。フォーカススキンのアルファ透明度値を指定します。フォーカス矩形で使用されるブレンドモードです。フォーカス矩形のどの角を丸くするかを指定します。たとえば、右の角を丸くし、左の角を直角に指定するには、"tr br" とします。