RadioButton

套件	fl.controls
類別	public class RadioButton
繼承	RadioButton LabelButton BaseButton UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
實作	IFocusManagerGroup

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

RadioButton 組件可讓您強制使用者在一組選擇中進行單一選取。此組件必須使用在至少有兩個 RadioButton 實體的群組中。不論在任何時間，只能在群組中選取一個成員。在群組中選取一個選項按鈕，將會取消選取群組中目前選取的選項按鈕。您可以設定 groupName 參數來指定選項按鈕屬於哪個群組。當使用者按一下或以 Tab 鍵移到 RadioButton 組件群組中時，只有已選取的選項按鈕會成為焦點。

您可以啟用或停用選項按鈕。停用的選項按鈕無法接受滑鼠或鍵盤輸入。

相關 API 元素

公用屬性

	屬性		定義自
		accessibilityImplementation : AccessibilityImplementation 對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。	InteractiveObject
		accessibilityProperties : AccessibilityProperties 此顯示物件的目前輔助功能選項。	DisplayObject
		alpha : Number 指出所指定物件的 Alpha 透明度值。	DisplayObject
		autoRepeat : Boolean [覆寫] 選項按鈕依定義永遠無法自動重複，因此在建構函式中，autoRepeat 屬性會設定為 false，而且無法變更。	RadioButton
		blendMode : String 來自 BlendMode 類別的值，會指定要使用何種混合模式。	DisplayObject
		blendShader : Shader [唯寫] 設定用來混合前景和背景的著色器。	DisplayObject
		buttonMode : Boolean 可指定此 sprite 的按鈕模式。	Sprite
		cacheAsBitmap : Boolean 如果設定為 true，Flash 執行階段會快取顯示物件的內部點陣圖表示法。	DisplayObject
		cacheAsBitmapMatrix : Matrix 如果為非 null，當 cacheAsBitmap 設定為 true 時，這個 Matrix 物件會定義顯示物件的顯示方法。	DisplayObject
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		contextMenu : NativeMenu 指定與此物件有關聯的快顯選單。	InteractiveObject
		doubleClickEnabled : Boolean 會指定物件是否會收到 doubleClick 事件。	InteractiveObject
		dropTarget : DisplayObject [唯讀] 指定要將 sprite 拖曳至或丟棄至哪個顯示物件上。	Sprite
		enabled : Boolean [覆寫] 會取得或設定值，指出組件是否可以接受使用者輸入。	BaseButton
		filters : Array 索引的陣列，其中包含目前和顯示物件相關的每個濾鏡物件。	DisplayObject
		focusEnabled : Boolean 會取得或設定 Boolean 值，指出組件是否可以在使用者按一下之後成為焦點。	UIComponent
		focusManager : IFocusManager 會取得或設定控制此組件及其同輩之焦點的 FocusManager。	UIComponent
		focusRect : Object 會指定這個物件是否會顯示焦點矩形。	InteractiveObject
		graphics : Graphics [唯讀] 指定屬於此 sprite 物件的 Graphics 物件，其中可能會產生向量繪圖命令。	Sprite
		group : RadioButtonGroup 此 RadioButton 所屬的 RadioButtonGroup 物件。	RadioButton
		groupName : String 選項按鈕實體或群組的群組名稱。	RadioButton
		height : Number [覆寫] 會取得或設定組件的高度，以像素為單位。	UIComponent
		hitArea : Sprite 指定用來當作 sprite 作用區域的另一個 sprite。	Sprite
		label : String 會取得或設定組件的文字標籤。	LabelButton
		labelPlacement : String 相對於指定圖示的標籤位置。	LabelButton
		loaderInfo : LoaderInfo [唯讀] 會傳回 LoaderInfo 物件，其中包含關於載入此顯示物件所屬之檔案的資訊。	DisplayObject
		mask : DisplayObject 呼叫之顯示物件會以指定的 mask 物件遮蓋。	DisplayObject
		metaData : Object 如果中繼資料是透過 PlaceObject4 標籤與 SWF 檔案中的這個 DisplayObject 實體一同儲存，則會取得 DisplayObject 實體的中繼資料物件。	DisplayObject
		mouseChildren : Boolean 判斷物件的子系是否支援啟用滑鼠或使用者輸入裝置。	DisplayObjectContainer
		mouseEnabled : Boolean 指定此物件是否接收滑鼠或其他使用者輸入及訊息。	InteractiveObject
		mouseFocusEnabled : Boolean 會取得或設定值，指出組件是否可以在使用者按一下之後成為焦點。	UIComponent
		mouseX : Number [唯讀] 指出滑鼠或使用者輸入裝置位置的 x 座標，以像素為單位。	DisplayObject
		mouseY : Number [唯讀] 指出滑鼠或使用者輸入裝置位置的 y 座標，以像素為單位。	DisplayObject
		name : String 指出 DisplayObject 的實體名稱。	DisplayObject
		needsSoftKeyboard : Boolean 指定虛擬鍵盤 (螢幕上的軟體鍵盤) 是否應在此 InteractiveObject 實體接收到焦點時顯示。	InteractiveObject
		numChildren : int [唯讀] 傳回此物件的子系數量。	DisplayObjectContainer
		opaqueBackground : Object 會指定顯示物件是否不透明，並具有特定背景顏色。	DisplayObject
		parent : DisplayObjectContainer [唯讀] 指出包含此顯示物件的 DisplayObjectContainer 物件。	DisplayObject
		root : DisplayObject [唯讀] 對載入之 SWF 檔案的顯示物件而言，root 屬性就是該 SWF 檔案所呈現之顯示清單樹狀結構部分的最上層顯示物件。	DisplayObject
		rotation : Number 指出 DisplayObject 實體的旋轉度數 (從該物件原本方向算起)。	DisplayObject
		rotationX : Number 表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 x 軸旋轉 (以度數為單位)。	DisplayObject
		rotationY : Number 表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 y 軸旋轉 (以度數為單位)。	DisplayObject
		rotationZ : Number 表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 z 軸旋轉 (以度數為單位)。	DisplayObject
		scale9Grid : Rectangle 目前產生效用的縮放格線。	DisplayObject
		scaleX : Number [覆寫] 會將目前組件的寬度乘以縮放比例係數。	UIComponent
		scaleY : Number [覆寫] 會將目前組件的高度乘以縮放比例係數。	UIComponent
		scaleZ : Number 指出從物件註冊點套用的物件深度縮放 (百分比)。	DisplayObject
		scrollRect : Rectangle 顯示物件的捲動矩形範圍。	DisplayObject
		selected : Boolean [覆寫] 會指出目前已選取 (true) 或取消選取 (false) 選項按鈕。	RadioButton
		softKeyboard : String 控制軟體鍵盤的外觀。	InteractiveObject
		softKeyboardInputAreaOfInterest : Rectangle 定義顯示軟體鍵盤時，應保留於螢幕上的區域 (iOS 未提供)。	InteractiveObject
		soundTransform : flash.media:SoundTransform 控制此 Sprite 的聲音。	Sprite
		stage : Stage [唯讀] 顯示物件的「舞台」。	DisplayObject
		tabChildren : Boolean 判斷物件的子系是否支援啟用定位鍵。	DisplayObjectContainer
		tabEnabled : Boolean 會指定這個物件是否在停駐點順序中。	InteractiveObject
		tabIndex : int 會指定 SWF 檔中的物件停駐點順序。	InteractiveObject
		textField : flash.text:TextField 組件內部文字欄位的參考。	LabelButton
		textSnapshot : flash.text:TextSnapshot [唯讀] 傳回此 DisplayObjectContainer 實體的 TextSnapshot 物件。	DisplayObjectContainer
		toggle : Boolean [覆寫] 選項按鈕是切換按鈕。其 toggle 屬性在建構函式中設定為 true，而且無法變更。	RadioButton
		transform : flash.geom:Transform 這是一個物件，具有和顯示物件的矩陣、顏色轉換和像素邊界有關的屬性。	DisplayObject
		useHandCursor : Boolean 指示當指標滑入 Sprite，且其 buttonMode 屬性設為 true 時，是否要出現指示手掌 (手掌游標) 的 Boolean 值。	Sprite
		value : Object 與選項按鈕相關聯的使用者定義值。	RadioButton
		visible : Boolean [覆寫] 會取得或設定值，指出目前組件實體是否為可見。	UIComponent
		width : Number [覆寫] 會取得或設定組件的寬度，以像素為單位。	UIComponent
		x : Number [覆寫] 會取得或設定 x 座標，代表組件在其父輩容器內的 x 軸位置。	UIComponent
		y : Number [覆寫] 會取得或設定 y 座標，代表組件在其父輩容器內的 y 軸位置。	UIComponent
		z : Number 表示 DisplayObject 實體相對於 3D 父輩容器的 z 座標位置 (沿著 z 軸)。	DisplayObject

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		RadioButton() 建立新的 RadioButton 組件實體。	RadioButton
		addChild(child:DisplayObject):DisplayObject 將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject 將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。	DisplayObjectContainer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。	EventDispatcher
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 指出安全性限制是否會造成傳回的清單 (可用指定的 point 點呼叫 DisplayObjectContainer.getObjectsUnderPoint() 方法來取得) 省略任何顯示物件。	DisplayObjectContainer
		clearStyle(style:String):void 從此組件實體刪除某種樣式屬性。	UIComponent
		contains(child:DisplayObject):Boolean 判斷指定的顯示物件是否為 DisplayObjectContainer 實體的子系，或為實體本身。	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean 會將事件傳送到事件流程。	EventDispatcher
		drawFocus(focused:Boolean):void [覆寫] 會顯示或隱藏此組件實體周圍的焦點指示器。	RadioButton
		drawNow():void 會起始立即繪製作業，而不需像 invalidateNow 一樣使所有項目無效化。	UIComponent
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle 傳回可定義顯示物件區域 (相對於 targetCoordinateSpace 物件的座標系統) 的矩形。	DisplayObject
		getChildAt(index:int):DisplayObject 傳回存在於指定索引位置的子顯示物件實體。	DisplayObjectContainer
		getChildByName(name:String):DisplayObject 傳回具有指定名稱的子顯示物件。	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int 傳回 child DisplayObject 實體的索引位置。	DisplayObjectContainer
		getFocus():InteractiveObject 會擷取目前成為焦點的物件。	UIComponent
		getObjectsUnderPoint(point:Point):Array 傳回位於指定點底下，且屬於此 DisplayObjectContainer 實體之子系 (或孫系，以下類推) 的物件陣列。	DisplayObjectContainer
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 根據 targetCoordinateSpace 參數所定義的座標系統，並排除形狀上的任何筆畫，傳回可定義顯示物件邊界的矩形。	DisplayObject
		getStyle(style:String):Object 會擷取在組件樣式查閱鏈中設定的樣式屬性。	UIComponent
		getStyleDefinition():Object [靜態] 會擷取目前組件的預設樣式對應。	RadioButton
		globalToLocal(point:Point):Point 將 point 物件從「舞台」(全域) 座標轉換成顯示物件的 (區域) 座標。	DisplayObject
		globalToLocal3D(point:Point):Vector3D 將二維點從「舞台」(全域) 座標轉換為三維顯示物件的 (區域) 座標。	DisplayObject
		hasEventListener(type:String):Boolean 會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		hitTestObject(obj:DisplayObject):Boolean 評估顯示物件的範圍框，看它是否與 obj 顯示物件的範圍框重疊或相交。	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 評估顯示物件，看它是否與 x 和 y 參數所指定的點重疊或相交。	DisplayObject
		invalidate(property:String, callLater:Boolean = true):void 會將屬性標示為無效，除非另有指定，否則會在下一個影格上重繪組件。	UIComponent
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		local3DToGlobal(point3d:Vector3D):Point 將三維顯示物件的 (區域) 座標的三維點轉換為「舞台」(全域) 座標中的二維點。	DisplayObject
		localToGlobal(point:Point):Point 將 point 物件從顯示物件的 (區域) 座標轉換成「舞台」(全域) 座標。	DisplayObject
		mergeStyles(... list):Object [靜態] 會將多種類別中的樣式合併為一個物件。	UIComponent
		move(x:Number, y:Number):void 將組件移至其父輩內指定的位置。	UIComponent
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		removeChild(child:DisplayObject):DisplayObject 將指定的 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject 從 DisplayObjectContainer 子清單中的指定索引位置移除子 DisplayObject。	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void 將所有 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 會從 EventDispatcher 物件移除偵聽程式。	EventDispatcher
		requestSoftKeyboard():Boolean 升起顯示虛擬鍵盤。	InteractiveObject
		setChildIndex(child:DisplayObject, index:int):void 變更顯示物件容器中現有子系的位置。	DisplayObjectContainer
		setFocus():void 將焦點設定到此組件。	UIComponent
		setMouseState(state:String):void 經由 ActionScript 設定滑鼠狀態。	BaseButton
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		setSize(width:Number, height:Number):void 會將組件設定為指定的寬度和高度。	UIComponent
		setStyle(style:String, value:Object):void 針對此組件實體設定樣式屬性。	UIComponent
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void 讓使用者拖曳指定的 sprite。	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void 讓使用者將指定的 Sprite 拖曳至觸控裝置上。	Sprite
		stopAllMovieClips():void 遞迴停止執行所有 MovieClips 的時間軸根源於此物件。	DisplayObjectContainer
		stopDrag():void 結束 startDrag() 方法。	Sprite
		stopTouchDrag(touchPointID:int):void 結束觸控裝置使用的 startTouchDrag() 方法。	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void 替換兩個指定子物件的 z 順序 (深度階層，由前至後順序)。	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void 在子清單的兩個指定索引位置，替換子物件的 z 順序 (深度階層，由前至後順序)。	DisplayObjectContainer
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		validateNow():void 會確認此物件之屬性和版面的有效性並加以更新，並在必要時重繪此物件。	UIComponent
		valueOf():Object 會傳回指定之物件的基本值。	Object
		willTrigger(type:String):Boolean 檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。	EventDispatcher

保護方法

隱藏繼承保護方法

顯示繼承保護方法

	方法		定義自
		getStyleValue(name:String):Object 考量全域層級、組件層級和實體層級上設定的所有樣式之後，傳回組件的指定樣式。	UIComponent

事件

按一下以瞭解事件的詳細資訊

隱藏繼承事件

顯示繼承事件

	摘要	定義自
activate	[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。	EventDispatcher
added	當顯示物件加入顯示清單中時傳送。	DisplayObject
addedToStage	會在顯示物件加入舞台上的顯示清單時，以直接或是透過加入包含該顯示物件之子樹狀結構的方式傳送。	DisplayObject
buttonDown	當使用者按下 Button 組件時傳送。	BaseButton
change	當選項按鈕實體的 selected 屬性變更時傳送。	RadioButton
clear	當使用者從文字快顯選單中選取「清除」(或「刪除」) 時傳送。	InteractiveObject
click	當使用者使用滑鼠或空白鍵按一下選項按鈕時傳送。	RadioButton
contextMenu	當使用者手勢在 AIR 應用程式中觸發與此互動式物件相關聯的快顯選單時傳送。	InteractiveObject
copy	當使用者針對複製作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「複製」時傳送。	InteractiveObject
cut	當使用者針對剪下作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「剪下」時傳送。	InteractiveObject
deactivate	[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。	EventDispatcher
doubleClick	在 InteractiveObject 物件的 doubleClickEnabled 旗標設為 true 的情況下，當使用者在相同的物件上方連續兩次快速按下並放開指標裝置主要按鈕時傳送。	InteractiveObject
enterFrame	[廣播事件] 當播放磁頭進入新影格時傳送。	DisplayObject
exitFrame	[廣播事件] 當播放磁頭結束目前影格時傳送。	DisplayObject
focusIn	當顯示物件取得焦點之後傳送。	InteractiveObject
focusOut	當顯示物件失去焦點時傳送。	InteractiveObject
frameConstructed	[廣播事件] 在影格顯示物件的建構函式執行之後，且影格指令碼執行之前傳送。	DisplayObject
gestureDirectionalTap	當使用者沿著觸控面與 InteractiveObject 實體建立接觸點 (例如沿著 Apple TV 的 Siri Remote 觸控面點選)，某些裝置可能也會將此接觸解譯為數個觸控事件的組合。	InteractiveObject
gestureLongPress	當使用在觸控裝置上的同一個 InteractiveObject 實體上按下兩個接觸點後送出 (例如在行動電話或平板電腦觸控螢幕的顯示物件上方，以兩支手指按下後鬆開)。	InteractiveObject
gesturePan	當使用者在觸控裝置上，將接觸點移動到 InteractiveObject 實體上方後傳送 (例如，在行動電話或平板電腦觸控螢幕的顯示物件上，由左向右移動手指)。	InteractiveObject
gestureRotate	當使用者在 InteractiveObject 實體的接觸點上做出旋轉手勢後傳送 (例如兩指觸摸行動電話或平板電腦的觸控螢幕，然後手指在顯示物件上旋轉)。	InteractiveObject
gestureSwipe	當使用者在與 InteractiveObject 實體的某個接觸點上做出揮動手勢後傳送 (例如，三指併在一起觸碰行動電話或平板電腦的觸控螢幕，然後在顯示物件上快速平行移動手指)。	InteractiveObject
gestureTap	當使用者與 InteractiveObject 實體建立接觸點，然後在觸控裝置上點一下後送出 (例如，將多根手指放到行動電話或平板電腦觸控螢幕的顯示物件上以開啟選單，然後其中一根手點一下，選取選單項目)。	InteractiveObject
gestureZoom	當使用者在 InteractiveObject 實體的某個接觸點上做出放大縮小手勢後傳送 (例如兩指併在一起觸摸行動電話或平板電腦的觸控螢幕，然後手指在顯示物件上快速張開)。	InteractiveObject
hide	在組件的可見性從可見變更為隱藏之後傳送。	UIComponent
imeStartComposition	這個事件會送出至任何支援 IME 內嵌輸入的用戶端應用程式。	InteractiveObject
keyDown	會當使用者按下按鍵時傳送。	InteractiveObject
keyFocusChange	當使用者嘗試使用鍵盤瀏覽變更焦點時傳送。	InteractiveObject
keyUp	會當使用者放開按鍵時傳送。	InteractiveObject
labelChange	在標籤值變更之後傳送。	LabelButton
middleClick	當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置中間按鈕時傳送。	InteractiveObject
middleMouseDown	當使用者將指向裝置的中間按鈕移至 InteractiveObject 實體上方按下時傳送。	InteractiveObject
middleMouseUp	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。	InteractiveObject
mouseDown	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。	InteractiveObject
mouseFocusChange	會當使用者嘗試使用指向裝置變更焦點時傳送。	InteractiveObject
mouseMove	會當指向裝置停在 InteractiveObject 上方的情況下使用者將其移動時傳送。	InteractiveObject
mouseOut	會當使用者將指向裝置移開 InteractiveObject 實體時傳送。	InteractiveObject
mouseOver	會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。	InteractiveObject
mouseUp	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。	InteractiveObject
mouseWheel	當滑鼠滾輪在 InteractiveObject 實體上方轉動時傳送。	InteractiveObject
move	在移動組件之後傳送。	UIComponent
nativeDragComplete	當使用者釋放手勢時，由拖曳初始程式 InteractiveObject 傳送。	InteractiveObject
nativeDragDrop	已在目標 InteractiveObject 上放下拖曳的物件，而且已呼叫 DragManager.acceptDragDrop() 接受該放開的資料時，由此目標 InteractiveObject 傳送。	InteractiveObject
nativeDragEnter	當手勢進入 InteractiveObject 的邊界時，由此 InteractiveObject 傳送。	InteractiveObject
nativeDragExit	當手勢離開 InteractiveObject 的邊界時，由此 InteractiveObject 傳送。	InteractiveObject
nativeDragOver	當拖曳手勢還留在 InteractiveObject 的邊界內，由此 InteractiveObject 持續傳送。	InteractiveObject
nativeDragStart	在呼叫 DragManager.doDrag() 進行拖曳作業初期，由指定做為拖曳初始程式的 InteractiveObject 傳送。	InteractiveObject
nativeDragUpdate	在呼叫 DragManager.doDrag() 進行拖曳作業期間，由指定做為拖曳初始程式的 InteractiveObject 傳送。	InteractiveObject
paste	當使用者針對貼上作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「貼上」時傳送。	InteractiveObject
proximityBegin	在使用者將作用中觸控筆往下移至超過螢幕鄰近偵測邊框時傳送。	InteractiveObject
proximityEnd	在使用者將作用中觸控筆提到螢幕鄰近偵測邊框時傳送。	InteractiveObject
proximityMove	在使用者將作用中觸控筆移到螢幕上方，而其餘仍在鄰近偵測邊框內時傳送。	InteractiveObject
proximityOut	在使用者將作用中觸控筆移出這個 InteractiveObject 之外，而其餘仍在螢幕的鄰近偵測邊框內時傳送。	InteractiveObject
proximityOver	在使用者直接將作用中觸控筆移到這個 InteractiveObject 上方，而其餘仍在螢幕的鄰近偵測邊框內時傳送。	InteractiveObject
proximityRollOut	在使用者將作用中觸控筆移出這個 InteractiveObject 及其任一子系之外，而其餘仍在螢幕的鄰近偵測邊框內時傳送。	InteractiveObject
proximityRollOver	在使用者透過這個 InteractiveObject，從顯示清單中後代的物件樹狀結構之外移動作用中觸控筆時傳送 (而其餘仍在螢幕的鄰近偵測邊框內)。	InteractiveObject
releaseOutside	當使用者第一次按下 InteractiveObject 實體上方的按鈕，然後將指向裝置滑出 InteractiveObject 實體之後即放開指向裝置上的按鈕時傳送。	InteractiveObject
removed	會當顯示物件將要從顯示清單移除時傳送。	DisplayObject
removedFromStage	會在顯示物件即將從顯示清單移除時，以直接或是透過移除包含該顯示物件之子樹狀結構的方式傳送。	DisplayObject
render	[廣播事件] 當顯示清單將要更新和顯示時傳送。	DisplayObject
resize	在調整組件大小之後傳送。	UIComponent
rightClick	當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置右邊按鈕時傳送。	InteractiveObject
rightMouseDown	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。	InteractiveObject
rightMouseUp	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。	InteractiveObject
rollOut	會當使用者將指向裝置移開 InteractiveObject 實體時傳送。	InteractiveObject
rollOver	會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。	InteractiveObject
selectAll	當使用者針對全選作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「全選」時傳送。	InteractiveObject
show	在組件的可見性從隱藏變更為可見之後傳送。	UIComponent
softKeyboardActivate	升起顯示軟體鍵盤之後立即傳送。	InteractiveObject
softKeyboardActivating	升起顯示軟體鍵盤前立即傳送。	InteractiveObject
softKeyboardDeactivate	降下隱藏軟體鍵盤之後立即傳送。	InteractiveObject
tabChildrenChange	在物件的 tabChildren 旗標值變更時傳送。	InteractiveObject
tabEnabledChange	在物件的 tabEnabled 旗標變更時傳送。	InteractiveObject
tabIndexChange	在物件的 tabIndex 屬性值變更時傳送。	InteractiveObject
textInput	當使用者輸入一或多文字的字元時送出。	InteractiveObject
touchBegin	當使用者在第一次接觸觸控裝置後傳送 (例如手指觸摸行動電話或平板電腦的觸控螢幕)。	InteractiveObject
touchEnd	當使用者在觸控裝置上移除接觸點後傳送 (例如在行動電話或平板電腦觸控螢幕上移開手指)。	InteractiveObject
touchMove	當使用者觸控裝置時傳送，並且連續不斷地傳送，直到接觸點移除為止。	InteractiveObject
touchOut	當使用者在觸控裝置中，將接觸點移出 InteractiveObject 實體後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件移至另一個顯示物件)。	InteractiveObject
touchOver	當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件外面的某一點，往顯示物件上方拖曳)。	InteractiveObject
touchRollOut	當使用者在觸控裝置上，將接觸點從 InteractiveObject 實體移出後送出 (例如，在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件上方拖曳到顯示物件以外)。	InteractiveObject
touchRollOver	當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件外面的某一點，往顯示物件上方拖曳)。	InteractiveObject
touchTap	當使用者在觸控裝置的同一個 InteractiveObject 實體上，在原先開始接觸點放開後送出 (例如在行動電話或平板電腦觸控螢幕上的顯示物件上方，以手指按下某個點後又鬆開)。	InteractiveObject

樣式

樣式可分為一般樣式及與特定主題關聯的樣式兩種。如果是一般樣式，可以與任何主題搭配使用。如果是與特定主題關聯的樣式，只有在您的應用程式使用特定主題時才能使用該樣式。

一般樣式

按一下以瞭解樣式的詳細資訊

隱藏繼承樣式

顯示繼承樣式

	說明	定義自
disabledIcon	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕處於停用狀態時，用來作為圖示的類別名稱。預設值為 `RadioButton_disabledIcon`。	RadioButton
disabledSkin	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕不是處於選取狀態並且停用時，用來作為背景與邊框之外觀元素的類別名稱.	LabelButton
disabledTextFormat	類型: flash.text.TextFormat 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕停用時用來繪製組件標籤的 TextFormat 物件.	UIComponent
downIcon	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕不是處於選取狀態並且按下滑鼠鈕時，用來作為圖示的類別名稱。預設值為 `RadioButton_downIcon`。	RadioButton
downSkin	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕不是處於選取狀態並且按下滑鼠鈕時，用來作為背景與邊框之外觀元素的類別名稱.	LabelButton
embedFonts	類型: Boolean 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 指出是否要使用內嵌的字體外框來呈現文字欄位.	LabelButton
focusRectPadding	類型: Number 格式: Length 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 分開組件外邊框與焦點指示器的外邊緣的邊框 (以像素計).	UIComponent
focusRectSkin	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來顯示焦點指示器的外觀元素.	UIComponent
icon	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當切換按鈕不是處於選取狀態並且滑鼠不是位於按鈕上方時，用來作為圖示的類別名稱。預設值為 `null`。	RadioButton
overIcon	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕不是處於選取狀態並且滑鼠位於此組件上方時，用來作為圖示的類別名稱。預設值為 `RadioButton_overIcon`。	RadioButton
overSkin	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕不是處於選取狀態並且滑鼠位於此組件上方時，用來作為背景與邊框之外觀元素的類別名稱.	LabelButton
repeatDelay	類型: Number 格式: Time 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 在傳送第二個 `buttonDown` 事件之前，第一個 `buttonDown` 事件傳送之後要等候的毫秒數.	LabelButton
repeatInterval	類型: Number 格式: Time 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 在發生以 `repeatDelay` 樣式指定的延遲之後，所傳送的 `buttonDown` 事件前後的間隔，以毫秒為單位.	LabelButton
selectedDisabledIcon	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕處於選取狀態並且停用時，用來作為圖示的類別名稱。預設值為 `RadioButton_selectedDisabledIcon`。	RadioButton
selectedDisabledSkin	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當切換按鈕處於選取狀態並且停用時，用來作為背景與邊框之外觀元素的類別名稱.	LabelButton
selectedDownIcon	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕處於選取狀態並且按下滑鼠鈕時，用來作為圖示的類別名稱。預設值為 `RadioButton_selectedDownIcon`。	RadioButton
selectedDownSkin	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當切換按鈕處於選取狀態並且按下滑鼠鈕時，用來作為背景與邊框之外觀元素的類別名稱.	LabelButton
selectedOverIcon	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕處於選取狀態並且滑鼠位於此組件上方時，用來作為圖示的類別名稱。預設值為 `RadioButton_selectedOverIcon`。	RadioButton
selectedOverSkin	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當切換按鈕處於選取狀態並且滑鼠位於此組件上方時，用來作為背景與邊框之外觀元素的類別名稱.	LabelButton
selectedUpIcon	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕處於選取狀態並且沒有按下滑鼠鈕時，用來作為圖示的類別名稱。預設值為 `RadioButton_selectedUpIcon`。	RadioButton
selectedUpSkin	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當切換按鈕處於選取狀態並且滑鼠不是位於組件上方時，用來作為背景與邊框之外觀元素的類別名稱.	LabelButton
textFormat	類型: flash.text.TextFormat 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來繪製組件標籤的 TextFormat 物件.	UIComponent
textPadding	類型: Number 格式: Length 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 介於文字與組件邊緣之間的距離，以及介於文字與圖示之間的距離，以像素為單位。預設值為 `5`。	RadioButton
upIcon	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當切換按鈕不是處於選取狀態並且滑鼠不是位於按鈕上方時，用來作為圖示的類別名稱。預設值為 `RadioButton_upIcon`。	RadioButton
upSkin	類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕不是處於選取狀態並且滑鼠不是位於組件上方時，用來作為背景與邊框之外觀元素的類別名稱.	LabelButton

公用常數

隱藏繼承公用常數

顯示繼承公用常數

	常數		定義自
		version : String = "3.0.3.1" 組件的版本號碼。	UIComponent

屬性詳細資訊

autoRepeat

屬性

autoRepeat:Boolean[覆寫]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

選項按鈕依定義永遠無法自動重複，因此在建構函式中，autoRepeat 屬性會設定為 false，而且無法變更。

實作
override public function get autoRepeat():Boolean
override public function set autoRepeat(value:Boolean):void

group

屬性

group:RadioButtonGroup

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

此 RadioButton 所屬的 RadioButtonGroup 物件。

實作
public function get group():RadioButtonGroup
public function set group(value:RadioButtonGroup):void

範例 ( 如何使用本範例 )

下列範例將示範如何建立具有不同群組的選項按鈕：


import fl.controls.RadioButton;
import fl.controls.RadioButtonGroup;

var rbg1:RadioButtonGroup = new RadioButtonGroup("group1");
var rbg2:RadioButtonGroup = new RadioButtonGroup("group2");

var rb1:RadioButton = new RadioButton();
var rb2:RadioButton = new RadioButton();
var rb3:RadioButton = new RadioButton();
var rb4:RadioButton = new RadioButton();

rb1.group = rbg1;
rb2.group = rbg1;
rb3.group = rbg2;
rb4.group = rbg2;

rb1.move(10,10);
rb2.move(10,50);
rb3.move(150,10);
rb4.move(150,50);

addChild(rb1);
addChild(rb2);
addChild(rb3);
addChild(rb4);

groupName

屬性

groupName:String

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

選項按鈕實體或群組的群組名稱。您可以使用這個屬性，取得或設定選項按鈕實體的群組名稱，或是選項按鈕群組的群組名稱。

預設值為 "RadioButtonGroup"。

實作
public function get groupName():String
public function set groupName(value:String):void

範例 ( 如何使用本範例 )

下列範例將示範如何判斷所按下之選項按鈕的群組名稱。

import fl.controls.RadioButton;
import fl.controls.RadioButtonGroup;

var rbg1:RadioButtonGroup = new RadioButtonGroup("group1");
var rbg2:RadioButtonGroup = new RadioButtonGroup("group2");

var rb1:RadioButton = new RadioButton();
var rb2:RadioButton = new RadioButton();
var rb3:RadioButton = new RadioButton();
var rb4:RadioButton = new RadioButton();
rb1.addEventListener(MouseEvent.CLICK, announceGroup);
rb2.addEventListener(MouseEvent.CLICK, announceGroup);
rb3.addEventListener(MouseEvent.CLICK, announceGroup);
rb4.addEventListener(MouseEvent.CLICK, announceGroup);
rb1.group = 
rb2.group = rbg1;
rb3.group =
rb4.group = rbg2;
rb1.move(10,10);
rb2.move(10,50);
rb3.move(150,10);
rb4.move(150,50);

addChild(rb1);
addChild(rb2);
addChild(rb3);
addChild(rb4);

function announceGroup(e:MouseEvent):void {
    var rb:RadioButton = e.target as RadioButton;
    trace(rb.groupName);
}

selected

屬性

selected:Boolean[覆寫]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會指出目前已選取 (true) 或取消選取 (false) 選項按鈕。您只能將此值設定為 true，將它設定為 false 不會有任何作用。若要達到所需的特效，請在相同的選項按鈕群組中選取不同的選項按鈕。

預設值為 false。

實作
override public function get selected():Boolean
override public function set selected(value:Boolean):void

toggle

屬性

toggle:Boolean[覆寫]

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

選項按鈕是切換按鈕。其 toggle 屬性在建構函式中設定為 true，而且無法變更。

預設值為 true。

實作
override public function get toggle():Boolean
override public function set toggle(value:Boolean):void

擲回值

Error — 您無法於 RadioButton 設定這個屬性。

value

屬性

value:Object

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

與選項按鈕相關聯的使用者定義值。

預設值為 null。

實作
public function get value():Object
public function set value(value:Object):void

建構函式詳細資料

()

建構函式

public function RadioButton()

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

建立新的 RadioButton 組件實體。

方法詳細資訊

drawFocus

()

方法

override public function drawFocus(focused:Boolean):void

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會顯示或隱藏此組件實體周圍的焦點指示器。

參數

focused:Boolean — 顯示或隱藏焦點指示器。

getStyleDefinition

()

方法

public static function getStyleDefinition():Object

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

會擷取目前組件的預設樣式對應。視組件使用的樣式而定，樣式對應會包含適用於組件的類型。例如，disabledTextFormat 樣式會包含 null 值或 TextFormat 物件。您可以使用這些樣式，並針對目前的組件呼叫 setStyle()。下列程式碼會覆寫指定組件上預設的 disabledTextFormat 樣式：

componentInstance.setStyle("disabledTextFormat", new TextFormat());

傳回值

Object — 預設的樣式物件。

範例 ( 如何使用本範例 )

下列範例會為幾個組件類別建立樣式瀏覽器：

import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}

事件詳細資訊

change

事件

事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.CHANGE

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

當選項按鈕實體的 selected 屬性變更時傳送。

Event.CHANGE 常數會定義 change 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`bubbles`	`true`
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`target`	其值遭到修改的物件。 `target` 不會永遠都是顯示清單中註冊事件偵聽程式的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

範例 ( 如何使用本範例 )

下列範例會建立三個 RadioButton 組件實體，並偵聽 click 和 change 事件：


import fl.controls.RadioButton;

var radio1:RadioButton = new RadioButton();
radio1.label = "Option A";
radio1.move(10, 10);
radio1.addEventListener(MouseEvent.CLICK, clickHandler);
radio1.addEventListener(Event.CHANGE, changeHandler);
addChild(radio1);

var radio2:RadioButton = new RadioButton();
radio2.label = "Option B";
radio2.move(10, 30);
radio2.addEventListener(MouseEvent.CLICK, clickHandler);
radio2.addEventListener(Event.CHANGE, changeHandler);
addChild(radio2);

var radio3:RadioButton = new RadioButton();
radio3.label = "Option C";
radio3.move(10, 50);
radio3.addEventListener(MouseEvent.CLICK, clickHandler);
radio3.addEventListener(Event.CHANGE, changeHandler);
addChild(radio3);

function clickHandler(event:MouseEvent):void {
    trace("click:", event.currentTarget.label);
}

function changeHandler(event:Event):void {
    trace("change:", event.currentTarget.label);
}

click

事件

事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.CLICK

語言版本:

ActionScript 3.0

產品版本:

Flash CS3

執行階段版本:

Flash Player 9.0.28.0, AIR 1.0

當使用者使用滑鼠或空白鍵按一下選項按鈕時傳送。

定義 type 屬性值 (click 事件物件)。

這個事件具有下列屬性：

屬性	值
`altKey`	如果 Alt 鍵為作用中 (Windows)，則為 `true`。
`bubbles`	`true`
`buttonDown`	click 事件的這個值一律為 `false`。
`cancelable`	`false`；沒有要取消的預設行為指令。
`commandKey`	在 Mac 中，如果 Command 鍵為作用中，則為 `true`；如果已停用則為 `false`。在 Windows 中一定為 `false`。
`controlKey`	如果 Ctrl 或 Control 鍵為作用中，則為 `true`；如果已停用，則為 `false`。
`ctrlKey`	在 Windows 或 Linux 中，如果 Ctrl 鍵為作用中，則為 `true`；在 Mac 中，如果 Ctrl 鍵或 Command 鍵為作用中，則為 `true`；否則為 `false`。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`localX`	相對於包含的 Sprite，事件發生的水平座標 (如果停用滑鼠鎖定)。
`localY`	相對於包含的 Sprite，事件發生的垂直座標 (如果停用滑鼠鎖定)。
`movementX`	自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
`movementY`	自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
`shiftKey`	如果 Shift 鍵為作用中，則為 `true`；若已停用，則為 `false`。
`stageX`	在全域舞台座標上，事件發生的水平座標。
`stageY`	在全域舞台座標上，事件發生的垂直座標。
`target`	位於指標裝置下方的 InteractiveObject 實體。 `target` 不會永遠都是顯示清單中註冊事件偵聽程式的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

範例 ( 如何使用本範例 )

下列範例會建立三個 RadioButton 組件實體，並偵聽 click 和 change 事件：


import fl.controls.RadioButton;

var radio1:RadioButton = new RadioButton();
radio1.label = "Option A";
radio1.move(10, 10);
radio1.addEventListener(MouseEvent.CLICK, clickHandler);
radio1.addEventListener(Event.CHANGE, changeHandler);
addChild(radio1);

var radio2:RadioButton = new RadioButton();
radio2.label = "Option B";
radio2.move(10, 30);
radio2.addEventListener(MouseEvent.CLICK, clickHandler);
radio2.addEventListener(Event.CHANGE, changeHandler);
addChild(radio2);

var radio3:RadioButton = new RadioButton();
radio3.label = "Option C";
radio3.move(10, 50);
radio3.addEventListener(MouseEvent.CLICK, clickHandler);
radio3.addEventListener(Event.CHANGE, changeHandler);
addChild(radio3);

function clickHandler(event:MouseEvent):void {
    trace("click:", event.currentTarget.label);
}

function changeHandler(event:Event):void {
    trace("change:", event.currentTarget.label);
}

範例如何使用本範例

RadioButtonExample.as

此範例將示範如何使用 RadioButton 類別建立基本的測驗系統。

將 RadioButton、Button 和 Label 組件加入元件庫。
將這個程式碼儲存成 RadioButtonExample.as，並與您的 FLA 存放在相同的目錄中。
將 FLA 中的 DocumentClass 設定為 RadioButtonExample。

package
{
    import flash.text.TextFieldAutoSize;
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import fl.controls.RadioButton;
    import fl.controls.RadioButtonGroup;
    import fl.controls.Label;
    import fl.controls.Button;
    
    public class RadioButtonExample extends Sprite
    {
        private var j:uint;
        private var padding:uint = 10;
        private var currHeight:uint = 0;
        private var verticalSpacing:uint = 30;

        private var rbg:RadioButtonGroup;
        private var questionLabel:Label;
        private var answerLabel:Label;        
        private var question:String = "What day is known internationally as Speak Like A Pirate Day?"
        private var answers:Array = [ "August 12", "March 4", "September 19", "June 22" ];
        
        public function RadioButtonExample() {
            setupQuiz();    
        }
        private function setupQuiz():void {
            setupQuestionLabel();
            setupRadioButtons();
            setupButton();
            setupAnswerLabel();
        }
        private function setupQuestionLabel():void {
            questionLabel = new Label();
            questionLabel.text = question;
            questionLabel.autoSize = TextFieldAutoSize.LEFT;
            questionLabel.move(padding,padding + currHeight);
            
            currHeight += verticalSpacing;
            addChild(questionLabel);
        }
        private function setupAnswerLabel():void {
            answerLabel = new Label();
            answerLabel.autoSize = TextFieldAutoSize.LEFT;
            answerLabel.move(padding + 120,padding + currHeight);
            
            addChild(answerLabel);            
        }
        private function setupRadioButtons():void {
            rbg = new RadioButtonGroup("question1");
            createRadioButton(answers[0], rbg);
            createRadioButton(answers[1], rbg);
            createRadioButton(answers[2], rbg);
            createRadioButton(answers[3], rbg);
        }
        private function setupButton():void {
            var b:Button = new Button();
            b.move(padding,padding + currHeight);
            b.label = "Check Answer";
            b.addEventListener(MouseEvent.CLICK,checkAnswer);
            
            addChild(b);
        }
        private function createRadioButton(rbLabel:String,rbg:RadioButtonGroup):void {
            var rb:RadioButton = new RadioButton();
            rb.group = rbg;
            rb.label = rbLabel;
            rb.move(padding, padding + currHeight);
            addChild(rb);

            currHeight += verticalSpacing;
        }
        private function checkAnswer(e:MouseEvent):void {
            if(!rbg.selection.label) answerLabel.text = "Select an answer.";
            else {
                var resultStr:String = rbg.selection.label == answers[2] ? "Correct" : "Incorrect";
                answerLabel.text = resultStr;
            }
        }
    }
}

法律聲明 | 線上隱私權政策

RadioButton - AS3 Flash

類別 x

autoRepeat

group

groupName

selected

toggle

value

RadioButton

drawFocus

getStyleDefinition

change

click