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 

StyleProxy  - AS3 Flex

Paketmx.styles
Klassepublic class StyleProxy
VererbungStyleProxy Inheritance Object
Implementiert IAdvancedStyleClient

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Schließt ein Objekt ein, das die IAdvancedStyleClient-Schnittstelle implementiert. Diese Schnittstelle unterstützt eine filterMap-Eigenschaft, die Stilquell-/Stilzielpaare enthält.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  className : String
[schreibgeschützt] Der Name der Komponentenklasse.
StyleProxy
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  filterMap : Object
Ein Satz Stringpaare.
StyleProxy
  id : String
[schreibgeschützt] Die Identität der Komponente.
StyleProxy
  inheritingStyles : Object
Ein Objekt mit den vererbbaren Stilen für diese Komponente.
StyleProxy
  nonInheritingStyles : Object
Ein Objekt mit den nicht vererbbaren Stilen für diese Komponente.
StyleProxy
  source : IStyleClient
Das Objekt, das die IStyleClient-Schnittstelle implementiert.
StyleProxy
  styleDeclaration : CSSStyleDeclaration
Die Stildeklaration, die die von diesem Objekt deklarierten Inline-Stile enthält.
StyleProxy
  styleName : Object
Die Quelle der Stilwerte dieses Objekts.
StyleProxy
  styleParent : IAdvancedStyleClient
Das übergeordnete Element des IAdvancedStyleClient.
StyleProxy
Öffentliche Methoden
 MethodeDefiniert von
  
StyleProxy(source:IStyleClient, filterMap:Object)
Konstruktor.
StyleProxy
  
Löscht eine Stileigenschaft aus dieser Komponenteninstanz.
StyleProxy
  
Gibt einen Array von CSSStyleDeclaration-Objekten für den Typselektor zurück, der auf diese Komponente anzuwenden ist, oder „null“, wenn keiner existiert.
StyleProxy
  
getStyle(styleProp:String):*
Ruft eine Stileigenschaft ab, die an einer beliebigen Stelle in der Stilkette der Komponente festgelegt ist.
StyleProxy
  
Gibt true zurück, wenn currentCSSState ungleich null ist.
StyleProxy
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 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.
StyleProxy
  
Bestimmt, ob diese Instanz dem angegebenen Typ entspricht oder eine Unterklasse davon ist.
StyleProxy
  
Propagiert die Stiländerungen bis zu den untergeordneten Komponenten dieser Komponente.
StyleProxy
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
Legt die internen Stilcachewerte fest, sodass die getStyle()-Methode funktioniert.
StyleProxy
  
Registriert den EffectManager als einen der Ereignis-Listener für jedes Effekt-Ereignis.
StyleProxy
 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.
StyleProxy
  
Wird ausgelöst, wenn der Wert einer Stileigenschaft geändert wird.
StyleProxy
  
Flex ruft die stylesInitialized()-Methode auf, wenn die Stile für eine Komponente zum ersten Mal initialisiert werden.
StyleProxy
 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
Eigenschaftendetails

className

Eigenschaft
className:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Der Name der Komponentenklasse.



Implementierung
    public function get className():String

filterMap

Eigenschaft 
filterMap:Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ein Satz Stringpaare. Das erste Element des Stringpaars ist der Name des Stils in der Quellkomponente. Das zweite Element des Stringpaars ist der Name des Stils in der Unterkomponente. Mit diesem Objekt können Sie einen bestimmten Stil in einer übergeordneten Komponente einem anderen Stil in der Unterkomponente zuweisen. Dies ist nützlich, wenn übergeordnete und untergeordnete Komponente den gleichen Stil verwenden, Sie jedoch die Werte getrennt steuern möchten.



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

id

Eigenschaft 
id:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Identität der Komponente.



Implementierung
    public function get id():String

inheritingStyles

Eigenschaft 
inheritingStyles:Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ein Objekt mit den vererbbaren Stilen für diese Komponente.



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

nonInheritingStyles

Eigenschaft 
nonInheritingStyles:Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ein Objekt mit den nicht vererbbaren Stilen für diese Komponente.



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

source

Eigenschaft 
source:IStyleClient

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das Objekt, das die IStyleClient-Schnittstelle implementiert. Dabei handelt es sich um das über die Proxy-Klasse zugänglich gemachte Objekt.



Implementierung
    public function get source():IStyleClient
    public function set source(value:IStyleClient):void

styleDeclaration

Eigenschaft 
styleDeclaration:CSSStyleDeclaration

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

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

styleName

Eigenschaft 
styleName:Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

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
Laufzeitversionen: Flash Player 10, AIR 1.5

Das übergeordnete Element des IAdvancedStyleClient. Normalerweise weisen Sie diese Eigenschaft nicht direkt zu. Sie wird von den Methoden addChild, addChildAt, removeChild und removeChildAt des flash.display.DisplayObjectContainer sowie den mx.core.UIComponent.addStyleClient()- und mx.core.UIComponent.removeStyleClient()-Methoden festgelegt. Wenn ein Wert direkt zugewiesen wird, ohne eine der oben genannten Methoden aufzurufen, übernimmt die Instanz der Klasse, die diese Schnittstelle implementiert, keine Stile von der UIComponent oder dem DisplayObject. Wenn ein Wert darüber hinaus direkt zugewiesen, ohne zunächst die Objekte aus dem aktuellen übergeordneten Element mithilfe der oben aufgeführten Methoden zu entfernen, kann dies zum Arbeitsspeicherverlust führen.



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

StyleProxy

()Konstruktor
public function StyleProxy(source:IStyleClient, filterMap:Object)

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Konstruktor.

Parameter
source:IStyleClient — Das Objekt, das die IStyleClient-Schnittstelle implementiert.
 
filterMap:Object — Der Satz Stile, der von der Quelle an die Unterkomponente übergeben werden soll.
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 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 3
Laufzeitversionen: Flash Player 9, AIR 1.1

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 3
Laufzeitversionen: Flash Player 9, AIR 1.1

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.

matchesCSSState

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

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.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
Laufzeitversionen: Flash Player 10, AIR 1.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 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Propagiert die Stiländerungen bis zu den untergeordneten Komponenten dieser Komponente.

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 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Legt die internen Stilcachewerte fest, sodass die getStyle()-Methode funktioniert. Wenn dieses Objekt bereits untergeordnete Objekte hat, werden die Stilcaches der untergeordneten Objekte reinitialisiert.

Parameter

recursive:Boolean — Regeneriert die Prototypketten der untergeordneten Komponenten.

registerEffects

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

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

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 3
Laufzeitversionen: Flash Player 9, AIR 1.1

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 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wird ausgelöst, wenn der Wert einer Stileigenschaft geändert wird.

Parameter

styleProp:String — Der Name der geänderten Stileigenschaft.

stylesInitialized

()Methode 
public function stylesInitialized():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.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.