Flash Player またはブラウザでのステージの配置を指定する StageAlign クラスの値です。使用できる値は次のとおりです。

align プロパティは、メイン SWF ファイルであるステージ所有者と同じセキュリティ Sandbox 内にあるオブジェクトでのみ使用できます。これを回避するには、ステージ所有者が Security.allowDomain() メソッドまたは Security.alowInsecureDomain() メソッドを呼び出して呼び出し元オブジェクトのドメインに許可を与えるようにします。詳細については、『ActionScript 3.0 のプログラミング』の「Flash Player セキュリティ」の章を参照してください。

関連項目

キーボードフォーカスを持つインタラクティブオブジェクトです。フォーカスが設定されていない場合、またはフォーカスが設定されたオブジェクトが呼び出し元オブジェクトからアクセスできないセキュリティ Sandbox に属している場合は null となります。

ステージのフレームレートを取得または設定します。フレームレートの定義は、1 秒あたりのフレーム数です。デフォルトでは、フレームレートは最初にロードされた SWF ファイルのものに設定されます。フレームレートの有効範囲は、1 秒あたり0.01 から 1000 フレームです。

メモ : ターゲットプラットフォームのフレーム設定が対応していないため、または Flash Player が表示デバイスの垂直帰線期間との同期が取れていないため、Flash Player で高いフレームレートを設定できない場合があります。垂直帰線期間は、LCD デバイスでは通常 60 Hz です。CPU 使用率が高くなることが予想される場合、ターゲットプラットフォームの最大フレームレートを低くすることもできます。

表示オブジェクトの高さを示します (ピクセル単位)。

オブジェクトの子に対してマウスが有効かどうかを調べます。オブジェクトが使用可能なマウスの場合、マウスを使用して対話できます。デフォルト値は true です。

このプロパティは、SimpleButton クラスではなく、Sprite クラスのインスタンスを使用してボタンを作成するときに役立ちます。Sprite インスタンスを使用してボタンを作成する場合、他の Sprite インスタンスを追加するために addChild() メソッドを使用してボタンの修飾を選択できます。子として追加する Sprite インスタンスは、親インスタンスをターゲットオブジェクトとすることを想定するときに、マウスイベントのターゲットオブジェクトとなる場合があるため、マウスイベントについて予期しない動作を引き起こす可能性があります。親インスタンスが確実にマウスイベントのターゲットオブジェクトになるようにするには、親インスタンスの mouseChildren プロパティを false に設定します。

このプロパティを設定すると、イベントは送出されなくなります。インタラクティブな機能を作成するには、addEventListener() メソッドを使用する必要があります。

このオブジェクトの子の数を返します。

Flash Player が使用するレンダリング品質を指定する StageQuality クラスの値です。使用できる値は次のとおりです。

• StageQuality.LOW—低いレンダリング品質。グラフィックはアンチエイリアス処理されず、ビットマップはスムージングされません。
• StageQuality.MEDIUM—普通のレンダリング品質。グラフィックは 2 × 2 ピクセルグリッドを使用してアンチエイリアス処理されますが、ビットマップはスムージングされません。この設定は、テキストを含まないムービーに適しています。
• StageQuality.HIGH—高いレンダリング品質。グラフィックは 4 × 4 ピクセルグリッドを使用してアンチエイリアス処理されます。ビットマップは、ムービーが静的なものである場合は、スムージングされます。これは、Flash Player が使用するデフォルトのレンダリング品質設定です。
• StageQuality.BEST—非常に高いレンダリング品質。グラフィックは 4 × 4 ピクセルグリッドを使用してアンチエイリアス処理され、ビットマップは常にスムージングされます。

関連項目

使用する拡大・縮小モードを指定する StageScaleMode クラスの値です。使用できる値は次のとおりです。

• StageScaleMode.EXACT_FIT— 指定された領域内に Flash アプリケーション全体が、アプリケーションの元の縦横比を維持したまま歪まずに表示されます。ただし、アプリケーションの両側に境界枠が表示されることがあります。
• StageScaleMode.SHOW_ALL— 指定された領域にちょうど収まるように Flash アプリケーション全体が表示されますが、元の縦横比は保たれません。歪みが発生する場合もあります。
• StageScaleMode.NO_BORDER— 指定された領域いっぱいに Flash アプリケーション全体が歪まずに表示されます。ただし、アプリケーションの元の縦横比を保つために、ある程度トリミングされることがあります。
• StageScaleMode.NO_SCALE— Flash アプリケーションの全体のサイズが固定され、プレーヤーウィンドウのサイズが変更された場合でも、サイズが維持されます。プレーヤーウィンドウがコンテンツよりも小さい場合は、トリミングされることがあります。

関連項目

Flash Player のコンテキストメニューにデフォルトの項目を表示するかどうかを指定します。

showDefaultContextMenu プロパティを true に設定すると、すべてのコンテキストメニュー項目が表示されます。これがデフォルトです。showDefaultContextMenu プロパティを false に設定すると、メニュー項目として [設定] および [Adobe Flash Player について] だけが表示されます。

オブジェクトがフォーカスを持つ場合に強調表示された境界線を表示するかどうかを指定します。

現在のステージの高さ (ピクセル数) です。

Stage.scaleMode プロパティの値が StageScaleMode.NO_SCALE に設定される場合、stageHeight プロパティは Flash Player ウィンドウの高さを表します。Stage.scaleMode の値が StageScaleMode.NO_SCALE に設定されていない場合、stageHeight は SWF ファイルの高さとなります。

関連項目

ステージの現在の幅をピクセル単位で指定します。

scaleMode プロパティの値が StageScaleMode.NO_SCALE に設定される場合、stageWidth プロパティは Flash Player の幅を表します。これは、Flash Player ウィンドウのサイズを変更することに応じて stageWidth プロパティがさまざまに変化することを意味します。scaleMode プロパティの値が StageScaleMode.NO_SCALE 以外に設定されている場合、stageWidth プロパティはオーサリング時に [ドキュメントプロパティ] ダイアログボックスで設定した SWF ファイルの幅を表します。つまり、Flash Player のウィンドウのサイズを変更しても stageWidth プロパティの値は一定です。

関連項目

オブジェクトの子に対してタブが有効かどうかを調べます。オブジェクトの子に対してタブを有効または無効にします。

この DisplayObjectContainer インスタンスの TextSnapshot オブジェクトを返します。

表示オブジェクトの幅を示します (ピクセル単位)。

この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。子インスタンスは、この DisplayObjectContainer インスタンスにある他のすべての子の前 (上) に追加されます。特定のインデックス位置に子を追加する場合は、addChildAt() メソッドを使用します。

既に異なる表示オブジェクトコンテナを親に持つ子オブジェクトを追加する場合は、もう一方の表示オブジェクトコンテナの子リストからそのオブジェクトが削除されます。

関連項目

この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。子インスタンスは、指定されたインデックス位置に追加されます。インデックス 0 は、この DisplayObjectContainer オブジェクトの表示リストの背景または一番下を表します。

たとえば、a、b、d というラベルの 3 個の表示オブジェクトをインデックス位置 0、2、1 にそれぞれ配置すると、以下のようになります。

既に異なる表示オブジェクトコンテナを親に持つ子オブジェクトを追加する場合は、もう一方の表示オブジェクトコンテナの子リストからそのオブジェクトが削除されます。

関連項目

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

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

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

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

イベントリスナーが不要になった場合は、removeEventListener() を呼び出して、イベントリスナーを削除します。削除しない場合、メモリの問題が発生する可能性があります。ガベージコレクターは参照を有するオブジェクトを削除しないため、登録されているイベントリスナーに関係したオブジェクトはメモリから自動的に除去されません。

EventDispatcher インスタンスをコピーしても、それに関連付けられているイベントリスナーはコピーされません。新しく作成したノードにイベントリスナーが必要な場合は、ノードを作成した後に、リスナーを関連付ける必要があります。ただし、EventDispatcher インスタンスを移動した場合は、関連付けられているイベントリスナーも一緒に移動されます。

イベントがノードで処理されるときに、イベントリスナーがそのノードに登録中であれば、イベントリスナーは現在の段階ではトリガされません。ただし、バブリング段階など、イベントフローの後の段階でトリガすることができます。

イベントがノードで処理されているときにイベントリスナーがノードから削除された場合でも、イベントは現在のアクションによってトリガされます。削除された後は、その後の処理で再び登録されない限り、イベントリスナーは二度と呼び出されません。

関連項目

イベントをイベントフローに送出します。イベントターゲットは EventDispatcher オブジェクトです。これに対して dispatchEvent() メソッドが呼び出されます。

EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。これにより、EventDispatcher オブジェクトがイベントタイプの処理をイベントフロー階層のどこで変更したかを判断できます。特定のイベントタイプが実際にイベントリスナーをトリガするかどうかを判別するには、willTrigger() を使用します。

hasEventListener() と w