Alert.show()

可用性

Flash Player 6 (6.0.79.0)。

版本

Flash MX Professional 2004。

用法

Alert.show(message[, title[, flags[, parent[, clickHandler[, icon[, defaultButton]]]]]])

参数

message 要显示的消息。

title Alert 标题栏中的文本。此参数可选;如果省略此参数,则标题栏为空。

flags 可选参数,指示要显示在 Alert 窗口中的按钮。默认值为 Alert.OK,它将显示"确定"按钮。在使用多个值时,请用 | 字符分隔各个值。使用以下值中的一个或多个:Alert.OKAlert.CANCELAlert.YESAlert.NO

您还可以使用 Alert.NONMODAL 指明 Alert 窗口为非模式窗口。非模式窗口允许用户与应用程序中的其它窗口交互。

parent Alert 组件的父窗口。Alert 窗口会将自己置于父窗口的中心。使用值 nullundefined 来指定 _root 时间轴。父窗口必须是 UIComponent 类的子类,并且是作为 UIComponent 的子类的另一个 Flash 组件,或者是作为 UIComponent 的子类的自定义窗口(有关详细信息,请参阅《学习 Adobe Flash 中的 ActionScript 2.0》中的"关于继承"。此参数是可选的。

clickHandler 单击按钮时广播的 click 事件的处理函数。除了标准的 click 事件对象属性外,还有另一个 detail 属性,该属性包含所单击按钮的标志值(Alert.OKAlert.CANCELAlert.YESAlert.NO)。此处理函数可以是函数或对象。有关详细信息,请参阅《使用 ActionScript 2.0 组件》中的"使用侦听器处理事件"

icon 表示要用作图标(显示在警告文本的左边)的库元件的链接标识符的字符串。此参数是可选的。

defaultButton 指示具有初始焦点并在用户按下 Enter (Windows) 或 Return (Macintosh) 时被单击的按钮。如果用户按 Tab 键切换到另一个按钮,则切换到的按钮在按下 Enter 键时触发。

此参数可以是以下值之一:Alert.OKAlert.CANCELAlert.YESAlert.NO

返回

所创建的 Alert 实例。

说明

方法(类);显示带有消息、可选标题、可选按钮和可选图标的 Alert 窗口的类(静态)方法。Alert 的标题显示在窗口的顶部,并且靠左对齐。图标显示在消息文本的左边。按钮显示在消息文本和图标下方的中间位置。

示例

以下代码显示一个带有"确定"按钮的 Alert 模式窗口的简单范例。

mx.controls.Alert.show("Hello, world!");

以下代码定义一个 click 处理函数,它将有关所单击按钮的消息发送到"输出"面板。(要使此代码显示警告,库中必须具有一个 Alert 组件;要向库中添加该组件,请将其拖到舞台上,然后将其删除):

import mx.controls.Alert;

// 定义按钮动作。
var myClickHandler:Function = function (evt_obj:Object) {
 if (evt_obj.detail == Alert.OK) {
  trace(Alert.okLabel);
 } else if (evt_obj.detail == Alert.CANCEL) {
  trace(Alert.cancelLabel);
 }
};

// 显示对话框。
var dialog_obj:Object = Alert.show("Test Alert", "Test", Alert.OK | Alert.CANCEL, null, myClickHandler, "testIcon", Alert.OK);