CheckBox 类

ActionScript 类名称 mx.controls.CheckBox

CheckBox 类的属性允许您在运行时创建一个文本标签，并将其放置在复选框的左部、右部、上部或下部。

使用 ActionScript 设置 CheckBox 类的属性将会覆盖在"属性"检查器或"组件"检查器中设置的同名参数。

CheckBox 组件使用焦点管理器覆盖默认的 Flash Player 焦点矩形，并绘制一个带圆角的自定义焦点矩形。有关更多信息，请参见"使用组件"中的创建自定义焦点导航。

每个组件类都有一个 version 属性，该属性是一个类属性。类属性只能用于该类本身。version 属性会返回一个字符串，该字符串指示组件的版本。若要访问此属性，请使用以下代码：

trace(mx.controls.CheckBox.version);

注意

代码 trace(myCheckBoxInstance.version); 返回 undefined。

CheckBox 类的方法摘要

没有 CheckBox 类专用的方法。

下表列出了 CheckBox 类从 UIObject 类继承的方法。从 CheckBox 对象调用这些方法时，请使用 checkBoxInstance.methodName 的形式。

方法	说明
UIObject.createClassObject()	创建指定类的对象。
UIObject.createObject()	创建对象的子对象。
UIObject.destroyObject()	销毁组件实例。
UIObject.doLater()	在"属性"检查器和"组件"检查器中设置了参数之后，调用一个函数。
UIObject.getStyle()	从样式声明或对象中获取样式属性。
UIObject.invalidate()	标记对象使其在到达下一个帧间隔时进行重绘。
UIObject.move()	将对象移动到要求的位置。
UIObject.redraw()	迫使对象有效以便能在当前帧中绘制。
UIObject.setSize()	将对象调整为所要求的大小。
UIObject.setSkin()	设置对象的外观。
UIObject.setStyle()	设置样式声明或对象内的样式属性。

下表列出了 CheckBox 类从 UIComponent 类继承的方法。从 CheckBox 对象调用这些方法时，请使用 checkBoxInstance.methodName 的形式。

方法	说明
UIComponent.getFocus()	返回对具有焦点的对象的引用。
UIComponent.setFocus()	将焦点设置到组件实例中。

下表列出了 CheckBox 类的属性。

属性	说明
CheckBox.label	指定在复选框旁边出现的文本。
CheckBox.labelPlacement	指定标签文本相对于复选框的方向。
CheckBox.selected	指定复选框是处于选中状态 (`true`) 还是处于取消选中状态 (`false`)。

下表列出了 CheckBox 类从 UIObject 类继承的属性。从 CheckBox 对象访问这些属性时，请使用 checkBoxInstance.propertyName 的形式。

属性	说明
UIObject.bottom	只读；对象的底边缘位置（相对于其父对象的底边缘）。
UIObject.height	只读；对象的高度，以像素为单位。
UIObject.left	只读；对象的左边缘（以像素为单位）。
UIObject.right	只读；对象的右边缘位置（相对于其父对象的右边缘）。
UIObject.scaleX	一个数字，它指示对象相对于其父对象在 x 方向上的缩放因子。
UIObject.scaleY	一个数字，它指示对象相对于其父对象在 y 方向上的缩放因子。
UIObject.top	只读；对象上边缘的位置（相对于其父对象）。
UIObject.visible	一个布尔值，它指示对象是可见的 (`true`) 还是不可见的 (`false`)。
UIObject.width	只读；对象的宽度，以像素为单位。
UIObject.x	只读；对象的左边缘（以像素为单位）。
UIObject.y	只读；对象的上边缘（以像素为单位）。

下表列出了 CheckBox 类从 UIComponent 类继承的属性。从 CheckBox 对象访问这些属性时，请使用 checkBoxInstance.propertyName 的形式。

属性	说明
UIComponent.enabled	指明组件是否可以接收焦点和输入。
UIComponent.tabIndex	一个数字，指明文档中组件的 Tab 键顺序。

下表列出了 CheckBox 类从 SimpleButton 类继承的属性。从 CheckBox 对象访问这些属性时，请使用 checkBoxInstance.propertyName 的形式。

属性	说明
SimpleButton.emphasized	指示按钮是否具有默认普通按钮的外观。
SimpleButton.emphasizedStyleDeclaration	当 `emphasized` 属性设置为 `true` 时的样式声明。
SimpleButton.selected	一个布尔值，它指示按钮处于选中状态 (`true`) 还是未处于选中状态 (`false`)。默认值为 `false`。
SimpleButton.toggle	一个布尔值，它指示按钮的行为与切换开关相同 (`true`) 还是不同 (`false`)。默认值为 `false`。

下表列出了 CheckBox 类从 Button 类继承的属性。从 CheckBox 对象访问这些属性时，请使用 checkBoxInstance.propertyName 的形式。

属性	说明
Button.label	指定在按钮上显示的文本。
Button.labelPlacement	指定标签文本相对于图标的方向。

下表列出了 CheckBox 类的一个事件。

事件	说明
CheckBox.click	在复选框上单击（松开）鼠标时，或者如果复选框具有焦点并按下空格键时触发。

下表列出了 CheckBox 类从 UIObject 类继承的事件。

下表列出了 CheckBox 类从 UIComponent 类继承的事件。

下表列出了 CheckBox 类从 SimpleButton 类继承的事件。

事件	说明
SimpleButton.click	单击一个按钮时广播。