Пакет | spark.components |
Класс | public class ButtonBar |
Наследование | ButtonBar ButtonBarBase ListBase SkinnableDataContainer SkinnableContainerBase SkinnableComponent UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Реализует | IFocusManagerComponent |
Подклассы | AXMBreadCrumb, AXMButtonBar |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Как правило, панель кнопок используется для группировки ряда связанных кнопок. Это придает им единообразный вид и единое управление и позволяет обрабатывать логику события change
в рамках одной панели.
Элемент управления ButtonBar Button создает элементы управления Button в зависимости от значения свойства dataProvider
. Используйте такие методы как addItem()
и removeItem()
для управления свойствомdataProvider
для добавления и удаления элементов данных. Элемент управления ButtonBar автоматически добавляет или удаляет требуемые нижестоящие элементы в зависимости от изменений свойства dataProvider
.
Чтобы использовать этот компонент в компоненте на основе списка, таком как List или DataGrid, следует создать средство визуализации элементов. Для получения информации о создании средства визуализации элементов см. раздел Пользовательские средства визуализации элементов Spark.
В проектах, которые не предназначены для мобильных устройств, с помощью элемента управления ButtonBar можно установить активный нижестоящий элемент контейнера ViewStack, как показано в следующем примере:
Примечание. Элементы управления Spark на основе списка (класс Spark ListBase и его подклассы, такие как ButtonBar, ComboBox, DropDownList, List и TabBar) не поддерживают класс BasicLayout в качестве значения свойства layout
. Не следует использовать BasicLayout с элементами управления Spark на основе списка.
<s:ButtonBar dataProvider="{myViewStack}" requireSelection="true" /> <mx:ViewStack id="myViewStack" borderStyle="solid"> <s:NavigatorContent id="search" label="Search"> <s:Label text="Search Screen"/> </s:NavigatorContent> <s:NavigatorContent id="custInfo" label="Customer Info"> <s:Label text="Customer Info"/> </s:NavigatorContent> <s:NavigatorContent id="accountInfo" label="Account Info"> <s:Label text="Account Info"/> </s:NavigatorContent> </mx:ViewStack>
Для элемента управления ButtonBar по умолчанию установлены следующие характеристики:
Характеристика | Описание |
---|---|
Размер по умолчанию | Достаточно большой, чтобы отобразить все кнопки |
Минимальный размер | 0 пикселей. |
Максимальный размер | Без ограничений |
Класс темы оформления по умолчанию | spark.skins.spark.ButtonBarSkin |
The <s:ButtonBar>
tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:ButtonBar />
Свойство MXML по умолчаниюdataProvider
Связанные элементы API
Метод | Определено | ||
---|---|---|---|
Конструктор. | ButtonBar | ||
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 | ||
[переопределить]
В случае с элементом данных возвращает правильный текст, который должен быть отображен средством визуализации с учетом свойств labelField и labelFunction. | ListBase | ||
Преобразует трехмерный объект 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 | ||
Обновляет средство визуализации для использования или повторного использования. | SkinnableDataContainer | ||
Проверяет правильность расположения и размера нижестоящих элементов и отображает различные визуальные эффекты. | UIComponent | ||
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его в случае необходимости. | UIComponent | ||
Используется в логике макета для проверки свойств компонента посредством вызова метода commitProperties(). | UIComponent | ||
Проверяет правильность измеренного размера компонента. Если совместно с данным IlayoutManagerClient вызван метод LayoutManager.invalidateSize(), то при измерении будет вызван метод validateSize(). | UIComponent | ||
Обрабатывает события valid и invalid из средства проверки, назначенного этому компоненту. | UIComponent | ||
Возвращает элементарное значение заданного объекта. | Object | ||
Возвращает матрицу прямоугольника, которая может быть передана передать в drawRoundRect() как параметр rot при рисовании вертикального градиента. | UIComponent | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher |
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
В этом компоненте используются темы оформления, состоящие из компонентов тем оформления. Непосредственную установку элементов темы оформления выполнять не требуется. Элементы темы оформления устанавливаются темой оформления компонента.
Компонент темы оформления | Описание | Определено | ||
---|---|---|---|---|
Обязательное: false Тип компонента: Статический Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Дополнительный элемент темы оформления, определяющий DataGroup в классе тем оформления, в котором помещаются, отображаются или располагаются элементы данных. | SkinnableDataContainer | |||
firstButton:IFactory | Обязательное: false Тип компонента: Динамический Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Элемент темы оформления, определяющий первую кнопку. IFactory должен возвращать объект типа. IVisualElement. | ButtonBar | ||
lastButton:IFactory | Обязательное: false Тип компонента: Динамический Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Элемент темы оформления, определяющий последнюю кнопку. IFactory должен возвращать объект типа. IVisualElement. | ButtonBar | ||
middleButton:IFactory | Обязательное: true Тип компонента: Динамический Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Элемент темы оформления, определяющий среднюю кнопку (кнопки). IFactory должен возвращать объект типа. IVisualElement. | ButtonBar |
Для установки темы оформления компонента реализуйте тему оформления, которая определяет следующие состояния. Несмотря на необходимость реализации всех состояний темы оформления, состояние темы оформления может быть пустым. Пустое состояние темы оформления указывает на отсутствие изменений темы оформления по умолчанию.
ButtonBar | () | Конструктор |
public function ButtonBar()
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
<?xml version="1.0"?> <!-- Simple example to demonstrate the Spark ButtonBar --> <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:Style> @namespace "library://ns.adobe.com/flex/spark"; ButtonBar ToggleButton:upAndSelected, ButtonBar ToggleButton:overAndSelected, ButtonBar ToggleButton:downAndSelected, ButtonBar ToggleButton:disabledAndSelected { chromeColor: #663366; color: #9999CC; } ButtonBar { chromeColor: #9999CC; color: #663366; } </fx:Style> <fx:Script> <![CDATA[ import spark.events.IndexChangeEvent; private function changeSelection(event:IndexChangeEvent): void { selectionText.text = "Selected Item: " + ButtonBar(event.target).selectedItem; } ]]> </fx:Script> <s:Panel title="Spark ButtonBar Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <s:Label text="Select an item below:" x="10" y="15" /> <s:ButtonBar id="viewMenu" requireSelection="true" x="10" y="40" width="320" change="changeSelection(event)"> <s:dataProvider> <s:ArrayCollection source="['Home', 'Rooms', 'Dining']" /> </s:dataProvider> </s:ButtonBar> <s:Label x="10" y="75" id="selectionText" /> </s:Panel> </s:Application>
Tue Jun 12 2018, 11:34 AM Z