fl.controls.Button (ActionScript 3.0)

Paket	fl.controls
Klasse	public class Button
Vererbung	Button LabelButton BaseButton UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
Implementiert	IFocusManagerComponent

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9.0.28.0

Die Button-Komponente ist eine häufig verwendete rechteckige Schaltfläche. Button-Komponenten zeigen eine Textbeschriftung, ein Symbol oder beides an.

Eine Button-Komponente ist in der Regel mit einer Ereignisprozedur-Methode verknüpft, bei der ein Listener für ein click-Ereignis zum Einsatz kommt, und die die angegebene Aufgabe nach dem Auslösen des click-Ereignisses ausführt. Wenn der Benutzer auf eine aktivierte Schaltfläche klickt, löst die Schaltfläche click- und buttonDown-Ereignisse aus. Eine Schaltfläche löst selbst dann andere Ereignisse aus, wenn sie nicht aktiviert ist. Dazu gehören mouseMove, mouseOver, mouseOut, rollOver, rollOut, mouseDown und mouseUp.

Sie können die Darstellung der Schaltfläche ändern, indem Sie für jeden Schaltflächenstatus eine andere Skin festlegen. Button-Komponenten können auch als Standardschaltfläche oder Schaltfläche mit Umschaltfunktion eingerichtet werden.

Beispiele anzeigen

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften verbergen

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		accessibilityProperties : AccessibilityProperties Die aktuellen Eingabehilfenoptionen für dieses Anzeigeobjekt.	DisplayObject
		alpha : Number Gibt den Alphatransparenzwert des angegebenen Objekts an.	DisplayObject
		autoRepeat : Boolean Ruft einen booleschen Wert ab, der angibt, ob das buttonDown-Ereignis mehr als einmal ausgelöst wird, wenn der Benutzer die Maustaste über der Komponente gedrückt hält, oder legt diesen fest.	BaseButton
		blendMode : String Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll.	DisplayObject
		buttonMode : Boolean Legt den Schaltflächenmodus für dieses Sprite fest.	Sprite
		cacheAsBitmap : Boolean Wird diese Eigenschaft auf "true" gesetzt, speichert Flash Player eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache.	DisplayObject
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		contextMenu : ContextMenu Gibt das diesem Objekt zugeordnete Kontextmenü an.	InteractiveObject
		doubleClickEnabled : Boolean Gibt an, ob das Objekt doubleClick-Ereignisse empfängt.	InteractiveObject
		dropTarget : DisplayObject [read-only] Gibt das Anzeigeobjekt an, über das der Sprite gezogen wird oder auf dem der Sprite abgelegt wurde.	Sprite
		emphasized : Boolean Ruft einen Booleschen Wert ab bzw. legt einen Booleschen Wert fest, der angibt, ob um die Button-Komponente ein Rand erstellt wird, wenn der Schaltflächenstatus "up" aktiviert ist.	Button
		enabled : Boolean Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Komponente eine Benutzereingabe annehmen kann.	BaseButton
		filters : Array Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält.	DisplayObject
		focusEnabled : Boolean Ruft einen booleschen Wert ab, der angibt, ob die Komponente den Fokus erhalten kann, wenn der Benutzer darauf klickt, oder legt diesen fest.	UIComponent
		focusManager : IFocusManager Ruft den FocusManager-Wert ab bzw. legt den FocusManager-Wert fest, der den Fokus für diese und gleichrangige Komponenten steuert.	UIComponent
		focusRect : Object Gibt an, ob für dieses Objekt ein Fokus-Rechteck angezeigt wird.	InteractiveObject
		graphics : Graphics [read-only] Legt das Graphics-Objekt fest, das zu diesem Sprite gehört und für das Vektorzeichnungsbefehle zulässig sind.	Sprite
		height : Number Ruft die Höhe der Komponente in Pixeln ab oder legt diese fest.	UIComponent
		hitArea : Sprite Gibt als Kollisionsbereich für ein Sprite ein anderes Sprite an.	Sprite
		label : String Ruft die Textbezeichnung für die Komponente ab oder legt diese fest.	LabelButton
		labelPlacement : String Position der Beschriftung im Verhältnis zum angegebenen Symbol.	LabelButton
		loaderInfo : LoaderInfo [read-only] Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört.	DisplayObject
		mask : DisplayObject Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert.	DisplayObject
		mouseChildren : Boolean Bestimmt, ob die dem Objekt untergeordneten Objekte per Maus aktivierbar sind.	DisplayObjectContainer
		mouseEnabled : Boolean Gibt an, ob dieses Objekt Meldungen von der Maus empfängt.	InteractiveObject
		mouseFocusEnabled : Boolean Ruft einen Wert ab, der angibt, ob die Komponente den Fokus erhalten kann, wenn der Benutzer darauf klickt, oder legt diesen fest.	UIComponent
		mouseX : Number [read-only] Gibt die x-Koordinate der Mausposition in Pixel an.	DisplayObject
		mouseY : Number [read-only] Gibt die y-Koordinate der Mausposition in Pixel an.	DisplayObject
		name : String Gibt den Instanznamen des Anzeigeobjekts an.	DisplayObject
		numChildren : int [read-only] Liefert die Anzahl der Objekte, die diesem Objekt untergeordnet sind.	DisplayObjectContainer
		opaqueBackground : Object Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist.	DisplayObject
		parent : DisplayObjectContainer [read-only] Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält.	DisplayObject
		prototype : Object [static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.	Object
		root : DisplayObject [read-only] Bei einem Anzeigeobjekt in einer geladenen SWF-Datei ist die root-Eigenschaft das oberste Anzeigeobjekt in dem Teil der Baumstruktur der Anzeigeliste, der diese SWF-Datei repräsentiert.	DisplayObject
		rotation : Number Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an.	DisplayObject
		scale9Grid : Rectangle Das aktuell verwendete Skalierungsraster.	DisplayObject
		scaleX : Number Multipliziert die aktuelle Breite der Komponente mit einem Skalierungsfaktor.	UIComponent
		scaleY : Number Multipliziert die aktuelle Höhe der Komponente mit einem Skalierungsfaktor.	UIComponent
		scrollRect : Rectangle Die Begrenzungen des Bildlaufrechtecks für das Anzeigeobjekt.	DisplayObject
		selected : Boolean Ruft einen Booleschen Wert ab bzw. legt einen Booleschen Wert fest, der angibt, ob eine Schaltfläche mit Umschaltfunktion aktiviert oder deaktiviert ist.	LabelButton
		soundTransform : SoundTransform Steuert den Sound innerhalb dieses Sprites.	Sprite
		stage : Stage [read-only] Die Bühne des Anzeigeobjekts.	DisplayObject
		tabChildren : Boolean Bestimmt, ob die dem Objekt untergeordneten Objekte per Tabulatortaste aktivierbar sind.	DisplayObjectContainer
		tabEnabled : Boolean Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet.	InteractiveObject
		tabIndex : int Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an.	InteractiveObject
		textField : TextField Ein Bezug auf das interne Textfeld einer Komponente.	LabelButton
		textSnapshot : TextSnapshot [read-only] Liefert ein TextSnapshot-Objekt für diese DisplayObjectContainer-Instanz.	DisplayObjectContainer
		toggle : Boolean Ruft einen Booleschen Wert ab bzw. legt einen Booleschen Wert fest, der angibt, ob es sich um eine Schaltfläche mit Umschaltfunktion handelt.	LabelButton
		transform : Transform Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören.	DisplayObject
		useHandCursor : Boolean Ein boolescher Wert, der angibt, ob der Handcursor angezeigt werden soll, wenn die Maus über ein Sprite-Objekt geführt wird, dessen buttonMode-Eigenschaft auf "true" gesetzt ist.	Sprite
		version : String = "3.0.0.15" Die Versionsnummer der Komponenten.	UIComponent
		visible : Boolean Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob die Komponenteninstanz sichtbar ist.	UIComponent
		width : Number Ruft die Breite der Komponente in Pixeln ab oder legt diese fest.	UIComponent
		x : Number Ruft die X-Koordinate ab, die die Position der Komponente auf der X-Achse innerhalb des übergeordneten Containers angibt.	UIComponent
		y : Number Ruft die Y-Koordinate ab, die die Position der Komponente auf der Y-Achse innerhalb des übergeordneten Containers angibt.	UIComponent

Öffentliche Methoden

Vererbte öffentliche Methoden verbergen

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		Button() Erstellt eine neue Instanz der Button-Komponente.	Button
		addChild(child:DisplayObject):DisplayObject Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu.	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu.	DisplayObjectContainer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	EventDispatcher
		areInaccessibleObjectsUnderPoint(point:Point):Boolean Gibt an, ob aufgrund der Sicherheitseinschränkungen irgendwelche Anzeigeobjekte aus der Liste ausgeschlossen werden, die beim Aufrufen der DisplayObjectContainer.getObjectsUnderPoint()-Methode mit dem angegebenen point-Punkt zurückgegeben wird.	DisplayObjectContainer
		clearStyle(style:String):void Löscht eine Stileigenschaft aus dieser Komponenteninstanz.	UIComponent
		contains(child:DisplayObject):Boolean Ermittelt, ob das angegebene Anzeigeobjekt der DisplayObjectContainer-Instanz oder der Instanz selbst untergeordnet ist.	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		drawFocus(focused:Boolean):void Blendet die Fokusanzeige auf dieser Komponente ein oder aus.	UIComponent
		drawNow():void Leitet einen unmittelbaren Erstellungsvorgang ein, ohne sämtliche Elemente wie bei "invalidateNow" zu entwerten.	UIComponent
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert.	DisplayObject
		getChildAt(index:int):DisplayObject Gibt die untergeordnete Anzeigeobjektinstanz zurück, die sich an der angegebenen Indexposition befindet.	DisplayObjectContainer
		getChildByName(name:String):DisplayObject Gibt das untergeordnete Anzeigeobjekt für den angegebenen Namen zurück.	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int Gibt die Indexposition einer untergeordneten DisplayObject-Instanz zurück.	DisplayObjectContainer
		getFocus():InteractiveObject Ruft das Objekt ab, das derzeit den Fokus hat.	UIComponent
		getObjectsUnderPoint(point:Point):Array Gibt ein Array an Objekten zurück, die unter dem angegebenen Punkt liegen und dieser DisplayObjectContainer-Instanz untergeordnet sind (auch über mehrere Unterordnungsstufen hinweg).	DisplayObjectContainer
		getRect(targetCoordinateSpace:DisplayObject):Rectangle Gibt ein Rechteck zurück, das die Begrenzung des Anzeigeobjekts (ohne etwaige Striche oder Formen) definiert, und zwar aufgrund des vom Parameter "targetCoordinateSpace" definierten Koordinatensystems.	DisplayObject
		getStyle(style:String):Object Ruft eine Stileigenschaft ab, die in der Stilkette der Komponente festgelegt ist.	UIComponent
		getStyleDefinition():Object [static] Ruft die Standardstilmatrix der aktuellen Komponente ab.	Button
		globalToLocal(point:Point):Point Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts.	DisplayObject
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		hitTestObject(obj:DisplayObject):Boolean Wertet das Anzeigeobjekt aus, um festzustellen, ob es das Anzeigeobjekt "obj" überdeckt oder schneidet.	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter "x" und "y" festgelegten Punkt überdeckt oder schneidet.	DisplayObject
		invalidate(property:String, callLater:Boolean = true):void Entwertet eine Eigenschaft und erstellt die Komponente im nächsten Bild neu, sofern nicht anderweitig festgelegt.	UIComponent
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		localToGlobal(point:Point):Point Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten.	DisplayObject
		mergeStyles(... list):Object [static] Führt Stile aus mehreren Klassen in einem Objekt zusammen.	UIComponent
		move(x:Number, y:Number):void Verschiebt die Komponente innerhalb der übergeordneten Komponente an die angegebene Position.	UIComponent
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeChild(child:DisplayObject):DisplayObject Entfernt die angegebene untergeordnete DisplayObject-Instanz aus der Child-Liste der DisplayObjectContainer-Instanz.	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject Entfernt ein untergeordnetes Anzeigeobjekt aus der angegebenen Indexposition in der Child-Liste des Anzeigeobjekt-Containers.	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setChildIndex(child:DisplayObject, index:int):void Ändert die Position eines vorhandenen untergeordneten Objekts im Anzeigeobjekt-Container.	DisplayObjectContainer
		setFocus():void Legt den Fokus auf diese Komponente.	UIComponent
		setMouseState(state:String):void Legt den Mausstatus mithilfe von ActionScript fest.	BaseButton
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		setSize(width:Number, height:Number):void Legt eine bestimmte Breite und Höhe für die Komponente fest.	UIComponent
		setStyle(style:String, value:Object):void Legt eine Stileigenschaft für diese Komponenteninstanz fest.	UIComponent
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Ermöglicht es Benutzern, das angegebene Sprite mit einer Ziehoperation zu verschieben.	Sprite
		stopDrag():void Beendet die startDrag()-Methode.	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void Kehrt die z-Reihenfolge (von vorne nach hinten) der beiden angegebenen untergeordneten Objekte um.	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void Kehrt die z-Reihenfolge (von vorne nach hinten) der untergeordneten Objekte an den beiden angegebenen Indexpositionen in der Child-Liste um.	DisplayObjectContainer
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		validateNow():void Die Eigenschaften und das Layout des Objekts werden geprüft und aktualisiert. Das Objekt wird ggf. neu erstellt.	UIComponent
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner vorangegangenen Elementen ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Vererbte Ereignisse verbergen

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	Wird ausgelöst, wenn Flash Player den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
added	Wird ausgelöst, wenn ein Objekt der Anzeigeliste hinzugefügt wird.	DisplayObject
addedToStage	Wird ausgelöst, wenn ein Anzeigeobjekt der Anzeigeliste für die Bühne hinzugefügt wird. Dies erfolgt entweder direkt oder über das Hinzufügen einer Unterstruktur, die das Anzeigeobjekt enthält.	DisplayObject
buttonDown	Wird ausgelöst, wenn der Benutzer auf die Button-Komponente klickt.	BaseButton
change	Wird ausgelöst, wenn sich der Wert der ausgewhlten Eigenschaft einer Button-Komponente mit Umschaltfunktion ändert.	BaseButton
click	Wird ausgelöst, nachdem die Schaltfläche mit Umschaltfunktion eine Eingabe von der Maus oder von der Leertaste erhalten hat.	LabelButton
deactivate	Wird ausgelöst, wenn Flash Player den Betriebssystemfokus verliert und inaktiv wird.	EventDispatcher
doubleClick	Wird ausgelöst, wenn der Benutzer die Haupttaste des Zeigegeräts zweimal schnell hintereinander über dem gleichen InteractiveObject-Objekt drückt und das doubleClickEnabled-Flag des Objekts "true" lautet.	InteractiveObject
enterFrame	Wird ausgelöst, wenn der Abspielkopf ein neues Bild erreicht.	DisplayObject
focusIn	Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus erhalten hat.	InteractiveObject
focusOut	Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus verloren hat.	InteractiveObject
hide	Wird ausgelöst, wenn die Sichtbarkeit der Komponente von sichtbar zu unsichtbar wechselt.	UIComponent
keyDown	Wird ausgelöst, wenn der Benutzer eine Taste drückt.	InteractiveObject
keyFocusChange	Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe der Tastatur zu ändern.	InteractiveObject
keyUp	Wird ausgelöst, wenn der Benutzer eine Taste loslässt.	InteractiveObject
labelChange	Wird ausgelöst, wenn sich der Beschriftungswert ändert.	LabelButton
mouseDown	Wird ausgelöst, wenn im Flash Player-Fenster die Taste des Zeigegeräts über einer InteractiveObject-Instanz gedrückt wird.	InteractiveObject
mouseFocusChange	Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe eines Zeigegeräts zu ändern.	InteractiveObject
mouseMove	Wird ausgelöst, wenn der Benutzer das Zeigegerät bewegt, während es sich auf einer InteractiveObject-Instanz befindet.	InteractiveObject
mouseOut	Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt.	InteractiveObject
mouseOver	Wird ausgelöst, wenn das Zeigegerät im Flash Player-Fenster über eine InteractiveObject-Instanz bewegt wird.	InteractiveObject
mouseUp	Wird ausgelöst, wenn im Flash Player-Fenster die Taste des Zeigegeräts über einer InteractiveObject-Instanz losgelassen wird.	InteractiveObject
mouseWheel	Wird ausgelöst, wenn ein Mausrad im Flash Player-Fenster über einer InteractiveObject-Instanz betätigt wird.	InteractiveObject
move	Wird nach dem Verschieben einer Komponente ausgelöst.	UIComponent
removed	Wird ausgelöst, wenn ein Objekt aus der Anzeigeliste entfernt werden soll.	DisplayObject
removedFromStage	Wird ausgelöst, wenn ein Anzeigeobjekt aus der Anzeigeliste entfernt werden soll. Dies erfolgt entweder direkt oder über das Entfernen einer Unterstruktur, die das Anzeigeobjekt enthält.	DisplayObject
render	Wird ausgelöst, wenn die Anzeigeliste aktualisiert und neu gezeichnet werden soll.	DisplayObject
resize	Wird ausgelöst, wenn die Größe der Komponente geändert wird.	UIComponent
rollOut	Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt.	InteractiveObject
rollOver	Wird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt.	InteractiveObject
show	Wird ausgelöst, wenn die Sichtbarkeit der Komponente von unsichtbar zu sichtbar wechselt.	UIComponent
tabChildrenChange	Wird ausgelöst, wenn sich der Wert des tabChildren-Flags des Objekts ändert.	InteractiveObject
tabEnabledChange	Wird ausgelöst, wenn sich das tabEnabled-Flag des Objekts ändert.	InteractiveObject
tabIndexChange	Wird ausgelöst, wenn sich der Wert der tabIndex-Eigenschaft des Objekts ändert.	InteractiveObject

Stile

Vererbte Stile verbergen

Vererbte Stile anzeigen

	Beschreibung	Definiert von
disabledIcon	Typ: Class Name der Klasse, die als Symbol verwendet wird, wenn die Schaltfläche nicht deaktiviert ist.	LabelButton
disabledSkin	Typ: Class Name der Klasse, die als Skin für den Hintergrund und den Rand verwendet wird, wenn die Schaltfläche nicht ausgewählt ist und deaktiviert ist.	LabelButton
disabledTextFormat	Typ: flash.text.TextFormat Das TextFormat-Objekt, das verwendet wird, um die Komponentenbezeichnung wiederzugeben, wenn die Schaltfläche deaktiviert ist.	UIComponent
downIcon	Typ: Class Name der Klasse, die als Symbol verwendet wird, wenn die Schaltfläche nicht ausgewählt ist und die Maustaste gedrckt wird.	LabelButton
downSkin	Typ: Class Name der Klasse, die als Skin für den Hintergrund und den Rand verwendet wird, wenn die Schaltfläche nicht ausgewählt ist und die Maustaste gedrückt wird.	LabelButton
embedFonts	Typ: Boolean Gibt an, ob eingebettete Schriftkonturen für die Wiedergabe des Textfelds verwendet werden sollen.	LabelButton
emphasizedPadding	Typ: Number Format: Length Die Zellauffüllung, die um die Schaltflächen in einer Hervorhebungsskin angewendet wird, in Pixel. Der Standardwert lautet `2`.	Button
emphasizedSkin	Typ: Class Die Skin, die verwendet wird, wenn eine Schaltfläche hervorgehoben ist. Der Standardwert lautet `Button_emphasizedSkin`.	Button
focusRectPadding	Typ: Number Format: Length Die Zellauffüllung, die die äußeren Grenzen der Komponente von den äußeren Rändern der Fokusanzeige trennt, in Pixel.	UIComponent
focusRectSkin	Typ: Class Die Skin, die für die Anzeige von Fokusanzeigen verwendet wird.	UIComponent
icon	Typ: Class Name der Klasse, die als Symbol verwendet wird, wenn eine umschaltbare Schaltfläche nicht ausgewählt ist und der Mauszeiger sich nicht über der Schaltfläche befindet.	LabelButton
overIcon	Typ: Class Name der Klasse, die als Symbol verwendet wird, wenn die Schaltfläche nicht ausgewählt ist und sich der Mauszeiger über der Komponente befindet.	LabelButton
overSkin	Typ: Class Name der Klasse, die als Skin für den Hintergrund und den Rand verwendet wird, wenn die Schaltfläche nicht ausgewählt ist und sich der Mauszeiger über der Komponente befindet.	LabelButton
repeatDelay	Typ: Number Format: Time Die Anzahl der Millisekunden, die nach dem ersten Auslösen des `buttonDown`-Ereignisses gewartet werden soll, bevor ein zweites `buttonDown`-Ereignis ausgelöst wird.	LabelButton
repeatInterval	Typ: Number Format: Time Das Intervall in Millisekunden zwischen `buttonDown`-Ereignissen, die nach der Verzögerung, die durch den `repeatDelay`-Stil festgelegt wird, ausgelöst werden.	LabelButton
selectedDisabledIcon	Typ: Class Name der Klasse, die als Symbol verwendet wird, wenn die Schaltfläche ausgewählt und deaktiviert ist.	LabelButton
selectedDisabledSkin	Typ: Class Name der Klasse, die als Skin für den Hintergrund und den Rand verwendet wird, wenn eine umschaltbare Schaltfläche ausgewählt und deaktiviert ist.	LabelButton
selectedDownIcon	Typ: Class Name der Klasse, die als Symbol verwendet wird, wenn die Schaltfläche ausgewählt ist und die Maustaste gedrückt wird.	LabelButton
selectedDownSkin	Typ: Class Name der Klasse, die als Skin für den Hintergrund und den Rand verwendet wird, wenn eine umschaltbare Schaltfläche ausgewählt ist und die Maustaste gedrückt wird.	LabelButton
selectedOverIcon	Typ: Class Name der Klasse, die als Symbol verwendet wird, wenn die Schaltfläche ausgewählt ist und sich der Mauszeiger über der Komponente befindet.	LabelButton
selectedOverSkin	Typ: Class Name der Klasse, die als Skin für den Hintergrund und den Rand verwendet wird, wenn eine umschaltbare Schaltfläche ausgewählt ist und sich der Mauszeiger über der Komponente befindet.	LabelButton
selectedUpIcon	Typ: Class Name der Klasse, die als Symbol verwendet wird, wenn die Schaltfläche ausgewählt ist und die Maustaste nicht gedrückt wird.	LabelButton
selectedUpSkin	Typ: Class Name der Klasse, die als Skin für den Hintergrund und den Rand verwendet wird, wenn eine umschaltbare Schaltfläche ausgewählt ist und sich der Mauszeiger nicht über der Komponente befindet.	LabelButton
textFormat	Typ: flash.text.TextFormat Das TextFormat-Objekt, das für die Wiedergabe der Komponentenbezeichnung verwendet wird.	UIComponent
textPadding	Typ: Number Format: Length Der Abstand zwischen dem Text und den Rändern der Komponente sowie der Abstand zwischen dem Text und dem Symbol in Pixel.	LabelButton
upIcon	Typ: Class Name der Klasse, die als Symbol verwendet wird, wenn eine umschaltbare Schaltfläche nicht ausgewählt ist und der Mauszeiger sich nicht über der Schaltfläche befindet.	LabelButton
upSkin	Typ: Class Name der Klasse, die als Skin für den Hintergrund und den Rand verwendet wird, wenn die Schaltfläche nicht ausgewählt ist und sich der Mauszeiger nicht über der Komponente befindet.	LabelButton

Eigenschaftsdetail

emphasized

Eigenschaft

emphasized:Boolean [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9.0.28.0

Ruft einen Booleschen Wert ab bzw. legt einen Booleschen Wert fest, der angibt, ob um die Button-Komponente ein Rand erstellt wird, wenn der Schaltflächenstatus "up" aktiviert ist. Der Wert true gibt an, dass um die Schaltfläche im Status "up" ein Rand erstellt wird, der Wert false, dass kein Rand erstellt wird.

Der Standardwert lautet false.

Implementierung
public function get emphasized():Boolean
public function set emphasized(value:Boolean):void

Siehe auch

emphasizedPadding
emphasizedSkin

Beispiel

Im folgenden Beispiel wird der Stil emphasizedPadding der Button-Instanz entsprechend dem Wert einer Slider-Komponente festgelegt:


import fl.controls.Button;
import fl.controls.Slider;
import fl.events.SliderEvent;

var styleObject:Object = Button.getStyleDefinition();
var defaultEmphasizedPadding:uint = styleObject.emphasizedPadding;

var myButton:Button = new Button();
myButton.label = "emphasizedPadding:" + defaultEmphasizedPadding;
myButton.emphasized = true;
myButton.width = 150;
myButton.move(20, 20);
addChild(myButton);

var mySlider:Slider = new Slider();
mySlider.snapInterval = 1;
mySlider.tickInterval = 1;
mySlider.liveDragging = true;
mySlider.value = defaultEmphasizedPadding;
mySlider.width = myButton.width;
mySlider.move(20, 60);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

function changeHandler(event:SliderEvent):void {
    myButton.label = "emphasizedPadding:" + event.value;
    myButton.setStyle("emphasizedPadding", event.value);
}

Konstruktordetail

Button

()

Konstruktor

public function Button()

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9.0.28.0

Erstellt eine neue Instanz der Button-Komponente.

Methodendetail

getStyleDefinition

()

Methode

public static function getStyleDefinition():Object

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9.0.28.0

Ruft die Standardstilmatrix der aktuellen Komponente ab. Die Stilmatrix enthält den für die Komponente geeigneten Typ und hängt von dem Stil ab, der von der Komponente verwendet wird. Der Stil disabledTextFormat enthält beispielsweise den Wert null oder ein TextFormat-Objekt. Sie können diese Stile verwenden und setStyle() für die aktuelle Komponente aufrufen. Mit folgendem Code wird der Standardstil disabledTextFormat der angegebenen Komponente überschrieben:

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

Rückgabewerte

Object — Das standardmäßige Stilobjekt.

Siehe auch

UIComponent.getStyle()
UIComponent.setStyle()
StyleManager

Beispiel

Im folgenden Beispiel wird ein Stilbrowser für mehrere Komponentenklassen erstellt:

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;
}

Beispiele Verwendung von Beispielen

ButtonExample.as

Im folgenden Beispiel wird gezeigt, wie Sie Schaltflächen dynamisch erstellen und diesen Stile zuweisen.

Gehen Sie wie folgt vor, um das Beispiel auszuführen:

Fügen Sie die Button- und TextArea-Komponenten zur Bibliothek hinzu.
Speichern Sie diesen Code unter "ButtonExample.as" im gleichen Verzeichnis wie die FLA-Datei.
Geben Sie "ButtonExample" als Dokumentklasse in der FLA-Datei an.

package
{
    import fl.controls.Button;
    import fl.controls.TextArea;
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextFormat;
    
    public class ButtonExample extends Sprite
    {
        private var b1:Button;
        private var b2:Button;      
        private var b3:Button;
        private var ta:TextArea;
        
        public function ButtonExample() {
            createTraceField();
            setupButtons();
        }
        private function createTraceField():void {
            ta = new TextArea();
            ta.setSize(200, 300);
            ta.move(200, 10);
            addChild(ta);
        }
        private function setupButtons():void {
            b1 = new Button();
            b2 = new Button();
            b3 = new Button();

            b1.width = 160;
            b2.width = 160;
            b3.width = 160;

            b1.move(10,10);
            b2.move(10,40);
            b3.move(10,70);

            b1.label = "Default Button";
            b2.label = "Custom Styled Button";
            b3.label = "Toggle Button";

            b2.setStyle("textFormat", new TextFormat("Georgia"));

            b3.toggle = true;
            
            b1.addEventListener(MouseEvent.CLICK, buttonClick);
            b2.addEventListener(MouseEvent.CLICK, buttonClick);
            b3.addEventListener(MouseEvent.CLICK, buttonClick);

            addChild(b1);
            addChild(b2);
            addChild(b3);
        }
        private function buttonClick(e:MouseEvent) {
            var button:Button = e.target as Button;
            ta.appendText(button.label + "\n");
        }
    }
}

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/fl/controls/Button.html

Komponenten-Referenzhandbuch für ActionScript 3.0		Alle Pakete \| Alle Klassen \| Sprachelemente \| Stichwortverzeichnis \| Anhänge \| Konventionen \| Frames Keine Frames
Button	Eigenschaften \| Methoden \| Ereignisse \| Stile \| Beispiele