为 ActionScript 导出库元件

Flash Player 9 和更高版本,Adobe AIR 1.0 和更高版本

默认情况下,Flash 文档库中的影片剪辑元件实例不能以动态方式创建(即只使用 ActionScript 创建)。这是因为导出供 ActionScript 使用的每个元件都会增加 SWF 文件的大小,而且众所周知,有些元件可能不适合在舞台上使用。因此,为了使元件可以在 ActionScript 中使用,必须指定为 ActionScript 导出该元件。

为 ActionScript 导出元件:

  1. 在“库”面板中选择该元件并打开其“元件属性”对话框。

  2. 必要时激活“高级”设置。

  3. 在“链接”部分中,激活“为 ActionScript 导出”复选框。

    这将激活“类”和“基类”字段。

    默认情况下,“类”字段会用删除了空格的元件名称进行填充(例如,名为“Tree House”的元件会变为“TreeHouse”)。若要指定该元件对其行为使用自定义类,请在此字段中输入该类的完整名称,包括它所在的包。如果希望在 ActionScript 中创建该元件的实例,但不需要添加任何其他行为,则可以使类名称保持原样。

    “基类”字段的值默认为 flash.display.MovieClip 。如果想让元件扩展另一个自定义类的功能,可以指定该类的名称替代这个值,只要该类扩展 Sprite(或 MovieClip)类即可。

  4. 按“确定”按钮以保存所做的更改。

    此时,如果 Flash 无法找到链接的 SWC 文件,或包含指定类的定义的外部 ActionScript 文件(例如,如果不需要为元件添加其它行为),则会显示警告:

    无法在类路径中找到对此类的定义,因此将在导出时自动在 SWF 文件中生成相应的定义。

    如果库元件不需要超出 MovieClip 类功能的独特功能,则可以忽略此警告消息。

如果没有为元件提供类,Flash 将为元件创建一个等同于下面所示类的类:

package 
{ 
    import flash.display.MovieClip; 
     
    public class ExampleMovieClip extends MovieClip 
    { 
        public function ExampleMovieClip() 
        { 
        } 
    } 
}

如果想要向元件中添加额外的 ActionScript 功能,请向下面的代码结构中添加相应的属性和方法。例如,假如有一个包含 50 像素宽和 50 像素高的圆形的影片剪辑元件,并用名为 Circle 的类指定为 ActionScript 导出该元件。以下代码在放入 Circle.as 文件后将扩展 MovieClip 类,同时为此元件提供额外的方法 getArea() getCircumference()

package  
{ 
    import flash.display.MovieClip; 
     
    public class Circle extends MovieClip 
    { 
        public function Circle() 
        { 
        } 
         
        public function getArea():Number 
        { 
        // The formula is Pi times the radius squared. 
        return Math.PI * Math.pow((width / 2), 2); 
        } 
         
        public function getCircumference():Number 
        { 
        // The formula is Pi times the diameter. 
        return Math.PI * width; 
        } 
    } 
}

放置在 Flash 文档第 1 帧的关键帧上的以下代码将创建该元件的一个实例,并在屏幕上显示该实例:

var c:Circle = new Circle(); 
addChild(c); 
trace(c.width); 
trace(c.height); 
trace(c.getArea()); 
trace(c.getCircumference());

此代码演示了基于 ActionScript 的实例化可作为将单个资源拖放到舞台上的替代方法。它所创建的圆形具有影片剪辑的所有属性,同时还具有 Circle 类中定义的自定义方法。这是一个非常简单的示例 — 您的库元件可在其类中指定任意数目的属性和方法。

基于 ActionScript 的实例化功能强大,因为允许动态创建大量实例,而如果采用手动方式来创建将是一项繁重的任务。同时还很灵活,因为您可以在创建每个实例时自定义该实例的属性。您可以通过使用循环动态创建多个 Circle 实例来体会上述优点。在 Flash 文档库中存在上述 Circle 元件和类的情况下,将下面的代码放在第 1 帧的关键帧上:

import flash.geom.ColorTransform; 
 
var totalCircles:uint = 10; 
var i:uint; 
for (i = 0; i < totalCircles; i++) 
{ 
    // Create a new Circle instance. 
    var c:Circle = new Circle(); 
    // Place the new Circle at an x coordinate that will space the circles 
    // evenly across the Stage. 
    c.x = (stage.stageWidth / totalCircles) * i; 
    // Place the Circle instance at the vertical center of the Stage. 
    c.y = stage.stageHeight / 2; 
    // Change the Circle instance to a random color 
    c.transform.colorTransform = getRandomColor(); 
    // Add the Circle instance to the current timeline. 
    addChild(c); 
} 
 
function getRandomColor():ColorTransform 
{ 
    // Generate random values for the red, green, and blue color channels. 
    var red:Number = (Math.random() * 512) - 255; 
    var green:Number = (Math.random() * 512) - 255; 
    var blue:Number = (Math.random() * 512) - 255; 
     
    // Create and return a ColorTransform object with the random colors. 
    return new ColorTransform(1, 1, 1, 1, red, green, blue, 0); 
}

此代码演示了如何使用代码快速创建和自定义元件的多个实例。每个实例都根据循环内的当前计数进行定位,并且每个实例都通过设置 transform 属性(Circle 通过扩展 MovieClip 类而继承该属性)获得了一种随机颜色。