CSSStyleDeclaration

Paket	mx.styles
Klasse	public class CSSStyleDeclaration
Vererbung	CSSStyleDeclaration EventDispatcher Object
Unterklassen	AdvancedDataGridColumn, DataGridColumn

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die CSSStyleDeclaration-Klasse stellt einen Satz CSS-Stilregeln dar. Der MXML-Compiler generiert automatisch ein CSSStyleDeclaration-Objekt für jeden Selektor in den CSS-Dateien, der mit einer Flex-Anwendung verknüpft ist.

Eine CSS-Regel wie

      Button { color: #FF0000 }

wirkt sich auf jede Instanz der Button-Klasse aus. Ein Selektor wie Button wird Typselektor genannt und darf nicht mit einem Punkt beginnen.

Eine CSS-Regel wie

      .redButton { color: #FF0000 }

wirkt sich nur auf Komponenten aus, deren styleName-Eigenschaft auf "redButton" gesetzt ist. Ein Selektor wie .redButton wird Klassenselektor genannt und muss mit einem Punkt beginnen.

Sie können auf die automatisch generierten CSSStyleDeclaration-Objekte zugreifen, indem Sie die StyleManager.getStyleDeclaration()-Methode aufrufen und ihr einen Typselektor

  var buttonDeclaration:CSSStyleDeclaration =
      StyleManager.getStyleDeclaration("Button");

oder einen Klassenselektor übergeben.

  var redButtonStyleDeclaration:CSSStyleDeclaration =
      StyleManager.getStyleDeclaration(".redButton");

Mit den Methoden getStyle(), setStyle() und clearStyle() können Sie Stileigenschaften einer CSSStyleDeclaration abrufen, einstellen und löschen.

Mit der StyleManager.setStyleDeclaration()-Methode können Sie außerdem eine CSSStyleDeclaration zur Laufzeit erstellen und installieren:

  var newStyleDeclaration:CSSStyleDeclaration = new CSSStyleDeclaration(".bigMargins");
  newStyleDeclaration.defaultFactory = function():void
  {
      leftMargin = 50;
      rightMargin = 50;
  }
  StyleManager.setStyleDeclaration(".bigMargins", newStyleDeclaration, true);

Verwandte API-Elemente

mx.core.UIComponent
mx.styles.StyleManager

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		defaultFactory : Function Diese Funktion wird normalerweise durch den MXML-Compiler automatisch generiert, wenn sie nicht null ist.	CSSStyleDeclaration
		factory : Function Diese Funktion wird normalerweise durch den MXML-Compiler automatisch generiert, wenn sie nicht null ist.	CSSStyleDeclaration
		overrides : Object Wenn die setStyle()-Methode für eine UIComponent oder CSSStyleDeclaration zur Laufzeit aufgerufen wird, speichert dieses Objekt die festgelegten Name/Wert-Paare. Sie überschreiben die Name/Wert-Paare in den Objekten, die durch die von den defaultFactory- und factory-Eigenschaften angegebenen Methoden erzeugt werden.	CSSStyleDeclaration
		selector : CSSSelector Diese Eigenschaft ist der Basisselektor für eine mögliche Selektorkette und Bedingungen zur Zuordnung von CSS-Stildeklarationen zu Komponenten.	CSSStyleDeclaration
		selectorIndex : int = 0 Die Reihenfolge, in der diese CSSStyleDeclaration in den StyleManager aufgenommen wurde.	CSSStyleDeclaration
		specificity : int [schreibgeschützt] Bestimmt die Priorität, wenn mehrere Stildeklarationen auf eine Komponente angewendet werden.	CSSStyleDeclaration
		subject : String [schreibgeschützt] Das Subjekt beschreibt den Namen einer Komponente, die eine mögliche Entsprechung für diese Stildeklaration darstellt.	CSSStyleDeclaration

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		CSSStyleDeclaration(selector:Object = null, styleManager:IStyleManager2 = null, autoRegisterWithStyleManager:Boolean = true) Konstruktor.	CSSStyleDeclaration
		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
		clearStyle(styleProp:String):void Löscht eine Stileigenschaft dieser CSSStyleDeclaration.	CSSStyleDeclaration
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		getStyle(styleProp:String):* Ruft den Wert für eine angegebene Stileigenschaft ab, die durch diese CSSStyleDeclaration bestimmt wird.	CSSStyleDeclaration
		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
		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
		matchesStyleClient(object:IAdvancedStyleClient):Boolean Bestimmt mithilfe der Selektorkette, ob diese Stildeklaration auf die angegebene Komponente anwendbar ist.	CSSStyleDeclaration
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		setStyle(styleProp:String, newValue:*):void Legt eine Stileigenschaft für diese CSSStyleDeclaration fest.	CSSStyleDeclaration
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		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 Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Ereignis		Übersicht	Definiert von
		activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
		deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher

Eigenschaftendetails

defaultFactory

Eigenschaft

defaultFactory:Function

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Diese Funktion wird normalerweise durch den MXML-Compiler automatisch generiert, wenn sie nicht null ist. Sie erstellt Kopien eines einfachen Objekts wie { leftMargin: 10, rightMargin: 10 } mit Name/Wert-Paaren für Stileigenschaften. Mit dem Objekt wird ein Knoten in der Prototypkette für die Suche nach Stileigenschaften erstellt.

Wenn diese CSSStyleDeclaration zu einer in MXML geschriebenen UIComponent gehört, kodiert diese Funktion die Stilattribute, die im Stamm-Tag der Komponentendefinition angegeben sind.

Wenn die UIComponent in ActionScript geschrieben wurde, ist diese Eigenschaft null.

Implementierung
public function get defaultFactory():Function
public function set defaultFactory(value:Function):void

factory

Eigenschaft

factory:Function

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wenn diese CSSStyleDeclaration zu einer UIComponent gehört, kodiert diese Funktion die Stilattribute, die in MXML für eine Instanz dieser Komponente angegeben wurden.

Implementierung
public function get factory():Function
public function set factory(value:Function):void

overrides

Eigenschaft

overrides:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wenn die setStyle()-Methode für eine UIComponent oder CSSStyleDeclaration zur Laufzeit aufgerufen wird, speichert dieses Objekt die festgelegten Name/Wert-Paare. Sie überschreiben die Name/Wert-Paare in den Objekten, die durch die von den defaultFactory- und factory-Eigenschaften angegebenen Methoden erzeugt werden.

Implementierung
public function get overrides():Object
public function set overrides(value:Object):void

selector

Eigenschaft

selector:CSSSelector

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Diese Eigenschaft ist der Basisselektor für eine mögliche Selektorkette und Bedingungen zur Zuordnung von CSS-Stildeklarationen zu Komponenten.

Implementierung
public function get selector():CSSSelector
public function set selector(value:CSSSelector):void

selectorIndex

Eigenschaft

public var selectorIndex:int = 0

Die Reihenfolge, in der diese CSSStyleDeclaration in den StyleManager aufgenommen wurde. MatchStyleDeclarations muss die Deklarationen in der Reihenfolge zurückgeben, in der sie deklariert wurden.

specificity

Eigenschaft

specificity:int [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Bestimmt die Priorität, wenn mehrere Stildeklarationen auf eine Komponente angewendet werden. Wenn Stildeklarationen die gleiche Priorität haben, hat die letzte Vorrang.

Implementierung
public function get specificity():int

subject

Eigenschaft

subject:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Das Subjekt beschreibt den Namen einer Komponente, die eine mögliche Entsprechung für diese Stildeklaration darstellt. Das Subjekt wird durch den am weitesten rechts befindlichen einfachen Typselektor in einer möglichen Selektorkette bestimmt.

Implementierung
public function get subject():String

Konstruktordetails

()

Konstruktor

public function CSSStyleDeclaration(selector:Object = null, styleManager:IStyleManager2 = null, autoRegisterWithStyleManager:Boolean = true)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Parameter

	`selector:Object` (default = `null`) — Wenn der Selektor ein CSSSelector ist, werden erweiterte CSS-Selektoren unterstützt. Wenn ein String für den Selektor verwendet wird, werden nur einfache CSS-Selektoren unterstützt. Wenn der String mit einem Punkt beginnt, wird er als universeller Klassenselektor betrachtet, andernfalls als einfacher Typselektor. Bei einem anderen Wert als null wird CSSStyleDeclaration beim StyleManager registriert.

	`styleManager:IStyleManager2` (default = `null`) — Der Stilmanager, in den diese Deklaration eingefügt wird. Wenn styleManager „null“ ist, wird der Stilmanager auf oberster Ebene verwendet.

	`autoRegisterWithStyleManager:Boolean` (default = `true`) — Wenn „true“, wird der Selektor im styleManager festgelegt. Der Selektor wird nur festgelegt, wenn sowohl `selektor` als auch `styleManager` nicht null sind.

Methodendetails

clearStyle

()

Methode

public function clearStyle(styleProp:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Löscht eine Stileigenschaft dieser CSSStyleDeclaration. Dies entspricht dem Festlegen von undefined für den Stilwert.

Parameter

styleProp:String — Der Name der style-Eigenschaft.

getStyle

()

Methode

public function getStyle(styleProp:String):*

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ruft den Wert für eine angegebene Stileigenschaft ab, die durch diese CSSStyleDeclaration bestimmt wird.

Ein Wert mit einem beliebigen Typ kann zurückgegeben werden.

Die Werte null, "", false, NaN und 0 sind gültige Stilwerte, der Wert undefined jedoch nicht. Er zeigt an, dass der entsprechende Stil für diese CSSStyleDeclaration nicht festgelegt ist. Mit der Methode StyleManager.isValidStyleValue() können Sie den zurückgegebenen Wert testen.

Parameter

styleProp:String — Der Name der style-Eigenschaft.

Rückgabewerte

* — Der Wert der angegebenen Stileigenschaft, falls eingestellt, andernfalls undefined.

matchesStyleClient

()

Methode

public function matchesStyleClient(object:IAdvancedStyleClient):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Bestimmt mithilfe der Selektorkette, ob diese Stildeklaration auf die angegebene Komponente anwendbar ist.

Parameter

object:IAdvancedStyleClient — Die Komponente, die mit der Stildeklaration verglichen werden soll.

Rückgabewerte

Boolean — Gibt „true“ zurück, wenn diese Stildeklaration auf die Komponente anwendbar ist, andernfalls „false“.

setStyle

()

Methode

public function setStyle(styleProp:String, newValue:*):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Legt eine Stileigenschaft für diese CSSStyleDeclaration fest.

Parameter

	`styleProp:String` — Der Name der style-Eigenschaft.

	`newValue:*` — Der Wert der Stileigenschaft. Der Wert kann einen beliebigen Typ aufweisen. Die Werte `null`, `""`, `false`, `NaN` und `0` sind gültige Stilwerte, der Wert `undefined` jedoch nicht. Das Festlegen des Werts `undefined` für eine Stileigenschaft entspricht einem Aufruf der `clearStyle()`-Methode.

Rechtliche Hinweise | Onlinedatenschutzerklärung

CSSStyleDeclaration - AS3 Flex

Klassen x

defaultFactory

factory

overrides

selector

selectorIndex

specificity

subject