CheckBox.click

可用性

Flash Player 6 (6.0.79.0)。

版本

Flash MX 2004。

用法

用法 1:

var listenerObject:Object = new Object();
listenerObject.click = function(eventObject:Object) {
    // ...
};
checkBoxInstance.addEventListener("click", listenerObject);

用法 2:

on (click) {
    // ...
}

描述

事件;在复选框上单击(松开)鼠标时,或者如果复选框具有焦点并按下了空格键时,向所有已注册的侦听器广播。

第一个用法示例使用一个调度程序/侦听器事件模型。组件实例 (checkBoxInstance) 调度一个事件(在本例中为 click),而该事件由您创建的侦听器对象 (listenerObject) 上的函数(也称作"处理函数")处理。您需要定义一个与侦听器对象上的事件同名的方法;当该事件被触发时,就会调用该方法。该事件被触发时,它会自动将一个事件对象 (eventObject) 传递到侦听器对象方法。该事件对象的属性包含有关事件的信息。您可以使用这些属性来编写处理该事件的代码。最后,对广播该事件的组件实例调用 addEventListener() 方法(请参阅 EventDispatcher.addEventListener()),以将侦听器注册到该实例。当该实例调度该事件时,就会调用该侦听器。

有关详细信息,请参阅"EventDispatcher 类"

第二个用法示例使用一个 on() 处理函数,并且必须直接附加到一个 CheckBox 实例。在附加到组件的 on() 处理函数内部使用的关键字 this 是指该组件实例。例如,以下代码附加到复选框 myCheckBox,它将"_level0.myCheckBox"发送到"输出"面板:

on (click) {
    trace(this);
}

示例

以下示例在复选框被选中时会启用按钮。此示例假定舞台上具有一个名为 submit_button 的 Button 组件实例以及一个名为 agree_ch 的 CheckBox 组件实例。向主时间轴的第一帧中添加以下代码:

agree_ch.label = "I agree";
submit_button.enabled = false;

// 创建侦听器对象。
var form_obj:Object = new Object();

// 为侦听器对象分配函数。
form_obj.click = function(event_obj:Object) {
 submit_button.enabled = event_obj.target.selected;
};

// 添加侦听器。
agree_ch.addEventListener("click", form_obj);

以下代码也会在 checkBoxInstance 被单击时向"输出"面板发送消息。on() 处理函数必须直接附加到 checkBoxInstance

on (click) {
    trace("check box component was clicked");
}

请参阅

EventDispatcher.addEventListener()