| 関数 | 定義 | ||
|---|---|---|---|
| clearInterval(id:uint):void
指定した
setInterval() 呼び出しをキャンセルします。 | flash.utils | ||
| clearTimeout(id:uint):void
指定した
setTimeout() 呼び出しをキャンセルします。 | flash.utils | ||
| describeType(value:*):XML
メソッドのパラメータとして命名された ActionScript オブジェクトを記述する XML オブジェクトを作成します。
| flash.utils | ||
| escapeMultiByte(value:String):String
System.useCodePage の値に従って、UTF-8 またはシステムコードページのいずれかにエンコードされた入力ストリングをエスケープしたコピーを返します。
| flash.utils | ||
getDefinitionByName(name:String):Object
name パラメータで指定したクラスのクラスオブジェクトへの参照を返します。 | flash.utils | ||
| getQualifiedClassName(value:*):String
オブジェクトの完全修飾クラス名を返します。
| flash.utils | ||
getQualifiedSuperclassName(value:*):String
value パラメータで指定したオブジェクトの基本クラスの完全修飾クラス名を返します。 | flash.utils | ||
| getTimer():int
Flash Player が初期化されてからの経過時間をミリ秒単位で返します。この時間は、基準時刻の計算に使用されます。
| flash.utils | ||
| setInterval(closure:Function, delay:Number, ... arguments):uint
ミリ秒単位で指定した間隔ごとに関数を実行します。
| flash.utils | ||
| setTimeout(closure:Function, delay:Number, ... arguments):uint
ミリ秒単位で指定した遅延時間の経過後に、指定した関数を実行します。
| flash.utils | ||
| unescapeMultiByte(value:String):String
System.useCodePage の値に従って、UTF-8 またはシステムコードページのいずれかからデコードされた入力ストリングをアンエスケープしたコピーを返します。
| flash.utils | ||
| clearInterval | () | 関数 |
public function clearInterval(id:uint):void
指定した setInterval() 呼び出しをキャンセルします。
id:uint — setInterval() 呼び出しの ID です。次のように変数を設定します。
|
関連項目
| clearTimeout | () | 関数 |
public function clearTimeout(id:uint):void
指定した setTimeout() 呼び出しをキャンセルします。
id:uint — setTimeout() 呼び出しの ID です。次のように変数を設定します。
|
関連項目
| describeType | () | 関数 |
public function describeType(value:*):XMLメソッドのパラメータとして命名された ActionScript オブジェクトを記述する XML オブジェクトを作成します。このメソッドには、ActionScript 言語のプログラミングコンセプト反映が実装されています。
value パラメータが特定の型のインスタンスである場合、返される XML オブジェクトにはその型のすべてのインスタンスプロパティが含まれますが、静的プロパティは含まれません。XML オブジェクトを解析する際に <type> タグの isStatic 属性の値を調べることによってこの状態を確認できます。value パラメータが特定の型のインスタンスである場合、この属性は false になります。
特定の型の静的プロパティを取得するには、型自体を value パラメータに渡します。返される XML オブジェクトには、そのタイプの静的プロパティのみでなく、すべてのインスタンスプロパティも含まれています。インスタンスプロパティは、<factory> というタグ内にネストされ、静的プロパティと区別されます。この場合、<type> タグの isStatic 属性は true です。
メモ: オブジェクトの継承階層間の移動のみが必要で、describeType() によって提供されるその他の情報は不要な場合には、代わりに、getQualifiedClassName() 関数および getQualifiedSuperclassName() 関数を使用します。
次の表は、describeType() によって生成される XML オブジェクトのタグおよび属性のいくつかについて説明したものです。
| タグ | 属性 | 説明 |
|---|---|---|
<type> | XML オブジェクトのルートタグです。 | |
| name | ActionScript オブジェクトのデータ型の名前です。 | |
| base | ActionScript オブジェクトを定義しているクラスのすぐ上のスーパークラスです。ActionScript オブジェクトがクラスオブジェクトの場合、値は Class になります。 | |
| isDynamic | ActionScript オブジェクトを定義しているクラスが dynamic の場合は true、それ以外の場合は false になります。ActionScript オブジェクトがクラスオブジェクトの場合、Class クラスは dynamic であるため、値は true になります。 | |
| isFinal | ActionScript オブジェクトを定義しているクラスが final の場合は true、それ以外の場合は false になります。 | |
| isStatic | ActionScript オブジェクトがクラスオブジェクトまたはコンストラクタ関数の場合は true、それ以外の場合は false になります。この属性が true の場合には factory タグ内にネストされていないすべてのタグが静的になるため、この属性には isStatic という名前が付けられています。 | |
<extendsClass> | ActionScript オブジェクトを定義しているクラスの各スーパークラスには、個別に extendsClass というタグがあります。 | |
| type | ActionScript オブジェクトを定義しているクラスを拡張したスーパークラスの名前です。 | |
<implementsInterface> | ActionScript オブジェクトを定義しているクラスまたはそのいずれかのスーパークラスによって実装されている各インターフェイスには、個別に implementsInterface というタグがあります。 | |
| type | ActionScript オブジェクトを定義しているクラスが実装しているインターフェイスの名前です。 | |
<accessor> | アクセサは、getter 関数と setter 関数によって定義されたプロパティです。 | |
| name | アクセサの名前です。 | |
| access | プロパティのアクセス権です。有効な値には、readonly、writeonly、readwrite などがあります。 | |
| type | プロパティのデータ型です。 | |
| declaredBy | 関連する getter 関数または setter 関数が含まれるクラスです。 | |
<constant> | 定数は、const ステートメントで定義されたプロパティです。 | |
| name | 定数の名前です。 | |
| type | 定数のデータ型です。 | |
<method> | メソッドは、クラス定義の一部として宣言された関数です。 | |
| name | メソッドの名前です。 | |
| declaredBy | メソッドの定義が含まれるクラスです。 | |
| returnType | メソッドの戻り値のデータ型です。 | |
<parameter> | メソッドによって定義される各パラメータには、個別に parameter というタグがあります。このタグは、常に <method> タグ内にネストされます。 | |
| index | メソッドのパラメータリストにパラメータが表示される順序に対応する番号です。最初のパラメータの値は 1 です。 | |
| type | パラメータのデータ型です。 | |
| optional | パラメータがオプションの場合には true、それ以外の場合は false になります。 | |
<variable> | 変数は、var ステートメントで定義されたプロパティです。 | |
| name | 変数の名前です。 | |
| type | 変数のデータ型です。 | |
<factory> | ActionScript オブジェクトがクラスオブジェクトまたはコンストラクタ関数の場合、インスタンスのすべてのプロパティおよびメソッドは、このタグ内にネストされます。<type> タグの isStatic 属性が true の場合、<factory> タグ内にネストされていないすべてのプロパティおよびメソッドは静的です。このタグは、ActionScript オブジェクトがクラスオブジェクトまたはコンストラクタ関数の場合にのみ表示されます。 |
value:* — 型の記述が必要なオブジェクトです。使用可能なすべての ActionScript 型、オブジェクトインスタンス、ユニットやクラスオブジェクトなどのプリミティブ型を含むこのメソッドに、任意の ActionScript 値を渡すことができます。
|
XML —
パラメータとして渡されたオブジェクトの詳細が含まれる XML オブジェクトです。オブジェクトに関する次の情報が記述されています。
メモ: |
関連項目
package {
import flash.display.Sprite;
import flash.utils.describeType;
public class DescribeTypeExample extends Sprite {
public function DescribeTypeExample() {
var child:Sprite = new Sprite();
var description:XML = describeType(child);
trace(description..accessor.@name.toXMLString());
}
}
}
| escapeMultiByte | () | 関数 |
public function escapeMultiByte(value:String):StringSystem.useCodePage の値に従って、UTF-8 またはシステムコードページのいずれかにエンコードされた入力ストリングをエスケープしたコピーを返します。System.useCodePage を使用すると、ローカルコードページでエンコードされた古いコンテンツに Player でアクセスできます。ただし、古いコードページを使用したシステムでしかアクセスできません。たとえば、Shift-JIS としてエンコードされた日本語データは、日本語のデフォルトコードページを使用した OS でしか正しくエスケープおよびアンエスケープできません。
パラメータvalue:String — エスケープするストリングです。
|
String —
入力ストリングをエスケープしたコピーです。System.useCodePage が true の場合、エスケープしたストリングはシステムコードページでエンコードされます。System.useCodePage が false の場合、エスケープしたストリングは UTF-8 でエンコードされます。たとえば、System.useCodePage が false の場合、入力ストリング "Crüe" は、すべてのシステムで "Cr%C3%BCe" としてエスケープされます。system.useCodePage が true で、ラテン語のコードページが使用されている場合、"Crüe" は "Cr%FCe" としてエスケープされます。'ü' 文字が含まれていないラテン語以外のコードページが使用されていると、"Cr?e" という結果になる場合があります。
|
| getDefinitionByName | () | 関数 |
public function getDefinitionByName(name:String):Object
name パラメータで指定したクラスのクラスオブジェクトへの参照を返します。
name:String — クラス名です。
|
Object —
name パラメータで指定したクラスのクラスオブジェクトへの参照を返します。
|
ReferenceError — 指定された名前の一般定義は存在しません。
|
GetDefinitionByNameExample クラスを使用して
ステージ上にオレンジ色の四角形を作成します。ここでは以下の手順を実行します。
ClassReference 変数は
Sprite に割り当てられます。instance という ClassReference のインスタンスがインスタンス化されます。instance が Sprite オブジェクトになるため、四角形は
Sprite で使用可能なメソッドを使用して描画および表示リストに追加されます。
package {
import flash.display.DisplayObject;
import flash.display.Sprite;
import flash.utils.getDefinitionByName;
public class GetDefinitionByNameExample extends Sprite {
private var bgColor:uint = 0xFFCC00;
private var size:uint = 80;
public function GetDefinitionByNameExample() {
var ClassReference:Class = getDefinitionByName("flash.display.Sprite") as Class;
var instance:Object = new ClassReference();
instance.graphics.beginFill(bgColor);
instance.graphics.drawRect(0, 0, size, size);
instance.graphics.endFill();
addChild(DisplayObject(instance));
}
}
}
| getQualifiedClassName | () | 関数 |
public function getQualifiedClassName(value:*):Stringオブジェクトの完全修飾クラス名を返します。
パラメータvalue:* — 完全修飾クラス名が必要なオブジェクトです。使用可能なすべての ActionScript 型、オブジェクトインスタンス、ユニットやクラスオブジェクトなどのプリミティブ型を含むこのメソッドに、任意の ActionScript 値を渡すことができます。
|
String —
完全修飾クラス名を含むストリングです。
|
関連項目
| getQualifiedSuperclassName | () | 関数 |
public function getQualifiedSuperclassName(value:*):String
value パラメータで指定したオブジェクトの基本クラスの完全修飾クラス名を返します。この関数では describeType() よりも迅速に基本クラス名を取得できますが、describeType() で提供されるすべての情報が提供されるわけではありません。
この関数を使用してクラス名を取得した後、getDefinitionByName() 関数を使用してクラス名をクラス参照に変換できます。
メモ: この関数はインスタンス階層に制限されています。一方、describeType() 関数は、value パラメータがデータ型の場合には、クラスオブジェクト階層を使用します。データ型に対して describeType() を呼び出すと、クラスオブジェクト階層に基づいてスーパークラスが返されます。スーパークラスでは、すべてのクラスオブジェクトが Class から継承されます。ただし、getQualifiedSuperclassName() 関数はクラスオブジェクト階層を無視し、より使い慣れたインスタンス階層に基づいてスーパークラスを返します。たとえば、getQualifiedSuperclassName(String) を呼び出すと、技術的には String クラスオブジェクトは Class から継承されますが、Object が返されます。つまり、型のインスタンスか型自体を使用するかどうかに関係なく、結果は同じです。
value:* — 任意の値です。
|
String —
存在しない場合は、完全修飾基本クラス名または null が返されます。
|
関連項目
| getTimer | () | 関数 |
public function getTimer():intFlash Player が初期化されてからの経過時間をミリ秒単位で返します。この時間は、基準時刻の計算に使用されます。カレンダー日付 (タイムスタンプ) については、Date オブジェクトを参照してください。
戻り値int —
Flash Player が初期化された時点からのミリ秒数です。Player で SWF ファイルを 1 つ再生を開始し、後で別の SWF ファイルをロードする場合は、戻り値は最初の SWF ファイルがロードされた時刻になります。
|
関連項目
GetTimerExample を使用して
Flash Player で再生を開始した時点からのミリ秒数を取得および出力します。
package {
import flash.utils.getTimer;
import flash.display.Sprite;
public class GetTimerExample extends Sprite {
public function GetTimerExample() {
var duration:uint = getTimer();
trace("duration: " + duration);
}
}
}
| setInterval | () | 関数 |
public function setInterval(closure:Function, delay:Number, ... arguments):uintミリ秒単位で指定した間隔ごとに関数を実行します。
このメソッドを使用することはできますが、コンパイラ警告が発生します。setInterval() メソッドを使用する代わりに、repeatCount パラメータを 0 (タイマーを無限に繰り返す設定) にして、指定した間隔で Timer オブジェクトを作成することを検討してください。
clearInterval() メソッドを使用して setInterval() の呼び出しをキャンセルする場合は、必ず次のように、後で setInterval() メソッドで参照される変数に setInterval() の呼び出しを割り当ててください。
var my_timedProcess:uint = setInterval(my_repeatedFunction, 1000);
// ...
clearInterval(my_timedProcess);
パラメータ
closure:Function — 実行する関数の名前です。引用符や括弧を使用しないでください。また、呼び出す関数にパラメータを指定しないでください。たとえば、functionName を使用して、functionName() や functionName(param) は使用しないでください。
|
|
delay:Number — ミリ秒単位の間隔です。
|
|
... arguments — closure 関数に渡す引数のオプションのリストです。
|
uint —
時間のプロセスに対する一意の数値識別子です。
|
関連項目
| setTimeout | () | 関数 |
public function setTimeout(closure:Function, delay:Number, ... arguments):uintミリ秒単位で指定した遅延時間の経過後に、指定した関数を実行します。
このメソッドを使用する代わりに、repeatCount パラメータを 1 (タイマーを 1 回のみ実行する設定) にして、指定した間隔で Timer オブジェクトを作成することを検討してください。
clearTimeout() メソッドを使用して setTimeout() の呼び出しをキャンセルする場合は、必ず次のように、後で setTimeout() メソッドで参照される変数に clearTimeout() の呼び出しを割り当ててください。
var my_timedProcess:uint = setTimeout(my_delayedFunction, 1000);
// ...
clearTimeout(my_timedProcess);
パラメータ
closure:Function — 実行する関数の名前です。引用符や括弧を使用しないでください。また、呼び出す関数にパラメータを指定しないでください。たとえば、functionName を使用して、functionName() や functionName(param) は使用しないでください。
|
|
delay:Number — 関数が実行されるまでの遅延時間 (ミリ秒単位) です。
|
|
... arguments — closure 関数に渡す引数のオプションのリストです。
|
uint —
時間のプロセスに対する一意の数値識別子です。
|
関連項目
| unescapeMultiByte | () | 関数 |
public function unescapeMultiByte(value:String):StringSystem.useCodePage の値に従って、UTF-8 またはシステムコードページのいずれかからデコードされた入力ストリングをアンエスケープしたコピーを返します。System.useCodePage を使用すると、ローカルコードページでエンコードされた古いコンテンツに Player でアクセスできます。ただし、古いコードページを使用したシステムでしかアクセスできません。たとえば、Shift-JIS としてエンコードされた日本語データは、日本語のデフォルトコードページを使用した OS でしか正しくエスケープおよびアンエスケープできません。
パラメータvalue:String — アンエスケープする、エスケープされたストリングです。
|
String —
入力ストリングをアンエスケープしたコピーです。System.useCodePage が true の場合、エスケープしたストリングはシステムコードページからデコードされます。System.useCodePage が false の場合、エスケープしたストリングは UTF-8 からデコードされます。たとえば、入力ストリングが "Cr%C3%BCe" で、System.useCodePage が false の場合、すべてのシステムでの結果は "Crüe" となります。System.useCodePage が true、入力ストリングが "Cr%FCe" で、ラテン語のコードページが使用されている場合も、結果は "Crüe" となります。System.useCodePage を true にして "Cr%C3%BCe" をアンエスケープすると、ラテン語のシステムで "Crüe" が発生するなど、さまざまなシステムでさまざまな不適切な結果が発生します。同様に、System.useCodePage を false にして "Cr%FCe" をアンエスケープすると、システムのコードページによって、"Cre" や"Cr?e" などのさまざまな結果が発生する可能性があります。
|
このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート
現在のページ: http://livedocs.adobe.com/flex/2_jp/langref/flash/utils/package.html