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() と willTrigger() の違いは、hasEventListener() では自身が属するオブジェクトのみ検証され、willTrigger() では type パラメータで指定されたイベントのイベントフロー全体が検証されることです。

hasEventListener() が LoaderInfo オブジェクトから呼び出された場合は、呼び出し側がアクセスできるリスナーのみ考慮されます。

invalidate() メソッドは、表示リストをレンダリングする必要のある次の機会に、表示オブジェクトに警告するよう Flash Player に通知します。たとえば、再生ヘッドを新しいフレームに進める場合などです。invalidate() メソッドを呼び出すと、表示リストが次にレンダリングされるときに、render イベントを受け取るように登録されている各表示オブジェクトに対して、Flash Player から render イベントが送出されます。Flash Player に render イベントを送出させたい場合には、その都度 invalidate() メソッドを呼び出す必要があります。

render イベントによって、実際に表示される直前に表示リストに変更を加えることができます。こうすることで、表示リストへの更新を最後まで遅らせることが可能です。この方法では、画面の更新を不必要に行わなくてよいため、パフォーマンスを向上させることができます。

render イベントは、stage.invalidate() メソッドを呼び出すコードと同じセキュリティドメイン内の表示オブジェクト、または Security.allowDomain() メソッドで許可が与えられているセキュリティドメインの表示オブジェクトに対してのみ、送出されます。

関連項目

Stage.focus プロパティがセキュリティ上の理由で null を返すかどうかを決定します。つまり、フォーカスを持つオブジェクトが、SWF ファイルがアクセスできないセキュリティ Sandbox に属している場合、isFocusInaccessible は true を返します。

DisplayObjectContainer の子リストの指定された index 位置から子 DisplayObject を削除します。削除された子の parent プロパティは null に設定されます。その子に対する参照が存在しない場合、そのオブジェクトはガベージコレクションによって収集されます。DisplayObjectContainer の子より上位にある表示オブジェクトのインデックス位置は 1 つ下がります。

ガベージコレクターとは、Flash Player が未使用のメモリースペースを再割り当てする処理のことです。変数またはオブジェクトがアクティブに参照されなくなり、任意の場所に保存されていない場合、ガベージコレクターによってメモリー内が探索され、それらに対する参照が存在しなければメモリースペースを占有している変数またはオブジェクトが一掃されます。

表示オブジェクトコンテナの既存の子の位置を変更します。これは、子オブジェクトのレイヤーに影響します。たとえば、a、b、c というラベルの 3 個の表示オブジェクトをインデックス位置 0、1、2 にそれぞれ配置すると、以下のようになります。

setChildIndex() メソッドを使用して、すでに使用されているインデックス位置を指定する場合、その位置を使用している子と、子リストでその子より上位にあるすべてのオブジェクトは、リスト上の位置が 1 つ上がります。たとえば、上記の例の表示オブジェクトコンテナの名前が container である場合、次に示すコードを呼び出すことによって、a および b というラベルが付けられた表示オブジェクトの位置を入れ替えることができます。

container.setChildIndex(container.getChildAt(1), 0);

このコードによって、次に示すようなオブジェクトの配置になります。

子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。表示オブジェクトコンテナの他のすべての子オブジェクトは、同じインデックス位置に残されます。

指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。指定されたタイプのイベントがこの EventDispatcher オブジェクトまたはその子孫に送出されたときに、イベントリスナーがイベントフローの任意の段階でトリガされる場合、このメソッドは true を返します。

hasEventListener() メソッドと willTrigger() メソッドの違いは、hasEventListener() では自身が属するオブジェクトのみ検証され、willTrigger() メソッドでは type パラメータで指定されたイベントのイベントフロー全体が検証されることです。

willTrigger() が LoaderInfo オブジェクトから呼び出された場合は、呼び出し側がアクセスできるリスナーのみ考慮されます。

マウスポインタが Flash Player のウィンドウ領域から離れたときに、Stage オブジェクトによって送出されます。

mouseLeave イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

Stage オブジェクトの scaleMode プロパティが StageScaleMode.NO_SCALE に設定され、SWF ファイルのサイズが変更されたときに送出されます。

resize イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

1. 最初にクラスコンストラクタは、Flash Player のウィンドウのサイズに関係なく、 固定する Flash アプリケーションを設定し、 その後 activateHandler() メソッドおよび resizeHandler() メソッドを使用して 2 つのイベントリスナーを追加します。
2. マウスの左ボタンをクリックすると、activateHandler() メソッドが実行されます。
3. ステージのサイズを変更すると、resizeHandler() メソッドが実行されます。

package {
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    import flash.events.Event;

    public class StageExample extends Sprite {

        public function StageExample() {
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            stage.addEventListener(Event.ACTIVATE, activateHandler);
            stage.addEventListener(Event.RESIZE, resizeHandler);
        }

        private function activateHandler(event:Event):void {
            trace("activateHandler: " + event);
        }

        private function resizeHandler(event:Event):void {
            trace("resizeHandler: " + event);
            trace("stageWidth: " + stage.stageWidth + " stageHeight: " + stage.stageHeight);
        }
    }
}