RadioButtonGroup

Пакет	spark.components
Класс	public class RadioButtonGroup
Наследование	RadioButtonGroup EventDispatcher Object
Реализует	IMXMLObject

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Компонент RadioButtonGroup определяет группу компонентов RadioButton, которая рассматривается как единый компонент с взаимоисключающими вариантами выбора. Таким образом, единовременно можно выбрать только один компонент RadioButton. Свойство id требуется при использовании тега <s:RadioButtonGroup> для определения имени группы. Любой компонент <s:RadioButton>, добавленный в эту группу, получит имя группы.

Обратите внимание, что компонент RadioButtonGroup является подклассом EventDispatcher, а не UIComponent, и реализует интерфейс IMXMLObject. Все остальные визуальные компоненты Flex реализуют интерфейс IVisualElement. Объявление компонента RadioButtonGroup должно содержаться в пределах тега <Declarations>, т.к. оно не может быть присвоено IVisualElement.

Чтобы использовать этот компонент в компоненте на основе списка, таком как List или DataGrid, следует создать средство визуализации элементов. Для получения информации о создании средства визуализации элементов см. раздел Пользовательские средства визуализации элементов Spark.

Синтаксис MXML expanded

Скрыть синтаксис MXML

The <s:RadioButtonGroup> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <s:RadioButtonGroup
    Properties
    enabled="true"
    selectedValue="null"
    selection="null"
 
    Events
    change="No default"
    itemClick="No default"
    valueCommit="No default"
  />

Посмотреть примеры

Связанные элементы API

spark.components.RadioButton

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		enabled : Boolean Определяет, разрешен выбор или нет.	RadioButtonGroup
		numRadioButtons : int [только для чтения] Число элементов RadioButton, принадлежащих этой RadioButtonGroup.	RadioButtonGroup
		selectedValue : Object Свойство value выбранного компонента RadioButton в группе, если таковое было установлено, в противном случае – свойство label выбранного переключателя RadioButton.	RadioButtonGroup
		selection : RadioButton Содержит ссылку на текущий выбранный компонент RadioButton в группе.	RadioButtonGroup

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		RadioButtonGroup(document:IFlexDisplayObject = null) Конструктор.	RadioButtonGroup
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		getRadioButtonAt(index:int):RadioButton Возвращает компонент RadioButton из заданной позиции индекса.	RadioButtonGroup
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		initialized(document:Object, id:String):void Реализация метода IMXMLObject.initialized() для поддержки отложенной реализации.	RadioButtonGroup
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
change	Передается при изменении значения выбранного компонента RadioButton в этой группе.	RadioButtonGroup
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
itemClick	Передается при выборе компонента RadioButton в группе.	RadioButtonGroup
valueCommit	Отправляется при изменении значений программным способом или в результате действий пользователя.	RadioButtonGroup

Сведения о свойстве

enabled

свойство

enabled:Boolean

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Определяет, разрешен выбор или нет. Следует отметить, что возвращаемое значение отражает только значение, которое было явно установлено в RadioButtonGroup, и не отражает любые значения, установленные явно на отдельных переключателях RadioButton.

Значением по умолчанию является true.

Реализация
public function get enabled():Boolean
public function set enabled(value:Boolean):void

numRadioButtons

свойство

numRadioButtons:int [только для чтения]

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Число элементов RadioButton, принадлежащих этой RadioButtonGroup.

Значением по умолчанию является "0".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие numRadioButtonsChanged .

Реализация
public function get numRadioButtons():int

selectedValue

свойство

selectedValue:Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Свойство value выбранного компонента RadioButton в группе, если таковое было установлено, в противном случае – свойство label выбранного переключателя RadioButton. При отсутствии выбранного элемента RadioButton для этого свойства устанавливается значение null.

В компоненте Flex при установке значения selectedValue выбирается первый компонент RadioButton со свойством value или label, соответствующим этому значению.

Значением по умолчанию является null.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие valueCommit .

Реализация
public function get selectedValue():Object
public function set selectedValue(value:Object):void

selection

свойство

selection:RadioButton

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Содержит ссылку на текущий выбранный компонент RadioButton в группе. Можно получить доступ к данному свойству только в ActionScript; установка в MXML не предусмотрена. Установка этого свойства как null отменяет выбор текущего компонента RadioButton. Событие изменения не отправляется.

Значением по умолчанию является null.

Реализация
public function get selection():RadioButton
public function set selection(value:RadioButton):void

Сведения о конструкторе

()

Конструктор

public function RadioButtonGroup(document:IFlexDisplayObject = null)

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Конструктор.

Параметры

document:IFlexDisplayObject (default = null) — В простых случаях, когда класс расширяет EventDispatcher, не следует использовать параметрdocument.

Связанные элементы API

flash.events.EventDispatcher

Сведения о методе

getRadioButtonAt

()

метод

public function getRadioButtonAt(index:int):RadioButton

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Возвращает компонент RadioButton из заданной позиции индекса.

Параметры

index:int — Индекс RadioButton на основе 0 в RadioButtonGroup.

Возвращает

RadioButton — Указанный компонент RadioButton, если индекс находится между 0 и numRadioButtons – 1. Возвращает null, если индекс является недействительным.

Связанные элементы API

numRadioButtons

initialized

()

метод

public function initialized(document:Object, id:String):void

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Реализация метода IMXMLObject.initialized() для поддержки отложенной реализации.

Параметры

	`document:Object` — Документ MXML, создавший этот объект.

	`id:String` — Идентификатор, используемый document в качестве ссылки на этот объект. Если объект представляет собой глубокое свойство в документе, `id` равно null.

Связанные элементы API

mx.core.IMXMLObject

Сведения о событии

change

Событие

Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.CHANGE

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Передается при изменении значения выбранного компонента RadioButton в этой группе.

Константа Event.CHANGE определяет значение свойства type объекта события change.

Это событие имеет следующие свойства:

Свойство	Значение
`bubbles`	`true`
`cancelable`	`false`; поведение по умолчанию, подлежащее отмене, не определено.
`currentTarget`	Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
`target`	Объект, значение которого было изменено. Свойство `target` не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство `currentTarget` для обращения к объекту в списке отображения, обрабатывающему событие в данный момент.

itemClick

Событие

Тип объекта события: mx.events.ItemClickEvent
свойство ItemClickEvent.type = mx.events.ItemClickEvent.ITEM_CLICK

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Передается при выборе компонента RadioButton в группе. Можно также указать обработчик для отдельных компонентов RadioButton. Это событие отправляется только при взаимодействии пользователя с переключателями с помощью мыши.

Константа ItemClickEvent. ITEM_CLICK определяет значение свойства type объекта события itemClick.

Свойства объекта события имеют следующие значения:

Свойство	Значение
`bubbles`	false
`cancelable`	false
`currentTarget`	Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется `myButton.addEventListener()` для регистрации прослушивателя события, значением `currentTarget` является myButton.
`index`	Индекс элемента навигации, который был выбран.
`item`	Элемент в поставщике данных элемента навигации, который был выбран.
`label`	Метка элемента навигации, которая была выбрана.
`relatedObject`	Нижестоящий объект, сгенерировавший это событие.
`target`	Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство `currentTarget` всегда используется для получения доступа к объекту, прослушивающему событие.

valueCommit

Событие

Тип объекта события: mx.events.FlexEvent
свойство FlexEvent.type = mx.events.FlexEvent.VALUE_COMMIT

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

Отправляется при изменении значений программным способом или в результате действий пользователя.

Поскольку программное изменение инициирует это событие, убедитесь, что ни один обработчик события valueCommit не изменяет значение, вызывающее другое событие valueCommit. Например, не изменяйте свойство selectedValue или selection в обработчике событий valueCommit.

Константа FlexEvent.VALUE_COMMIT определяет значение свойства type объекта события valueCommit.

Свойства объекта события имеют следующие значения:

Свойство	Значение
`bubbles`	false
`cancelable`	false
`currentTarget`	Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется `myButton.addEventListener()` для регистрации прослушивателя события, значением `currentTarget` является myButton.
`target`	Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство `currentTarget` всегда используется для получения доступа к объекту, прослушивающему событие.

Примеры Использование этого примера

RadioButtonGroupExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<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;
            import mx.events.ItemClickEvent;
            
            private function handlePayment(event:ItemClickEvent):void {
                if (event.currentTarget.selectedValue == "check") {
                    Alert.show("You opted to pay by check."); 
                } else if (event.currentTarget.selectedValue == "credit") {
                    Alert.show("You opted to pay by credit card.");
                }
            }
        ]]>
    </fx:Script>
    
    <fx:Declarations>
        <s:RadioButtonGroup id="paymentType" itemClick="handlePayment(event);"/>
    </fx:Declarations>
    <s:VGroup paddingLeft="10" paddingTop="10">
        <s:RadioButton groupName="paymentType" 
                       id="payCheck" 
                       value="check" 
                       label="Pay by check" 
                       width="150"/>
        <s:RadioButton groupName="paymentType" 
                       id="payCredit" 
                       value="credit" 
                       label="Pay by credit card" 
                       width="150"/>
    </s:VGroup>
</s:Application>

Юридическая информация | Политика конфиденциальности онлайн

RadioButtonGroup - AS3 Flex

Классы x

enabled

numRadioButtons

selectedValue

selection