RadioButtonGroup

Paket	spark.components
Sınıf	public class RadioButtonGroup
Miras Alma	RadioButtonGroup EventDispatcher Object
Uygular	IMXMLObject

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

The RadioButtonGroup component defines a group of RadioButton components that act as a single mutually exclusive component; therefore, a user can select only one RadioButton component at a time. The id property is required when you use the <s:RadioButtonGroup> tag to define the group name. Any <s:RadioButton> component added to this group will have this group name.

Notice that the RadioButtonGroup component is a subclass of EventDispatcher, not UIComponent, and implements the IMXMLObject interface. All other Flex visual components implement the IVisualElement interface. The RadioButtonGroup component declaration must be contained within the <Declarations> tag since it is not assignable to IVisualElement.

To use this component in a list-based component, such as a List or DataGrid, create an item renderer. For information about creating an item renderer, see Custom Spark item renderers.

MXML Sözdizimi expanded

MXML Sözdizimini Gizle

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"
  />

Örnekleri görüntüle

İlgili API Öğeleri

spark.components.RadioButton

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		constructor : Object Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.	Object
		enabled : Boolean Determines whether selection is allowed.	RadioButtonGroup
		numRadioButtons : int [salt okunur] The number of RadioButtons that belong to this RadioButtonGroup.	RadioButtonGroup
		selectedValue : Object The value property of the selected RadioButton component in the group, if it has been set, otherwise, the label property of the selected RadioButton.	RadioButtonGroup
		selection : RadioButton Contains a reference to the currently selected RadioButton component in the group.	RadioButtonGroup

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		RadioButtonGroup(document:IFlexDisplayObject = null) Constructor.	RadioButtonGroup
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder.	EventDispatcher
		dispatchEvent(event:Event):Boolean Olay akışına bir olay gönderir.	EventDispatcher
		getRadioButtonAt(index:int):RadioButton Returns the RadioButton component at the specified index.	RadioButtonGroup
		hasEventListener(type:String):Boolean EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.	EventDispatcher
		hasOwnProperty(name:String):Boolean Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.	Object
		initialized(document:Object, id:String):void Implementation of the IMXMLObject.initialized() method to support deferred instantiation.	RadioButtonGroup
		isPrototypeOf(theClass:Object):Boolean Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.	Object
		propertyIsEnumerable(name:String):Boolean Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher nesnesinden bir dinleyiciyi kaldırır.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.	Object
		toLocaleString():String Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.	Object
		toString():String Belirtilen nesnenin dize olarak temsil edilen halini döndürür.	Object
		valueOf():Object Belirtilen nesnenin temel değerini döndürür.	Object
		willTrigger(type:String):Boolean Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder.	EventDispatcher

Olaylar

Olaylarla ilgili daha fazla bilgi için tıklatın

Miras Alınan Olayları Gizle

Miras Alınan Olayları Göster

	Özet	Tanımlayan:
activate	[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir.	EventDispatcher
change	Dispatched when the value of the selected RadioButton component in this group changes.	RadioButtonGroup
deactivate	[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.	EventDispatcher
itemClick	Dispatched when a user selects a RadioButton component in the group.	RadioButtonGroup
valueCommit	Dispatched when values are changed programmatically or by user interaction.	RadioButtonGroup

Özellik Ayrıntısı

enabled

özellik

enabled:Boolean

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Determines whether selection is allowed. Note that the value returned only reflects the value that was explicitly set on the RadioButtonGroup and does not reflect any values explicitly set on the individual RadioButtons.

Varsayılan değer şudur true.

Uygulama
public function get enabled():Boolean
public function set enabled(value:Boolean):void

numRadioButtons

özellik

numRadioButtons:int [salt okunur]

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

The number of RadioButtons that belong to this RadioButtonGroup.

Varsayılan değer şudur "0".

Bu özellik veri ciltleme kaynağı olarak kullanılabilir. Bu özellik değiştirildiğinde, numRadioButtonsChanged olayını gönderir.

Uygulama
public function get numRadioButtons():int

selectedValue

özellik

selectedValue:Object

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

The value property of the selected RadioButton component in the group, if it has been set, otherwise, the label property of the selected RadioButton. If no RadioButton is selected, this property is null.

If you set selectedValue, Flex selects the first RadioButton component whose value or label property matches this value.

Varsayılan değer şudur null.

Bu özellik veri ciltleme kaynağı olarak kullanılabilir. Bu özellik değiştirildiğinde, valueCommit olayını gönderir.

Uygulama
public function get selectedValue():Object
public function set selectedValue(value:Object):void

selection

özellik

selection:RadioButton

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Contains a reference to the currently selected RadioButton component in the group. You can access this property in ActionScript only; it is not settable in MXML. Setting this property to null deselects the currently selected RadioButton component. A change event is not dispatched.

Varsayılan değer şudur null.

Bu özellik veri ciltleme kaynağı olarak kullanılabilir. Bu özellik değiştirildiğinde, valueCommit olayını gönderir.

Uygulama
public function get selection():RadioButton
public function set selection(value:RadioButton):void

Yapıcı Ayrıntı

()

Yapıcı

public function RadioButtonGroup(document:IFlexDisplayObject = null)

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Constructor.

Parametreler

document:IFlexDisplayObject (default = null) — In simple cases where a class extends EventDispatcher, the document parameter should not be used.

İlgili API Öğeleri

flash.events.EventDispatcher

Yöntem Ayrıntısı

getRadioButtonAt

()

yöntem

public function getRadioButtonAt(index:int):RadioButton

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Returns the RadioButton component at the specified index.

Parametreler

index:int — The 0-based index of the RadioButton in the RadioButtonGroup.

Döndürür

RadioButton — The specified RadioButton component if index is between 0 and numRadioButtons - 1. Returns null if the index is invalid.

İlgili API Öğeleri

numRadioButtons

initialized

()

yöntem

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

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Implementation of the IMXMLObject.initialized() method to support deferred instantiation.

Parametreler

	`document:Object` — The MXML document that created this object.

	`id:String` — The identifier used by document to refer to this object. If the object is a deep property on document, `id` is null.

İlgili API Öğeleri

mx.core.IMXMLObject

Olay Ayrıntısı

change

Olay

Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.CHANGE

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Dispatched when the value of the selected RadioButton component in this group changes.

Event.CHANGE sabiti, change olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`true`
`cancelable`	`false`; iptal edilecek varsayılan davranış yoktur.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`target`	Değerleri değiştirilen nesne. `target` her zaman olay dinleyicisini kaydeden görüntüleme listesindeki nesne değildir. Geçerli olarak olayı işleyen görüntüleme listesindeki nesneye erişmek için `currentTarget` özelliğini kullanın.

itemClick

Olay

Olay Nesne Türü: mx.events.ItemClickEvent
özellik ItemClickEvent.type = mx.events.ItemClickEvent.ITEM_CLICK

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Dispatched when a user selects a RadioButton component in the group. You can also set a handler for individual RadioButton components. This event is dispatched only when the user interacts with the radio buttons by using the mouse.

The ItemClickEvent.ITEM_CLICK constant defines the value of the type property of the event object for an itemClick event.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	false
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`index`	The index of the navigation item that was clicked.
`item`	The item in the data provider of the navigation item that was clicked.
`label`	The label of the navigation item that was clicked.
`relatedObject`	The child object that generated the event.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.

valueCommit

Olay

Olay Nesne Türü: mx.events.FlexEvent
özellik FlexEvent.type = mx.events.FlexEvent.VALUE_COMMIT

Dil Sürümü:

ActionScript 3.0

Ürün Sürümü:

Flex 4

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Dispatched when values are changed programmatically or by user interaction.

Because a programmatic change triggers this event, make sure that any valueCommit event handler does not change a value that causes another valueCommit event. For example, do not change theselectedValue property or selection property in a valueCommit event handler.

The FlexEvent.VALUE_COMMIT constant defines the value of the type property of the event object for a valueCommit event.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	false
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.

Örnekler Bu örnek nasıl kullanılır?

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>

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

RadioButtonGroup - AS3 Flex

Sınıflar x

enabled

numRadioButtons

selectedValue

selection