このメソッドは、コピーを作成しないで、配列を変更します。
メモ : Array のサブクラス内でこのメソッドをオーバーライドするには、次の例に示すように、パラメータに
負の整数を使用すると、配列の末尾を基準として位置を指定できます。例えば、-1 は配列の最後のエレメントです。値として 0 を指定すると、エレメントは削除されません。Array — 元の配列から削除されたエレメントを含む配列です。指定された配列内のエレメントを表すストリングを返します。インデックス 0 から最大インデックスまでの配列内のすべてのエレメントを、カンマで区切られた連結ストリングに変換して返します。指定された配列内のエレメントを表すストリングを返します。インデックス 0 から最大インデックスまでの配列内のすべてのエレメントを、カンマで区切られた連結ストリングに変換して返します。
カスタムセパレータを指定するには、Array
エレメントを配列の先頭に追加して、配列の新しい長さを返します。配列内の他のエレメントは、元の位置 i から i+1 に移動されます。args — 配列の先頭に挿入される数値、エレメント、または変数です。Array クラスのソートメソッドに対して、大文字と小文字を区別しないソートを指定します。この定数の値は 1 です。Array クラスのソートメソッドに対して、降順でのソートを指定します。この定数の値は 2 です。Array クラスのソートメソッドに対して、文字ストリングではなく数値によるソートを指定します。NUMERIC 定数を設定しないでソートを実行すると、各配列エレメントは文字ストリングとして処理され、Unicode 順でソートされます。この定数は、配列内の数値に対してのみ適用されます。ソート結果として、配列インデックスで構成される配列を返すことを指定します。この定数の値は 8 です。Array クラスのソートメソッドに対して、一意性ソート要件を指定します。一意性ソートオプションを指定すると、ソート対象の任意の 2 つのエレメントまたはフィールドが同じ値である場合に、ソートが終了します。この定数の値は 4 です。
例 例の使用法
このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
Class オブジェクトはプログラム内の各クラス定義に対して作成されます。Class オブジェクトにはクラスの静的プロパティとメソッドが含まれます。new 演算子を使用してクラスオブジェクトを呼び出すと、クラスのインスタンスが作成されます。クラス名は、次に例を示すように、Class オブジェクトへの参照です。class ステートメントを使用してクラスを宣言します。次の例で示すように、Class オブジェクトは、実行時に既存インスタンスオブジェクトへクラスを割り当てるといった、高度な手法の場合に使用します。クラスの静的プロパティとメソッドは、クラスの Class オブジェクトに存在します。通常は、Class 型の変数を手動で宣言または作成する必要はありません。swf ファイルがロードされ、Circle 型のオブジェクトがインスタンス化されることがあります。次の例は、子 SWF ファイルのアセットにアクセスする 1 つの方法を示しています。0 では、SWF ファイルにコンパイルされる外部アセット(イメージ、サウンド、フォントなど)に対して埋め込みクラスを作成できます。attachMovie() メソッドを使用して、リンケージ識別子によって外部アセットを関連付けていました。0 では、各埋め込みアセットが固有の埋め込みアセットクラスによって表されます。そのため、new 演算子を使用してアセットの関連クラスをインスタンス化することや、それらのアセットについてメソッドやプロパティを呼び出すことができます。例えば、MXML コンパイラを使用して SWF ファイルを生成する場合、次のように埋め込みクラスを作成します。さらに、これをインスタンス化するために、次のコードを追加します。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。
例 例の使用法
次の例は、以下に示す手順に従って、Class オブジェクを使用して、インスタンス化するクラスの決定を実行時まで保留する方法を示しています。この例では、この Boolean 型の変数を true に設定していますが、コードでカスタムテスト式を使用してこの変数の値を設定することができます。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
Date クラスは日時のデータを表します。Date クラスの 1 つのインスタンスは特定の一時点を表します。この特定の一時点について、月、日、時、秒などのプロパティを照会および変更できます。
Date クラスを使用すると、世界時(グリニッジ標準時
現在の呼称は世界標準時または UTC)またはローカル時間を基準にした日付と時刻の値を取得できます。ローカル時間は、Flash Player を実行しているオペレーティングシステムに設定されているローカルタイムゾーンによって決定されます。Date クラスのメソッドは静的ではありません。メソッドを呼び出すときに指定した個々の Date オブジェクトにのみ適用されます。これらは静的なメソッドです。0 は新しいアクセサプロパティをいくつか追加しています。これらのアクセサプロパティは、Date インスタンスにアクセスしたり、Date インスタンスを変更する多くの Date クラスメソッドの代わりに使用できます。
相対時間または経過時間を計算するには、flash
継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。[読み取り専用] 世界時(UTC)とコンピュータのローカル時間の差(分単位)です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
指定された日時を保持する新しい Date オブジェクトを作成します。世界時(UTC)とコンピュータのローカル時間の差(分単位)を返します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。月内の日付をローカル時間で設定し、新しい時刻をミリ秒で返します。年をローカル時間で設定し、新しい時刻をミリ秒で返します。時をローカル時間で設定し、新しい時刻をミリ秒で返します。ミリ秒をローカル時間で設定し、新しい時刻をミリ秒で返します。分をローカル時間で設定し、新しい時刻をミリ秒で返します。月と、オプションで日付をローカル時間で設定し、新しい時刻をミリ秒で返します。ループ処理に対するダイナミックプロパティの可用性を設定します。秒をローカル時間で設定し、新しい時刻をミリ秒で返します。月内の日付を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。年を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。時を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。ミリ秒を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。分を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。月、および日(オプション)を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。秒、およびオプションでミリ秒を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。曜日と日付のみのストリング表現を返します。時刻またはタイムゾーンは含まれません。曜日と日付のみのストリング表現を返します。時刻またはタイムゾーンは含まれません。曜日、日付、時刻のストリング表現を、指定されたローカル時間で返します。時刻のみのストリング表現を返します。曜日、日付、年、またはタイムゾーンは含まれません。曜日、日付、時刻、およびタイムゾーンのストリング表現を返します。時刻とタイムゾーンのみのストリング表現を返します。曜日と日付は含まれません。曜日、日付、および時刻のストリング表現を世界時(UTC)で返します。
プロパティの詳細
ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。このメソッドは、複数の Date オブジェクトを比較する際に特定の時間を表すのに使用します。世界時(UTC)とコンピュータのローカル時間の差(分単位)です。つまり、この分の値をコンピュータのローカル時間に加算すると世界時と等しくなります。コンピュータの時刻が世界時より遅い時間に設定されている場合、戻り値は負の数になります。
コンストラクタの詳細
指定された日時を保持する新しい Date オブジェクトを作成します。新しく作成された Date オブジェクトに含まれる日付は、渡された引数の数とデータ型により異なります。引数が渡されなかった場合、Date オブジェクトには現在の日時が割り当てられます。データ型 String の引数が 1 つ渡され、このストリングに有効な日付が含まれている場合は、Date オブジェクトにはその日付に基づく時間値が割り当てられます。複数の引数が渡された場合、Date オブジェクトには、渡された引数値が表す日付の年、月、日、時、分、秒、ミリ秒に基づく時間値が割り当てられます。Date クラスのコンストラクタにストリングを渡す場合、日付にはさまざまな形式を使用できますが、少なくとも月、日、年が含まれている必要があります。次に、有効な形式をいくつか示します。それ以外の場合は時間値を表します。それ以外の場合は年を 4 桁で指定する必要があります。
メソッドの詳細
ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。次の例では、新しい Date オブジェクト now をパラメータの指定なしで作成します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。次の例では、新しい Date オブジェクト now をパラメータの指定なしで作成します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。次の例では、新しい Date オブジェクト now をパラメータの指定なしで作成します。このメソッドは、複数の Date オブジェクトを比較する際に特定の時間を表すのに使用します。年が 1929 に設定されているため、ミリ秒は負の値で表されます。getTime はうるう年に対応しているので、次の疑似コードのような if 文が不要です。世界時(UTC)とコンピュータのローカル時間の差(分単位)を返します。Number — この分をコンピュータのローカル時間に加算すると世界時と等しくなります。コンピュータの時刻が世界時より遅い時間に設定されている場合、戻り値は負の数になります。次の例では、新しい Date オブジェクト now をパラメータの指定なしで作成します。さらに、この結果を 60 で除算して、タイムゾーンのオフセットを時間単位に変換します。この場合、結果は同じになります。次の例では、新しい Date オブジェクト now をパラメータの指定なしで作成します。次に実際の使用例を示します。これは、グリニッジ標準時(GMT)を基準にした時間と分のオフセットを示します。なお、グリニッジ標準時は現在は世界時(UTC)とも呼ばれています。年、月、曜日は、スラッシュ(/)またはスペースで区切ることができますが、ダッシュ(-)で区切ることはできません。他にも、次のような形式がサポートされます。月、曜日、年だけというように、これらの形式の一部分を含めることもできます。月内の日付をローカル時間で設定し、新しい時刻をミリ秒で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。これにより、新しく設定された日付を取得します。年をローカル時間で設定し、新しい時刻をミリ秒で返します。month パラメータと day パラメータを指定すると、両方はローカル時間に設定されます。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。
このメソッドを呼び出しても Date オブジェクトの他のフィールドは変更されませんが、このメソッドを呼び出した結果として曜日が変わった場合には、Date
2 桁の数値は 4 桁の年の省略形を表しません。これにより、新しく設定された年を取得します。時をローカル時間で設定し、新しい時刻をミリ秒で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。これにより、新しく設定された時と分を取得します。ミリ秒をローカル時間で設定し、新しい時刻をミリ秒で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。次の例では、新しい Date オブジェクト now をパラメータの指定なしで作成します。分をローカル時間で設定し、新しい時刻をミリ秒で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。次の例では、新しい Date オブジェクト now をパラメータの指定なしで作成します。月と、オプションで日付をローカル時間で設定し、新しい時刻をミリ秒で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。これにより、新しく設定された月を取得します。秒をローカル時間で設定し、新しい時刻をミリ秒で返します。ローカル時間は、Flash Player を実行しているオペレーティングシステムによって決まります。次の例では、新しい Date オブジェクト now をパラメータの指定なしで作成します。これにより、新しく設定された秒を取得します。次の例では、新しい Date オブジェクト now をパラメータの指定なしで作成します。月内の日付を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。
このメソッドを呼び出しても、Date オブジェクトの他のフィールドは変更されませんが、このメソッドを呼び出した結果として曜日が変わった場合には、Date
trace() ステートメントで日付が正しく設定されたことを確認します。年を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。このメソッドでは、オプションで月と日を設定することもできます。
このメソッドを呼び出しても他のフィールドは変更されませんが、このメソッドを呼び出した結果として曜日が変わった場合には、Date
trace() ステートメントで年が正しく設定されたことを確認します。時を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。オプションで、分、秒、およびミリ秒を指定することができます。ミリ秒を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。次の例では、新しい Date オブジェクト now をパラメータの指定なしで作成します。分を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。オプションで、秒とミリ秒を指定することができます。次の例では、新しい Date オブジェクト now をパラメータの指定なしで作成します。月、および日(オプション)を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。
このメソッドを呼び出しても他のフィールドは変更されませんが、このメソッドを呼び出した結果として曜日が変わった場合には、Date
これにより、新しく設定された月を取得します。秒、およびオプションでミリ秒を世界時(UTC)で設定し、新しい時刻をミリ秒で返します。次の例では、新しい Date オブジェクト now をパラメータの指定なしで作成します。これにより、新しく設定された秒を取得します。曜日と日付のみのストリング表現を返します。時刻またはタイムゾーンは含まれません。次のメソッドと対照を成します。曜日と日付のみのストリング表現を返します。時刻またはタイムゾーンは含まれません。次のメソッドと対照を成します。曜日、日付、時刻のストリング表現を、指定されたローカル時間で返します。
同じ情報 (およびタイムゾーン) をストリングの最後に年を付けて返す Date
時刻のみのストリング表現を返します。曜日、日付、年、またはタイムゾーンは含まれません。
時刻とタイムゾーンを返す Date
String — 時刻とタイムゾーンのみのストリング表現です。曜日、日付、時刻、およびタイムゾーンのストリング表現を返します。出力の日付形式は、次のとおりです。次に実際の使用例を示します。これにより now のすべてのパラメータ(now を作成したときの)を表示します。時刻とタイムゾーンのみのストリング表現を返します。曜日と日付は含まれません。String — 時刻とタイムゾーンのみのストリング表現です。曜日、日付、および時刻のストリング表現を世界時(UTC)で返します。このメソッドでは世界時を使用するのに対し、Date コンストラクタではローカル時間を使用します。このメソッドは、UTC の日付を Date クラスのコンストラクタに渡す場合に便利です。
Date クラスのコンストラクタはミリ秒オフセットを引数として受け取るので、Date
UTC() メソッドを使用して UTC の日付を対応のミリ秒オフセットに変換し、このオフセットを引数として Date クラスコンストラクタに送ることができます。
例 例の使用法
次の例では、次に示す変数を割り当てる場合の Date() コンストラクタのさまざまな使用法を示しています。これにより、myDate1 には、使用しているシステムの日時に基づいた現在の日時が設定されます。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
Math クラスには、一般的な数学関数および値を表すメソッドおよび定数があります。数学定数および関数にアクセスして処理するには、このクラスのメソッドとプロパティを使用します。constant というシンタックスを使用して呼び出す必要があります。Math クラスのいくつかのメソッドでは、ラジアン単位の角度がパラメータとして使用されています。メソッドを呼び出す前に次の式を使用してラジアン値を計算し、計算した値をパラメータとして指定できます。また、式の右辺全体(degrees には度数で角度を代入)をラジアンパラメータとして指定することもできます。ラジアン値を計算するには、次の式を使用します。ラジアンで角度を計算するには、次の式を使用します。次の例では、角度 45 度のサインを計算する式をパラメータとして渡します。Flash Player では、上述の関数を計算するときに CPU(CPU が浮動小数の計算をサポートしていない場合はオペレーティングシステム)が呼び出され、使用する CPU やオペレーティングシステムによって多少異なる結果が表示されます。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
[静的] パラメータ val で指定された数値の絶対値を計算して返します。[静的] パラメータ val で指定された数値のアークコサイン(逆余弦)を計算してラジアン単位で返します。[静的] パラメータ val で指定された数値のアークサイン(逆正弦)を計算してラジアン単位で返します。[静的] パラメータ val で指定された値がタンジェント(正接)の値になる角度を計算してラジアン単位で返します。[静的] y/x 座標の角度をラジアン単位で計算して返します。このとき、円の x 軸(0,0 は円の中心を示します)から反時計回りに測定します。[静的] 指定された数値または式を切り上げた値を返します。[静的] ラジアン単位で指定された角度のコサイン(余弦)を計算して返します。[静的] 自然対数の底(e)をパラメータ x で指定された指数で累乗した値を返します。[静的] パラメータ val で指定された数値または式を切り捨てた値を返します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。[静的] パラメータ val の値を最も近い整数に四捨五入し、値を返します。ループ処理に対するダイナミックプロパティの可用性を設定します。[静的] ラジアン単位で指定された角度のサイン(正弦)を計算して返します。[静的] 指定された数値の平方根を計算して返します。[静的] 指定された角度のタンジェント(正接)を計算して返します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。[静的] 自然対数の底を表す数学定数で e と表記されるものです。[静的] 円周と円の直径の比を表す数学定数で pi と表記されるものです。[静的] 2 の平方根を表す数学定数です。
メソッドの詳細
パラメータ val で指定された数値の絶対値を計算して返します。パラメータ val で指定された数値のアークコサイン(逆余弦)を計算してラジアン単位で返します。0 の数値です。パラメータ val で指定された数値のアークサイン(逆正弦)を計算してラジアン単位で返します。0 の数値です。パラメータ val で指定された値がタンジェント(正接)の値になる角度を計算してラジアン単位で返します。円の x 軸(0,0 は円の中心を示します)から反時計回りに測定した場合に、y/x 座標の角度をラジアン単位で計算して返します。戻り値は、正のパイと負のパイの間の値になります。指定された数値または式を切り上げた値を返します。数値の切り上げとは、その数値以上の最も近い整数にすることです。ラジアン単位で指定された角度のコサイン(余弦)を計算して返します。ラジアンを計算するには、Math クラスの概要を参照してください。0 の数値です。自然対数の底(e)を、パラメータ x で指定された指数で累乗した値を返します。E を使用して、e の値を指定できます。パラメータ val で指定された数値または式を切り捨てた値を返します。切り捨てとは、指定された数値または式以下の最も近い整数にすることです。パラメータ val の自然対数を返します。max() は複数の引数を取ることができます。min() は複数の引数を取ることができます。計算には必ず非ランダムのエレメントが含まれるので、返される値は非公開の方式および疑似乱数で計算されます。パラメータ val の値を最も近い整数に四捨五入し、値を返します。
val が 2 つの最も近い整数から等距離である場合(5 で終わる数値など)、値は次に大きな整数に切り上げられます。ラジアン単位で指定された角度のサイン(正弦)を計算して返します。ラジアンを計算するには、Math クラスの概要を参照してください。
指定した角度のサイン(-1
指定された数値の平方根を計算して返します。指定された角度のタンジェント(正接)を計算して返します。ラジアンを計算するには、Math クラスの概要を参照してください。自然対数の底を表す数学定数で e と表記されるものです。2 の自然対数を表す数学定数で log2 と表記されるものです。E) の対数を表す数学定数で loge と表記されるものです。log() メソッドは、数値の自然対数を計算します。2 を底とする定数 e の対数を表す数学定数で log2e と表記されるものです。log メソッドは、数値の自然対数を計算します。LOG2E を乗算すると、2 を底とする対数を得ることができます。円周と円の直径の比を表す数学定数で pi と表記されるものです。1/2 の平方根を表す数学定数です。2 の平方根を表す数学定数です。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
オブジェクトは、new 演算子シンタックスを使用したコンストラクタで作成され、プロパティを動的に割り当てることができます。また、次のようにオブジェクトリテラルを割り当てて作成することもできます。明示的な基本クラスを宣言していないクラスはすべて、ビルトインの Object クラスを拡張します。Object クラスを使用して、結合配列を作成できます。基本的に、結合配列は Object クラスのインスタンスであり、キー値ペアはプロパティとその値という形式で表現されます。
Object データタイプを使用して結合配列を宣言する別の理由は、そうすると、オブジェクトリテラルを使用して結合配列にデータを設定できるからです(ただし、宣言時のみ)
次の例では、オブジェクトリテラルを使用して結合配列を作成し、ドット演算子と配列アクセス演算子を両方とも使用して項目にアクセスします。その後、新しいプロパティを作成することで新しいキー値ペアを追加します。0 には、クラス継承とプロトタイプ継承という 2 つの種類の継承があります。クラス継承 - 主要な継承メカニズムであり、固定プロパティの継承をサポートします。固定プロパティは、クラス定義の一部として宣言される変数、定数、またはメソッドです。クラス宣言はすべて、クラスに関する情報が保存されている特別なクラスオブジェクトで表されます。0 では代替の継承形式として機能します。各クラスには関連付けられたプロトタイプオブジェクトがあり、プロトタイプオブジェクトのプロパティは、そのクラスのすべてのインスタンス間で共有されます。クラスインスタンスを作成した場合、インスタンスはそのクラスのプロトタイプオブジェクトへの参照を持っています。この参照は、インスタンスと、関連するクラスのプロトタイプオブジェクトとの間のリンクとして機能します。実行時に、クラスインスタンスにプロパティが見つからない場合は、委譲先であるクラスのプロトタイプオブジェクトにそのプロパティがないかどうかがチェックされます。プロトタイプオブジェクトにもない場合は、そのプロパティが見つかるまで、プロトタイプオブジェクトの委譲先でチェックを行うという処理が階層の上位に向かって連続的に継続されます。次の例に示すように、クラス継承とプロトタイプ継承は共存可能です。クラスの代わりに関数を使用すると、カスタムプロトタイプ継承ツリーを作成できます。クラスを使用すると、プロトタイプ継承ツリーはクラス継承ツリーをミラーします。ただし、プロトタイプオブジェクトは動的であるため、プロトタイプベースのプロパティを実行時に追加および削除できます。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。Object オブジェクトを作成し、そのオブジェクトのコンストラクタメソッドへの参照をオブジェクトの constructor プロパティに格納します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。
プロパティの詳細
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。オブジェクトがクラスのインスタンスの場合、constructor プロパティはクラスオブジェクトへの参照を保持します。オブジェクトがコンストラクタ関数で作成されている場合、constructor プロパティはコンストラクタ関数への参照を保持します。コンストラクタ関数と、クラスのコンストラクタメソッドとを混同しないように注意してください。コンストラクタ関数は、オブジェクトの作成に使用する Function オブジェクトで、クラスの定義に class キーワードを使用することの代わりになります。class キーワードを使用してクラスを定義する場合、クラスのプロトタイプオブジェクトには、クラスオブジェクトへの参照を保持する constructor という名前のプロパティが割り当てられます。クラスのインスタンスは、プロトタイプオブジェクトからこのプロパティを継承します。例えば、次のコードでは新しいクラス A、および myA という名前のクラスインスタンスを作成します。上級ユーザーの場合は、オブジェクト作成用のテンプレートとして使える オブジェクトを定義するのに functionfunction キーワードを使用し、class キーワードを使用しない場合もあります。このような関数は、new 演算子と組み合わせてオブジェクトを作成できるため、コンストラクタ関数と呼ばれています。function キーワードを使用してコンストラクタ関数を作成する場合、そのプロトタイプオブジェクトには、コンストラクタ関数への参照を保持する constructor という名前のプロパティが割り当てられます。次に、コンストラクタ関数を使用してオブジェクトを作成すると、そのオブジェクトはコンストラクタ関数のプロトタイプオブジェクトから constructor プロパティを継承します。例えば、次のコードでは新しいコンストラクタ関数 f、および myF という名前のオブジェクトを作成します。つまり、ユーザーコードで割り当てステートメントを使用して値を変更できます。constructor プロパティの値の変更はお勧めしませんが、constructor プロパティの値に依存したコードを書く場合は、その値がリセットされないようにする必要があります。constructor)を使用してプロパティにアクセスするときにのみ、この値を変更できます。これは、ランタイムのエンティティであるプロトタイプオブジェクトに constructor プロパティが依存しているからです。クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。prototype プロパティは自動的に作成され、作成したクラスまたは関数オブジェクトに割り当てられます。このプロパティは、作成したクラスまたは関数に固有であるという点で静的です。例えば、クラスを作成すると、prototype プロパティの値は、そのクラスのすべてのインスタンスで共有され、クラスプロパティとしてのみアクセスできます。クラスのインスタンスは、prototype プロパティに直接アクセスできません。クラスのプロトタイプオブジェクトは、そのクラスの特別なインスタンスであり、クラスのすべてのインスタンス間で状態を共有するためのメカニズムを提供します。実行時に、クラスインスタンスにプロパティが見つからない場合は、委譲先であるクラスのプロトタイプオブジェクトにそのプロパティがないかどうかがチェックされます。0 では、プロトタイプ継承は主要な継承メカニズムではありません。0 での主要な継承メカニズムは、クラス定義の固定プロパティを継承するクラス継承です。
コンストラクタの詳細
Object オブジェクトを作成し、そのオブジェクトのコンストラクタメソッドへの参照をオブジェクトの constructor プロパティに格納します。
メソッドの詳細
オブジェクトに指定されたプロパティが定義されているかどうかを示します。true が返されるのは、ターゲットオブジェクトに name パラメータで指定されたストリングに一致するプロパティがある場合です。次のタイプのプロパティについては、オブジェクトがクラスオブジェクトではなく、クラスのインスタンスである場合に true が返されます。
固定インスタンスプロパティ — オブジェクトのクラスで定義された、静的でない変数、定数、またはメソッド
継承された固定インスタンスプロパティ — オブジェクトのクラスが継承した変数、定数、またはメソッド
動的プロパティ — オブジェクトをインスタンス化した後に(クラス定義外で)オブジェクトに追加されたプロパティ 動的プロパティを追加するには、dynamic キーワードを使用して、オブジェクトを定義しているクラスを宣言する必要があります。次のタイプのプロパティについては、オブジェクトがクラスのインスタンスである場合に false が返されます。
静的プロパティ — オブジェクトを定義しているクラスまたはその任意のスーパークラスの静的キーワードを使用して定義された変数、定数、またはメソッド
プロトタイププロパティ — オブジェクトのプロトタイプチェーンの一部であるプロトタイプに定義されたプロパティ ActionScript 3
0 では、プロトタイプチェーンはクラス継承には使用されませんが、継承の代替形式として存在しています。0 には、クラス定義の直接的な表現であるクラスオブジェクトがあります。hasOwnProperty() メソッドをクラスオブジェクトに対して呼び出すと、プロパティがそのクラスオブジェクトに定義された静的プロパティである場合にのみ、true が返されます。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。このメソッドで true が返されるのは、オブジェクトが theClass パラメータで指定されたオブジェクトのプロトタイプチェーン内にある場合です。指定されたプロパティが存在し、列挙できるかどうかを示します。in の場合、このプロパティが存在し、 ループで列挙できます。このメソッドではターゲットオブジェクトのプロトタイプチェーンをチェックしないため、プロパティがターゲットオブジェクト上に存在している必要があります。作成するプロパティは列挙できますが、ビルトインプロパティは通常列挙できません。ループ処理に対するダイナミックプロパティの可用性を設定します。このメソッドではターゲットオブジェクトのプロトタイプチェーンをチェックしないため、プロパティがターゲットオブジェクト上に存在している必要があります。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。このオブジェクトにプリミティブ値がない場合、オブジェクト自体が返されます。Object — このオブジェクトのプリミティブ値、またはオブジェクト自体です。
例 例の使用法
カスタムクラス Circle は、値オブジェクトを受け入れ、対応する内部プロパティを値オブジェクトに定義されたプロパティに設定しながらループします。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
String クラスは、文字のストリングを表すデータ型です。String クラスは、プリミティブなストリング値の型の操作を可能にするメソッドとプロパティを提供します。これらのメソッドは String オブジェクト以外のオブジェクトでも使用できます。
すべてのストリングインデックスはゼロから始まるため、各ストリング x の最終文字のインデックスは x
コンストラクタメソッド new String() を使用して新しいストリング変数を作成するか、または単にストリングリテラル値を割り当てるかにかかわらず、String クラスのメソッドをどれでも呼び出すことができます。旧バージョンの ActionScript とは異なり、String クラスのメソッドには、コンストラクタを使用するか、グローバル関数を使用するか、または単にストリングリテラル値を割り当てるかによる違いはありません。次の各行のコードは同じです。次に例を示します。このステートメントでは、値は null に設定されます。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[読み取り専用] 指定した String オブジェクト内にある文字数を表す整数です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
指定されたストリングに初期化された新しい String オブジェクトを作成します。index パラメータで指定された位置にある文字を返します。指定された引数を必要に応じてストリングに変換し、String オブジェクトの最後に追加して結果のストリングを返します。[静的] パラメータ内の Unicode 文字コードに対応する文字をストリングとして返します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。複数のストリングのソート順を比較し、比較の結果を整数で返します。指定されたプロパティが存在し、列挙できるかどうかを示します。指定された pattern をストリングと照合し、新しいストリングを返します。この新しいストリングでは、pattern と最初に一致した部分が repl で指定された内容に置き換えられます。指定された pattern を検索し、最初に一致したサブストリングのインデックスを返します。ループ処理に対するダイナミックプロパティの可用性を設定します。このストリングのコピーを返します。すべての大文字が小文字に変換されます。このストリングのコピーを返します。すべての小文字が大文字に変換されます。このストリングのコピーを返します。すべての大文字が小文字に変換されます。指定されたオブジェクトのストリング表現を返します。このストリングのコピーを返します。すべての小文字が大文字に変換されます。String インスタンスのプリミティブ値を返します。
プロパティの詳細
指定した String オブジェクト内にある文字数を表す整数です。
すべてのストリングインデックスはゼロから始まるため、各ストリング x の最終文字のインデックスは x
コンストラクタの詳細
指定されたストリングに初期化された新しい String オブジェクトを作成します。メモ : ストリングリテラルの方が String オブジェクトよりもオーバーヘッドが少なく、一般的により簡単に使用できます。String オブジェクトを使用する特別な理由がある場合以外は、String クラスよりもストリングリテラルを使用することをお勧めします。
メソッドの詳細
index パラメータで指定された位置にある文字を返します。指定されたインデックスがこのストリングのインデックスの範囲外である場合は、空のストリングが返されます。charAt() と似ていますが、実際の文字ではなく 16 ビット整数文字コードを返す点が異なります。または、インデックスがこのストリングのインデックスの範囲外である場合は、 NaN を返します。指定された引数を必要に応じてストリングに変換し、String オブジェクトの最後に追加して結果のストリングを返します。ソースの String オブジェクトの元の値は変更されません。String — 指定のパラメータにより連結されたこのストリングで構成される新しいストリングです。パラメータ内の Unicode 文字コードに対応する文字をストリングとして返します。このインデックスはゼロから始まります。つまりストリングの最初の文字は、インデックス 1 ではなくインデックス 0 にあると見なされます。これはオプションです。int — 指定のサブストリングまたは -1 で最初に見つかった指定のサブストリングのインデックスです。このインデックスはゼロから始まります。これはオプションです。デフォルトは、インデックスに許可されている最大値です。startIndex が指定されていない場合、ストリング内の最後のアイテムから検索が開始されます。int — 最後に見つかった指定のサブストリングの位置です。見つからなかった場合は -1 を返します。複数のストリングのソート順を比較し、比較の結果を整数で返します。
このメソッドはロケール特有の方法で比較を処理することを目的としていますが、ActionScript 3
=)演算子などのその他のストリング比較と異なる結果を生成しません。ストリングが等価の場合、戻り値は 0 になります。元のストリング値が other で指定されたストリング値より前に来る場合、戻り値は負の整数になります。この値の絶対値は、2 つのストリング値の間にある文字数を表します。元のストリング値が other の後に来る場合、戻り値は正の整数になります。この値の絶対値は、2 つのストリング値を隔てる文字数を表します。これはオプションです。それ以外の場合、元のストリングがストリング引数より前に来る場合は負の整数、ストリング引数が元のストリングより前に来る場合は正の整数になります。どちらの場合も、数値の絶対値は 2 つのストリングの違いを表します。パターンには任意の型のオブジェクトを指定できますが、一般的にストリングまたは正規表現を使用します。pattern が正規表現でもストリングでもない場合、メソッドは実行する前にこれをストリングに変換します。Array — 指定された pattern と一致するストリング内のすべてのサブストリングで構成されるストリングの配列です。pattern が正規表現の場合、一致するサブストリングを複数含む配列を返すには、正規表現の中に g(グローバル)フラグを設定する必要があります。g(グローバル)フラグを設定しない場合、返される配列には一致するサブストリングが 1 つだけ含まれ、正規表現の lastIndex プロパティは変更されません。g(グローバル)フラグを設定した場合、メソッドはストリングの先頭(インデックス位置 0)から検索を開始します。/x*/ などの正規表現を使用する場合、一致するサブストリングが空のストリングであることがあります。その場合、メソッドはその空のストリングを一致するサブストリングの配列に追加し、次のインデックス位置から検索を続行します。一致するサブストリングが見つからなかった場合、メソッドは null を返します。pattern パラメータの値を渡さなかった場合、または未定義値を渡した場合、メソッドは null を返します。指定された pattern をストリングと照合し、新しいストリングを返します。この新しいストリングでは、pattern と最初に一致した部分が repl で指定された内容に置き換えられます。pattern パラメータには、ストリングまたは正規表現を指定できます。repl パラメータには、ストリングまたは関数を指定できます。関数を指定した場合、一致した部分は、関数によって返されるストリングに置き換えられます。元のストリングは変更されません。次の例では、"sh"(大文字と小文字は区別)の最初のインスタンスのみが置き換えられます。次の例では、g(グローバル)フラグが正規表現で設定されているので、"sh"(大文字と小文字は区別)のすべてのインスタンスが置き換えられます。次の例では、正規表現の中に g(グローバル)フラグが設定されているので、"sh" のすべてのインスタンスが置き換えられます。また、一致は大文字と小文字を区別 しません。パターンには任意の型のオブジェクトを指定できますが、一般的にストリングまたは正規表現を使用します。ただし、このパラメータに関数を指定することもできます。関数を指定した場合、一致した内容が、関数によって返されるストリングに置き換えられます。repl パラメータにストリングを指定し、pattern パラメータに正規表現を指定した場合、次の特殊な $ 置換コードを repl ストリングに使用することができます。
パターンに一致したサブストリング
ストリングのうち、パターンに一致したサブストリングより前の部分です。このコードで使用する記号は、直線状の左一重引用符(`)です。垂直の一重引用符(')または曲がった左一重引用符(‘)ではありません。ストリングのうち、パターンに一致したサブストリングより後の部分です。このコードで使用する記号は、垂直の一重引用符(')です。括弧指定されたグループの n 番目の一致です。括弧指定されたグループの nn 番目一致です。nn 番目のパターンが未定義の場合、置換テキストは空のストリングになります。たとえば、次の例は、1 番目および 2 番目に一致したキャプチャグループを表す $2 および $1 置換コードを使用する方法を示しています。
ストリング内の一致する部分
キャプチャされた、括弧指定されたグループとのすべての一致が次の引数として提供されます。この方法で渡される引数の数は、括弧内のパターンとの一致数によって異なります。
ストリング内で一致部分が始まる場所のインデックス位置
次に例を示します。1 回目は、パターンがサブストリング "abc12" に一致し、次の引数のリストが関数に渡されます。2 回目は、パターンがサブストリング "def23" に一致し、次の引数のリストが関数に渡されます。ソースストリングは変更されていません。指定された pattern を検索し、最初に一致したサブストリングのインデックスを返します。一致するサブストリングがなかった場合、メソッドは -1 を返します。パターンには任意の型のオブジェクトを指定できますが、一般的にストリングまたは正規表現を使用します。pattern が正規表現でもストリングでもない場合、メソッドは実行する前にこれをストリングに変換します。正規表現を指定した場合、メソッドは正規表現のグローバルフラグ("g")を無視し、また正規表現の lastIndex プロパティを無視し、元のまま維持します。未定義の値を渡した場合、または値を渡さなかった場合、メソッドは -1 を返します。int — 最初に一致したサブストリングのインデックス、または一致するサブストリングがない場合は -1 です。
ストリングのインデックスはゼロから始まり、ストリングの先頭の文字はインデックス 0、最後の文字は string
endIndex パラメータを指定しない場合、サブストリングの終わりがストリングの終わりになります。startIndex で指定されたインデックス文字が、endIndex で指定されたインデックス文字と同じか、その右側にある場合、メソッドは空のストリングを返します。このとき、-1 が最後の文字です。endIndex パラメータで指定されたインデックス位置の文字は、抽出されるストリングには含まれません。endIndex が負の数値の場合、終点はストリングの終わりからカウントされて決定されます。このとき、-1 が最後の文字になります。デフォルトは、インデックスに許可されている最大値です。String — 指定されたインデックスに基づくサブストリングです。delimiter パラメータが正規表現の場合、ストリング内の特定の位置で見つかった最初の一致のみが考慮されます。バックトラッキングにより、同じ位置で空でないサブストリングの一致が見つかったとしても、それは考慮されません。次に実際の使用例を示します。delimiter パラメータがグループ化括弧を含む正規表現の場合、delimiter が一致するたびに、未定義結果を含むグループ化括弧の結果が出力配列にスプライスされます。次に例を示します。limit パラメータを指定した場合、配列には指定された数を超えるエレメントは返されません。delimiter が空のストリング、空の正規表現、または空のストリングも一致とされる正規表現の場合、ストリング内のそれぞれの 1 文字が配列内のエレメントとして出力されます。delimiter パラメータが未定義の場合は、ストリング全体が、返される配列の最初のエレメントに挿入されます。パターンには任意の型のオブジェクトを指定できますが、一般的にストリングまたは正規表現を使用します。delimiter が正規表現でもストリングでもない場合、メソッドは実行する前にこれをストリングに変換します。デフォルトは、許可されている最大値です。元のストリングは変更されません。startIndex が負の数値の場合、始点はストリングの終わりから決定されます。このとき、-1 が最後の文字になります。デフォルト値は、許可されている最大値です。String — 指定されたパラメータに基づくサブストリングです。元のストリングは変更されません。デフォルトは、インデックスに許可されている最大値です。このパラメータが負の値である場合は、0 が使用されます。String — 指定されたパラメータに基づくサブストリングです。このストリングのコピーを返します。すべての大文字が小文字に変換されます。元のストリングは変更されません。
このメソッドはロケールに特化した方法で変換を処理することを目的としていますが、ActionScript 3
すべての大文字が小文字に変換されます。このストリングのコピーを返します。すべての小文字が大文字に変換されます。元のストリングは変更されません。
このメソッドはロケールに特化した方法で変換を処理することを目的としていますが、ActionScript 3
すべての小文字が大文字に変換されます。このストリングのコピーを返します。すべての大文字が小文字に変換されます。元のストリングは変更されません。txt ファイルで定義されています。すべての大文字が小文字に変換されます。このストリングのコピーを返します。すべての小文字が大文字に変換されます。元のストリングは変更されません。txt ファイルで定義されています。すべての小文字が大文字に変換されます。String インスタンスのプリミティブ値を返します。このメソッドは、String オブジェクトをプリミティブなストリング値に変換するように設計されています。Flash Player は必要時に自動的に valueOf() を呼び出すようになっているため、このメソッドを明示的に呼び出すことが必要となることはほとんどありません。
例 例の使用法
ここでは以下の手順を実行します。これらのインスタンスはさまざまなストリングと新しい StringHelper オブジェクトにより初期化されます。trimFront():ストリングの先頭から末尾に向かって文字を比較し、char パラメータに一致するすべての文字を、最初に char パラメータに一致しない文字が現れるまで、再帰的に削除します。そして更新されたストリングを返します。trimBack():ストリングの末尾から先頭に向かって文字を比較し、char パラメータに一致するすべての文字を、最初に char パラメータに一致しない文字が現れるまで、再帰的に削除します。そして更新されたストリングを返します。宣言されているストリング変数を使用して、2 番目のストリングの作成に replace() メソッド、3 番目のストリングの作成に trim() メソッドを呼び出して、3 つのストリングを作成します。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
Vector クラスを使用すると、ベクターにアクセスして操作することができます。ベクターとはすべてのエレメントが同じデータ型を持つ配列です。ベクターのエレメントのデータ型は、ベクターのベース型と呼ばれています。ベース型は、ビルトインクラスとカスタムクラスを含む任意のクラスです。ベース型は、Vector 変数の宣言時とクラスコンストラクタの呼び出しによるインスタンスの作成時に指定されます。配列の場合と同様に、配列アクセス([])演算子を使用すると、ベクターエレメントの値を設定または取得できます。また、いくつかのベクターのメソッドは、エレメントの値を設定および取得するためのメカニズムを備えています。Vector オブジェクトのプロパティとメソッドは、配列のプロパティとメソッドと似ており、ほとんどの場合は同じです。すべてのエレメントが同じデータ型を持つ配列を使用する場合は、Vector インスタンスが推奨されます。ベクターのベース型は、後置型パラメータシンタックスを使用して指定されます。
型パラメータシンタックスは、次の例が示すように、ドット()、左山括弧(<)、クラス名、および右山括弧(>)からなるシーケンスです。つまり、この行は String インスタンスのみ保持することができ、String インスタンスのみ取得できるベクター(配列)を表します。<T> データ型によって宣言された変数は、同じベース型 T を使用して構築された Vector インスタンスのみ格納することができます。<String>() を呼び出して構築されたベクターは、ベクターで宣言されている変数に割り当てることはできません。<int> データ型によって宣言された変数に割り当てることはできません。ベース型は完全に一致する必要があります。例えば、次のコードは、オブジェクトのベース型が宣言された変数のベース型と同じでないため(Sprite が DisplayObject のサブクラスであっても)コンパイルされません。ベース型 T を持つベクターを T のスーパークラスのベクターに変換するには、Vector() グローバル関数を使用します。データ型の制限に加えて、Vector クラスには Array クラスと区別される次のようなその他の制限があります。ベクターは高密度の配列です。位置 1 ~ 6 に値がない場合でもインデックス 0 と 7 に値を指定することができる配列とは異なり、ベクターでは各インデックスに値(または null)を指定する必要があります。ベクターは、オプションで固定長、つまり含まれるエレメントの数を変更できないように設定できます。ベクターのエレメントへのアクセスは範囲チェックが行われます。最後のエレメント(length - 1)より長いインデックスから値を読み取ることはできません。
現在の最後のインデックスを越えて値を設定することはできません(つまり、既存のインデックスまたはインデックス [length] でのみ値を設定することができます)
このような制限の結果として、ベクターでは、エレメントがすべて単一クラスのインスタンスとなる Array インスタンスにはない、次の 2 つの主要な利点が得られます。パフォーマンス:Array インスタンスを使用するよりも、Vector インスタンスを使用する方が、配列エレメントのアクセスと繰り返しが高速になります。型の安全性:コンパイラは Strict モードの場合、不正なデータ型の値をベクターに割り当てたり、ベクターから値を読み取るときに間違ったデータ型が読み取られる恐れがあるなどのデータ型のエラーを識別できます。ただし、push() メソッドまたは unshift() メソッドを使用してベクターに値を追加する場合、引数のデータ型はコンパイル時にチェックされず、実行時にチェックされることに注意してください。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。ベクターの length プロパティを変更できるかどうかを指定します。ベクター内で使用できる有効なインデックスの範囲です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
指定されたベース型を持つベクターを作成します。パラメータで指定されたエレメントをベクター内のエレメントと連結して、新しいベクターを作成します。指定された関数について false を返すアイテムに達するまで、ベクター内の各アイテムにテスト関数を実行します。ベクター内の各アイテムについてテスト関数を実行し、指定された関数について true を返すすべてのアイテムを含む新しいベクターを返します。ベクター内の各アイテムについて関数を実行します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。ベクター内のアイテムを検索し、アイテムのインデックス位置を返します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。ベクター内のエレメントをストリングに変換し、指定されたセパレータをエレメント間に挿入し、エレメントを連結して、その結果をストリングとして返します。ベクター内のアイテムを、指定されたインデックス位置から後方に向かって検索し、一致したアイテムのインデックス位置を返します。ベクター内の各アイテムについて関数を実行し、このベクター内の各アイテムに対する関数の呼び出しの結果に対応するアイテムの新しいベクターを返します。ベクターの最後のエレメントを削除して、そのエレメントを返します。指定されたプロパティが存在し、列挙できるかどうかを示します。エレメントをベクターの最後に追加して、ベクターの新しい長さを返します。ベクター内のエレメントの順序を反転します。ループ処理に対するダイナミックプロパティの可用性を設定します。ベクターの最初のエレメントを削除して、そのエレメントを返します。元のベクターから一連のエレメントを取り出して、新しいベクターを返します。元のベクターは変更されません。true を返すアイテムに達するまで、ベクター内の各アイテムにテスト関数を実行します。ベクター内のエレメントをソートします。ベクターのエレメントを追加および削除します。指定されたベクター内のエレメントを表すストリングを返します。ベクター内のエレメントを表すストリングを返します。エレメントをベクターの先頭に追加して、ベクターの新しい長さを返します。指定されたオブジェクトのプリミティブな値を返します。
プロパティの詳細
ベクターの length プロパティを変更できるかどうかを指定します。
length プロパティを変更する以下のメソッドの呼び出し
ベクター内で使用できる有効なインデックスの範囲です。ずべてのベクターエレメントは、常にベース型のインスタンスまたは null のいずれかの値を持ちます。length プロパティが前の値より大きい値に設定されている場合、追加のエレメントが作成され、ベース型に適したデフォルト値(参照型の場合は null)が設定されます。length プロパティが前の値より小さい値に設定されている場合、新しい length 値以上のインデックス位置にあるすべてのエレメントがベクターから削除されます。
コンストラクタの詳細
指定されたベース型を持つベクターを作成します。<T>() コンストラクタを呼び出すときに、型パラメータシンタックスを使用してベース型を指定します。
型パラメータシンタックスは、次の例が示すように、ドット()、左山括弧(<)、クラス名、および右山括弧(>)からなるシーケンスです。配列または他のベクター(異なるベース型を持つベクターなど)から Vector インスタンスを作成するには、Vector() グローバル関数を使用します。
このパラメータが 0 より大きい場合、指定された数のベクターエレメントが作成され、ベース型に適したデフォルト値が設定されます(参照型の場合、null)
この値は fixed プロパティを使用して設定することもできます。
メソッドの詳細
パラメータで指定されたエレメントをベクター内のエレメントと連結して、新しいベクターを作成します。パラメータでベクターを指定すると、そのベクターのエレメントが連結されます。
args — 新しいベクターに連結されるこのベクターのベース型の 1 つ以上の値
値を渡さない場合、新しいベクターは元のベクターの複製になります。
<T> — このベクターの後にパラメータのエレメントが続くベクターと同じベース型を持つベクター
TypeError — 引数がベース型のインスタンスではない場合で、ベース型に変換できない場合
指定された関数について false を返すアイテムに達するまで、ベクター内の各アイテムにテスト関数を実行します。このメソッドを使用して、ベクター内のすべてのアイテムがある基準(値が特定の数値より小さいなど)を満たしているかどうかを判別できます。この関数は、ベクターの現在のアイテム、アイテムのインデックス、および Vector オブジェクトの 3 つの引数によって呼び出されます。コールバック関数はブール値を返します。指定された関数について、ベクター内のいずれかのアイテムが true を返す場合は true を返します。ベクター内の各アイテムについてテスト関数を実行し、指定された関数について true を返すすべてのアイテムを含む新しいベクターを返します。false を返すアイテムは、結果ベクターに含められません。戻りベクターのベース型はメソッドが呼び出されるベクターのベース型と一致します。この関数は、ベクターの現在のアイテム、アイテムのインデックス、および Vector オブジェクトの 3 つの引数によって呼び出されます。ベクター内の各アイテムについて関数を実行します。この関数は、ベクターの現在のアイテム、アイテムのインデックス、および Vector オブジェクトの 3 つの引数によって呼び出されます。関数呼び出しの戻り値は破棄されます。ベクター内のアイテムを検索し、アイテムのインデックス位置を返します。アイテムは、厳密な等価(===)を使用してベクターエレメントと比較されます。つまり、検索は最後の -fromIndex アイテムから開始し、その位置から前方に向かってベクターの最後まで検索します。int — ベクター内のアイテムの 0 から始まるインデックス位置です。ベクター内のエレメントをストリングに変換し、指定されたセパレータをエレメント間に挿入し、エレメントを連結して、その結果をストリングとして返します。ネストされたベクターは、join() メソッドに渡されるセパレータで区切るのではなく、常にカンマ(,)で区切ります。このパラメータを省略すると、デフォルトのセパレータとしてカンマが使用されます。String — ストリングに変換されたベクターのエレメントで構成され、指定されたストリングで区切られているストリングです。ベクター内のアイテムを、指定されたインデックス位置から後方に向かって検索し、一致したアイテムのインデックス位置を返します。アイテムは、厳密な等価(===)を使用してベクターエレメントと比較されます。デフォルトは、許容される最大インデックス値です。つまり、検索はベクター内の最後のアイテムから開始されます。つまり、検索は最後の -fromIndex アイテムから開始し、その位置から後方に向かってインデックス 0 まで検索します。int — ベクター内のアイテムの 0 から始まるインデックス位置です。ベクター内の各アイテムについて関数を実行し、このベクター内の各アイテムに対する関数の呼び出しの結果に対応するアイテムの新しいベクターを返します。結果ベクターには、元のベクターと同じベース型と length が指定されます。結果ベクターのインデックス i のエレメントは、元のベクターのインデックス i のエレメントでの呼び出しの結果です。この関数は、ベクターの現在のアイテム、アイテムのインデックス、および Vector オブジェクトの 3 つの引数によって呼び出されます。<T> — ベクター内の各アイテムに対する関数の呼び出しの結果が含まれる新しいベクターです。結果ベクターには、元のベクターと同じベース型と length が指定されます。ベクターの最後のエレメントを削除して、そのエレメントを返します。この関数が呼び出されるときに、ベクターの length プロパティは 1 つ減少します。T — 指定されたベクターの最後のエレメントの値です。エレメントをベクターの最後に追加して、ベクターの新しい長さを返します。この関数は複数の引数を受け入れることができるので、Strict モードの場合でも、コンパイル時に引数のデータ型はチェックされません。ただし、ベース型のインスタンスではない引数が渡されると、実行時に例外が発生します。uint — 新しいエレメントが追加された後のベクターの長さです。ベクター内のエレメントの順序を反転します。このメソッドは呼び出されるベクターを変更します。
<T> — 逆の順序のエレメントを持つベクター
ベクターの最初のエレメントを削除して、そのエレメントを返します。残りのベクターエレメントは、元の位置 i から i - 1 に移動されます。
T — ベクター内の最初のエレメント
元のベクターから一連のエレメントを取り出して、新しいベクターを返します。元のベクターは変更されません。パラメータを何も渡さないと、元のベクターの複製が作成されます。つまり、-1 が最後のエレメントです。このパラメータを省略すると、スライスにはベクターの最初から最後までのすべてのエレメントが取り込まれます。endIndex が負の数値の場合、終点はベクターの末尾から開始します。つまり、-1 が最後のエレメントです。<T> — 元のベクターから取り出した一連のエレメントから成るベクターです。true を返すアイテムに達するまで、ベクター内の各アイテムにテスト関数を実行します。このメソッドを使用して、ベクター内のいずれのアイテムもある基準(値が特定の数値より小さいなど)を満たしているかどうかを判別できます。この関数は、ベクターの現在のアイテム、アイテムのインデックス、および Vector オブジェクトの 3 つの引数によって呼び出されます。コールバック関数はブール値を返します。指定された関数についてベクター内のいずれかのアイテムが true を返す場合は true を返します。ベクター内のエレメントをソートします。指定したメソッドはベクターのベース型(T)の 2 つの引数を受け取り、数値を返す必要があります。
x が y の前に表示されるソート順の場合は負の数
x が y の後に表示されるソート順の場合は正の数
<T> — 新しい順序のエレメントを持つベクター
ベクターのエレメントを追加および削除します。このメソッドは、コピーを作成しないで、ベクターを変更します。
メモ:ベクターのサブクラス内でこのメソッドをオーバーライドするには、次の例に示すように、パラメータに
負の整数を使用すると、ベクターの末尾を基準として位置を指定できます。例えば、-1 はベクターの最後のエレメントです。値として 0 を指定すると、エレメントは削除されません。items — startIndex パラメータで指定したベクター内の位置に挿入するカンマ区切り値またはベクターのオプションリストです。<T> — 元のベクターから削除されたエレメントを含むベクターです。指定されたベクター内のエレメントを表すストリングを返します。インデックス 0 から最大インデックスまでのベクター内のすべてのエレメントを、カンマで区切られた連結ストリングに変換して返します。ベクター内のエレメントを表すストリングを返します。インデックス 0 から最大インデックスまでのベクター内のすべてのエレメントを、カンマで区切られた連結ストリングに変換して返します。エレメントをベクターの先頭に追加して、ベクターの新しい長さを返します。ベクター内のその他のエレメントは、元の位置 i から i に新しいエレメントの数を加えた位置に移動されます。この関数は複数の引数を受け入れることができるので、Strict モードの場合でも、コンパイル時に引数のデータ型はチェックされません。ただし、ベース型のインスタンスではない引数が渡されると、実行時に例外が発生します。
args — ベクターの先頭に挿入されるこのベクターのベース型の 1 つ以上のインスタンス
uint — ベクターの新しい長さを表す整数です。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
XML クラスには、XML オブジェクトを操作するためのメソッドとプロパティが含まれています。toXMLString() メソッドは、XML オブジェクトに単純内容が含まれるか複合内容が含まれるかに関係なく、XML オブジェクトのストリング表現を返します。xml パッケージに移行されています。0 に残されているものです。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[静的] XML オブジェクトがソースの XML データを解析する際に、XML コメントを無視するかどうかを決定します。[静的] XML オブジェクトがソースの XML データを解析する際に、XML 処理命令を無視するかどうかを決定します。[静的] テキストノードの先頭および最後の空白文字を、解析時に無視するかどうかを決定します。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
新しい XML オブジェクトを作成します。XML オブジェクトのスコープ内の名前空間セットに名前空間を追加します。指定された子を XML オブジェクトのプロパティの最後に追加します。指定された XML オブジェクトの属性値のリストを返します。XML オブジェクトの子を列挙します。親のコンテキスト内でのこの XML オブジェクトの 0 から始まるインデックス位置を識別します。XML オブジェクトの子を、出現する順序で列挙します。XML コメントを持つ XML オブジェクトのプロパティを列挙します。指定された XML オブジェクトのコピーを返します。指定された name パラメータを持つ XML オブジェクトのすべての子孫(子、孫、ひ孫など)を返します。XML オブジェクトのエレメントを列挙します。XML オブジェクトに複合内容が含まれるかどうかを確認します。オブジェクトに p パラメータで指定されたプロパティがあるかどうかを確認します。XML オブジェクトに単純内容が含まれるかどうかを確認します。オブジェクトの親に基づいて、XML オブジェクトの名前空間を列挙します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。XML オブジェクトの場合、このメソッドは常に整数 1 を返します。XML オブジェクトの修飾名のローカル名部分を指定します。XML オブジェクトの修飾名を指定します。パラメータを指定しない場合、この XML オブジェクトの修飾名に関連付けられている名前空間を指定します。親のコンテキストで XML オブジェクトに関連付けられている名前空間宣言を列挙します。ノードのタイプ(テキスト、コメント、処理命令、属性、またはエレメント)を指定します。XML オブジェクトとすべての子孫の XML オブジェクトについて、隣接するテキストノードを結合し、空のテキストノードを削除します。XML オブジェクトの親を返します。指定された child オブジェクトのコピーを、このエレメント内の既存のすべての XML プロパティの前に挿入します。name パラメータを指定した場合、その name を持つ処理命令を含む XML オブジェクトのすべての子を列挙します。in ステートメント内で反復処理されるプロパティセット内に、プロパティ p があるかどうかを確認します。このオブジェクトとすべての子孫に指定された名前空間を削除します。XML オブジェクトの子プロパティを、value パラメータで指定された XML プロパティのセットに置き換えます。XML オブジェクトのローカル名を、指定された name パラメータに変更します。XML オブジェクトの名前を、指定された修飾名または属性名に設定します。XML オブジェクトに関連付けられている名前空間を設定します。ループ処理に対するダイナミックプロパティの可用性を設定します。XML オブジェクトのストリング表現を返します。XML オブジェクトを返します。
プロパティの詳細
XML オブジェクトがソースの XML データを解析する際に、XML コメントを無視するかどうかを決定します。
デフォルトでは、コメントを無視します(true)
ソースの XML にコメントノードが含まれる場合、このノードは XML の解析時には保持されるか、または破棄されます。XML オブジェクトがソースの XML データを解析する際に、XML 処理命令を無視するかどうかを決定します。
デフォルトでは、処理命令を無視します(true)
ソースの XML に処理命令ノードが含まれる場合、このノードは XML の解析時には保持されるか、または破棄されます。テキストノードの先頭および最後の空白文字を、解析時に無視するかどうかを決定します。
デフォルトでは、空白文字を無視します(true)
インデントは、タブ文字でなく、空白文字で適用されます。デフォルト値は 2 です。
コンストラクタの詳細
新しい XML オブジェクトを作成します。XML クラスのメソッドを呼び出す前に、コンストラクタを使用して XML オブジェクトを作成する必要があります。toXMLString() メソッドは、XML オブジェクトに単純内容が含まれるか複合内容が含まれるかに関係なく、XML オブジェクトのストリング表現を返します。
メソッドの詳細
XML オブジェクトのスコープ内の名前空間セットに名前空間を追加します。その名前空間が XML オブジェクトのスコープ内の名前空間セットに既に存在する(指定されたパラメータに一致する接頭辞を持つ)場合、既存の名前空間の接頭辞は undefined に設定されます。入力パラメータが Namespace オブジェクトの場合は、このオブジェクトが直接使用されます。入力パラメータが QName オブジェクトの場合は、新しい名前空間の作成に入力パラメータの URI が使用され、それ以外の場合は、入力パラメータは String に変換され、名前空間がその String から作成されます。次の例では、1 つの XML オブジェクトに定義されている名前空間を使用して、これを別の XML オブジェクトに適用します。指定された子を XML オブジェクトのプロパティの最後に追加します。この例では、新しいエレメントを XML オブジェクトの子リストの最後に追加します。属性は XML エレメント内にあります。修飾名参照が必要な場合は、QName オブジェクトで渡すことができます。QName オブジェクトは名前空間とローカル名を定義するもので、属性の修飾名の定義に使用することができます。属性値が定義されていない場合は空の XMLList を返します。指定された XML オブジェクトの属性値のリストを返します。次の例では、属性の名前を返します。この例は、すべての属性の名前を返します。XML オブジェクトの子を列挙します。子のインデックス番号を使用しても同じ結果が得られます。インデックス番号は、複数の XML の子のリスト内での子の位置を識別します。XML ドキュメント内のすべての子を出力するにはアスタリスク(*)を使用します。次の例は、child() メソッドを使って指定された名前の子エレメントを識別する方法を示しています。親のコンテキスト内でのこの XML オブジェクトの 0 から始まるインデックス位置を識別します。正の整数だけでなく、-1 も返します。XML オブジェクトの子を、出現する順序で列挙します。XML コメントを持つ XML オブジェクトのプロパティを列挙します。指定された XML オブジェクトのコピーを返します。コピーとはノードのツリー全体の複製です。この例では、copy() メソッドは XML オブジェクトの新しいインスタンスを作成しています。コピーを修正しても、元のオブジェクトは変更されません。デフォルト値は次のとおりです。メモ : このメソッドを クラスのインスタンスには適用しません。Object — プロパティをデフォルト値に設定したオブジェクトです。次の例は、XML オブジェクトを設定する前に、コメントおよび処理命令を配置するカスタム設定を適用する方法、別のXML オブジェクトを設定する前にデフォルト設定に戻す方法、さらに別の XML オブジェクトの設定のために再度カスタム設定を適用する方法を示しています。指定された name パラメータを持つ XML オブジェクトのすべての子孫(子、孫、ひ孫など)を返します。name パラメータはオプションです。すべての子孫を返すには、"*" パラメータを使用します。パラメータを指定しない場合はストリング "*" が渡され、XML オブジェクトのすべての子孫が返されます。XML オブジェクトのエレメントを列挙します。name パラメータはオプションです。name パラメータは、特定のエレメントの列挙に使用します。すべてのエレメントを列挙するには、パラメータにアスタリスク(*)を使用します。アスタリスクはデフォルトパラメータでもあります。エレメントの総数を出力するには、アスタリスクパラメータと共に length() メソッドを使用します。エレメントの名前は山括弧で囲まれています。エレメントの内容は開始タグと終了タグで囲まれます。すべてのエレメントの呼び出しでアスタリスク(*)を使用すると、エレメントのタグと内容の両方を返します。次の例では、elements() メソッドは、コメント、テキストプロパティ、または処理命令を返さずに、エレメントのリストのみを返しています。XML オブジェクトに複合内容が含まれるかどうかを確認します。子エレメントを持つ場合、XML オブジェクトには複合内容が含まれます。属性、コメント、処理命令、およびテキストノードを表す XML オブジェクトは複合内容を持ちません。ただし、これらを含むオブジェクトでも、子エレメントを持つ場合は、複合内容を含んでいると見なされます。次の例は、単純内容を含む a という名前の 1 つのプロパティと、複合内容を含む a という名前の 1 つのプロパティを持つ XML オブジェクトを示しています。オブジェクトに p パラメータで指定されたプロパティがあるかどうかを確認します。この例の最後の行が次のように記述されていると、a という名前の最初のエレメントに b という名前のプロパティが存在しないため、Flash Player は例外をスローします。XML オブジェクトに単純内容が含まれるかどうかを確認します。XML オブジェクトが子エレメントを持たないテキストノード、属性ノード、または XML エレメントを表す場合には、このオブジェクトには単純内容が含まれます。コメントおよび処理命令を表す XML オブジェクトには単純内容は含まれません。次の例は、単純内容を含む a という名前の 1 つのプロパティと、複合内容を含む a という名前の 1 つのプロパティを持つ XML オブジェクトを示しています。オブジェクトの親に基づいて、XML オブジェクトの名前空間を列挙します。テキスト、属性、コメント、パイなどのエレメントでない XML の子に対してこのメソッドを呼び出すと、undefined を返します。次の例では、XML オブジェクトの子エレメントの最後にエレメントを追加します。テキスト、属性、コメント、パイなどのエレメントでない XML の子に対してこのメソッドを呼び出すと、undefined を返します。次の例では、XML オブジェクトの子エレメントの最後にエレメントを追加します。XML オブジェクトの場合、このメソッドは常に整数 1 を返します。XML オブジェクトの修飾名のローカル名部分を指定します。XML オブジェクトの修飾名を指定します。次の例は、name() メソッドを使用して XML オブジェクトの修飾名を取得する方法を示しています。次の例は、XML プロパティ、テキストエレメント、および属性に対して呼び出す name() メソッドの使用法を示しています。パラメータを指定しない場合、この XML オブジェクトの修飾名に関連付けられている名前空間を指定します。このような条件に一致する名前空間がなかった場合、メソッドは undefined を返します。親のコンテキストで XML オブジェクトに関連付けられている名前空間宣言を列挙します。次の例は、XML オブジェクトの名前空間宣言を出力します。ノードのタイプ(テキスト、コメント、処理命令、属性、またはエレメント)を指定します。この例では、5 つのすべてのノードタイプをトレースします。XML オブジェクトとすべての子孫の XML オブジェクトについて、隣接するテキストノードを結合し、空のテキストノードを削除します。XML オブジェクトの親を返します。次の例では、parent() メソッドを使用して、XML 構造内の特定エレメントの親エレメントを識別します。指定された child オブジェクトのコピーを、このエレメント内の既存のすべての XML プロパティの前に挿入します。name パラメータを指定した場合、その name を持つ処理命令を含む XML オブジェクトのすべての子を列挙します。パラメータを指定しなかった場合、メソッドは任意の処理命令を含む XML オブジェクトのすべての子を列挙します。in ステートメント内で反復処理されるプロパティセット内にあるかどうかを確認します。in ステートメント内でプロパティを反復処理できる場合は true、それ以外の場合は false を返します。このオブジェクトとすべての子孫に指定された名前空間を削除します。名前空間がオブジェクトの修飾名またはオブジェクトの属性の修飾名によって参照されている場合、removeNamespaces() メソッドは名前空間を削除しません。次の例は、XML オブジェクトから名前空間宣言を削除する方法を示しています。無修飾名は、デフォルトの名前空間内での XML エレメントの識別に使用します。XML — 一致するプロパティが置き換えられた、結果として作成される XML オブジェクトです。次の例では、1 番目のパラメータにストリングを指定して replace() メソッドを呼び出します。XML オブジェクトの子プロパティを、value パラメータで指定された XML プロパティのセットに置き換えます。XML オブジェクトのローカル名を、指定された name パラメータに変更します。XML オブジェクトの名前を、指定された修飾名または属性名に設定します。XML オブジェクトに関連付けられている名前空間を設定します。デフォルト設定は次のとおりです。デフォルト設定は、setObj パラメータが指定されていない場合に適用されます。メモ : このメソッドは クラスのインスタンスには適用しません。rest — 次の各プロパティを持つオブジェクトです。次の例は、XML オブジェクトを設定する前に、コメントおよび処理命令を配置するカスタム設定を適用する方法、別のXML オブジェクトを設定する前にデフォルト設定に戻す方法、さらに別の XML オブジェクトの設定のために再度カスタム設定を適用する方法を示しています。次の例では、text() メソッドを使用して、XML オブジェクトのテキストノードを取得します。XML オブジェクトのストリング表現を返します。この変換の規則は、XML オブジェクトに単純内容が含まれるか、複合内容が含まれるかによって決まります。XML オブジェクトに単純内容が含まれる場合、toString() は、開始タグ、属性、名前空間宣言、および終了タグが削除された XML オブジェクトのストリング内容を返します。次の例は、XML オブジェクトに単純内容が含まれる場合に toString() メソッドによって何が返されるかを示しています。次の例は、XML オブジェクトに複合内容が含まれる場合に toString() メソッドによって何が返されるかを示しています。XML オブジェクトのストリング表現を返します。XML オブジェクトを返します。次の例は、valueOf() メソッドで返された値が、ソースの XML オブジェクトと同じであることを示しています。
例 例の使用法
次の例では、最初に XML 変数を作成して、それにノードを追加します。次に XML プロパティを使用して、XML ノードを検出および出力します。属性名で情報を見つけるために、アットマーク(@)がいくつかの trace() 呼び出しで使用されています。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
XMLList オブジェクトは複数の XML オブジェクトまたはエレメント(複数のノードまたは属性を含む)を表すこともできるので、コレクション内のエレメント全体に対してメソッドを呼び出すことも、コレクション内のエレメントごとにメソッドを呼び出すことも可能です。そのため、このオブジェクトにはどのような XML メソッドをも呼び出すことができます。複数の XML オブジェクトを含む XMLList オブジェクトと共に XML クラスのメソッドを使用しようとすると、例外がスローされます。in ステートメントなどを使用して、XMLList コレクションに対して反復処理を行い、コレクション内の各 XML オブジェクトにメソッドを適用します。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
指定された name パラメータを持つ XML オブジェクトのすべての子孫(子、孫、ひ孫など)を返します。XMLList オブジェクトに複合内容が含まれるかどうかを確認します。p により指定されたプロパティをチェックします。XMLList オブジェクトに単純内容が含まれるかどうかを確認します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。XMLList オブジェクト内のプロパティ数を返します。name パラメータを指定した場合は、その名前を持つ処理命令を含む XMLList オブジェクトのすべての子を一覧表示します。in ステートメント内で反復処理されるプロパティセット内に、プロパティ p があるかどうかを確認します。ループ処理に対するダイナミックプロパティの可用性を設定します。XMLList オブジェクト内のすべての XML オブジェクトのストリング表現を返します。
コンストラクタの詳細
メソッドの詳細
コピーとはノードのツリー全体の複製です。指定された name パラメータを持つ XML オブジェクトのすべての子孫(子、孫、ひ孫など)を返します。すべての子孫を返すには、アスタリスク(*)パラメータを使用します。パラメータを指定しない場合はストリング "*" が渡され、XML オブジェクトのすべての子孫が返されます。XMLList オブジェクトに複合内容が含まれるかどうかを確認します。XMLList オブジェクトに複数のエレメントが含まれている。p により指定されたプロパティをチェックします。XMLList オブジェクトに単純内容が含まれるかどうかを確認します。次のいずれかの条件が true の場合に、XMLList オブジェクトは単純内容を持つと見なされます。XMLList オブジェクトにエレメントが含まれていない。XMLList オブジェクト内のプロパティ数を返します。name パラメータを指定した場合、その名前を持つ処理命令を含む XMLList オブジェクトのすべての子を一覧表示します。パラメータを指定しなかった場合、メソッドは任意の処理命令を含む XMLList オブジェクトのすべての子を一覧表示します。in ステートメント内で反復処理されるプロパティセット内にあるかどうかを確認します。in ステートメント内でプロパティを反復処理できる場合は true、それ以外の場合は false を返します。XMLList オブジェクト内のすべての XML オブジェクトのストリング表現を返します。この変換の規則は、XML オブジェクトに単純内容が含まれるか、複合内容が含まれるかによって決まります。XML オブジェクトに単純内容が含まれる場合、toString() は、開始タグ、属性、名前空間宣言、および終了タグが削除された XML オブジェクトのストリング内容を返します。XML オブジェクトに複合内容が含まれる場合、toString() は、開始タグ、属性、名前空間宣言、および終了タグを含む XML オブジェクト全体を表す、XML エンコードされたストリングを返します。次の例は、XML オブジェクトに単純内容が含まれる場合に toString() メソッドによって何が返されるかを示しています。次の例は、XML オブジェクトに複合内容が含まれる場合に toString() メソッドによって何が返されるかを示しています。XMLList オブジェクト内のすべての XML オブジェクトのストリング表現を返します。
例 例の使用法
このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
プロパティを型指定なしに指定します。数値式を加算します。指定されたエレメント(a0 など)で新しい配列または多次元配列を初期化するか、配列内のエレメントにアクセスします。左側のビットは常に 0 で埋められるため、元の式の符号が保持されないという点を除いて、ビット単位の右シフト(>>)演算子と同じです。スクリプトコメントのブロックを区切ります。の順に評価します。ストリングを連結(結合)します。オペランドから 1 を減算します。@ 演算子と共に使用した場合は、一致する子孫の属性を検索します。クラス変数およびメソッドにアクセスし、オブジェクトプロパティの取得および設定を行い、読み込まれたパッケージまたはクラスを区切ります。2 つの式の等価性をテストします。式に 1 を加算します。等価(==)演算子の正反対が真であるかどうかをテストします。小さいか等しい場合、結果は true になります。スクリプトコメントの先頭を示します。変数や式のブール値を反転します。2 つの数値や式を乗算します。プロパティ、メソッド、XML プロパティ、または XML 属性の名前空間を識別します。新しいオブジェクトを作成し、指定された name と value のプロパティペアで初期化します。パラメータに対してグループ化演算を実行するか、複数の式を順番に評価します。または、パラメータを囲み、引数として括弧の前の関数に渡します。文字の前後を囲んで使用する場合、囲まれた文字はリテラル値を表し、変数やストリング、その他の ActionScript エレメントではなく、正規表現(RegExp)と見なされます。関数が任意の数のカンマ区切りの引数を取るよう指定します。自動データ変換を行わずに、2 つの式が等しいかどうかをテストします。厳密な等価(===)演算子の正反対が真であるかどうかをテストします。文字の前後を囲んで使用する場合、囲まれた文字はリテラル値を表し、変数や数値、その他の ActionScript エレメントではなく、ストリングと見なされます。符号反転や減算に使用します。データ型を割り当てるために使用します。この演算子は、変数の型、関数の戻り値の型、または関数パラメータの型を指定します。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
ネイティブドラッグ & ドロップ API を使用すると、ユーザーは、AIR アプリケーションとネイティブのオペレーティングシステムの間、2 つのアプリケーションの間または 1 つのアプリケーション内のコンポーネントの間でデータをドラッグできるようになります。次の種類のデータを転送できます。
直列化されたオブジェクト
オブジェクト参照 (元のアプリケーション内でのみ有効)
このクラスのインスタンスを作成する必要はありません。ドラッグ & ドロップ操作は、ユーザーが表示されたアイテムをクリックして別の場所にドラッグすると開始される、ユーザーインターフェイスのジェスチャです。ドラッグジェスチャを実行している間、AIR アプリケーションウィンドウ内を移動するにつれて、表示リスト上のオブジェクトによってネイティブドラッグイベントが送出されます。これらのイベントのハンドラは NativeDragManager クラスのメソッドを呼び出して、ドラッグされたアイテムをオブジェクトにドロップできるかどうかを示します。これに応答してマウスポインタが変わり、ユーザーにフィードバックが提供されます。通常、ドラッグ & ドロップジェスチャは、アクションと呼ばれる 3 種類の操作に使用されます。これらのアクションの意味はアプリケーションのコンテキストに応じて異なるため、ランタイムではアクションに対して特定の動作は適用されません。ただし、アクションを適切に実装すると、アプリケーションに対するユーザーの操作性が向上します。実行可能なアクションは次のとおりです。
copy - データのコピーを作成し、元のデータには変更を加えません(1 つのアプリケーション内でオブジェクトをドラッグする場合、元のオブジェクトへの参照ではなくそのオブジェクト自体をコピーするときは注意が必要です)
move - アイテムをあるリストから別のリストに移動する場合のように、元のコンテキストから、ドロップターゲットに定義されたコンテキストにデータを移動します。link - 元のコンテキストにアイテムを残したまま、元のデータへの参照またはショートカットを作成します。doDrag() 呼び出しに指定することにより、実行可能なアクションをドラッグジェスチャに設定できます。
また、実行できるのが互換性のないアクションのみのドロップを受け入れないようにできます(ただし、ランタイムでは適用できません)
ドロップの前にプロパティを設定することによって、ドラッグマネージャはマウスポインタを更新してサポートされるアクションを示すことができ、ユーザーが修飾キーを使用して互換性のないアクションを選択することを防止できます。指定されたアクションが実行できるアクションではない場合は、ターゲットが acceptDrop() メソッドを呼び出してもドロップは許可されません。ドロップターゲットにアクションが設定されていない場合、許可されたアクションから copy、move、link の優先順位に従ってデフォルトのアクションが選択されます。開始オブジェクトは、選択されたアクションに応じて内部状態を更新する必要があります。
イベントの順序
doDrag() メソッド(mouseDown イベントハンドラ内または mouseMove イベントハンドラ内)を呼び出すことによりドラッグジェスチャが開始され、ユーザーの操作に応答して次のイベントシーケンスが実行されます。doDrag() が呼び出されると、このメソッドにパラメータとして渡されたインタラクティブオブジェクトが開始元オブジェクトとなって、nativeDragStart イベントが送出されます。ドラッグジェスチャがインタラクティブオブジェクトの上で止まっている間、継続的に nativeDragOver イベントが送出されます。これらのイベントのいずれかに応答して、ドロップ可能ターゲットとして機能するオブジェクトがイベントオブジェクトのプロパティをチェックし、ドロップを受け入れ可能かどうかを判断します。これで、ユーザーはドラッグしたアイテムをターゲットにドロップすることができます。acceptDrop() メソッドに対する前の呼び出しでドラッグターゲットとして指定されていた場合、その呼び出しは無効になり、ジェスチャが再びインタラクティブオブジェクトに入った場合は acceptDrop() をもう一度呼び出す必要があります。このイベントのハンドラは、イベントオブジェクトの transferable プロパティのデータにアクセスできます。このイベントのハンドラは、イベントオブジェクトの dropAction プロパティをチェックして、リストからドラッグされたアイテムの削除など、内部のデータ状態に対して実行する必要のある変更があるかどうかを確認できます。NONE の場合、ドラッグしたアイテムが適切なターゲットにドロップされなかったことを示します。
アプリケーション間のジェスチャ
その他の点では、ジェスチャを実行中のイベントは、同じ AIR アプリケーション内で開始および終了するジェスチャと同じパターンに従って送出されます。
開始元オブジェクトは引き続き nativeDragComplete イベントを送出し、ネイティブオペレーティングシステムによって設定されたドラッグアクションを通知します (ドロップが受け入れられなかった場合は none)
ドラッグジェスチャがある AIR アプリケーションから別の AIR アプリケーションに移動すると、開始元オブジェクトとターゲット表示オブジェクトは、それぞれのアプリケーション内で通常と同じイベントを送出します。ドラッグ & ドロップジェスチャの実行中に転送されるデータは Clipboard オブジェクトに格納されます。doDrag() メソッドを使用して、ドラッグジェスチャを開始したドラッグ操作に追加されます。ドロップ可能ターゲットは、ネイティブドラッグイベントオブジェクトの clipboard プロパティを使用して Clipboard オブジェクトにアクセスできます。オブジェクトに対してその他のアクセスを行うと、ランタイムエラーが生成されます。
セキュリティについての考慮事項
開始元オブジェクトおよびターゲットオブジェクトのセキュリティサンドボックスに応じて、ドラッグされているデータへのアクセス方法が決まります。両方のオブジェクトが同じサンドボックス内にある場合は、すべての NativeDragEvent オブジェクトからデータにアクセスできます。一方、開始元オブジェクトとターゲットオブジェクトが異なるサンドボックス内にある場合、データにアクセスできるのは nativeDragDrop イベントのイベントハンドラ内のターゲットサンドボックスだけです。getData() メソッドを呼び出すとセキュリティエラーが生成されます。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。doDrag() 呼び出しに渡されるインタラクティブオブジェクトです。[静的] ドロップターゲットによって指定されているドラッグアクションです。[静的] [読み取り専用] ドラッグ操作が現在進行中かどうかを報告します。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
[静的] 指定されたターゲットインタラクティブオブジェクトが現在のドラッグイベントに対応するドロップを受け入れ可能であることを、NativeDragManager オブジェクトに通知します。[静的] ドラッグ & ドロップ操作を開始します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。
プロパティの詳細
doDrag() 呼び出しに渡されるインタラクティブオブジェクトです。ドロップターゲットによって指定されているドラッグアクションです。ドラッグ操作が現在進行中かどうかを報告します。
メソッドの詳細
指定されたターゲットインタラクティブオブジェクトが現在のドラッグイベントに対応するドロップを受け入れ可能であることを、NativeDragManager オブジェクトに通知します。このメソッドは、指定されたターゲットオブジェクトに、ドラッグしたアイテムの少なくとも 1 つのデータ形式および少なくとも 1 つの許可されたアクションを処理できる nativeDragDrop ハンドラがある場合にのみ呼び出す必要があります。ドラッグ & ドロップ操作を開始します。
ドラッグ操作を開始するには
転送するデータを 1 つ以上の形式で追加します。オプションで、ドラッグ中にプロキシイメージとして機能する BitmapData オブジェクトを作成します。NONE の場合、ドラッグしたアイテムが適切なターゲットにドロップされなかったことを示します。null の場合、プロキシイメージは表示されません。負の座標では、イメージが上方向の、ホットスポットを基準としてその左側に移動します。null の場合、ドラッグイメージの左上隅が、マウスホットスポットの位置に配置されます。null の場合、すべてのアクションが許可されます。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
BitmapData クラスのメソッドを使用して、任意のサイズの透明または不透明のビットマップイメージを作成し、実行時にさまざまな方法で操作できます。このクラスを使用すると、ビットマップのレンダリング処理を Flash Player 内部の表示更新ルーチンから分離できます。BitmapData オブジェクトを直接操作することで複雑なイメージを作成できるので、ベクターデータのコンテンツを連続的に再描画するフレーム単位のオーバーヘッドを避けることができます。BitmapData クラスのメソッドは、(ビットマップ以外の表示オブジェクトでは使用可能な) フィルタを使って設定できないような効果をサポートします。このデータは、完全に不透明なビットマップ、またはアルファチャンネルデータを含む透明なビットマップを表現できます。各 32 ビット整数は、ビットマップ内の 1 つのピクセルのプロパティを決定します。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[読み取り専用] ビットマップイメージの高さ (ピクセル単位) です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。[読み取り専用] ビットマップイメージのサイズと位置を定義する矩形です。[読み取り専用] ビットマップイメージがピクセル単位の透明度をサポートするかどうかを定義します。[読み取り専用] ビットマップイメージの幅 (ピクセル単位) です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
ソースイメージとフィルタオブジェクトを受け取り、フィルタを適用して得られるイメージを生成します。含まれるビットマップはまったく同じコピーになります。イメージ間のピクセル操作 (伸長、回転、カラー効果なし) を高速に実行するルーチンを提供します。指定された ARGB カラーで矩形領域のピクセルを塗りつぶします。(x, y) 座標を始点として所定の色で塗りつぶすことにより、イメージに対する塗りつぶし処理を実行します。(findColor パラメータが true に設定されている場合) ビットマップイメージ内の指定された色のすべてのピクセルを完全に囲む矩形領域を判別します。または、(findColor パラメータが false に設定されている場合) 指定された色ではないすべてのピクセルを完全に囲む矩形領域を判別します。アルファチャンネルデータと RGB データを含む ARGB カラー値を返します。ピクセルデータの矩形領域からバイト配列を生成します。ピクセルデータの矩形領域からベクター配列を生成します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。1 つのビットマップイメージと、ポイント、矩形、または他のビットマップイメージとの間でピクセルレベルのヒットを検出します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。ソースイメージとターゲットイメージをチャンネルごとにブレンドします。ランダムノイズを表すピクセルでイメージを塗りつぶします。最大で 4 つのカラーパレットデータ配列 (各チャンネルごとに 1 つの配列) を使用して、イメージ内のカラーチャンネル値をマッピングし直します。ソースイメージからターゲットイメージへのピクセルディゾルブ、または同じイメージを使用したピクセルディゾルブを実行します。指定されたプロパティが存在し、列挙できるかどうかを示します。所定の (x, y) ピクセル量だけイメージをスクロールします。バイト配列をピクセルデータの矩形領域に変換します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたしきい値と比較してイメージ内のピクセル値をテストし、テストに適合したピクセルに新しいカラー値を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。
プロパティの詳細
ビットマップイメージの高さ (ピクセル単位) です。ビットマップイメージのサイズと位置を定義する矩形です。矩形の上端と左端は 0 になります。幅と高さは、BitmapData オブジェクトのピクセルの幅および高さと等しくなります。ビットマップイメージがピクセル単位の透明度をサポートするかどうかを定義します。BitmapData オブジェクトを作成した後、transparent プロパティの値が true であるかどうかを確認することにより、このオブジェクトがピクセルごとの透明度をサポートするかどうかを検査できます。ビットマップイメージの幅 (ピクセル単位) です。
コンストラクタの詳細
fillColor パラメータに値を指定した場合、ビットマップのすべてのピクセルにその色が設定されます。不透明のビットマップを作成した後、それを透明のビットマップに変更することはできません。不透明のビットマップに含まれるすべてのピクセルは、24 ビットのカラーチャンネル情報だけを使用します。ビットマップを透明に定義した場合、すべてのピクセルは、アルファ透明チャンネルを含む 32 ビットのカラーチャンネル情報を使用します。幅または高さに 2880 より大きい値を指定すると、新しいインスタンスは作成されません。
メソッドの詳細
ソースイメージとフィルタオブジェクトを受け取り、フィルタを適用して得られるイメージを生成します。
このメソッドはビルトインフィルタオブジェクトの動作に依存します (このオブジェクトは、入力ソース矩形によって影響を受けるターゲット矩形を決定します)
フィルタを適用した後、結果として得られるイメージが入力イメージよりも大きくなることがあります。最適なパフォーマンスを得るには、このような状況を避けてください。それぞれの種類のフィルタには、次のような要件があります。BlurFilter — このフィルタは、透明または不透明なソースイメージとターゲットイメージを使用できます。イメージのフォーマットが一致しない場合、フィルタ適用中に作成されるソースイメージのコピーがターゲットイメージのフォーマットに合わせられます。ドロップシャドウはターゲットイメージ上に作成されません。これらのフィルタを不透明なターゲットイメージに対して使用すると、例外がスローされます。DisplacementMapFilter — このフィルタは、透明または不透明なソースイメージとターゲットイメージを使用できますが、イメージの形式はソースとターゲットで同じである必要があります。次の例では、BitmapData インスタンスにぼかしフィルタを適用する方法について説明します。含まれるビットマップはまったく同じコピーになります。次の例は、BitmapData インスタンスのクローンを作成する方法を示しています。さらに、クローンされた BitmapData インスタンスを変更しても、元のインスタンスは変更されないことを示しています。矩形がビットマップイメージの境界と一致する場合、このメソッドはイメージ全体のカラー値を変換します。この新しいオブジェクトの各ピクセルは、2 つのソースオブジェクトのピクセル間の [差分] です。この場合、アルファチャネルの差分は無視されます。両者の RGB カラーは同じですが、アルファ値は異なります。ターゲット BitmapData オブジェクト内のその他のチャンネルのデータはすべて保たれます。ソースチャンネルの値とターゲットチャンネルの値は、次のいずれかになります。ビットマップ内のより小さな領域のチャンネルデータだけをコピーするには、BitmapData オブジェクトのサイズ全体よりも小さいソース矩形を指定します。ある特定の領域のチャンネルデータだけをターゲットイメージ内の別の領域にコピーするには、(0,0) 以外のポイントを指定します。次の例は、BitmapData オブジェクト内の赤チャンネルを、20×20 ピクセル領域にわたってオブジェクト独自の青チャンネルにコピーする方法を示しています。イメージ間のピクセル操作 (伸長、回転、カラー効果なし) を高速に実行するルーチンを提供します。このメソッドは、ソースイメージの矩形領域を、ターゲット BitmapData オブジェクトのターゲットポイントにある同じサイズの矩形領域にコピーします。ソースイメージにアルファデータがある場合、両方のアルファデータセットを使用して、ソースイメージのピクセルがソースイメージ上に合成されます。alphaPoint パラメータは、アルファイメージ内のポイントであり、ソース側矩形の左上隅に対応するものです。ソースイメージとアルファイメージが交わらない部分のピクセルは、ターゲットイメージにコピーされません。mergeAlpha プロパティは、透明なイメージを別の透明なイメージにコピーするときにアルファチャンネルを使用するかどうかを制御します。新しいピクセルが配置される矩形領域の左上隅を表します。アルファチャンネルを使用せずにピクセルをコピーするには、値を false に設定します。dispose() メソッドをイメージに対して呼び出すと、イメージの高さと幅が 0 に設定されます。それ以降、この BitmapData インスタンスのメソッドまたはプロパティを呼び出すと失敗し、例外がスローされます。
さらに、必要に応じて、拡大 / 縮小時にビットマップのスムージングを行うかどうかを指定することもできます (これはソースオブジェクトが BitmapData オブジェクトの場合にのみ可能です)
このメソッドは、オーサリングツールインターフェイスにおいてオブジェクトに対して標準ベクターレンダラを使ってオブジェクトを描画する方法に直接対応します。ソース表示オブジェクトは、この呼び出しで適用される変換を使用しません。ライブラリやファイル内に存在するように処理され、マトリックス変換、カラー変換、ブレンドモードはありません。この制限事項はアプリケーションセキュリティサンドボックス内の AIR コンテンツには適用されません。ロードされたビットマップイメージの source としての使用にも制限があります。ロードされたイメージが呼び出し元と同じドメインに存在していた場合、draw() メソッドの呼び出しは成功します。また、イメージのサーバー上のクロスドメインポリシーファイルで、draw() メソッドを呼び出す SWF コンテンツのドメインに対して許可を与えることもできます。これらの制限は、アプリケーションセキュリティサンドボックス内の AIR コンテンツには適用されません。マトリックス変換をイメージに適用したくない場合は、(デフォルト new Matrix() コンストラクタを使って作成される) 単位マトリックスにこのパラメータを設定するか、null 値を渡してください。オブジェクトが提供されない場合、ビットマップイメージのカラーは変換されません。この値を指定しない場合、クリッピングは発生せず、ソースオブジェクト全体が描画されます。allowDomain() メソッド呼び出し後に呼び出し元からアクセスできるコンテンツに含まれていません。この制限事項はアプリケーションセキュリティサンドボックス内の AIR コンテンツには適用されません。指定された ARGB カラーで矩形領域のピクセルを塗りつぶします。次の例は BitmapData オブジェクトの矩形領域を青で塗りつぶす方法を示しています。(x , y) 座標を始点として所定の色で塗りつぶすことにより、イメージに対する塗りつぶし処理を実行します。floodFill() メソッドは、各種のペイントプログラムのバケツツールのようなものです。次の例では、BitmapData オブジェクトの領域(つまり、ポイント(10, 10)で定義されたピクセルを囲んでいる領域で、すべてのカラーがそのポイントと同じ色になっている)を赤で塗りつぶす方法を示しています。たとえば、ぼかしフィルタは通常、元のイメージのサイズよりも大きい領域に影響します。generateFilterRect() メソッドを使用すると、このターゲット矩形のサイズを前もって知ることができるので、フィルタ処理の前にターゲットイメージを適切なサイズにすることができます。一部のフィルタでは、ソースイメージのサイズに基づいてターゲット矩形がクリッピングされる場合があります。(findColor パラメータが true に設定されている場合) ビットマップイメージ内の指定された色のすべてのピクセルを完全に囲む矩形領域を判別します。または、(findColor パラメータが false に設定されている場合) 指定された色ではないすべてのピクセルを完全に囲む矩形領域を判別します。
= color であるピクセルの境界を見つけるためにイメージ全体が検索されます (value はピクセルのカラー値)
値が false に設定された場合、イメージ内の指定されたカラーが存在しない領域の境界を返します。アルファ情報は返しません。BitmapData オブジェクト内のピクセルはすべて、乗算済みカラー値として保存されます。乗算済みイメージピクセルは、アルファデータが既に乗算された赤、緑、青の各カラーチャンネル値を保持します。例えば、アルファ値が 0 の場合、乗算されていない値に関わらず、RGB チャンネルの値も 0 になります。このようにデータが失われると、処理の実行時に問題が生じることがあります。BitmapData のすべてのメソッドは、乗算されていない値を受け取ったり返したりします。ピクセルの内部表現は、値として返される前に、乗算済みから非乗算に変換されます。設定処理の際は、ピクセル値が事前に乗算されてから、生のイメージピクセルが設定されます。アルファチャンネルデータと RGB データを含む ARGB カラー値を返します。BitmapData オブジェクト内のピクセルはすべて、乗算済みカラー値として保存されます。乗算済みイメージピクセルは、アルファデータが既に乗算された赤、緑、青の各カラーチャンネル値を保持します。例えば、アルファ値が 0 の場合、乗算されていない値に関わらず、RGB チャンネルの値も 0 になります。このようにデータが失われると、処理の実行時に問題が生じることがあります。BitmapData のすべてのメソッドは、乗算されていない値を受け取ったり返したりします。ピクセルの内部表現は、値として返される前に、乗算済みから非乗算に変換されます。設定処理の際は、ピクセル値が事前に乗算されてから、生のイメージピクセルが設定されます。ピクセルデータの矩形領域からバイト配列を生成します。各ピクセルごとに、符号なし整数 (32 ビットの乗算されないピクセル値) をバイト配列に書き込みます。ピクセルデータの矩形領域からベクター配列を生成します。指定された矩形を表す、符号なし整数 (32 ビットの乗算されないピクセル値) の Vector オブジェクトを返します。4 つの Vector インスタンスは、赤、緑、青およびアルファの順の各コンポーネントを表します。1 つのビットマップイメージと、ポイント、矩形、または他のビットマップイメージとの間でピクセルレベルのヒットを検出します。ヒットは、1 つの不透明なピクセルまたは 2 つの重なり合う不透明なピクセル上のポイントまたは矩形の重なりです。ヒットテストの際、どちらのオブジェクトの変換(伸縮、回転など)も考慮されません。イメージが不透明である場合、このメソッドでは完全に不透明な矩形と見なされます。透過性を考慮するピクセルレベルのヒットテストを実施する場合は、両方のイメージとも透明である必要があります。2 つの透明なイメージをテストするとき、アルファしきい値パラメータは、アルファチャンネル値(0 ~ 255)がいくつであれば不透明とみなすかを制御します。ソースイメージとターゲットイメージをチャンネルごとにブレンドします。チャンネルおよびピクセルごとに、ソースピクセルおよびターゲットピクセルのチャンネル値に基づいて新しい値が計算されます。
たとえば、赤チャンネルでは、新しい値が次のように計算されます (ここで、redSrc はソースイメージのピクセルでの赤チャンネル値、redDest はターゲットイメージの対応するピクセルでの赤チャンネル値です)
0 を指定すると、ターゲットの値がそのまま結果で使用され、0x100 を指定すると、ソースの値がそのまま使用されます。
その間の数値を指定すると、混ぜ合わされた色が使用されます(50% の場合、0x80 など)
最初のオブジェクトは緑、2 番目のオブジェクトは赤でそれぞれ塗りつぶされます。ランダムノイズを表すピクセルでイメージを塗りつぶします。他のすべてのパラメータを同じままにした場合、ランダムシードの値を変更することでさまざまな疑似乱数を生成できます。ノイズ関数はマッピング関数であり、真の乱数生成関数ではありません。このため、同じランダムシードから毎回同じ結果が作成されます。OR 論理演算子 (|) を使用して、複数のチャンネル値を組み合わせることができます。値が true である場合、すべてのカラーチャンネルに同じ値を設定することでグレースケールのイメージが作成されます。このパラメータを true に設定しても、アルファチャンネル選択には影響しません。最大で 4 つのカラーパレットデータ配列(各チャンネルごとに 1 つの配列)を使用して、イメージ内のカラーチャンネル値をマッピングし直します。赤、緑、青、アルファの各値を算出した後、標準の 32 ビット整数算術演算を使ってこれらの値を足し合わせます。各ピクセルの赤、緑、青、アルファのチャンネル値を抽出して、別個の 0 ~ 255 の値にします。これらの値は、次の該当する配列で新しいカラー値を調べる場合に使用します。これら 4 つの配列にはそれぞれ 256 個の値が含まれている必要があります。新しいチャンネル値を 4 つともすべて取得した後、それらの値を組み合わせて、ピクセルに適用される標準の ARGB 値にします。このメソッドではクロスチャンネル効果をサポートできます。それぞれの入力配列は完全な 32 ビット値を含むことができます。値を足し合わせるときに移動は発生しません。このルーチンは、チャンネル単位のクランピングに対応していません。チャンネルに対して配列が指定されない場合は、ソースイメージからターゲットイメージにカラーチャンネルがコピーされます。このメソッドは各種効果で使用できます。例えば、通常のパレットマッピング (1 つのチャンネルを選択して疑似色イメージに変換する) などです。さらに、ガンマ、曲線、平準化、量子化といったさまざまなカラー操作アルゴリズムにもこのメソッドを使用できます。Perlin ノイズ生成アルゴリズムでは、個々のランダムノイズ関数 (オクターブといいます) を補間および組み合わせることで、より自然に見えるランダムノイズを生成する単一の関数にします。音楽のオクターブと同様、各オクターブ関数の周波数は、その前のオクターブ関数の周波数の 2 倍になります。Perlin ノイズは、複数のノイズデータセットをさまざまな詳細レベルで組み合わせるので、"フラクタルノイズの和" と呼ばれてきました。Perlin ノイズ関数は、木目、雲、山脈など、自然現象や風景をシミュレートする場合に使用できます。ほとんどの場合、Perlin ノイズ関数の出力をそのまま表示するのではなく、他のイメージを強調したり、擬似ランダムバリエーションを与えるために使用します。単純なデジタルランダムノイズ関数は、コントラストのきついポイントが含まれるイメージを生成する場合が多いです。このようにきついコントラストは自然界にはあまりありません。Perlin ノイズアルゴリズムは、さまざまな詳細レベルで実行する複数のノイズ関数を混ぜ合わせます。このアルゴリズムの結果、互いに隣接するピクセル値の差異はより小さくなります。オクターブ数を多くすると、よりきめ細かいイメージを作成できます。オクターブ数を増やすと、処理時間も長くなります。他のすべてのパラメータを同じままにした場合、ランダムシードの値を変更することでさまざまな疑似乱数を生成できます。Perlin ノイズ関数はマッピング関数であり、真の乱数生成関数ではありません。このため、同じランダムシードから毎回同じ結果が作成されます。値が true の場合、ビットマップ塗りとしてシームレスなタイリング用テクスチャを作成するために、このメソッドはイメージのトランジションエッジをスムーズにすることを試みます。値が true の場合、このメソッドはフラクタルノイズを生成します。それ以外の場合は、乱流を生成します。乱流があるイメージにはグラデーションに視覚的な不連続性があるので、炎や海の波のようなシャープな視覚効果に適している場合があります。OR 論理演算子 (|) を使用して、複数のチャンネル値を組み合わせることができます。値が true の場合、赤、緑、および青の各カラーチャンネルに同じ値を設定して、グレースケールイメージが作成されます。この値が true に設定されても、アルファチャンネルの値に影響はありません。オフセット値を操作することで、perlinNoise イメージのレイヤーをスムーズにスクロールできます。オフセット配列内の各ポイントは、特定のオクターブノイズ関数に影響を与えます。ソースイメージからターゲットイメージへのピクセルディゾルブ、または同じイメージを使用したピクセルディゾルブを実行します。完了するまでピクセルディゾルブを続けるには、この関数の戻り値を後続の呼び出しに渡す必要があります。ソースイメージとターゲットイメージが等しくない場合は、すべてのプロパティを使用して、ソースからターゲットにピクセルがコピーされます。この処理により、空白イメージから完全に設定されたイメージへのディゾルブが可能になります。ソースイメージとターゲットイメージが等しい場合は、color パラメータを使ってピクセルが塗られます。この処理により、完全に設定されたイメージを消去するようにディゾルブできます。このモードでは、ターゲット point パラメータが無視されます。int — 後続の呼び出しで使用する新しいランダムシード (乱数の種) です。所定の (x , y) ピクセル量だけイメージをスクロールします。スクロール領域外のエッジ領域は変わらずにそのままになります。次の例は、Bitmap データオブジェクトを右に 40 ピクセルだけスクロールした効果を示しています。この処理中、イメージピクセルのアルファチャンネルは現在の値が保持されます。RGB カラーパラメータの値は、乗算されていないカラー値として扱われます。その後、ピクセル変更がすべて完了したら、unlock() メソッドを呼び出します。このように処理を行うと、ピクセル変更がすべて完了するまで、この BitmapData インスタンスを参照するオブジェクトは更新されません。BitmapData オブジェクト内のピクセルはすべて、乗算済みカラー値として保存されます。乗算済みイメージピクセルは、アルファデータが既に乗算された赤、緑、青の各カラーチャンネル値を保持します。例えば、アルファ値が 0 の場合、乗算されていない値に関わらず、RGB チャンネルの値も 0 になります。このようにデータが失われると、処理の実行時に問題が生じることがあります。BitmapData のすべてのメソッドは、乗算されていない値を受け取ったり返したりします。ピクセルの内部表現は、値として返される前に、乗算済みから非乗算に変換されます。設定処理の際は、ピクセル値が事前に乗算されてから、生のイメージピクセルが設定されます。その後、ピクセル変更がすべて完了したら、unlock() メソッドを呼び出します。このように処理を行うと、ピクセル変更がすべて完了するまで、この BitmapData インスタンスを参照するオブジェクトは更新されません。ビットマップが不透明な (透明でない) 場合には、このカラー値のアルファ透明度部分は無視されます。バイト配列をピクセルデータの矩形領域に変換します。矩形全体が書き込まれる前にバイト配列が終了した場合、関数は終了します。バイト配列内のデータは 32 ビット ARGB ピクセル値と想定されます。ピクセル読み取りの前後に、バイト配列に対するシークは実行されません。このメソッドは、可能な限り多くのピクセルを塗りつぶした後、例外をスローします。指定されたしきい値と比較してイメージ内のピクセル値をテストし、テストに適合したピクセルに新しいカラー値を設定します。threshold() メソッドを使用すると、イメージ内のカラー範囲を分離して置換し、イメージピクセルに対しその他の論理演算を実行することができます。operation パラメータは、しきい値テストで使用する比較演算子を指定します。たとえば、operation パラメータとして "==" を使用することにより、イメージ内の特定のカラー値を分離できます。アニメーション化されたトランジションやその他の効果に対して、この技法を使用できます。ストリングとして渡されます。threshold:uint — 各ピクセルがしきい値に適合するか、それともしきい値を超えているかをテストするための基準となる値です。値が false であれば、しきい値テストに適合しない場合にソースイメージはコピーされません。このパラメータに値を指定しない場合、BitmapData オブジェクトの全領域が変更されたと見なされます。0 以降を必要とします。
例 例の使用法
gif" のコピーを下のイメージの右に配置します。このコピーでは、threshold() メソッドを使用するテストに合格したピクセルに新しい色が適用されています。これを行うには、以下の手順を実行します。url プロパティを作成します。これはイメージファイルの場所と名前です。クラスコンストラクタが Loader オブジェクトを作成します。これは、表示オブジェクトを使用してメモリにイメージをロードします。次にイメージが表示リストに配置され、イメージは画面の座標 x = 0、y = 0 に表示されます。元のイメージと同じ座標、幅、高さで初期化された新しい Rectangle オブジェクトを作成します。次に示す変数を作成します。この例では、アルファ 0xCC の明るい灰色に設定されます。
color — しきい値のテストに合格したピクセルに設定する色
この例では黄色です。この例では透明色の青色です。これは、しきい値を満たさなかった場合には、ピクセル値がコピーされないことを示します。しきい値のテストに合格したピクセルだけが変更されるため、この値に意味はありません。[ローカルでの再生に関するセキュリティ] を [ローカルファイルにのみアクセスする] に設定して SWF ファイルをコンパイルする必要があります。gif" という名前のファイルが SWF ファイルと同じディレクトリに配置されている必要があります。イメージは、幅が約 80 ピクセル以内のものを使用することをお勧めします。次の例では、Loader クラスを使用して PNG ファイルをロードし、アプリケーションのシステムアイコンのイメージを使用します。メモ:この例をテストするには、次の操作を実行します。js ファイルを追加します。png という名前の 128x128 ピクセル PNG イメージファイルをプロジェクトディレクトリのアイコンサブディレクトリに追加します。このプロジェクトのアプリケーション記述ファイルを作成し、ADL を使用してプロジェクトをテストします。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
Graphics クラスには、ベクターシェイプの作成に使用できる一連のメソッドがあります。以下は、簡単に使用できるように用意されているヘルパー関数の一例です。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
描画領域をビットマップイメージで塗りつぶします。この Graphics オブジェクトに描画されているグラフィックをクリアし、塗りと線のスタイルの設定をリセットします。円を描画します。楕円を描画します。描画用の一連のコマンドを送信します。矩形を描画します。角丸矩形を描画します。一連の三角形をレンダリングします。通常は、ビットマップを歪曲させて、3 次元の外観にします。オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。線の描画で、線として使用するビットマップを指定します。線の描画で使用するグラデーションを指定します。線の描画で、線として使用するビットマップを指定します。現在の描画位置から (x, y) まで、現在の線のスタイルを使用して線を描画します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。
メソッドの詳細
描画領域をビットマップイメージで塗りつぶします。ビットマップを繰り返すか、タイリング表示して、領域を塗りつぶすことができます。アプリケーションでは、3 つ以上の点が描画されたとき、または endFill() メソッドが呼び出されたときに、塗りをレンダリングします。Matrix クラスのマトリックスオブジェクトです。これを使用してビットマップ上に変形を定義できます。例えば、次のマトリックスを使用すると、ビットマップを 45 度(π/4 ラジアン)回転できます。false の場合、ビットマップイメージは繰り返されません。ビットマップからはみ出す塗り領域にはビットマップのエッジが使用されます。たとえば、次のビットマップ (20 x 20 ピクセルのチェッカーボードのパターン) を考えます。次の例のように repeat が true に設定されている場合、ビットマップの塗りでビットマップが繰り返されます。repeat が false に設定されている場合、エッジのピクセルがビットマップの外側の塗り領域に使用されます。true の場合、拡大ビットマップイメージは双線形アルゴリズムを使用してレンダリングされます。最近傍アルゴリズムを使用したレンダリングの方が高速です。jpg)を使用し、回転させながら繰り返して矩形を塗りつぶします。ここでは、ファイルは SWF ファイルと同じディレクトリにあります。SWF ファイルは、[ローカルでの再生に関するセキュリティ] を [ローカルファイルにのみアクセスする] に設定してコンパイルする必要があります。アプリケーションでは、3 つ以上の点が描画されたとき、または endFill() メソッドが呼び出されたときに、塗りをレンダリングします。このメソッドの使用方法の詳細については、このクラスの末尾の例を参照してください。アプリケーションでは、3 つ以上の点が描画されたとき、または endFill() メソッドが呼び出されたときに、塗りをレンダリングします。最大 15 色まで指定できます。0 未満の値を指定した場合、デフォルトで 0 が適用されます。1 より大きい値を指定した場合、デフォルトで 1 が適用されます。この値は、100%でサンプリングされる色の幅の割合をパーセントで定義します。値 0 はグラデーションボックスの左の位置を表し、255 はグラデーションボックスの右の位置を表します。注意:この値は、グラデーションボックス内の位置を表すもので、最終グラデーションの座標空間を表すものではありません。最終グラデーションは、グラデーションボックスより広くなったり狭くなったりする場合があります。colors パラメータの値ごとに、値を指定してください。例えば、青と緑の 2 色を含む線状グラデーションの場合、次の例は、ratios 配列のさまざまな値に基づいて配置される色を示します。Matrix クラスで定義される変換マトリックスです。たとえば、2 つの色の間にシンプルな線状グラデーションがあるとします。PAD を使用しているため、グラデーションの塗りは次のようになります。REFLECT を使用する場合、グラデーションの塗りは次のようになります。REPEAT を使用する場合、グラデーションの塗りは次のようになります。REFLECT に設定されたシンプルな線状グラデーションがあるとします。それぞれの補間方法で、外観に次のような影響があります。0 は焦点が中央にあること、1 は焦点がグラデーション円のいずれかの境界にあること、-1 は焦点がグラデーション円のもう一方の境界にあることを示します。75 に設定されています。アプリケーションでは、3 つ以上の点が描画されたとき、または endFill() メソッドが呼び出されたときに、塗りをレンダリングします。この Shader インスタンスはイメージ入力の指定には必要ありません。ただし、シェーダでイメージ入力が指定されている場合は、手動で入力を指定する必要があります。Shader インスタンスを引数として渡すと、シェーダが内部的にコピーされます。描画塗り操作は、元のシェーダを参照するのではなく、その内部コピーを使用します。パラメータ値、入力、バイトコードの変更などの変更をシェーダに加えたとしても、塗りつぶしに使用したコピーシェーダにはその変更は適用されません。Matrix クラスのマトリックスオブジェクトです。これを使用してシェーダ上に変形を定義できます。例えば、次のマトリックスを使用すると、シェーダを 45 度(π/4 ラジアン)回転できます。シェーダで受け取る座標は、matrix パラメータに対して指定したマトリックスに基づきます。デフォルトの(null)のマトリックスの場合、シェーダの座標は入力のサンプリングが可能なローカルピクセル座標になります。input プロパティを参照してください。この Graphics オブジェクトに描画されているグラフィックをクリアし、塗りと線のスタイルの設定をリセットします。描画先のムービークリップに Flash の描画ツールで作成したコンテンツが含まれている場合は、curveTo() メソッドへの呼び出しの結果はこのコンテンツの下に描画されます。いずれかのパラメータを省略すると、このメソッドは失敗し、現在の描画位置は変更されません。描画される曲線は、二次ベジェ曲線です。二次ベジェ曲線は、2 つのアンカーポイントと 1 つのコントロールポイントで構成されています。曲線は、2 つのアンカーポイントを補間し、コントロールポイントに向かいます。
controlX:Number — 親表示オブジェクトの基準点からの相対的なコントロールポイントの水平座標を指定する数値
controlY:Number — 親表示オブジェクトの基準点からの相対的なコントロールポイントの垂直座標を指定する数値
anchorX:Number — 親表示オブジェクトの基準点からの相対的な次のアンカーポイントの水平座標を指定する数値
anchorY:Number — 親表示オブジェクトの基準点からの相対的な次のアンカーポイントの垂直座標を指定する数値
4 本の曲線を描いて円を作成し、緑で塗りつぶします。二次ベジェ方程式の性質上、これは完全な円ではありません。1 ピクセルの 2 本の曲線を描画し、その曲線の間のスペースを白で塗りつぶします。水平方向のコントロールポイントで、異なる曲線サイズが指定されています。円を描画します。drawCircle() メソッドを呼び出す前に、線のスタイルまたは塗り、あるいはその両方を設定します。このメソッドの使用方法の詳細については、このクラスの末尾の例を参照してください。楕円を描画します。コンストラクタが drawEgg() 関数を呼び出し、卵を描画する領域に対する水平方向および垂直方向のパラメータと卵の種類(eggSize)を渡します。卵(楕円)の高さと幅は、描画する領域を決定するために使用できます。この関数に対して事前に記述されたエラー処理はありません。グラフィックパスには別のグラフィックパスを含めることができます。描画用の一連のコマンドを送信します。drawPath() メソッドのパラメータは、描画コマンドと、x 座標と y 座標の値のペアおよび描画方向の組み合わせです。x 座標と y 座標の値のペアは配列の Number であり、各ペアによって座標位置が定義されます。drawPath() メソッドでは、浮動小数点の計算を使用するため、シェイプの回転と拡大 / 縮小がより正確で、よりよい結果が得られます。drawPath() メソッドは、線の塗りおよび描画に少し異なる規則も使用します。異なる規則を以下に示します。
塗りがパスをレンダリングするのに適用される場合:
3 ポイント未満のサブパスはレンダリングされません(ただし、線のレンダリングは発生し、線に対する規則は以下と同じになります)
閉じていないサブパス(始まりと終わりの端点が同じでない)は、暗黙的に閉じられます。
線がパスをレンダリングするのに適用される場合:
サブパスは、任意の数のポイントで構成できます。サブパスが暗黙的に閉じられることはありません。data ベクターは一連の数値であり、2 つの数値からなる各グループは 1 つの座標位置を表します。上記の例では、座標のペアとコマンドをそれぞれ個別に割り当てて配列に位置を表示していますが、単一のステートメントで割り当てることもできます。以下の例では、単一の push() ステートメント内で各配列に値を割り当てることにより、同じ星を描画しています。このため、星の中心は塗りつぶされません。次のように、3 つ目のパラメータにゼロ以外の湾曲タイプを指定すると、星の中心が塗りつぶされます。矩形を描画します。drawRect() メソッドを呼び出す前に、線のスタイルまたは塗り、あるいはその両方を設定します。
x:Number — 親表示オブジェクトの基準点からの相対的な水平座標を示す数値(ピクセル単位)
y:Number — 親表示オブジェクトの基準点からの相対的な垂直座標を示す数値 (ピクセル単位)
このメソッドの使用方法の詳細については、このクラスの末尾の例を参照してください。角丸矩形を描画します。
x:Number — 親表示オブジェクトの基準点からの相対的な水平座標を示す数値(ピクセル単位)
y:Number — 親表示オブジェクトの基準点からの相対的な垂直座標を示す数値 (ピクセル単位)
(オプション) 値を指定しない場合は、ellipseWidth パラメータに指定された値がデフォルトで適用されます。このメソッドの使用方法の詳細については、このクラスの末尾の例を参照してください。一連の三角形をレンダリングします。通常は、ビットマップを歪曲させて、3 次元の外観にします。どのタイプの塗りでも使用できます。ただし、その塗りに変換マトリックスがある場合でも、その変換マトリックスは無視されます。ビットマップ塗りを使用する場合、uvtData パラメータを使用すると、テクスチャマッピングを改善できます。3 つのインデックスごとに三角形が定義されます。indexes パラメータはオプションですが、インデックスを使用すると、通常、送信されるデータ量と計算されるデータ量が減少します。各座標は、塗りに使用されるビットマップ上のポイントを参照します。このベクターの長さが vertices ベクターの 2 倍である場合、外見上の修正を行うことなく、正規化座標が使用されます。このベクターの長さが vertices ベクターの 3 倍である場合、3 番目の座標は、「t」(視点空間における視点からテクスチャまでの距離)として解釈されます。これにより、3D でテクスチャをマッピングする場合に、レンダリングエンジンが外観を正しく適用できるようになります。このパラメータは、現在のビューで見えない三角形のレンダリングを避けるのに使用します。現在の描画位置が moveTo() メソッドの直前の呼び出しで指定された座標と等しくない場合、塗りが定義されていれば、パスが線で閉じられた後、塗りが適用されます。線の描画で、線として使用するビットマップを指定します。Matrix クラスで定義されるオプションの変換マトリックスです。マトリックスを使用して拡大 / 縮小できます。または、線スタイルに適用する前にビットマップを操作します。線の描画で使用するグラデーションを指定します。0 未満の値の場合は、デフォルトで 0 が適用されます。1 より大きい値の場合は、デフォルトで 1 が適用されます。この値は、100% でサンプリングされる色の幅の割合をパーセントで定義します。値 0 はグラデーションボックスの左の位置を表し、255 はグラデーションボックスの右の位置を表します。この値は、グラデーションボックス内の位置を表すもので、最終グラデーションの座標空間を表すものではありません。最終グラデーションは、グラデーションボックスより広くなったり狭くなったりする場合があります。colors パラメータの値ごとに、値を指定してください。例えば、青と緑の 2 色を含む線状グラデーションの場合、次の図は、ratios 配列のさまざまな値に基づいて配置される色を示します。Matrix クラスで定義される変換マトリックスです。REFLECT に設定されたシンプルな線状グラデーションがあるとします。それぞれの補間方法で、外観に次のような影響があります。0 は焦点が中央にあること、1 は焦点がグラデーション円のいずれかの境界にあること、-1 は焦点がグラデーション円のもう一方の境界にあることを示します。75 に設定したグラデーションを示しています。次の例では、赤から緑、青へのグラデーションの境界線を使用する矩形と円を描画します。線の太さは 5 ピクセルに設定されます。グラデーションは線状に設定されます。グラデーションの色は赤、緑、および青に設定されます。グラデーションの分布は均等です。矩形の幅はグラデーションのすべての領域を包含します。一方、円は領域の中央から 50% を包含します。線の描画で、線として使用するビットマップを指定します。Matrix クラスで定義されるオプションの変換マトリックスです。マトリックスを使用して拡大 / 縮小できます。または、線スタイルに適用する前にビットマップを操作します。パスの描画中に lineStyle() メソッドを呼び出し、パス内の線のセグメントごとに異なるスタイルを指定できます。0 未満の値を指定した場合は、デフォルトで 0 が適用されます。0 は極細線です。255 を超える値を指定した場合は、デフォルトで 255 が適用されます。
0) — 線の色のアルファ値を示す数値
値を指定しない場合は、デフォルトで 1 (ソリッド) が適用されます。0 未満の値を指定した場合、デフォルトで 0 が適用されます。1 より大きい値を指定した場合、デフォルトで 1 が適用されます。この値は、曲線のアンカーの位置と線のサイズ自身の両方に影響を与えます。値を指定しない場合、線でピクセルのヒンティングが使用されません。左側の円は垂直方向にのみ拡大または縮小され、右側の円は垂直と水平の両方向に拡大または縮小されたものです。左側の円は水平方向にのみ拡大または縮小され、右側の円は垂直と水平の両方向に拡大または縮小されたものです。有効な値は次のとおりです。この値を指定しない場合は、丸いキャップが使用されます。有効な値は次のとおりです。miterLimit の値により、線の接合点を越えてマイターを延長できる長さが決定します。マイターを延長できる長さは、この値と線の thickness が乗算されたものです。例として、次のような角のある線を考えます。重ね合わされた黒の基準線は、接合点を示しています。miterLimit のそれぞれの値には、マイターが切り取られる独自の最大角度があります。次の表に、いくつかの例を示します。角度が以下より小さい場合は切り取られる。現在の描画位置から (x, y) まで、現在の線のスタイルを使用して線を描画します。描画先の表示オブジェクトに Flash の描画ツールで作成したコンテンツが含まれている場合、lineTo() メソッドへの呼び出しの結果はこのコンテンツの下に描画されます。いずれかのパラメータを省略すると、このメソッドは失敗し、現在の描画位置は変更されません。
x:Number — 親表示オブジェクトの基準点からの相対的な水平座標を示す数値 (ピクセル単位)
y:Number — 親表示オブジェクトの基準点からの相対的な垂直座標を示す数値 (ピクセル単位)
線の太さが 10 ピクセル、色が金色で不透明、線の先端のキャップがなし (すべての線が結合されるため) に設定され、線の継ぎ目はマイター限度が 10、尖った鋭角の MITER に設定されます。いずれかのパラメータを省略すると、このメソッドは失敗し、現在の描画位置は変更されません。
x:Number — 親表示オブジェクトの基準点からの相対的な水平座標を示す数値 (ピクセル単位)
y:Number — 親表示オブジェクトの基準点からの相対的な垂直座標を示す数値 (ピクセル単位)
また、拡大 / 縮小しないよう設定されます。透明度が 25% の赤に色が設定されます。ただし、Shape にベクター描画オブジェクトを配置しないと、管理、移動、または変更できる方法が制限されます。
例 例の使用法
これを行うには、以下の手順を実行します。後で各シェイプのサイズを決定する際に使用する size プロパティを宣言します。背景色をオレンジ色、境界線色を濃い灰色、境界線のサイズを 0 ピクセル、角丸の半径を 9 ピクセル、ステージの端と他のオブジェクトの間のスペースを 5 ピクセルに、それぞれ設定するプロパティを宣言します。ステージの一番上に配置された各シェイプを、x = 5、y = 5 から、シェイプ間のスペースを 5 ピクセルにして再描画します。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
ビットマップ塗りを定義します。ビットマップは、スムージング、繰り返し、またはタイリング表示して領域を塗りつぶしたり、変形マトリックスを使用して操作できます。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
透明または不透明なビットマップイメージです。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。ビットマップイメージを一定のパターンでタイル状に表示するかどうかを指定します。ビットマップイメージにスムージングアルゴリズムを適用するかどうかを指定します。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。
プロパティの詳細
透明または不透明なビットマップイメージです。例えば、次のマトリックスは、ビットマップを 45 度(π/4 ラジアン)回転します。ビットマップイメージを一定のパターンでタイル状に表示するかどうかを指定します。true の場合、ビットマップイメージが一定のパターンでタイル状に表示されます。false の場合、ビットマップイメージは繰り返されません。ビットマップ境界からはみ出す塗り領域には、ビットマップのエッジの一番外側のピクセルが使用されます。例えば、次のビットマップ(20 x 20 ピクセルのチェッカーボードのパターン)を考えます。次の例のように repeat が true に設定されている場合、ビットマップの塗りでビットマップが繰り返されます。repeat が false に設定されている場合、エッジのピクセルがビットマップの外側の塗り領域に使用されます。ビットマップイメージにスムージングアルゴリズムを適用するかどうかを指定します。false の場合、拡大ビットマップイメージは最近傍アルゴリズムを使用してレンダリングされ、ピクセル化されたように見えます。true の場合、拡大ビットマップイメージは双線形アルゴリズムを使用してレンダリングされます。通常は、最近傍アルゴリズムを使用したレンダリングの方が高速です。
コンストラクタの詳細
Matrix クラスのマトリックスオブジェクトです。これを使用してビットマップ上に変形を定義します。false の場合、ビットマップイメージは繰り返されません。ビットマップからはみ出す塗り領域にはビットマップのエッジが使用されます。true の場合、双線形アルゴリズムを使用して拡大されたビットマップイメージがレンダリングされます。通常は、最近傍アルゴリズムを使用したレンダリングの方が高速です。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
描画コマンドおよびそれらのコマンドの座標パラメータのコレクションです。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
パスを表す整数としての描画コマンドの Vector です。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。
プロパティの詳細
パスを表す整数としての描画コマンドの Vector です。
コンストラクタの詳細
メソッドの詳細
controlX:Number — 親表示オブジェクトの基準点からの相対的なコントロールポイントの水平座標を指定する数値
controlY:Number — 親表示オブジェクトの基準点からの相対的なコントロールポイントの垂直座標を指定する数値
anchorX:Number — 親表示オブジェクトの基準点からの相対的な次のアンカーポイントの水平座標を指定する数値
anchorY:Number — 親表示オブジェクトの基準点からの相対的な次のアンカーポイントの垂直座標を指定する数値
このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
ロードを開始するには load() メソッドを使用します。ロードされた表示オブジェクトは Loader オブジェクトの子として追加されます。テキストまたはバイナリデータをロードするには URLLoader クラスを使用します。Loader クラスは、継承する次のメソッドをオーバーライドします。これは、Loader オブジェクトが持つことができるのは 1 つの子表示オブジェクト、つまりロードするオブジェクトに限られているためです。次のメソッドを呼び出すと例外がスローされます。0 では使用されません。コンテンツは、アクセスできるソースであればどのソースからでもロードできます。呼び出し元 SWF ファイルがネットワーク上のサンドボックスにあり、ロードするファイルがローカルにある場合はロードできません。
ただし、ロードされたコンテンツファイルで、System
0 で作成されたもの) でそれをクロススクリプトすることはできません。ロードされたコンテンツがイメージの場合、セキュリティサンドボックスの外にある SWF ファイルからそのデータにアクセスすることはできません。ただし、その SWF ファイルのドメインがイメージの元のドメインにある URL ポリシーファイルに含まれていた場合は可能です。ローカルファイルシステムのサンドボックスにあるムービークリップでは、ネットワーク接続したローカルのサンドボックスにあるムービークリップをスクリプト処理できません。その逆も同様です。一般的な予約ポートへは接続できません。0 のプログラミング』のセキュリティに関する章を参照してください。ただし、AIR では、アプリケーションセキュリティサンドボックス内のコンテンツ(AIR アプリケーションと共にインストールされたコンテンツ)は、これらのセキュリティ制限による制限を受けません。詳しくは、次のトピックを参照してください。信頼されていないソース(Loader オブジェクトのルート SWF ファイルのドメイン以外のドメインなど)から SWF ファイルを読み込む場合は、次のコードに示すように、Loader オブジェクトに対してマスクを定義して、読み込まれたコンテンツ(Loader オブジェクトの子)がそのマスクの外部にあるステージの一部分に描画されないようにすることができます。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
この表示オブジェクトの現在のアクセシビリティオプションです。指定されたオブジェクトのアルファ透明度値を示します。[書き込み専用] 前景と背景のブレンドに使用するシェーダを設定します。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[読み取り専用] ロードされているオブジェクトに対応する LoaderInfo オブジェクトを返します。このオブジェクトに関連付けられたコンテキストメニューを指定します。表示オブジェクトに現在関連付けられている各フィルタオブジェクトが格納されているインデックス付きの配列です。このオブジェクトがフォーカス矩形を表示するかどうかを指定します。
表示オブジェクトの高さを示します (ピクセル単位)
[読み取り専用] この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。オブジェクトの子に対してマウスが有効かどうかを調べます。このオブジェクトがマウスメッセージを受け取るかどうかを指定します。
[読み取り専用] マウス位置の x 座標を示します(ピクセル単位)
[読み取り専用] マウス位置の y 座標を示します(ピクセル単位)
[読み取り専用] このオブジェクトの子の数を返します。表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。[読み取り専用] 読み込まれた SWF ファイル内の表示オブジェクトの場合、root プロパティはその SWF ファイルが表す表示リストのツリー構造部分の一番上にある表示オブジェクトとなります。現在有効な拡大 / 縮小グリッドです。基準点から適用されるオブジェクトの水平スケール(パーセンテージ)を示します。オブジェクトの基準点から適用されるオブジェクトの垂直スケール(percentage)を示します。オブジェクトの基準点から適用されるオブジェクトの奥行きスケール(パーセンテージ)を示します。表示オブジェクトのスクロール矩形の境界です。[読み取り専用] 表示オブジェクトのステージです。オブジェクトの子に対してタブが有効かどうかを調べます。このオブジェクトがタブ順序に含まれるかどうかを指定します。SWF ファイル内のオブジェクトのタブ順序を指定します。表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。表示オブジェクトが可視かどうかを示します。
表示オブジェクトの幅を示します (ピクセル単位)
継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。イベントをイベントフローに送出します。指定のインデックス位置にある子表示オブジェクトインスタンスを返します。指定された名前に一致する子表示オブジェクトを返します。point オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。ステージ(グローバル)座標の 2 次元のポイントを 3 次元の表示オブジェクトの(ローカル)座標に変換します。EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。表示オブジェクトの境界ボックスを評価して、obj 表示オブジェクトの境界ボックスと重複または交差するかどうかを調べます。表示オブジェクトを評価して、x および y パラメータで指定されたポイントと重複または交差するかどうかを調べます。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。ByteArray オブジェクトに保管されているバイナリデータから読み込みます。3 次元の表示オブジェクトの(ローカル)座標の 3 次元のポイントをステージ(グローバル)座標の 2 次元のポイントに変換します。point オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。指定されたプロパティが存在し、列挙できるかどうかを示します。表示オブジェクトコンテナの既存の子の位置を変更します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定された 2 つの子オブジェクトの z 順序(重ね順)を入れ替えます。子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。指定されたオブジェクトのストリング表現を返します。子 SWF ファイルの内容のアンロードを試み、ロードされた SWF ファイルのコマンドの実行を中止します。指定されたオブジェクトのプリミティブな値を返します。指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。継承されるイベントを隠す。
継承されるイベントを表示
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。表示オブジェクトが表示リストに追加されたときに送出されます。表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの追加により、ステージ上の表示リストに追加されたときに送出されます。ユーザーがコンテキストメニューから「削除」を選択した場合に送信されます。ユーザージェスチャが AIR アプリケーションでこのインタラクティブオブジェクトに関連付けられたコンテキストメニューをトリガすると、送出されます。ユーザーがコピー操作のためにプラットフォーム固有のアクセラレータキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「コピー」を選択した場合に送信されます。ユーザーがカット操作のためにプラットフォーム固有のアクセラレータキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「カット」を選択した場合に送信されます。[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。[ブロードキャストイベント] 再生ヘッドが新しいフレームに入るときに送出されます。[ブロードキャストイベント] 再生ヘッドが現在のフレームを終了するときに送出されます。表示オブジェクトがフォーカスを取得した後に送出されます。表示オブジェクトがフォーカスを失った後に送出されます。[ブロードキャストイベント] フレーム表示オブジェクトのコンストラクタが実行した後で、かつフレームスクリプトが実行される前に送出されます。ユーザーがキーを押したときに送出されます。ユーザーがキーボード操作によってフォーカスを変更しようとすると送出されます。ユーザーがキーを離したときに送出されます。ユーザーがポインティングデバイスでフォーカスを変更しようとすると送出されます。
ドラッグされたオブジェクトがターゲットにドロップされ、そのドロップ操作が DragManager
ユーザーがペースト操作のためにプラットフォーム固有のアクセラレータキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「ペースト」を選択した場合に送信されます。表示オブジェクトが表示リストから削除されようとしているときに送出されます。表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの削除により、表示リストから削除されようとしているときに送出されます。[ブロードキャストイベント] 表示リストが更新およびレンダリングされようとしているときに送出されます。ユーザーがすべて選択操作のためにプラットフォーム固有のアクセラレータキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「すべて選択」を選択した場合に送信されます。オブジェクトの tabIndex プロパティの値が変更されたときに送出されます。
プロパティの詳細
ロードされているオブジェクトに対応する LoaderInfo オブジェクトを返します。LoaderInfo オブジェクトは、ロードの進行状況に関する情報と、ロードされたファイルに関する統計を提供します。
コンストラクタの詳細
その後、Loader オブジェクトを表示リストに追加できます。アセットはロードされるとステージに表示されます。Loader インスタンスを "リスト外" で、つまり、表示リスト上の表示オブジェクトコンテナに追加しなくても使用できます。このモードの場合、Loader インスタンスを使用して、アプリケーションの追加モジュールを含む SWF ファイルをロードすることができます。その時点で、モジュール SWF ファイル内のコードを実行し、モジュールを初期化して、開始できます。リスト外モードでは、Loader インスタンスを使用して、コンポーネントまたはメディアアセットを含む SWF ファイルをロードすることもできます。この場合も、LoaderInfo オブジェクトのイベント通知を使用して、コンポーネントのロードが完了したことを検出できます。その時点で、アプリケーションは SWF ファイルのライブラリ内のコンポーネントとメディアアセットの使用を開始できます。0 クラスをインスタンス化することによって行います。open イベントは、ロードが開始したときに送出されます。progress イベントは、ファイルがロードされている間、継続的に発生します。complete イベントは、ファイルのダウンロードが完了したときに送出されます。ただし、この時点では、ロードされたムービークリップのメソッドとプロパティはまだ使用できません。init イベントは、ロードされた SWF ファイルのプロパティおよびメソッドにアクセスできるようになると、送出されます。そのため、ロードされた SWF ファイルに対して各種の操作を開始できます。ほとんどの場合、init ハンドラを使用します。
メソッドの詳細
アニメーション GIF ファイルを読み込むと、先頭のフレームのみ表示されます。Loader オブジェクトには子を 1 つだけしか含めることができないため、後続の load() 要求を発行すると直前の要求(保留中であれば)を終了し、新たに読み込みを開始します。Loader オブジェクトに読み込んだ SWF ファイルまたはイメージは、その Loader オブジェクトの親の表示オブジェクトの位置、回転、および拡大 / 縮小の各プロパティを継承します。このメソッドを使用して読み込まれたムービーまたはイメージを削除したり、進行中の読み込み処理をキャンセルするには、unload() メソッドを使用します。POST 処理は、マウスのクリックやキーの押下などのユーザーが開始したアクションに応答して実行する必要があります。POST 処理がクロスドメインである (POST ターゲットが、POST 要求を送信中の SWF ファイルと同じサーバー上にない) 場合は、クロスドメインアクセスを許可する URL ポリシーファイルをターゲットサーバーが提供する必要があります。シンタックスが有効でない場合は、アップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。セキュリティ情報について詳しくは、以下を参照してください。相対パスの場合は、メイン SWF ファイルを基準にする必要があります。ファイル名には、ドライブ指定を含めることはできません。
オブジェクトのロード時にポリシーファイルの存在を確認するかどうか
context パラメータが指定されていない場合または null のオブジェクトを参照している場合、読み込まれるコンテンツはそれ自身のセキュリティドメインに置かれたままになります。つまり、ロードされたメディアは、通常のセキュリティサンドボックスまたは独自のサンドボックスのいずれかにしか配置できません。後者の場合は、ポリシーファイルが必要です。また、ローカルでないメディアのローカルサンドボックスへのインポート、およびローカルメディアの通常のサンドボックス以外の場所への配置は許可されません。0 のプログラミング』のセキュリティに関する章の「ネットワーク API の制限」を参照してください。ByteArray オブジェクトに保管されているバイナリデータからロードします。context パラメータが指定されていない場合または null のオブジェクトを参照している場合、コンテンツは現在のセキュリティドメインにロードされます。具体的には、ロードする側の SWF ファイルが、コードにリモート SWF を組み込むことによってリモート SWF を明示的に信頼している場合は、それ自身のセキュリティドメインに直接リモート SWF を読み込むことができます。0 のプログラミング』のセキュリティに関する章の「ネットワーク API の制限」を参照してください。他のオブジェクトが参照している可能性があるので、子は必ずしも破棄されるとは限りません。ただし、Loader オブジェクトの子ではなくなります。そうしなかった場合は、子 SWF ファイルがアンロードされた後も、子 SWF ファイルのオーディオの再生が続く場合があります。子 SWF ファイルのストリームを閉じるには、unload イベントを受け取る子にイベントリスナーを追加します。次のコードは、このような処理を行う例を示します。子 SWF ファイルのアンロードを試み、ロードされた SWF ファイルのコマンドの実行を中止します。この結果、子 SWF ファイルおよび子 SWF ファイルの表示リストで以下が行われます。サウンドが停止されます。Stage イベントリスナーが削除されます。タイマーが停止されます。ムービークリップが停止されます。多数のオブジェクトを非同期でアンロードする場合は、gc パラメータを false に設定するとアプリケーションのパフォーマンスが向上する可能性があります。
例 例の使用法
これを行うには、以下の手順を実行します。url プロパティを作成します。これはイメージファイルの場所と名前です。これにより、イメージが表示リストにロードされます。マウスをクリックすると、ロードされたイメージはアンロードされます。一般的には、SWF ファイルをロードするとき、init イベントの方が便利です。ioErrorHandler() メソッドは、イメージファイルを使用できないか、イメージファイルにアクセスできない場合に実行されます。progressHandler() メソッドは、イメージファイルのロードが開始したときに実行され、イメージのロードが完了したときに再び実行されます。次の要件に注意してください。gif という名前のファイルがコンパイル済み SWF ファイルと同じディレクトリに配置されている必要があります。メイン SWF ファイルのサイズ内に収まる領域を持つイメージを使用します。この例では、LoaderInfo オブジェクトで使用可能なすべてのイベントを利用しますが、ほとんどの場合、必要になるのは 1 つのサブセットのみです。特に、イメージファイルをロードするだけの場合は、ローカルイメージをロードするときの complete イベント (および必要に応じて ioError イベント) で十分です。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
定数は、ウィンドウのそれぞれの端と隅に名前を付けるために定義されます。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
オブジェクトに指定されたプロパティが定義されているかどうかを示します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。指定されたプロパティが存在し、列挙できるかどうかを示します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。[静的] ウィンドウの下端です。[静的] ウィンドウの左下隅です。[静的] ウィンドウの右下隅です。[静的] ウィンドウの左端です。[静的] どの端や隅を基準にしてフォームをサイズ変更するか指定しません。デフォルトの動作が実行されます。[静的] ウィンドウの右端です。[静的] ウィンドウの上端です。[静的] ウィンドウの左上隅です。[静的] ウィンドウの右上隅です。ウィンドウの下端です。ウィンドウの左下隅です。ウィンドウの右下隅です。ウィンドウの左端です。どの端や隅を基準にしてフォームをサイズ変更するか指定しません。デフォルトの動作が実行されます。ウィンドウの右端です。ウィンドウの上端です。ウィンドウの左上隅です。ウィンドウの右上隅です。このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。
コメントの追加
Stage クラスはメイン描画領域を表します。Stage オブジェクトはグローバルにアクセスすることはできません。これらのプロパティおよびメソッドの多くは、Stage オブジェクトに適用できないか、Stage オブジェクトで呼び出す際にセキュリティチェックを必要とします。セキュリティチェックを必要とするプロパティとメソッドについては、Stage クラスの一部として記述されています。加えて、以下に示す継承プロパティは Stage オブジェクトに適用できません。これらのプロパティは読み取ることはできますが、設定することはできないため、常にデフォルト値となります。このため、任意の DisplayObject インスタンスにイベントリスナーを追加して、これらのイベントを監視できます。ブロードキャストイベントの詳細については、DisplayObject クラスに関する説明を参照してください。継承されるパブリックプロパティを隠す。
継承されるパブリックプロパティを表示
この表示オブジェクトの現在のアクセシビリティオプションです。指定されたオブジェクトのアルファ透明度値を示します。[書き込み専用] 前景と背景のブレンドに使用するシェーダを設定します。指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。このオブジェクトに関連付けられたコンテキストメニューを指定します。表示オブジェクトに現在関連付けられている各フィルタオブジェクトが格納されているインデックス付きの配列です。キーボードフォーカスを持つインタラクティブオブジェクトです。フォーカスが設定されていない場合、またはフォーカスが設定されたオブジェクトが呼び出し元オブジェクトからアクセスできないセキュリティ Sandbox に属している場合は null となります。このオブジェクトがフォーカス矩形を表示するかどうかを指定します。ステージのフレームレートを取得または設定します。
[読み取り専用] フルスクリーンサイズに移行したときに使用されるモニタの高さを返します (直ちに移行する場合)
[読み取り専用] フルスクリーンサイズに移行したときに使用されるモニタの幅を返します (直ちに移行する場合)
[読み取り専用] この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。[override] オブジェクトの子に対してマウスが有効かどうかを調べます。このオブジェクトがマウスメッセージを受け取るかどうかを指定します。
[読み取り専用] マウス位置の x 座標を示します(ピクセル単位)
[読み取り専用] マウス位置の y 座標を示します(ピクセル単位)
表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。[読み取り専用] 読み込まれた SWF ファイル内の表示オブジェクトの場合、root プロパティはその SWF ファイルが表す表示リストのツリー構造部分の一番上にある表示オブジェクトとなります。現在有効な拡大 / 縮小グリッドです。基準点から適用されるオブジェクトの水平スケール(パーセンテージ)を示します。オブジェクトの基準点から適用されるオブジェクトの垂直スケール(percentage)を示します。オブジェクトの基準点から適用されるオブジェクトの奥行きスケール(パーセンテージ)を示します。表示オブジェクトのスクロール矩形の境界です。Flash Player のコンテキストメニューにデフォルトの項目を表示するかどうかを指定します。[読み取り専用] 表示オブジェクトのステージです。オブジェクトがフォーカスを持つ場合に強調表示された境界線を表示するかどうかを指定します。現在のステージの高さ (ピクセル数) です。ステージの現在の幅をピクセル単位で指定します。[override] オブジェクトの子に対してタブが有効かどうかを調べます。このオブジェクトがタブ順序に含まれるかどうかを指定します。SWF ファイル内のオブジェクトのタブ順序を指定します。表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。表示オブジェクトが可視かどうかを示します。継承されるパブリックメソッドを隠す。
継承されるパブリックメソッドを表示
キーボードフォーカスを objectToFocus で指定されたインタラクティブオブジェクトに設定します。指定のインデックス位置にある子表示オブジェクトインスタンスを返します。指定された名前に一致する子表示オブジェクトを返します。point オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。ステージ(グローバル)座標の 2 次元のポイントを 3 次元の表示オブジェクトの(ローカル)座標に変換します。オブジェクトに指定されたプロパティが定義されているかどうかを示します。表示オブジェクトの境界ボックスを評価して、obj 表示オブジェクトの境界ボックスと重複または交差するかどうかを調べます。表示オブジェクトを評価して、x および y パラメータで指定されたポイントと重複または交差するかどうかを調べます。例えば、再生ヘッドを新しいフレームに進める場合などです。focus プロパティがセキュリティ上の理由で null を返すかどうかを決定します。Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。3 次元の表示オブジェクトの(ローカル)座標の 3 次元のポイントをステージ(グローバル)座標の 2 次元のポイントに変換します。point オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。指定されたプロパティが存在し、列挙できるかどうかを示します。[override] 表示オブジェクトコンテナの既存の子の位置を変更します。ループ処理に対するダイナミックプロパティの可用性を設定します。指定された 2 つの子オブジェクトの z 順序(重ね順)を入れ替えます。指定されたオブジェクトのストリング表現を返します。指定されたオブジェクトのプリミティブな値を返します。継承されるイベントを隠す。
継承されるイベントを表示
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。表示オブジェクトが表示リストに追加されたときに送出されます。表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの追加により、ステージ上の表示リストに追加されたときに送出されます。ユーザーがコンテキストメニューから「削除」を選択した場合に送信されます。ユーザージェスチャが AIR アプリケーションでこのインタラクティブオブジェクトに関連付けられたコンテキストメニューをトリガすると、送出されます。ユーザーがコピー操作のためにプラットフォーム固有のアクセラレータキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「コピー」を選択した場合に送信されます。ユーザーがカット操作のためにプラットフォーム固有のアクセラレータキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「カット」を選択した場合に送信されます。[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。[ブロードキャストイベント] 再生ヘッドが新しいフレームに入るときに送出されます。[ブロードキャストイベント] 再生ヘッドが現在のフレームを終了するときに送出されます。表示オブジェクトがフォーカスを取得した後に送出されます。表示オブジェクトがフォーカスを失った後に送出されます。[ブロードキャストイベント] フレーム表示オブジェクトのコンストラクタが実行した後で、かつフレームスクリプトが実行される前に送出されます。Stage オブジェクトが、フルスクリーンモードに設定または設定解除されると送出されます。ユーザーがキーを押したときに送出されます。ユーザーがキーボード操作によってフォーカスを変更しようとすると送出されます。ユーザーがキーを離したときに送出されます。ユーザーがポインティングデバイスでフォーカスを変更しようとすると送出されます。マウスポインタがステージ領域から離れたときに、Stage オブジェクトによって送出されます。
ドラッグされたオブジェクトがターゲットにドロップされ、そのドロップ操作が DragManager
ユーザーがペースト操作のためにプラットフォーム固有のアクセラレータキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「ペースト」を選択した場合に送信されます。表示オブジェクトが表示リストから削除されようとしているときに送出されます。表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの削除により、表示リストから削除されようとしているときに送出されます。[ブロードキャストイベント] 表示リストが更新およびレンダリングされようとしているときに送出されます。ユーザーがすべて選択操作のためにプラットフォーム固有のアクセラレータキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「すべて選択」を選択した場合に送信されます。オブジェクトの tabIndex プロパティの値が変更されたときに送出されます。
プロパティの詳細
使用できる値は次のとおりです。
垂直方向の配置
align プロパティは、メイン SWF ファイルであるステージ所有者と同じセキュリティ Sandbox 内にあるオブジェクトでのみ使用できます。カラー補正は、メインモニタに有効な ICC カラープロファイルが割り当てられている場合にのみ機能します。このカラープロファイルは、デバイスの特別なカラー属性を指定します。
現在のシステムでカラー補正が使用できるかどうかとデフォルトの状態を確認するには、Stage
カラー補正を利用できる場合、ステージのすべてのカラーは、最も標準的なカラー空間である RGB カラー空間にあると見なされます。カラー補正中、入力デバイスのソースプロファイルは考慮されません。入力カラー補正は適用されません。ステージ出力のみがメインモニタの ICC カラープロファイルにマップされます。カラー管理をアクティブにする一般的な利点としては、予測可能な一貫性のあるカラー、変換性能の向上、正確なプルーフィング、より効率的なクロスメディア出力などがあります。ただし、色域がデバイスごとに異なり、元のイメージとも異なるため、カラー管理では完全な変換はできない点にご注意ください。また、カラー管理では、カスタムプロファイルも編集済みプロファイルも必要ありません。カラープロファイルは、ブラウザ、オペレーティングシステム(OS)、OS 拡張、出力デバイス、アプリケーションサポートに依存します。このため、SWF ムービーはすべて暗黙の sRGB プロファイルを持つドキュメントと見なされます。Flash Player では、モニター間の補正のみを行い、カメラやスキャナなどの入力デバイス間の補正は行いません。Flash Player が実行されているオペレーティングシステムがカラー補正をサポートしているかどうか、および Flash Player がメイン (主) モニタのカラープロファイルを解読できるかどうかを示します。また、このプロパティはホストシステム (通常はブラウザ) のカラー補正のデフォルト状態を返します。現在、戻り値は次のとおりです。使用できる値は次のとおりです。HTML ページでは、スクリプトを使用して SWF 埋め込みタグを生成することもできます。フルスクリーンモードは、マウスクリックまたはキー操作に対応して開始されます。入力可能なキーには、フルスクリーンモードを終了するキーボードショーカットや、矢印キー、スペースキー、Shift キー、Tab キーなどの非出力キーがあります。フルスクリーンモードは、次のキーボードショートカットで終了します。フルスクリーンモードに入ると、ムービーの上に Flash Player ダイアログボックスが表示されます。このダイアログボックスには、現在フルスクリーンモードであり、Esc キーを押すとフルスクリーンモードを終了できるというメッセージが表示されます。0 以降からは、ウィンドウモードの場合と同じようにウィンドウレスモードでフルスクリーンモードが動作するようになりました。AIR では、キーボード入力を許可するインタラクティブフルスクリーンモードがサポートされています。フルスクリーンモードで実行される AIR コンテンツの場合、システムのスクリーンセーバーと節電オプションは、ビデオコンテンツが再生中のときとビデオが停止するかフルスクリーンモードが終了するまで無効になっています。この場合のステージ所有者とはメイン SWF ファイルです。次の例では、displayState プロパティを変更して、フルスクリーンにする方法のインタラクティブなデモンストレーションを作成しています。メモ : フルスクリーンは、ユーザーがキーをクリックまたは押した場合など、特定の状況においてのみ、セキュリティ上の制限のためにトリガされます。キーボードフォーカスを持つインタラクティブオブジェクトです。フォーカスが設定されていない場合、またはフォーカスが設定されたオブジェクトが呼び出し元オブジェクトからアクセスできないセキュリティ Sandbox に属している場合は null となります。Error — ターゲットにフォーカスを設定できない場合にエラーがスローされます。ステージのフレームレートを取得または設定します。フレームレートの定義は、1 秒あたりのフレーム数です。デフォルトでは、フレームレートは最初にロードされた SWF ファイルのものに設定されます。
フレームレートの有効範囲は、1 秒あたり 0
メモ : ターゲットプラットフォームのフレーム設定が対応していないため、または Flash Player が表示デバイスの垂直帰線期間との同期が取れていないため、アプリケーションで高いフレームレートを設定できない場合があります。CPU 使用率が高くなることが予想される場合、ターゲットプラットフォームの最大フレームレートを低くすることもできます。この場合のステージ所有者とはメイン SWF ファイルです。
フルスクリーンサイズに移行したときに使用されるモニタの高さを返します (直ちに移行する場合)
ユーザーが複数のモニタを持っている場合、使用されるモニタは、そのときに最も多くのステージが表示されているモニタです。メモ : 値を取得してから、フルスクリーンサイズに移行するまでの間に、あるモニタから別のモニタにブラウザを移動する機会がある場合、値が不正になる可能性があります。
これはモニタのピクセルの高さであり、Stage
NO_SCALE に設定された場合には、ステージの高さと同じになります。この例では、ステージのサイズの緑の矩形を作成し、その上にボタンとしてアクティブ化する赤い四角形を配置します。