| Paket | mx.styles |
| Klasse | public class AdvancedStyleClient |
| Vererbung | AdvancedStyleClient  EventDispatcher Object |
| Implementiert | IAdvancedStyleClient, IFlexModule, IMXMLObject |
| Unterklassen | GlobalizationBase, Sort, SortField |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
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
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| className : String [schreibgeschützt]
Der Name der Komponentenklasse. | AdvancedStyleClient | ||
 | constructor : 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 | ||
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | AdvancedStyleClient | ||
| 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 | ||
|
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 | ||
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 | ||
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
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 | ||
|
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 | ||
|
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 | ||
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
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 | ||
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
className | Eigenschaft |
id | Eigenschaft |
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):voidmoduleFactory | 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):voidnonInheritingStyles | 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):voidstyleDeclaration | 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):voidVerwandte 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():IStyleManager2styleName | 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):voidstyleParent | 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):voidAdvancedStyleClient | () | Konstruktor |
public function AdvancedStyleClient()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Konstruktor.
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ückgabewerteArray — 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.
|
* — 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.
Boolean — true, 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.
|
Boolean — true, 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.
|
Boolean — true, 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.
Tue Jun 12 2018, 10:04 AM Z