Пакет | mx.controls |
Класс | public class CheckBox |
Наследование | CheckBox Button UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Реализует | IToggleButton |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Начиная с Flex 4.0, Adobe рекомендует вместо этого класса использовать класс spark.components.CheckBox. |
Элемент управления CheckBox состоит из дополнительной метки и небольшого поля, которое может содержать или не содержать флажок. Дополнительную текстовую метку можно поместить слева, справа, сверху или снизу от CheckBox. При щелчке по элементу управления CheckBox или по связанному с ним тексту состояние CheckBox изменяется с checked (флажок установлен) на unchecked (флажок удален) или наоборот. Элементы управления CheckBox включают набор значений true или false, которые не являются взаимоисключающими.
Элемент управления CheckBox имеет следующие характеристики по умолчанию:
Характеристика | Описание |
---|---|
Размер по умолчанию | Размер, достаточный для включения метки. |
Минимальный размер | 0 пикселей. |
Максимальный размер | Без ограничений |
The <mx:CheckBox>
tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<mx:CheckBox Styles disabledIconColor="0x999999" iconColor="0x2B333C" />
Общедоступные свойства
Защищенные свойства
Общедоступные методы
Метод | Определено | ||
---|---|---|---|
CheckBox()
Конструктор. | CheckBox | ||
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. | DisplayObjectContainer | ||
Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | ||
Добавляет клиент с невизуальным стилем в экземпляр компонента. | UIComponent | ||
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой point. | DisplayObjectContainer | ||
Ставит в очередь функцию для последующего вызова. | UIComponent | ||
Удаляет свойство style для экземпляра компонента. | UIComponent | ||
Определяет, является ли указанный объект отображения дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. | DisplayObjectContainer | ||
Преобразует объект Point из координат содержимого в глобальные координаты. | UIComponent | ||
Преобразует объект Point из координат содержимого в локальные координаты. | UIComponent | ||
Возвращает набор свойств, которые идентифицируют нижестоящий элемент в рамках этого контейнера. | UIComponent | ||
Возвращает набор свойств, которые идентифицируют нижестоящий элемент в рамках этого контейнера. | UIComponent | ||
Создает ссылку на id этого объекта IUIComponent в вышестоящем объекте документа. | UIComponent | ||
Удаляет ссылку на id этого объекта IUIComponent в вышестоящем объекте документа. | UIComponent | ||
Возвращается к объекту UITextFormat, соответствующему текстовым стилям для этого UIComponent. | UIComponent | ||
[переопределить]
Посылает событие в поток событий. | UIComponent | ||
Отображает или скрывает индикатор фокуса вокруг этого компонента. | UIComponent | ||
drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
Обеспечивает отображение прямоугольника в объекте Graphics указанной темы оформления программным способом. | UIComponent | ||
Вызывается экземпляром эффекта по завершении воспроизведения эффекта в компоненте. | UIComponent | ||
Вызывается экземпляром эффекта при запуске воспроизведения эффекта в компоненте. | UIComponent | ||
Завершает все воспроизводимые в настоящее время эффекты на компоненте. | UIComponent | ||
Выполняет все привязки, для которых объект UIComponent является адресом назначения. | UIComponent | ||
Вызывается после завершения печати. | UIComponent | ||
Предоставляет объект автоматизации с указанным индексом. | UIComponent | ||
Обеспечивает список объектов автоматизации. | UIComponent | ||
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | ||
Возвращает координату Х границ элемента для указанного размера элемента. | UIComponent | ||
Возвращает координату Y границ элемента при указанном размере элемента. | UIComponent | ||
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса. | DisplayObjectContainer | ||
Возвращает экземпляр дочернего экранного объекта с заданным именем. | DisplayObjectContainer | ||
Возвращает позицию индекса для экземпляра DisplayObject child. | DisplayObjectContainer | ||
Выполняет поиск селекторов типа для этого экземпляра UIComponent. | UIComponent | ||
Возвращает значение ограничения макета, идентичное значению получения стиля ограничения для этого компонента. | UIComponent | ||
Стандартный метод, позволяющий определить, использовать ли явную или измеренную высоту
| UIComponent | ||
Стандартный метод, позволяющий определить, использовать ли явную или измеренную ширину
| UIComponent | ||
Получает объект, который в настоящее время имеет фокус. | UIComponent | ||
Возвращает высоту макета элемента. | UIComponent | ||
Возвращает ширину макета элемента. | UIComponent | ||
Возвращает координату Х, используемую элементом для отображения на экране. | UIComponent | ||
Возвращает координату Y, используемую элементом для отображения на экране. | UIComponent | ||
Возвращает матрицу преобразования, используемую для определения макета компонента относительно соответствующих элементов одного уровня. | UIComponent | ||
Возвращает преобразование макета Matrix3D для этого элемента. | UIComponent | ||
Возвращает максимальную высоту элемента. | UIComponent | ||
Возвращает максимальную ширину элемента. | UIComponent | ||
Возвращает минимальную высоту элемента. | UIComponent | ||
Возвращает минимальную ширину элемента. | UIComponent | ||
Возвращает массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
Возвращает предпочтительную высоту элемента. | UIComponent | ||
Возвращает предпочтительную ширину элемента. | UIComponent | ||
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | DisplayObject | ||
Возвращает элемент в dataProvider, использованный указанным Repeater для создания этого Repeater, или null, если повторение этого Repeater не выполнено. | UIComponent | ||
Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента. | UIComponent | ||
Преобразует объект Point из глобальных координат в координаты содержимого. | UIComponent | ||
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | DisplayObject | ||
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные). | DisplayObject | ||
Возвращает true, если для currentCSSState не указано значение null. | UIComponent | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Определяет, было ли указанное состояние задано в данном UIComponent. | UIComponent | ||
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | DisplayObject | ||
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | ||
Возвращает матрицу прямоугольника, которая может быть передана в метод drawRoundRect() метод как параметр rot при рисовании горизонтального градиента. | UIComponent | ||
Инициализирует внутреннюю структуру этого компонента. | UIComponent | ||
Инициализирует разные свойства, которые отслеживают повторенные экземпляры этого компонента. | UIComponent | ||
Отмечает компонент с целью вызова его метода updateDisplayList() во время последующего обновления экрана. | UIComponent | ||
Вызывается элементами компонента для указания, что свойство depth было изменено. | UIComponent | ||
Элемент должен вызывать этот метод при изменении своего layoutDirection или при изменении своего вышестоящего layoutDirection. | UIComponent | ||
Отмечает компонент с целью вызова его метода commitProperties() во время последующего обновления экрана. | UIComponent | ||
Отмечает компонент с целью вызова его метода measure() во время последующего обновления экрана. | UIComponent | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными). | DisplayObject | ||
Преобразует объект Point из координат содержимого в локальные координаты. | UIComponent | ||
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | ||
Возвращает значение true, если cssState совпадает с currentCSSState. | UIComponent | ||
Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом). | UIComponent | ||
Выполняет измерения для указанного текста HTML, который может содержать HTML-теги, например <font> и <b>. При этом предполагается, что текст отображается в однострочном поле UITextField при помощи объекта UITextFormat, определяемого стилями этого UIComponent. | UIComponent | ||
Выполняет измерения для указанного текста. При этом предполагается, что текст отображается в однострочном поле UITextField (или UIFTETextField) при помощи объекта UITextFormat, определяемого стилями этого UIComponent. | UIComponent | ||
Перемещает компонент в указанное положение в пределах его вышестоящего элемента. | UIComponent | ||
Обеспечивает распространение изменений стиля для нижестоящих элементов. | UIComponent | ||
Возвращает значение true, если цепочка свойств owner направлена от child к этому UIComponent. | UIComponent | ||
Вызывается Flex при добавлении или удалении объекта UIComponent из вышестоящего элемента. | UIComponent | ||
Готовит IFlexDisplayObject к печати. | UIComponent | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Создает или восстанавливает кэш стиля CSS для этого компонента и, если параметр recursive является true, также для всех нижестоящих элементов этого компонента. | UIComponent | ||
Обеспечить регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта. | UIComponent | ||
Удаляет заданный объект child DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
Удаляет дочерний DisplayObject из заданной позиции индекса в списке дочерних элементов DisplayObjectContainer. | DisplayObjectContainer | ||
Удаляет все дочерние экземпляры DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | ||
Удаляет клиент с невизуальным стилем из экземпляра компонента. | UIComponent | ||
Воспроизводит указанное событие. | UIComponent | ||
Вызывает виртуальную клавиатуру. | InteractiveObject | ||
Определяет нижестоящий элемент с помощью предоставленного идентификатора. | UIComponent | ||
[статические]
Возобновляет фоновую обработку методов, поставленных в очередь callLater() после вызова suspendBackgroundProcessing(). | UIComponent | ||
Размеры объекта. | UIComponent | ||
Изменяет положение существующего дочернего элемента в DisplayObjectContainer. | DisplayObjectContainer | ||
Устанавливает значение ограничения макета, совпадающее со значением стиля ограничения для этого компонента. | UIComponent | ||
Установить текущее состояние. | UIComponent | ||
Задает фокус на этот компонент. | UIComponent | ||
Устанавливает координаты, используемые элементом для отображения на экране. | UIComponent | ||
Устанавливает размер макета элемента. | UIComponent | ||
Устанавливает матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня. | UIComponent | ||
Устанавливает трехмерную матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня. | UIComponent | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Задает свойство style для экземпляра компонента. | UIComponent | ||
Вызывается при изменении свойства visible. | UIComponent | ||
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). | Sprite | ||
Позволяет перетаскивать указанный спрайт на устройстве с сенсорным экраном. | Sprite | ||
Рекурсивно останавливает выполнение временной шкалы всех фрагментов MovieClip, размещенных в корне этого объекта. | DisplayObjectContainer | ||
Завершает метод startDrag(). | Sprite | ||
Завершает выполнение метода startTouchDrag(), используется для устройств с сенсорным экраном. | Sprite | ||
Обеспечивает обнаружение изменений в свойствах стиля. | UIComponent | ||
Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента. | UIComponent | ||
[статические]
Блокирует фоновую обработку методов, поставленных в очередь callLater() до вызова resumeBackgroundProcessing(). | UIComponent | ||
Меняет местами (в порядке «от начала к концу») два заданных дочерних объекта. | DisplayObjectContainer | ||
Меняет местами (в порядке «от начала к концу») дочерние объекты, расположенные в двух заданных позициях индекса в списке дочерних элементов. | DisplayObjectContainer | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
[переопределить]
Возвращает строку, указывающую расположение этого объекта в иерархии объектов DisplayObject в приложении. | FlexSprite | ||
transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
Служебный метод для обновления вращения, масштабирования и перемещения преобразования при сохранении определенной точки, указанной в собственной области координат компонента, зафиксированной в области координат вышестоящего элемента. | UIComponent | ||
Служебный метод для преобразования точки, указанной в локальных координатах этого объекта, к ее местоположению в координатах вышестоящего узла объекта. | UIComponent | ||
Проверяет правильность расположения и размера нижестоящих элементов и отображает различные визуальные эффекты. | UIComponent | ||
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его в случае необходимости. | UIComponent | ||
Используется в логике макета для проверки свойств компонента посредством вызова метода commitProperties(). | UIComponent | ||
Проверяет правильность измеренного размера компонента. Если совместно с данным IlayoutManagerClient вызван метод LayoutManager.invalidateSize(), то при измерении будет вызван метод validateSize(). | UIComponent | ||
Обрабатывает события valid и invalid из средства проверки, назначенного этому компоненту. | UIComponent | ||
Возвращает элементарное значение заданного объекта. | Object | ||
Возвращает матрицу прямоугольника, которая может быть передана передать в drawRoundRect() как параметр rot при рисовании вертикального градиента. | UIComponent | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher |
События
Стили
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
Общие стили
Стили тем Spark
Стиль | Описание | Определено | ||
---|---|---|---|---|
Тип: uint Формат: Color Наследование CSS: Да Тема: spark Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Цвет, применяемый к кнопке при значении true для выделенного флажка. | Button | |||
Тип: uint Формат: Color Наследование CSS: Да Тема: spark Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Основной цвет компонента. | UIComponent | |||
Тип: Number Формат: Length Наследование CSS: Нет Тема: halo, spark Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Радиус углов компонента. | Button | |||
Тип: uint Формат: Color Наследование CSS: Да Тема: spark Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Цвет кольца фокуса, если компонент находится в фокусе | Button | |||
symbolColor | Тип: uint Формат: Color Наследование CSS: Да Тема: spark Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Цвет любого символа компонента. Примеры включают флажок элемента управления CheckBox или стрелку на кнопке элемента управления ScrollBar. Значением по умолчанию является 0x000000 . | CheckBox |
Стили тем Гало
Стиль | Описание | Определено | ||
---|---|---|---|---|
Тип: uint Формат: Color Наследование CSS: Нет Тема: halo Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Цвет границы. | Button | |||
Тип: Number Формат: Length Наследование CSS: Нет Тема: halo, spark Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Радиус углов компонента. | Button | |||
disabledIconColor | Тип: uint Формат: Color Наследование CSS: Да Тема: halo Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Цвет значка в деактивированной теме оформления. Например, этот стиль используется классом тем оформления CheckBoxIcon для отображения галочки в деактивированном элементе управления CheckBox, классом ComboBoxSkin для отображения стрелки вниз деактивированного элемента управления ComboBox и классом тем оформления DateChooserMonthArrowSkin для отображения стрелки месяца в деактивированном элементе управления DateChooser. Значение по умолчанию зависит от класса компонента; если оно не переопределяется классом, значением по умолчанию является 0x999999 .
| CheckBox | ||
Тип: Array Наследование CSS: Нет Тема: halo Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Альфа-каналы, используемые для заливки фона элементов управления. | Button | |||
Тип: Array Формат: Color Наследование CSS: Нет Тема: halo Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Цвета, используемые для определения оттенка заливки фона элемента управления. | Button | |||
Тип: Array Наследование CSS: Нет Тема: halo Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Альфа-прозрачность, используемая для заливки выделения цветом элементов управления. | Button | |||
iconColor | Тип: uint Формат: Color Наследование CSS: Да Тема: halo Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Цвет значка в теме оформления. Например, этот стиль используется классом тем оформления CheckBoxIcon для отображения галочки в элементе управления CheckBox, классом ComboBoxSkin для отображения стрелки вниз в элементе управления ComboBox и классом тем оформления DateChooserMonthArrowSkin для отображения стрелки месяца в элементе управления DateChooser. Значение по умолчанию зависит от класса компонента; если оно не переопределяется классом, значением по умолчанию является 0x111111 .
| CheckBox | ||
Тип: uint Формат: Color Наследование CSS: Да Тема: halo Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Цвет темы компонента. | UIComponent |
Эффекты
Общедоступные константы
Сведения о конструкторе
CheckBox | () | Конструктор |
public function CheckBox()
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
Примеры Использование этого примера
CheckBoxExample.mxml
<?xml version="1.0"?> <!-- Simple example to demonstrate the Halo CheckBox control --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx"> <fx:Script> <![CDATA[ import mx.controls.Alert; // This event handler adds and deletes items from the shopping cart. private function modifyCart():void { cartItems.text = ""; if(milkCB.selected) { cartItems.text += "milk" + "\n"; } if(eggsCB.selected) { cartItems.text += "eggs" + "\n"; } if(breadCB.selected) { cartItems.text +="bread" + "\n"; } } // This event handler opens the Halo Alert control. private function sendMessage():void { if(couponCB.selected) { Alert.show("You will receive coupons."); } else { Alert.show("You will not receive any coupons."); } } ]]> </fx:Script> <s:Panel title="Halo CheckBox Control Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <s:HGroup left="10" right="10" top="10" bottom="10"> <s:VGroup> <mx:CheckBox id="milkCB" label="milk" click="modifyCart();"/> <mx:CheckBox id="eggsCB" label="eggs" click="modifyCart();"/> <mx:CheckBox id="breadCB" label="bread" click="modifyCart();"/> </s:VGroup> <s:VGroup> <s:Label text="Items in my cart "/> <s:TextArea id="cartItems" width="300" height="50" verticalScrollPolicy="off"/> <!-- Event handler sendMessages() is used to handle event click --> <mx:CheckBox id="couponCB" label="Send me coupons for items in my cart" click="sendMessage();" selected="true" color="blue"/> </s:VGroup> </s:HGroup> </s:Panel> </s:Application>
Tue Jun 12 2018, 11:34 AM Z