如何使用 ActionScript 示例

代码片断示例

代码片断示例类似于：

var x:int = 5; 
trace(x); // 5

代码片断仅包含说明一种想法的代码。它们通常不包含包语句或类语句。

基于类的示例

许多示例用于显示完整的 ActionScript 类的源代码。基于类的示例类似于：

package { 
    public class Example1 { 
        public function Example1():void { 
            var x:int = 5; 
            trace(x); //5 
        } 
    } 
}

基于类的示例的代码包括一个包语句、一个类声明和一个构造函数。

包含多个源文件的实用示例

《ActionScript 3.0 开发人员指南》中的许多主题都以实用示例来结束，这些示例显示了如何在实用的实际上下文中使用某些 ActionScript 功能。这些示例通常包含多个文件，包括：

实用示例通常以 ZIP 归档文件的形式提供。

开发人员指南在 ZIP 中提供的示例列表

Flash Professional CS5 和 Flex 4 的 ZIP 文件（从 www.adobe.com/go/learn_programmingAS3samples_flash_cn 上下载）包含以下示例：

• AlarmClock（ 事件处理示例：闹钟 ）

• AlgorithmicVisualGenerator（ 绘制 API 示例：算法可视化生成器 ）

• ASCIIArt（ 字符串示例：ASCII 图表 ）

• CapabilitiesExplorer（ 功能示例：检测系统功能 ）

• CustomErrors（ 处理错误示例：CustomErrors 应用程序 ）

• DisplayObjectTransformer（ 几何形状示例：对显示对象应用矩阵转换 ）

• FilterWorkbench（ 筛选显示对象示例：Filter Workbench ）

• GlobalStockTicker（ 示例：国际化股票报价应用程序 ）

• IntrovertIM_HTML（ 外部 API 示例：在 ActionScript 和 Web 浏览器中的 JavaScript 之间进行通信 ）

• NewsLayout（ TextField 示例：报纸风格的文本格式设置 ）

• PlayList（ 数组示例：播放列表 ）

• PodcastPlayer（ 声音示例：Podcast Player ）

• ProjectionDragger（ 示例：透视投影 ）

• ReorderByZ（ 使用 Matrix3D 对象重新排序显示 ）

• RSSViewer（ 在 ActionScript 中使用 XML 的示例：从 Internet 加载 RSS 数据 ）

• RuntimeAssetsExplorer（ 影片剪辑示例：RuntimeAssetsExplorer ）

• SimpleClock（ 日期和时间示例：简单模拟时钟 ）

• SpinningMoon（ 位图示例：带动画效果的旋转的月亮 ）

• SpriteArranger（ 显示对象示例：SpriteArranger ）

• TelnetSocket（ TCP 套接字示例：构建 Telnet 客户端 ）

• VideoJukebox（ 视频示例：视频自动唱片点唱机 ）

• WikiEditor（ 正则表达式示例：Wiki 解析程序 ）

• WordSearch（ 鼠标输入示例：WordSearch ）

Flash 开发人员中心和 Flex 开发人员中心的许多快速入门文章中也提供了实用示例。

在 Flash Professional 中运行代码片断示例

要在 Flash Professional 中运行代码片断示例，请执行以下操作：

1. 选择“文件”>“新建”。

2. 在“新建文档”对话框中，选择“Flash 文档”，然后单击“确定”。

   将显示一个新的 Flash 窗口。

3. 在“时间轴”面板中，单击第一个图层的第一帧。

4. 在“动作”面板中，键入或粘贴代码片断示例。

5. 选择“文件”>“保存”。为文件指定一个名称，然后单击“确定”。

6. 要测试该示例，请选择“控制”>“测试影片”。

在 Flash Professional 中运行基于类的示例

要在 Flash Professional 中运行基于类的示例，请执行以下操作：

在 Flash Professional 中运行实用示例

实用示例通常以 ZIP 归档文件的形式提供。要使用 Flash Professional 运行实用示例，请执行以下操作：

1. 将归档文件解压缩到所选的文件夹中。

2. 在 Flash Professional 中，选择“文件”>“打开”。

3. 浏览到将归档文件解压缩到的文件夹中。在该文件夹中选择 FLA 文件并单击“打开”。

4. 要测试该示例，请选择“控制”>“测试影片”。

在 Flash Builder 中运行代码片断示例

要在 Flash Builder 中运行代码片断示例，请执行以下操作：

在 Flash Builder 中运行基于类的示例

要在 Flash Builder 中运行基于类的示例，请执行以下操作：

1. 选择“文件”>“新建”>“ActionScript 项目”。

2. 将主类的名称（例如 ContextMenuExample）输入到“项目名称”字段中。为其他字段使用默认值（或根据特定环境对这些默认值进行更改）。单击“完成”创建项目和主 ActionScript 文件。

3. 擦除任何从 ActionScript 文件生成的内容。将示例代码（包括包语句和 import 语句）粘贴到 ActionScript 文件并保存该文件。

   注： 某些基于类的示例（如 flashx.textLayout.container.ContainerController 类示例 ）在包声明 ( package flashx.textLayout.container.examples { ) 中包含多个级别。对于这些示例，将文件保存在与包声明 (flashx/textLayout/container/examples) 匹配的子文件中，或删除包名称（以便 ActionScript 仅以 package { 开头），则可以从任意位置测试该文件。

4. 要运行该示例，请为主 ActionScript 类名称选择“运行”>“运行”菜单选项（例如“运行”>“运行 ContextMenuExample”）。

在 Flash Builder 中运行实用示例

实用示例通常以 ZIP 归档文件的形式提供。要使用 Flash Builder 运行实用示例，请执行以下操作：

舞台大小

在移动设备上运行示例时的舞台要比在使用非移动设备时的舞台小得多。许多示例不要求特定的舞台大小。创建 SWF 文件时，应指定适合设备的舞台大小。例如，指定为 176 x 208 像素。

《ActionScript 3.0 开发指南》中的实用示例旨在阐明不同的 ActionScript 3.0 概念和类。这些示例的用户界面设计得很美观，而且在桌面计算机或便携式计算机上运作良好。虽然这些示例可以在移动设备上运行，但其舞台大小和用户界面设计不太适合小屏幕。Adobe 建议您在计算机上运行这些实用示例来了解 ActionScript，然后在您的移动应用程序中使用相关的代码片断。

文本字段而不是 trace 语句

在移动设备上运行示例时，无法显示示例的 trace 语句的输出。要查看输出，请创建 TextField 类的一个实例。然后，将 trace 语句的文本附加到该文本字段的 text 属性中。

您可以使用以下函数设置用于跟踪的文本字段：

function createTracingTextField(x:Number, y:Number, 
                                width:Number, height:Number):TextField { 
           
    var tracingTF:TextField = new TextField(); 
    tracingTF.x = x; 
    tracingTF.y = y; 
    tracingTF.width = width; 
    tracingTF.height = height; 
     
    // A border lets you more easily see the area the text field covers. 
    tracingTF.border = true; 
    // Left justifying means that the right side of the text field is automatically 
    // resized if a line of text is wider than the width of the text field. 
    // The bottom is also automatically resized if the number of lines of text 
    // exceed the length of the text field. 
    tracingTF.autoSize = TextFieldAutoSize.LEFT; 
     
    // Use a text size that works well on the device. 
    var myFormat:TextFormat = new TextFormat(); 
    myFormat.size = 18; 
    tracingTF.defaultTextFormat = myFormat; 
     
    addChild(tracingTF); 
    return tracingTF; 
}

例如，将此函数作为私有函数添加到文档类中。然后，在文档类的其他方法中，跟踪数据，代码类似以下内容：

var traceField:TextField = createTracingTextField(10, 10, 150, 150); 
// Use the newline character "\n" to force the text to the next line. 
traceField.appendText("data to trace\n"); 
traceField.appendText("more data to trace\n"); 
// Use the following line to clear the text field. 
traceField.appendText("");

appendText() 方法只接受一个值作为参数。该值是字符串（String 实例或字符串文本）。要输出非字符串变量的值，首先将该值转换为字符串。最简单的方法是调用对象的 toString() 方法：

var albumYear:int = 1999; 
traceField.appendText("albumYear = "); 
traceField.appendText(albumYear.toString());

文本大小

许多示例使用文本字段来帮助阐明概念。有时，调整文本字段中文本的大小可以提高移动设备上的可读性。例如，如果示例使用名为 myTextField 的文本字段实例，则可以使用下列代码更改其文本的大小：

// Use a text size that works well on the device. 
var myFormat:TextFormat = new TextFormat(); 
myFormat.size = 18; 
myTextField.defaultTextFormat = myFormat

捕获用户输入

移动操作系统和浏览器将捕获 SWF 内容没有接收到的一些用户输入事件。具体的行为要取决于操作系统和浏览器，但在移动设备上运行示例时，可能会导致意外行为。有关详细信息，请参阅 KeyboardEvent 优先级 。

此外，许多示例的用户界面是针对桌面计算机或便携式计算机设计的。例如，《ActionScript 3.0 开发人员指南》中的大多数实用示例适合通过桌面观看。因此，有时在移动设备的屏幕上看不见整个舞台。能否显示浏览器中的内容具体还要取决于浏览器。而且，这些示例的设计初衷不是用来捕捉和处理滚动或平移事件。因此，有些示例的用户界面不适合在小型屏幕上运行。Adobe 建议您在计算机上运行这些示例来了解 ActionScript，然后在您的移动应用程序中使用相关的代码片断。

有关详细信息，请参阅 平移和滚动显示对象 。

处理焦点

一些示例要求您将焦点置于一区域。通过将焦点置于一区域，您可以完成某些任务，例如，输入文本或选择按钮。要指定区域焦点，请使用移动设备的指针设备，例如笔针或您的手指。或者，使用移动设备的导航键指定区域焦点。要选择有焦点的按钮，请使用移动设备的 Select 键，就像使用计算机上的 Enter 一样。在某些设备上，敲两次按钮才能将其选中。

有关焦点的详细信息，请参阅 管理焦点 。

处理鼠标事件

许多示例侦听鼠标事件。例如，在计算机上，当用户将鼠标移动到某个显示对象上方或在某个显示对象上单击鼠标按钮时会发生这些鼠标事件。在移动设备上，使用指针设备（如笔针或手指）的事件称为触摸事件。Flash Player 10.1 已将触摸事件映射到鼠标事件。这种映射可以确保在 Flash Player 10.1 之前开发的 SWF 内容可以继续正常使用。因此，当使用指针设备选择或拖动显示对象时示例可正常工作。

性能

移动设备的处理能力没有桌面设备强。一些使 CPU 高负载的示例在移动设备上的执行速度可能会很慢。例如， 绘制 API 示例：算法可视化生成器 中的示例每输入一个帧便会执行大量计算和绘图。在计算机上运行此示例可以阐示多种绘图 API。但是，由于移动设备的性能限制，此示例不适合在一些移动设备上运行。

有关移动设备上的性能的详细信息，请参阅 优化 Flash Platform 的性能 。

最佳做法

这些示例不考虑开发适用于移动设备的应用程序的最佳做法。您需要特别注意移动设备在内存和处理能力方面的限制。同样，小型屏幕的用户界面的要求也与桌面显示不同。有关开发用于移动设备的应用程序的详细信息， 请参阅 优化 Flash Platform 的性能 。