Пакет | spark.components |
Класс | public class CheckBox |
Наследование | CheckBox ToggleButtonBase ButtonBase SkinnableComponent UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Подклассы | AXMCheckBox |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
При щелчке пользователя на компоненте CheckBox или его связанном тексте компонент CheckBox устанавливает для своего свойства selected
значение true
для случая установленного флажка и значение false
для случая удаленного флажка.
Чтобы использовать этот компонент в компоненте на основе списка, таком как List или DataGrid, следует создать средство визуализации элементов. Для получения информации о создании средства визуализации элементов см. раздел Пользовательские средства визуализации элементов Spark.
Элемент управления CheckBox имеет следующие характеристики по умолчанию:
Характеристика | Описание |
---|---|
Размер по умолчанию | Имеет достаточную ширину для отображения текстовой метки элемента управления |
Минимальный размер | 18 пикселей в ширину и 18 пикселей в высоту |
Максимальный размер | 10000 пикселей в ширину и 10000 пикселей в высоту |
Класс темы оформления по умолчанию | spark.skins.spark.CheckBoxSkin |
The <s:CheckBox>
tag inherits all of the tag
attributes of its superclass and adds the following attributes:
<s:CheckBox Properties symbolColor="0x000000" />
Свойство MXML по умолчаниюlabel
Связанные элементы API
Метод | Определено | ||
---|---|---|---|
CheckBox()
Конструктор. | CheckBox | ||
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 | ||
Выполняет поиск селекторов типа для этого экземпляра 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 | ||
Отмечает компонент с целью установки нового состояния темы оформления во время последующего обновления экрана. | SkinnableComponent | ||
Показывает, есть ли экземпляр класса 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 | ||
Удаляет все дочерние экземпляры DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | ||
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | ||
Удаляет клиент с невизуальным стилем из экземпляра компонента. | UIComponent | ||
Воспроизводит указанное событие. | UIComponent | ||
Вызывает виртуальную клавиатуру. | InteractiveObject | ||
Определяет нижестоящий элемент с помощью предоставленного идентификатора. | UIComponent | ||
[статические]
Возобновляет фоновую обработку методов, поставленных в очередь callLater() после вызова suspendBackgroundProcessing(). | UIComponent | ||
Размеры объекта. | UIComponent | ||
Устанавливает значение ограничения макета, совпадающее со значением стиля ограничения для этого компонента. | 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 | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | 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 |
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
Стиль | Описание | Определено | ||
---|---|---|---|---|
Тип: uint Формат: Color Наследование CSS: Да Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Основной цвет компонента. | SkinnableComponent | |||
Тип: Number Наследование CSS: Нет Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Альфа-канал кольца фокуса для данного компонента. | ButtonBase | |||
Тип: uint Формат: Color Наследование CSS: Да Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Цвет кольца фокуса при наведении фокуса на компонент. | ButtonBase | |||
symbolColor | Тип: uint Формат: Color Наследование CSS: Да Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Цвет любого символа компонента. Примером является флажок элемента управления CheckBox или стрелка на кнопке прокрутки. Значением по умолчанию является 0x000000 . | CheckBox |
Стиль | Описание | Определено | ||
---|---|---|---|---|
Тип: uint Формат: Color Наследование CSS: Да Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Основной цвет компонента. | SkinnableComponent | |||
Тип: Number Наследование CSS: Нет Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Альфа-канал кольца фокуса для данного компонента. | ButtonBase | |||
Тип: uint Формат: Color Наследование CSS: Да Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Цвет кольца фокуса при наведении фокуса на компонент. | ButtonBase | |||
iconPlacement | Тип: String Наследование CSS: Нет Тема: mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Ориентация значка по отношению к метке. Допустимыми значениями в MXML являются right , left , bottom и top .
В ActionScript для установки значения этого свойства используются следующие константы: IconPlacement.LEFT . | CheckBox | ||
Тип: Number Формат: Length Наследование CSS: Да Тема: mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash10.1, AIR 2.0 Дополнительный вертикальный пробел между строками текста. | ButtonBase | |||
Тип: Number Наследование CSS: Да Тема: mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash10.1, AIR 2.0 Число дополнительных пикселей, отображаемых между символами. | ButtonBase | |||
symbolColor | Тип: uint Формат: Color Наследование CSS: Да Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Цвет любого символа компонента. Примером является флажок элемента управления CheckBox или стрелка на кнопке прокрутки. Значением по умолчанию является 0x000000 . | CheckBox |
В этом компоненте используются темы оформления, состоящие из компонентов тем оформления. Непосредственную установку элементов темы оформления выполнять не требуется. Элементы темы оформления устанавливаются темой оформления компонента.
Для установки темы оформления компонента реализуйте тему оформления, которая определяет следующие состояния. Несмотря на необходимость реализации всех состояний темы оформления, состояние темы оформления может быть пустым. Пустое состояние темы оформления указывает на отсутствие изменений темы оформления по умолчанию.
CheckBox | () | Конструктор |
public function CheckBox()
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
<?xml version="1.0"?> <!-- Simple example to demonstrate the Spark 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[ [Bindable] public var totalCost:Number = 4.50; // This event handler adds/removes the cost of condiments to/from the total cost. private function modifyBurger(evt:MouseEvent):void { // Add 0.25 to the total cost for every condiment. Delete 0.25 for // every condiment removed. if(CheckBox(evt.target).selected) { totalCost += 0.25; } else { totalCost -= 0.25; } // Format the totalCost and then display it in a label. totalString.text = usdFormatter.format(totalCost); } ]]> </fx:Script> <fx:Declarations> <mx:CurrencyFormatter id="usdFormatter" precision="2" currencySymbol="$" decimalSeparatorFrom="." decimalSeparatorTo="." useNegativeSign="true" useThousandsSeparator="true" alignSymbol="left"/> </fx:Declarations> <s:Panel title="Spark CheckBox Control Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <s:VGroup left="10" right="10" top="10" bottom="10"> <s:Label text="Hamburger Base Price: $4.50" /> <s:Label text="Select condiments for your hamburger (0.25 each):" /> <s:CheckBox id="lettuceCB" label="Pickles" click="modifyBurger(event);"/> <s:CheckBox id="tomatoCB" label="Tomato" click="modifyBurger(event);"/> <s:CheckBox id="pickleCB" label="Lettuce" click="modifyBurger(event);"/> <s:CheckBox id="mayoCB" label="Mayonnaise" click="modifyBurger(event);"/> <mx:Spacer height="20" /> <s:HGroup> <s:Label text="Total Price: " /> <s:Label id="totalString" text="$4.50"/> </s:HGroup> </s:VGroup> </s:Panel> </s:Application>
Tue Jun 12 2018, 11:34 AM Z