RadioButtonGroup

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

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Начиная с Flex 4.0, Adobe рекомендует вместо этого класса использовать класс spark.components.RadioButtonGroup.

Элемент управления RadioButtonGroup определяет группу элементов управления RadioButton, которая рассматривается как единый элемент управления с взаимоисключающими вариантами выбора. Таким образом, единовременно можно выбрать только один элемент управления RadioButton. Хотя группировка экземпляров RadioButton в RadioButtonGroup является необязательной, группа позволяет выполнять такие действия, как установка отдельного обработчика событий сразу на группу кнопок, а не на каждую кнопку в отдельности.

Свойство id требуется при использовании тега <mx:RadioButtonGroup> для определения имени группы.

Обратите внимание, что элемент управления RadioButtonGroup является подклассом EventDispatcher, а не UIComponent, и реализует интерфейс IMXMLObject. Визуальные компоненты любого другого компонента Flex являются подклассами UIComponent, реализующего интерфейс IUIComponent. Элемент управления RadioButtonGroup имеет встроенную поддержку в компиляторе Flex, что позволяет использовать его как нижестоящий элемент контейнера Flex даже при отсутствии реализации IUIComponent. Все другие нижестоящие элементы контейнера должны реализовывать интерфейс IUIComponent.

Поэтому при попытке определения визуального компонента как подкласса EventDispatcher, реализующего интерфейс IMXMLObject, невозможно использовать его как нижестоящий элемент контейнера.

Синтаксис MXML expanded

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

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

  <mx:RadioButtonGroup
    Properties
    enabled="true|false"
    id="No default"
    labelPlacement="right|left|top|bottom"
 
    Events
    change="No default"
    itemClick="No default"
  />

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

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

mx.controls.RadioButton

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

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

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

	Свойство		Определено
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		enabled : Boolean Определяет, разрешен выбор или нет.	RadioButtonGroup
		labelPlacement : String Расположение метки RadioButton относительно значка RadioButton для каждого элемента управления в группе.	RadioButtonGroup
		numRadioButtons : int [только для чтения] Число элементов RadioButton, принадлежащих этой RadioButtonGroup.	RadioButtonGroup
		selectedValue : Object Значение свойства value выбранного элемента управления RadioButton в группе, если оно установлено как отличное от null (значение по умолчанию).	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

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

enabled

свойство

enabled:Boolean

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Определяет, разрешен выбор или нет.

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

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

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

labelPlacement

свойство

labelPlacement:String

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Расположение метки RadioButton относительно значка RadioButton для каждого элемента управления в группе. Можно переопределить эту установку для отдельных элементов управления.

Допустимыми значениями в MXML являются right, left, bottom и top.

В ActionScript для установки значения этого свойства можно использовать следующие константы: ButtonLabelPlacement.RIGHT, ButtonLabelPlacement.LEFT, ButtonLabelPlacement.BOTTOM и ButtonLabelPlacement.TOP.

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

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

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

numRadioButtons

свойство

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

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

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

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

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

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

selectedValue

свойство

selectedValue:Object

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Значение свойства value выбранного элемента управления RadioButton в группе, если оно установлено как отличное от null (значение по умолчанию). Иначе selectedValue является значением свойства 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 3

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

Flash Player 9, AIR 1.1

Содержит ссылку на текущий выбранный элемент управления 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 3

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

Flash Player 9, AIR 1.1

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

Параметры

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

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

flash.events.EventDispatcher

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

getRadioButtonAt

()

метод

public function getRadioButtonAt(index:int):RadioButton

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

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

Параметры

index:int — Индекс элемента управления RadioButton в элементе управления RadioButtonGroup, где индекс первого элемента управления равен 0.

Возвращает

RadioButton — Указанный элемент управления RadioButton.

initialized

()

метод

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

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Реализация метода 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 3

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

Flash Player 9, AIR 1.1

Передается при изменении значения выбранного элемента управления 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 3

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

Flash Player 9, AIR 1.1

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

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

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

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

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

RadioButtonGroupExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate Halo RadioButtonGroup 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;
            import  mx.events.ItemClickEvent;
        
            // Event handler function to display the selected button
            // in a Halo Alert control.
            private function handleCard(evt:ItemClickEvent):void {
                switch (evt.currentTarget.selectedValue) {
                    case "AmEx":
                        Alert.show("You selected American Express");
                        break;
                    case "MC":
                        Alert.show("You selected MasterCard");
                        break;
                    case "Visa":
                        Alert.show("You selected Visa");
                        break;
                }
            }
        ]]>
    </fx:Script>

    <fx:Declarations>
        <mx:RadioButtonGroup id="cardtype" itemClick="handleCard(event);"/>
    </fx:Declarations>

    <s:Panel title="Halo RadioButtonGroup Control Example"
            width="75%" height="75%" 
            horizontalCenter="0" verticalCenter="0">
        <s:VGroup left="10" right="10" top="10" bottom="10">
            <s:Label width="100%" color="blue" 
                    text="Select a type of credit card."/>

            <mx:RadioButton groupName="cardtype" id="americanExpress" value="AmEx" 
                    label="American Express" width="150" />
            <mx:RadioButton groupName="cardtype" id="masterCard" value="MC" 
                    label="MasterCard" width="150" />
            <mx:RadioButton groupName="cardtype" id="visa" value="Visa" 
                    label="Visa" width="150" />
        </s:VGroup>
    </s:Panel>

</s:Application>

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

RadioButtonGroup - AS3 Flex

Классы x

enabled

labelPlacement

numRadioButtons

selectedValue

selection