onUpdate

可用性

Flash Player 6。

用法

function onUpdate (){
   ...statements...;
}

参数

无。

返回

无。

说明

事件处理函数；onUpdate 是为用于组件的实时预览影片定义的。当舞台上组件的实例具有实时预览影片时，每次组件实例的组件参数发生变化，创作工具都会调用实时预览影片的 onUpdate 函数。创作工具调用 onUpdate 函数时不使用参数，并且将忽略其返回值。应该在实时预览影片的主时间轴上声明 onUpdate 函数。

在实时预览影片中定义 onUpdate 函数是可选的。

有关实时预览影片的更多信息，请参见使用组件。

示例

onUpdate 函数使实时预览影片可以更新其视觉外观以匹配组件参数的新值。当用户更改组件属性检查器或“组件参数”面板中的参数值时，即会调用 onUpdate。onUpdate 函数将执行某些操作对其自身进行更新。例如，如果组件包括 color 参数，则 onUpdate 函数可能会更改实时预览中影片剪辑的颜色以反映新的参数值。另外，它可以将新颜色存储在内部变量中。

这里是一个使用 onUpdate 函数的示例，该示例通过实时预览影片中的空影片剪辑传递参数值。假设某个带有标签的按钮组件具有变量 labelColor，该变量指定文本标签的颜色。以下代码在组件影片主时间轴的第 1 帧中：

//定义 textColor 参数变量指定按钮标签文本的颜色。
buttonLabel.textColor = labelColor;

在实时预览影片中，将一个名为“xch”的空影片剪辑放置在实时预览影片中。然后将以下代码放置到实时预览影片的第 1 帧中。将“xch”添加到 labelColor 变量路径以通过 my_mc 影片剪辑传递变量：

//编写一个 onUpdate 函数，将“my_mc.”添加到参数变量名中：
function onUpdate (){
  buttonLabel.textColor = my_mc.labelColor;
}