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

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

関連項目

使用する表示状態を指定する StageDisplayState クラスの値です。使用できる値は次のとおりです。

• ユーザーの画面全体にステージを拡張するように StageDisplayState.FULL_SCREEN によって Flash Player が設定されます。
• StageDisplayState.NORMAL によって、Flash Player を標準のステージ表示モードに戻します。

フルスクリーンモードでのムービーの拡大 / 縮小動作は、scaleMode 設定 (Stage.scaleMode プロパティまたは HTML ファイル内の SWF ファイルの embed タグ設定を使用して設定) で決定されます。Flash Player が フルスクリーンモードへのトランジションの最中に、scaleMode プロパティを noScale に設定すると、Stage の width および height プロパティが更新され、Flash Player によって Stage.resize イベントが送出されます。

次の制約は、スタンドアロンの Flash Planer を使用するのではなく、HTML ページ内で再生される SWF ファイルに適用されます。

• フルスクリーンモードを有効にするには、次の例のように allowFullScreen パラメータを SWF ファイルを含む HTML ページの object および embed タグに追加します。このとき、allowFullScreen は "true" に設定します。

  <param name="allowFullScreen" value="true" />
           ...
    <embed src="example.swf" allowFullScreen="true" ... >

  HTML ページでは、スクリプトを使用して SWF 埋め込みタグを生成することもできます。allowFullScreen 設定が正しく挿入されるように、スクリプトを変更する必要があります。Flash および Flex Builder で生成された HTML ページでは、AC_FL_RunContent() 関数を使用して SWF ファイルへの参照を埋め込みます。ユーザーは、次のように allowFullScreen パラメータの設定を追加する必要があります。

  AC_FL_RunContent( ... "allowFullScreen", "true", ... )

• フルスクリーンモードは、マウスクリックまたはキー操作に対応して開始されます。ムービーでは、ユーザー入力なしに Stage.displayState を変更できません。Flash Player がフルスクリーンモードの場合、フルスクリーンモードを中止するキーボードショートカットキーボード以外の入力はすべて無効になります。フルスクリーンモードに入ると、ムービーの上に Flash Player ダイアログ ボックスが表示され、フルスクリーンモードであること、および Esc キーを押すとフルスクリーンモードを終了できることを知らせます。
• Flash Player Update 3 以降からは、ウィンドウモードの場合と同じようにウィンドウレスモードでフルスクリーンモードが動作するようになりました。ウィンドウモード (HTML では wmode) を不透明表示 (opaque) または透明表示 (transparent) に設定すると、フルスクリーンを開始できますが、フルスクリーンウィンドウは常に不透明になります。

関連項目

package {
    import flash.display.Sprite;
    import flash.display.Stage;
    import flash.events.*;
    import flash.net.NetConnection;
    import flash.net.NetStream;
    import flash.media.Video;
    
    public class FullScreenExample extends Sprite
    {
        private var videoURL:String = "testVideo.flv";
        private var connection:NetConnection;
        private var stream:NetStream;
        private var video:Video;        
        
        public function FullScreenExample() {
            connection = new NetConnection();
            connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            connection.connect(null);
            
            loaderInfo.addEventListener(Event.INIT, createMouseListener);            
        }

        private function createMouseListener(event:Event):void {
            stage.addEventListener(MouseEvent.CLICK,toggleFullScreen);
        }        
        
        private function toggleFullScreen(event:MouseEvent):void {
            switch(stage.displayState) {
                case "normal":
                    stage.displayState = "fullScreen";    
                    break;
                case "fullScreen":
                default:
                    stage.displayState = "normal";    
                    break;
            }
        }    
        
        // Video related:
        private function netStatusHandler(event:NetStatusEvent):void {
            switch (event.info.code) {
                case "NetConnection.Connect.Success":
                    connectStream();
                    break;
                case "NetStream.Play.StreamNotFound":
                    trace("Unable to locate video: " + videoURL);
                    break;
            }
        }
        private function connectStream():void {
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);

            video = new Video(stage.stageWidth,stage.stageHeight);
            video.attachNetStream(stream);
            stream.play(videoURL);
            addChild(video);
        }
        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }
        private function asyncErrorHandler(event:AsyncErrorEvent):void {
            // ignore AsyncErrorEvent events.
        }            
    }
}

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

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

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

フルスクリーンサイズに移行したときに使用されるモニタの高さを返します (直ちに移行する場合)。ユーザーが複数のモニタを持っている場合、使用されるモニタは、そのときに最も多くのステージが表示されているモニタです。

メモ : 値を取得してから、フルスクリーンサイズに移行するまでの間に、あるモニタから別のモニタにブラウザを移動する機会がある場合、値が不正になる可能性があります。Stage.displayState を StageDisplayState.FULL_SCREEN に設定するイベントハンドラで値を取得すると、値は正しくなります。

これはモニタのピクセルの高さであり、Stage.align が StageAlign.TOP_LEFT に設定され、Stage.scaleMode が StageScaleMode.NO_SCALE に設定された場合には、ステージの高さと同じになります。

Player のバージョン : Flash Player 9 Update 3

関連項目

import flash.display.Sprite;
import flash.display.Stage;
import flash.display.StageDisplayState;
import flash.events.MouseEvent;
import flash.geom.Rectangle;
 
// cover the stage with a green rectangle
var greenRect:Sprite = new Sprite();
greenRect.graphics.beginFill(0x00FF00);
greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight);
addChild(greenRect);
 
// create red square on stage, turn it into a button for going to full screen
var redSquare:Sprite = new Sprite();
redSquare.graphics.beginFill(0xFF0000);
redSquare.graphics.drawRect(0, 0, 300, 300);
redSquare.x = 50;
redSquare.y = 50;
redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen);
redSquare.buttonMode = true;
addChild(redSquare);
 
function enterFullScreen(e:MouseEvent):void
{
    // we will go to full screen zoomed in on the red square
    var redSquare:Sprite = e.target as Sprite;
    var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height);
 
    // calculate aspect ratio of the red square
    var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height;
 
    // calculate aspect ratio of the screen
    var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight;
  
    // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare
    // try commenting out this section to see what happens if you do not fix the aspect ratio.
    if (rectAspectRatio > screenAspectRatio) {
         var newHeight:Number = fullScreenRect.width / screenAspectRatio;
         fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2);
        fullScreenRect.height = newHeight;
    } else if (rectAspectRatio < screenAspectRatio) {
        var newWidth:Number = fullScreenRect.height * screenAspectRatio;
        fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2);
        fullScreenRect.width = newWidth;
    }
 
    // go to full screen
    stage.fullScreenSourceRect = fullScreenRect;
    stage.displayState = StageDisplayState.FULL_SCREEN;
}

ステージの特定の領域を Flash Player で拡大 / 縮小してフルスクリーンモードにするように設定します。可能な場合、拡大 / 縮小は、ユーザーのコンピュータ上でグラフィックカードやビデオカードを使用してハードウェアで行われます。通常、この方が、ソフトウェアで拡大 / 縮小するよりもすばやくコンテンツが表示されます。

このプロパティを有効な矩形に設定し、displayState プロパティをフルスクリーンモードに設定すると、指定された領域が Flash Player により拡大 / 縮小されます。ActionScript 内の実際のステージサイズ (ピクセル単位) は変更されません。標準の "フルスクリーンモードを終了するには、Esc キーを押します" というメッセージに対応するため、矩形のサイズに最小限度が適用されます。通常、この限度は約 260 × 30 ピクセルですが、プラットフォームおよび Flash Player のバージョンによって異なる場合があります。

このプロパティを設定できるのは、Flash Player がフルスクリーンモードでない場合のみです。このプロパティを正しく使用するには、コード例に示すように、このプロパティを最初に設定し、次に displayState プロパティをフルスクリーンモードに設定します。

拡大 / 縮小を有効にするには、次のように fullScreenSourceRect プロパティを矩形オブジェクトに設定します。

  
  // valid, will enable hardware scaling
  stage.fullScreenSourceRect = new Rectangle(0,0,320,240); 
  

拡大 / 縮小を無効にするには、ActionScript 3.0 では fullScreenSourceRect=null に設定し、ActionScript 2.0 では undefined に設定します。

  stage.fullScreenSourceRect = null;
  

エンドユーザーが Flash Player の表示設定を使用して、ハードウェアの拡大 / 縮小をオフにすることもできます。この機能はデフォルトでは有効になっています。詳細については、www.adobe.com/go/display_settings_jp を参照してください。

Player のバージョン : Flash Player 9 Update 3

関連項目

 
import flash.geom.*; 
{
  stage.fullScreenSourceRect = new Rectangle(0,0,320,240);
  stage.displayState = StageDisplayState.FULL_SCREEN;
}

package {
    import flash.display.Sprite;
    import flash.display.StageDisplayState;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;
    import flash.events.NetStatusEvent;
    import flash.events.AsyncErrorEvent;
    import flash.events.SecurityErrorEvent;
    import flash.events.MouseEvent;
    import flash.events.Event;
    import flash.geom.Rectangle;
    
    public class Stage_fullScreenSourceRectExample2 extends Sprite {
        private var videoURL:String = "testVideo1.flv";
        private var connection:NetConnection;
        private var stream:NetStream;
        private var myVideo:Video;        
        private    var savedWidth:uint;
        private    var savedHeight:uint;
 
        public function Stage_fullScreenSourceRectExample2() {
    
            connection = new NetConnection();
             connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);    
            connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            connection.connect(null);

            loaderInfo.addEventListener(Event.INIT, createMouseListener);            
        }

        private function createMouseListener(event:Event):void {
            stage.addEventListener(MouseEvent.CLICK, toggleFullScreen);
        }        

        private function toggleFullScreen(event:MouseEvent):void {

            if(stage.displayState == StageDisplayState.NORMAL) {
                myVideo.width = myVideo.videoWidth;
                  myVideo.height = myVideo.videoHeight;

                try {
                    stage.fullScreenSourceRect = new Rectangle(myVideo.x, myVideo.y, 
                                                           myVideo.width, myVideo.height);
                     stage.displayState = StageDisplayState.FULL_SCREEN;

                 } catch (e:SecurityError) {
                     trace ("A security error occurred while switching to full screen: " + event);
                    myVideo.width = savedWidth;
                    myVideo.height = savedHeight;
                 }

            }else {
                myVideo.width = savedWidth;
                myVideo.height = savedHeight;
                stage.displayState = StageDisplayState.NORMAL;
            }
        }    

       private function netStatusHandler(event:NetStatusEvent):void {
            switch (event.info.code) {
                case "NetConnection.Connect.Success":
                    connectStream();
                    break;
                case "NetStream.Play.StreamNotFound":
                    trace ("Unable to locate video: " + videoURL);
                    break;
            }
        }

       private function connectStream():void {
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);     

             myVideo = new Video();
            myVideo.attachNetStream(stream);
            stream.play(videoURL);

            savedWidth = myVideo.width;
            savedHeight = myVideo.height;

            addChild(myVideo);
        }
       
        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);    
        }
        
        private function asyncErrorHandler(event:AsyncErrorEvent):void {
            
        }            
    }
}

フルスクリーンサイズに移行したときに使用されるモニタの幅を返します (直ちに移行する場合)。ユーザーが複数のモニタを持っている場合、使用されるモニタは、そのときに最も多くのステージが表示されているモニタです。

メモ : 値を取得してから、フルスクリーンサイズに移行するまでの間に、あるモニタから別のモニタにブラウザを移動する機会がある場合、値が不正になる可能性があります。Stage.displayState を StageDisplayState.FULL_SCREEN に設定するイベントハンドラで値を取得すると、値は正しくなります。

これはモニタのピクセル幅であり、Stage.align が StageAlign.TOP_LEFT に設定され、Stage.scaleMode が StageScaleMode.NO_SCALE に設定された場合には、ステージ幅と同じになります。

Player のバージョン : Flash Player 9 Update 3

関連項目

import flash.display.Sprite;
import flash.display.Stage;
import flash.display.StageDisplayState;
import flash.events.MouseEvent;
import flash.geom.Rectangle;
 
// cover the stage with a green rectangle
var greenRect:Sprite = new Sprite();
greenRect.graphics.beginFill(0x00FF00);
greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight);
addChild(greenRect);
 
// create red square on stage, turn it into a button for going to full screen
var redSquare:Sprite = new Sprite();
redSquare.graphics.beginFill(0xFF0000);
redSquare.graphics.drawRect(0, 0, 300, 300);
redSquare.x = 50;
redSquare.y = 50;
redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen);
redSquare.buttonMode = true;
addChild(redSquare);
 
function enterFullScreen(e:MouseEvent):void
{
    // we will go to full screen zoomed in on the red square
    var redSquare:Sprite = e.target as Sprite;
    var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height);
 
    // calculate aspect ratio of the red square
    var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height;
 
    // calculate aspect ratio of the screen
    var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight;
  
    // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare
    // try commenting out this section to see what happens if you do not fix the aspect ratio.
    if (rectAspectRatio > screenAspectRatio) {
         var newHeight:Number = fullScreenRect.width / screenAspectRatio;
         fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2);
        fullScreenRect.height = newHeight;
    } else if (rectAspectRatio < screenAspectRatio) {
        var newWidth:Number = fullScreenRect.height * screenAspectRatio;
        fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2);
        fullScreenRect.width = newWidth;
    }
 
    // go to full screen
    stage.fullScreenSourceRect = fullScreenRect;
    stage.displayState = StageDisplayState.FULL_SCREEN;
}

表示オブジェクトの高さを示します (ピクセル単位)。この高さは、表示オブジェクトのコンテンツの境界に基づいて計算されます。次のコードに示すように、この height プロパティを設定すると、それに合わせて scaleY プロパティの値が調整されます。

 var rect:Shape = new Shape();
 rect.graphics.beginFill(0xFF0000);
 rect.graphics.drawRect(0, 0, 100, 100);
 trace(rect.scaleY) // 1;
 rect.height = 200;
 trace(rect.scaleY) // 2;

TextField と Video オブジェクトを除いて、height を別の値に設定しようとしても、コンテンツのない表示オブジェクト (たとえば、空のスプラインなど) の高さは 0 になります。

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

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

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

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

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

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

関連項目

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

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

表示オブジェクトの幅を示します (ピクセル単位)。この幅は、表示オブジェクトのコンテンツの境界に基づいて計算されます。次のコードに示すように、この width プロパティを設定すると、それに合わせて scaleX プロパティの値が調整されます。

 var rect:Shape = new Shape();
 rect.graphics.beginFill(0xFF0000);
 rect.graphics.drawRect(0, 0, 100, 100);
 trace(rect.scaleX) // 1;
 rect.width = 200;
 trace(rect.scaleX) // 2;

TextField と Video オブジェクトを除いて、width を別の値に設定しようとしても、コンテンツのない表示オブジェクト (たとえば、空のスプラインなど) の幅は 0 になります。

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

パラメータ

関連項目

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

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

パラメータ

関連項目

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

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

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

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

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

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

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

パラメータ

関連項目

パラメータ

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

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

パラメータ

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

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

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

関連項目

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

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

パラメータ

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

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

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

パラメータ

パラメータ

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

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

パラメータ

Stage オブジェクトが、フルスクリーンモードに設定または設定解除されると、Flash Player によって送出されます。フルスクリーンモードの変更は、ActionScript、ユーザーによるキーボードショートカットの呼び出し、または現在のフォーカスのフルスクリーンウィンドウからの移動によって開始できます。

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

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

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

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

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

1. 最初にクラスコンストラクタは、Flash Player のウィンドウのサイズに関係なく、activateHandler() メソッドおよび resizeHandler() メソッドを使用して、固定する Flash アプリケーションを設定します。
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);
        }
    }
}