一个 StageAlign 类中指定舞台在 Flash Player 或浏览器中的对齐方式的值。 以下是有效值：

align 属性只可用于与 Stage 所有者（主 SWF 文件）位于同一安全沙箱的对象。 为避免出现这种情况，Stage 所有者可以通过调用 Security.allowDomain() 方法或 Security.alowInsecureDomain() 方法来向域的调用对象授予权限。 有关详细信息，请参阅《ActionScript 3.0 编程》中的“安全性”一章。

另请参见

用于指定要使用哪个显示状态的 StageDisplayState 类的值。 以下是有效值：

• StageDisplayState.FULL_SCREEN 将 Flash Player 设置为把舞台扩展到用户的整个屏幕。
• StageDisplayState.NORMAL 将播放器设置回标准的舞台显示模式。

影片在全屏模式下的缩放行为由 scaleMode 设置确定（在 HTML 文件中使用 Stage.scaleMode 属性或 SWF 文件的 embed 标签设置进行设置）。 如果 scaleMode 属性设置为 noScale，同时 Flash Player 过渡到全屏模式，则会更新 Stage width 和 height 属性，并且 Flash Player 将调度 Stage.resize 事件。

在 HTML 页中播放的 SWF 文件（而不是使用独立的 Flash Player 播放的 SWF 文件）受以下限制：

• 若要启用全屏模式，请将 allowFullScreen 参数添加到包含 SWF 文件的 HTML 页中的 object 和 embed 标签，同时将 allowFullScreen 设置为 "true"，如下例所示：

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

  HTML 页还可以使用脚本生成 SWF 嵌入标签。 您需要更改脚本以使其插入正确的 allowNetworking 设置。 Flash 和 Flex Builder 生成的 HTML 页使用 AC_FL_RunContent() 函数嵌入对 SWF 文件的引用，而且您需要添加 allowNetworking 参数设置，如下所示：

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

• 全屏模式是在响应用户单击鼠标或按键时初始化的；在没有用户输入的情况下，影片不能更改 Stage.displayState。 当 Flash Player 处于全屏模式时，将禁用所有键盘输入（可使用户退出全屏模式的键盘快捷键除外）。 当用户进入全屏模式时，将在影片前面显示一个 Flash Player 对话框，告诉用户已经进入了全屏模式，并可以按 Esc 键退出全屏模式。

另请参见

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.
        }            
    }
}

具有键盘焦点的交互式对象；如果没有设置焦点，或者具有焦点的对象属于调用对象无权访问的安全沙箱，则为 null。

获取并设置舞台的帧频。 帧频是指每秒显示的帧数。 默认情况下，频率设置为第一个加载的 SWF 文件的帧频。 帧频的有效范围为每秒 0.01 到 1000 个帧。

Note:Flash Player 可能由于以下原因而无法支持高帧频设置：目标平台不够快或播放器与显示设备的垂直空白时间（在 LCD 设备上通常为 60 Hz）同步。 在某些情况下，如果目标平台将占用高 CPU 使用率，它可能还会选择降低最大帧率。

指示显示对象的高度，以像素为单位。 高度是根据显示对象内容的范围来计算的。 如果您设置了 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 对象以外，没有内容的显示对象（如一个空的 Sprite）的高度为 0，即使您尝试将 height 设置为其它值，也是这样。

确定对象的子项是否支持鼠标。 如果对象支持鼠标，则用户可以使用鼠标与其交互。 默认值为 true。

当您使用 Sprite 类的实例（而不是使用 SimpleButton 类）来创建按钮时，此属性很有用。 当您使用 Sprite 实例来创建按钮时，您可以选择使用 addChild() 方法添加其它 Sprite 实例来修饰按钮。 此过程可能导致鼠标事件出现意外行为，因为当您期望父实例成为鼠标事件的目标对象时，作为子项添加的 Sprite 实例却可能成为目标对象。 要确保父实例用作鼠标事件的目标对象，您可以将父实例的 mouseChildren 属性设置为 false。

设置此属性不会调度任何事件。 您必须使用 addEventListener() 方法才能创建交互式功能。

返回此对象的子项数目。

一个 StageQuality 类中指定 Flash Player 使用哪种呈现品质的值。 以下是有效值：

• 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 的宽度。 这意味着 stageWidth 属性将随着您调整 Flash Player 窗口的大小而变化。 将 scaleMode 属性的值设置为 StageScaleMode.NO_SCALE 时，stageWidth 属性表示进行创作时在“文档属性”对话框中设置的 SWF 文件的宽度。 这意味着在您调整 Flash Player 窗口大小时，stageWidth 属性的值将保持不变。 无法设置此属性。

另请参见

确定对象的子项是否支持 Tab 键。 为对象的子项启用或禁用 Tab 切换。 默认值为 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 对象以外，没有内容的显示对象（如一个空的 Sprite）的宽度为 0，即使您尝试将 width 设置为其它值，也是这样。

如果添加一个已将其它显示对象容器作为父项的子对象，则会从其它显示对象容器的子列表中删除该对象。

参数

另请参见

例如，下例在索引位置 0、2、1 处分别显示 a、b、c 三个显示对象：

如果添加一个已将其它显示对象容器作为父项的子对象，则会从其它显示对象容器的子列表中删除该对象。

参数

另请参见

成功注册一个事件侦听器后，无法通过额外调用 addEventListener() 来更改其优先级。 要更改侦听器的优先级，必须首先调用 removeListener()。 然后，可以使用新的优先级再次注册该侦听器。

请记住，注册该侦听器后，如果继续调用具有不同 type 或 useCapture 值的 addEventListener()，则会创建单独的侦听器注册。 例如，如果首先注册 useCapture 设置为 true 的侦听器，则该侦听器只在捕获阶段进行侦听。 如果使用同一个侦听器对象再次调用 addEventListener()，并将 useCapture 设置为 false，那么便会拥有两个单独的侦听器：一个在捕获阶段进行侦听，另一个在目标和冒泡阶段进行侦听。

不能只为目标阶段或冒泡阶段注册事件侦听器。 这些阶段在注册期间是成对出现的，因为冒泡阶段只适用于目标节点的始祖。

如果不再需要某个事件侦听器，可调用 removeEventListener() 删除它，否则会产生内存问题。 由于垃圾回收器不会删除仍包含引用的对象，因此不会从内存中自动删除使用已注册事件侦听器的对象。

复制 EventDispatcher 实例时并不复制其中附加的事件侦听器。 （如果新近创建的节点需要一个事件侦听器，必须在创建该节点后附加该侦听器）。 但是，如果移动 EventDispatcher 实例，则其中附加的事件侦听器也会随之移动。

如果在正在处理事件的节点上注册事件侦听器，则不会在当前阶段触发事件侦听器，但会在事件流的稍后阶段触发，如冒泡阶段。

如果从正在处理事件的节点中删除事件侦听器，则该事件侦听器仍由当前操作触发。 删除事件侦听器后，决不会再次调用该事件侦听器（除非再次注册以备将来处理）。

参数

另请参见

参数

hasEventListener() 与 willTrigger() 的区别是：hasEventListener() 只检查它所属的对象，而 willTrigger() 检查整个事件流以查找由 type 参数指定的事件。

当从 LoaderInfo 对象调用 hasEventListener() 时，只考虑调用方可以访问的侦听器。

参数

调用 invalidate() 方法，以便在出现下一个 Flash Player 必须呈现显示列表的时机（例如，当播放头前进到一个新帧）时，向其发出提醒显示对象的信号。 调用 invalidate() 方法后，在显示列表下次呈现时，Flash Player 会向每个已注册侦听 render 事件的显示对象发送一个 render 事件。 每次想让 Flash Player 发送 render 事件时，都必须调用 invalidate() 方法。

render 事件使您可以在显示列表实际呈现前对其进行更改。 因此，您就可以将对显示列表的更新尽可能地向后延迟。 这样可以通过消除不必要的屏幕更新来提高性能。

只将 render 事件调度到与调用 stage.invalidate() 方法的代码位于同一安全域中的显示对象，或位于通过 Security.allowDomain() 方法被授予权限的安全域中的显示对象。

另请参见

确定 Stage.focus 属性是否因某些安全原因返回 null。 也就是说，如果具有焦点的对象属于 SWF 文件无权访问的安全沙箱，那么 isFocusInaccessible 就会返回 true。

垃圾回收器是 Flash Player 用来重新分配未使用的内存空间的进程。 当在某处变量或对象不再被主动地引用或存储时，垃圾回收器将清理其过去占用的内存空间，并且如果不存在对该变量或对象的任何其它引用，则擦除此内存空间。

参数

在使用 setChildIndex() 方法并指定一个已占用的索引位置时，子项列表中占用该位置的子对象以及更高位置的所有对象在该列表中将上移一个位置。 例如，如果上例中的显示对象容器名为 container，则可以通过调用以下代码来交换带有 a 和 b 标记的显示对象的位置：

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

该代码产生以下对象排列：

参数

参数

hasEventListener() 与 willTrigger() 方法的区别是：hasEventListener() 只检查它所属的对象，而 willTrigger() 方法检查整个事件流以查找由 type 参数指定的事件。

当从 LoaderInfo 对象调用 willTrigger() 时，只考虑调用方可以访问的侦听器。

参数

当 Stage 对象进入或离开全屏模式时由 Flash Player 调度。 可以通过 ActionScript、或用户调用键盘快捷键或者当前焦点离开全屏窗口来启动全屏模式的更改。

此事件具有以下属性：

当鼠标指针移出 Flash Player 窗口区域时由 Stage 对象进行调度。

此事件具有以下属性：

当 Stage 对象的 scaleMode 属性设置为 StageScaleMode.NO_SCALE 且 SWF 文件大小经过重新调整时进行调度。

此事件具有以下属性：

1. 无论 Flash Player 窗口的大小如何，类的构造函数都会首先将 Flash 应用程序设置为固定大小，然后使用 activateHandler() 和 resizeHandler() 方法添加两个事件侦听器。
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);
        }
    }
}