ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.styles 

AdvancedStyleClient  - AS3 Flex

Paketmx.styles
Klassepublic class AdvancedStyleClient
VererbungAdvancedStyleClient Inheritance EventDispatcher Inheritance Object
Implementiert IAdvancedStyleClient, IFlexModule, IMXMLObject
Unterklassen GlobalizationBase, Sort, SortField

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Eine Basisklasse, die beim Implementieren eines Objekts verwendet werden kann, das die IAdvancedStyleClient-Schnittstelle verwendet. Die Basisklasse stellt Implementierungen der Methoden und Eigenschaften bereit, die ein Objekt für die Beteiligung am Stil-Subsystem benötigt.

Zusätzlich zur IAdvancedStyleClient-Schnittstelle implementiert dieses Objekt außerdem die IFlexModule- und IMXMLObject-Schnittstellen. Die IMXMLObject-Schnittstelle enthält eine initialized-Methode, die aufgerufen wird, wenn die Klasse mithilfe einer MXML-Deklaration instanziiert wird. Die Implementierung der von dieser Basisklasse bereitgestellten initialized-Methode fügt dem Dokumentobjekt, das die MXML-Deklaration enthält, die Klasseninstanz hinzu. Weitere Informationen finden Sie in der Beschreibung der initilized-Methode.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  className : String
[schreibgeschützt] Der Name der Komponentenklasse.
AdvancedStyleClient
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  id : String
Die Identität der Komponente.
AdvancedStyleClient
  inheritingStyles : Object
Ein Objekt, das die vererbbaren Stile für diese nichtvisuelle Stilclientinstanz enthält.
AdvancedStyleClient
  moduleFactory : IFlexModuleFactory
Eine Module-Factory wird als Kontext zum Suchen des Stilmanagers verwendet, der die Stile für diese nichtvisuelle Stilclientinstanz steuert.
AdvancedStyleClient
  nonInheritingStyles : Object
Beginn der Kette von Komponentenstilen, die keine Vererbungsstile sind.
AdvancedStyleClient
  styleDeclaration : CSSStyleDeclaration
Die Stildeklaration, die die von diesem Objekt deklarierten Inline-Stile enthält.
AdvancedStyleClient
  styleManager : IStyleManager2
[schreibgeschützt] Gibt die von dieser Komponente verwendete StyleManager-Instanz zurück.
AdvancedStyleClient
  styleName : Object
Die Quelle der Stilwerte dieses Objekts.
AdvancedStyleClient
  styleParent : IAdvancedStyleClient
Das übergeordnete Element einer Komponente wird zur Überprüfung der untergeordneten Selektoren verwendet.
AdvancedStyleClient
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
AdvancedStyleClient
 Inherited
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
  
Löscht eine Stileigenschaft aus dieser Komponenteninstanz.
AdvancedStyleClient
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
Gibt einen Array von CSSStyleDeclaration-Objekten für den Typselektor zurück, der auf diese Komponente anzuwenden ist, oder „null“, wenn keiner existiert.
AdvancedStyleClient
  
getStyle(styleProp:String):*
Ruft eine Stileigenschaft ab, die an einer beliebigen Stelle in der Stilkette der Komponente festgelegt ist.
AdvancedStyleClient
  
Gibt true zurück, wenn currentCSSState ungleich null ist.
AdvancedStyleClient
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
  
Die initialized-Methode wird aufgerufen, wenn diese Klasse oder eine Klasse, die diese Klasse erweitert, in einer MXML-Deklaration verwendet wird.
AdvancedStyleClient
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
Gibt „true“ zurück, wenn cssState mit currentCSSState übereinstimmt.
AdvancedStyleClient
  
Bestimmt, ob diese Instanz dem angegebenen Typ entspricht oder eine Unterklasse davon ist.
AdvancedStyleClient
  
Gibt Stiländerungen an die untergeordneten Elemente dieser Stilclientinstanz weiter.
AdvancedStyleClient
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
Legt die internen Stilcachewerte fest, sodass die getStyle()-Methode funktioniert.
AdvancedStyleClient
  
Registriert den EffectManager als einen der Ereignis-Listener für jedes Effekt-Ereignis.
AdvancedStyleClient
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
setStyle(styleProp:String, newValue:*):void
Legt eine Stileigenschaft für diese Komponenteninstanz fest.
AdvancedStyleClient
  
Erkennt Änderungen an Stileigenschaften.
AdvancedStyleClient
  
Flex ruft die stylesInitialized()-Methode auf, wenn die Stile für eine Komponente zum ersten Mal initialisiert werden.
AdvancedStyleClient
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Ü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
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
Eigenschaftendetails

className

Eigenschaft
className:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Der Name der Komponentenklasse.



Implementierung
    public function get className():String

id

Eigenschaft 
id:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Die Identität der Komponente.



Implementierung
    public function get id():String
    public function set id(value:String):void

inheritingStyles

Eigenschaft 
inheritingStyles:Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Ein Objekt, das die vererbbaren Stile für diese nichtvisuelle Stilclientinstanz enthält.



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

moduleFactory

Eigenschaft 
moduleFactory:IFlexModuleFactory

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Eine Module-Factory wird als Kontext zum Suchen des Stilmanagers verwendet, der die Stile für diese nichtvisuelle Stilclientinstanz steuert.



Implementierung
    public function get moduleFactory():IFlexModuleFactory
    public function set moduleFactory(value:IFlexModuleFactory):void

nonInheritingStyles

Eigenschaft 
nonInheritingStyles:Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Beginn der Kette von Komponentenstilen, die keine Vererbungsstile sind. Die getStyle()-Methode greift einfach auf nonInheritingStyles[styleName] zu, um die vollständige, mit dem Entwurf verknüpfte Kette zu durchsuchen. Dieses Objekt wird durch die initProtoChain()-Methode eingerichtet. Unter normalen Umständen brauchen Entwickler auf diese Eigenschaft nie direkt zuzugreifen.



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

styleDeclaration

Eigenschaft 
styleDeclaration:CSSStyleDeclaration

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Die Stildeklaration, die die von diesem Objekt deklarierten Inline-Stile enthält.



Implementierung
    public function get styleDeclaration():CSSStyleDeclaration
    public function set styleDeclaration(value:CSSStyleDeclaration):void

Verwandte API-Elemente

styleManager

Eigenschaft 
styleManager:IStyleManager2  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Gibt die von dieser Komponente verwendete StyleManager-Instanz zurück.



Implementierung
    public function get styleManager():IStyleManager2

styleName

Eigenschaft 
styleName:Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Die Quelle der Stilwerte dieses Objekts. Der Wert der styleName-Eigenschaft entspricht einem von drei Typen:

  • String, wie „headerStyle“. Der String gibt einen Klassenselektor an, der in einem CSS-Stylesheet definiert ist.
  • CSSStyleDeclaration, wie StyleManager.getStyleDeclaration(".headerStyle").
  • UIComponent. Das Objekt, das diese Schnittstelle implementiert, erbt alle Stilwerte von der referenzierten UIComponent.



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

styleParent

Eigenschaft 
styleParent:IAdvancedStyleClient

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Das übergeordnete Element einer Komponente wird zur Überprüfung der untergeordneten Selektoren verwendet. Ein übergeordnetes Element muss außerdem ein IAdvancedStyleClient sein, um an erweiterten Stildeklarationen teilzunehmen.



Implementierung
    public function get styleParent():IAdvancedStyleClient
    public function set styleParent(value:IAdvancedStyleClient):void
Konstruktordetails

AdvancedStyleClient

()Konstruktor
public function AdvancedStyleClient()

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Konstruktor.

Methodendetails

clearStyle

()Methode
public function clearStyle(styleProp:String):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Löscht eine Stileigenschaft aus dieser Komponenteninstanz.

Hierbei gibt die getStyle()-Methode nicht notwendigerweise undefined zurück.

Parameter

styleProp:String — Name der style-Eigenschaft.

getClassStyleDeclarations

()Methode 
public function getClassStyleDeclarations():Array

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Gibt einen Array von CSSStyleDeclaration-Objekten für den Typselektor zurück, der auf diese Komponente anzuwenden ist, oder null, wenn keiner existiert.

Beispiel: Angenommen, die Komponente MyButton erweitert Button. Diese Methode sucht zuerst nach einem MyButton-Selektor, dann nach einem Button-Typselektor, und schließlich nach einem UIComponent-Typselektor.

Rückgabewerte
Array — Array von CSSStyleDeclaration-Objekten.

getStyle

()Methode 
public function getStyle(styleProp:String):*

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Ruft eine Stileigenschaft ab, die an einer beliebigen Stelle in der Stilkette der Komponente festgelegt ist.

Mit dieser Methode wird eine beliebige Stileigenschaft abgerufen. Es kann also ein boolescher Wert, ein String, eine Zahl, eine Ganzzahl, eine vorzeichenlose Ganzzahl (für eine RGB-Farbe), eine Klasse (für eine Skin) oder ein beliebiges Objekt zurückgegeben werden. Deshalb ist als Rückgabetyp * angegeben.

Wenn Sie eine bestimmte Stileigenschaft abrufen, kennen Sie ihren Typ und möchten das Ergebnis häufig in einer Variable dieses Typs speichern. Sie können dazu entweder den as-Operator oder eine Coercion verwenden. Beispiel:

      var backgroundColor:uint = getStyle("backgroundColor") as int;
      
      or
      
      var backgroundColor:uint = int(getStyle("backgroundColor"));
      

Wenn die Stileigenschaft in der Stilkette nicht festgelegt wurde, lautet der Rückgabewert der getStyle()-Methode undefined. Beachten Sie, dass es sich bei undefined um einen speziellen Wert handelt, der sich von false, dem leeren String "", NaN, 0 oder null unterscheidet. Ein gültiger Stilwert kann niemals undefined sein. Mit der statischen Methode StyleManager.isValidStyleValue() können Sie überprüfen, ob der Wert festgelegt wurde.

Parameter

styleProp:String — Name der style-Eigenschaft.

Rückgabewerte
* — Der Stilwert.

hasCSSState

()Methode 
public function hasCSSState():Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.6
Laufzeitversionen: Flash Player 10, AIR 2.5

Gibt true zurück, wenn currentCSSState ungleich null ist. Normalerweise rufen Sie diese Methode nicht direkt auf. Sie wird von der mx.styles.CSSCondition.matchesStyleClient()-Methode aufgerufen.

Beachten Sie, dass Spark-Komponenten ihren Skinstatus als Pseudostatus verwenden. Halo-Komponenten verwenden die currentState-Eigenschaft.

Rückgabewerte
Booleantrue, wenn currentCSSState ungleich null ist. Standardmäßig ist currentCSSState mit currentState identisch. Gibt false zurück, wenn kein Status vorhanden ist.

initialized

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

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Die initialized-Methode wird aufgerufen, wenn diese Klasse oder eine Klasse, die diese Klasse erweitert, in einer MXML-Deklaration verwendet wird. Sie wird aufgerufen, nachdem das Implementierungsobjekt erstellt und sämtliche im MXML-Tag angegebenen Komponenteneigenschaften initialisiert wurden.

Wenn das Dokument, das dieses Objekt erstellt hat, eine UIComponent (z. B. Anwendung, Modul usw.) ist, wird die addStyleClient-Methode der UIComponent aufgerufen, um dieses Objekt der Liste nicht visueller Stilclients der UIComponent hinzuzufügen. So kann das Objekt die Stile aus dem Dokument übernehmen.

Parameter

document:Object — Das MXML-Dokument, das dieses Objekt erstellt hat.
 
id:String — Der vom Dokumentobjekt für den Verweis auf dieses Objekt verwendete Bezeichner.

matchesCSSState

()Methode 
public function matchesCSSState(cssState:String):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Gibt true zurück, wenn cssState mit currentCSSState übereinstimmt. Normalerweise rufen Sie diese Methode nicht direkt auf. Sie wird von der mx.styles.CSSCondition.matchesStyleClient()-Methode aufgerufen.

Beachten Sie, dass Spark-Komponenten ihren Skinstatus als Pseudostatus verwenden. Halo-Komponenten verwenden die currentState-Eigenschaft.

Parameter

cssState:String — Ein möglicher Wert von CSSCondition.value. Stellt den aktuellen Status dieser Komponente dar; wird zum Zuordnen von CSS-Pseudoselektoren verwendet.

Rückgabewerte
Booleantrue, wenn cssState mit currentCSSState übereinstimmt. Standardmäßig ist currentCSSState mit currentState identisch. Gibt null zurück, wenn kein Status vorhanden ist.

matchesCSSType

()Methode 
public function matchesCSSType(cssType:String):Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Bestimmt, ob diese Instanz dem angegebenen Typ entspricht oder eine Unterklasse davon ist. Normalerweise rufen Sie diese Methode nicht direkt auf. Sie wird von der mx.styles.CSSCondition.matchesStyleClient()-Methode aufgerufen.

Parameter

cssType:String — Ein CSSSelector-Objekt.

Rückgabewerte
Booleantrue, wenn cssType sich in der Hierarchie qualifizierter Typselektoren befindet.

notifyStyleChangeInChildren

()Methode 
public function notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Gibt Stiländerungen an die untergeordneten Elemente dieser Stilclientinstanz weiter. Ein nicht visueller Stilclient (d. h. ein Stilclient, der kein DisplayObject ist) verfügt über keine untergeordneten Elemente. Daher hat diese Methode keine Auswirkungen auf nicht visuelle Stilclients.

Parameter

styleProp:String — Name der style-Eigenschaft.
 
recursive:Boolean — Legt fest, ob die Stiländerungen an die den untergeordneten Komponenten nachgeordneten Komponenten propagiert werden.

regenerateStyleCache

()Methode 
public function regenerateStyleCache(recursive:Boolean):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Legt die internen Stilcachewerte fest, sodass die getStyle()-Methode funktioniert.

Parameter

recursive:Boolean — Regeneriert die Prototypketten der untergeordneten Komponenten.

registerEffects

()Methode 
public function registerEffects(effects:Array):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Registriert den EffectManager als einen der Ereignis-Listener für jedes Effekt-Ereignis.

Parameter

effects:Array — Ein Array von Strings mit Effektnamen.

setStyle

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

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Legt eine Stileigenschaft für diese Komponenteninstanz fest.

Dieser Stil kann einen global festgelegten Stil überschreiben.

Der Aufruf der setStyle()-Methode kann zu einer verringerten Leistung führen. Verwenden Sie diese Methode nur, wenn unbedingt notwendig.

Parameter

styleProp:String — Name der style-Eigenschaft.
 
newValue:* — Neuer Wert für den Stil.

styleChanged

()Methode 
public function styleChanged(styleProp:String):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Erkennt Änderungen an Stileigenschaften. Ist eine Stileigenschaft eingestellt, ruft Flex die styleChanged()-Methode auf und übergibt an sie den Namen des eingestellten Stils.

Dies ist eine erweiterte Methode, die Sie bei der Erstellung einer AdvancedStyleClient-Unterklasse überschreiben können. Wenn Sie eine benutzerdefinierte Klasse erstellen, können Sie die styleChanged()-Methode überschreiben, um den an sie übergebenen Stilnamen zu prüfen, und die Änderung entsprechend verarbeiten. Auf diese Weise können Sie das Standardverhalten eines vorhandenen Stils überschreiben oder Ihre eigenen benutzerdefinierten Stileigenschaften hinzufügen.

Parameter

styleProp:String — Der Name der Stileigenschaft oder „null“, wenn alle Stile für diesen Stilclient geändert wurden.

stylesInitialized

()Methode 
public function stylesInitialized():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10, AIR 2.5

Flex ruft die stylesInitialized()-Methode auf, wenn die Stile für eine Komponente zum ersten Mal initialisiert werden.





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.