编写触发代码提示的代码

使用动作脚本编辑器(在“动作”面板或“脚本”窗口中)时,Flash 可以检测到正在输入的动作并显示代码提示,即包含该动作完整语法的工具提示,或列出可能的方法或属性名称的弹出菜单。当您精确键入或命名对象时,会出现参数、属性和事件的代码提示,这样,动作脚本编辑器就会知道要显示哪些代码提示,此问题将在本部分下文中讨论。有关在代码提示出现时如何使用它们的信息,请参见使用代码提示

注意:代码提示将为那些不要求您为其创建和命名一个对象的本地类(例如 Math、Key、Mouse 等)自动启用。

严格指定对象类型以触发代码提示

在您使用动作脚本 2.0 时,可以精确键入基于内置类(例如 Button、Array 等)的变量。如果您这样做,动作脚本编辑器将显示该变量的代码提示。例如,假设您键入以下代码:

var names:Array = new Array();
names.

只要您键入句点 (.),Flash 就会显示可用于 Array 对象的方法和属性的列表,因为您已经将该变量的类型指定为数组。有关数据类型指定的更多信息,请参见严格数据类型指定。有关在代码提示出现时如何使用它们的信息,请参见使用代码提示

使用后缀触发代码提示

如果您使用的是动作脚本 1,或者在创建对象时未严格指定类型(请参见严格指定对象类型以触发代码提示),而又想显示这些对象的代码提示,则必须在创建每个对象时在其名称后添加特殊后缀。例如,触发 Array 类和 Camera 类的代码提示的后缀分别是 _array_cam。如果您键入以下代码:

var my_array = new Array();
var my_cam = Camera.get();

然后,键入以下两项中的任何一项(变量名称后面跟有句点),就会分别显示 Array 和 Camera 对象的代码提示。

my_array.
my_cam.

对于在舞台上出现的对象,请使用属性检查器的“实例名称”文本框中的后缀。例如,要显示 MovieClip 对象的代码提示,请使用属性检查器为所有 MovieClip 对象指定带有 _mc 后缀的实例名称。然后,只要您键入实例名称和紧随的句点,就会显示代码提示。

尽管在精确键入对象时不需要后缀来触发代码提示,但一贯地使用它们可以帮助您和其他人理解您的脚本。

下表列出了支持自动代码提示所需的后缀:

对象类型

变量后缀

Array

_array

按钮

_btn

摄像头

_cam

Color

_color

ContextMenu

_cm

ContextMenuItem

_cmi

日期

_date

Error

_err

LoadVars

_lv

LocalConnection

_lc

麦克风

_mic

MovieClip

_mc

MovieClipLoader

_mcl

PrintJob

_pj

NetConnection

_nc

NetStream

_ns

SharedObject

_so

Sound

_sound

字符串

_str

TextField

_txt

TextFormat

_fmt

Video

_video

XML

_xml

XMLNode

_xmlnode

XMLSocket

_xmlsocket

有关在代码提示出现时如何使用它们的信息,请参见使用代码提示

使用注释触发代码提示

您也可以使用动作脚本注释来指定对象的类,以用于代码提示。下面的示例将告诉动作脚本,实例 theObject 的类是 Object,依此类推。如果在这些注释后输入 mc,然后再输入一个句点,代码提示将显示 MovieClip 的方法和属性列表;如果输入 theArray,然后再输入一个句点,代码提示将显示 Array 的方法和属性列表,依此类推。

// 对象 theObject;
// 数组 theArray;
// 影片剪辑 mc;

不过,Macromedia 建议使用严格数据类型指定(请参见严格指定对象类型以触发代码提示)或使用后缀(请参见使用后缀触发代码提示),而不建议使用此技术,因为前面的两种技术自动启用代码提示,并使代码更易懂。有关在代码提示出现时如何使用它们的信息,请参见使用代码提示