IStyleManager - Adobe ActionScript® 3 (AS3 Flex) API-Referenz

Paket	mx.styles
Schnittstelle	public interface IStyleManager

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 2.0.1

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die IStyleManager-Klasse verwaltet Folgendes:

Welche CSS-Stileigenschaften die Klasse erbt
Welche Stileigenschaften Farben sind und daher gesondert behandelt werden
Eine Liste von Strings, die Aliasse für Farbwerte sind

Diese Schnittstelle wurde von Flex 2.0.1 verwendet. An ihre Stelle tritt in Flex 3 IStyleManager2.

Verwandte API-Elemente

mx.styles.CSSStyleDeclaration

Öffentliche Methoden

	Methode		Definiert von
		clearStyleDeclaration(selector:String, update:Boolean):void Löscht das CSSStyleDeclaration-Objekt, das die Regeln für den angegebenen CSS-Selektor speichert.	IStyleManager
		getColorName(colorName:Object):uint Gibt den numerischen RGB-Farbwert zurück, der dem angegebenen Farbstring entspricht.	IStyleManager
		getColorNames(colors:Array):void Konvertiert jedes Element des Farbarrays von einem Farbnamen in einen numerischen RGB-Farbwert.	IStyleManager
		getStyleDeclaration(selector:String):CSSStyleDeclaration Ruft das CSSStyleDeclaration-Objekt ab, in dem die Regeln für den angegegebenen CSS-Selektor gespeichert sind.	IStyleManager
		isColorName(colorName:String):Boolean Überprüft, ob der angegebene String ein Alias für einen Farbwert ist.	IStyleManager
		isInheritingStyle(styleName:String):Boolean Überprüft, ob ein Stil erbt.	IStyleManager
		isInheritingTextFormatStyle(styleName:String):Boolean Überprüft, ob ein TextFormat-Stil erbt.	IStyleManager
		isParentDisplayListInvalidatingStyle(styleName:String):Boolean Überprüft, ob der Stil sich auf den übergeordneten Container der Komponente auswirkt, sodass dieser bei einer Stiländerung neu gezeichnet wird.	IStyleManager
		isParentSizeInvalidatingStyle(styleName:String):Boolean Überprüft, ob der Stil die Größe des übergeordneten Containers der Komponente ändert.	IStyleManager
		isSizeInvalidatingStyle(styleName:String):Boolean Überprüft, ob ein Stil die Größe einer Komponente ändert.	IStyleManager
		isValidStyleValue(value:*):Boolean Bestimmt, ob ein angegebener Parameter eine gültige Stileigenschaft ist.	IStyleManager
		loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher Lädt eine Stil-SWF.	IStyleManager
		registerColorName(colorName:String, colorValue:uint):void Fügt der Liste der Farbaliasse einen Farbnamen hinzu.	IStyleManager
		registerInheritingStyle(styleName:String):void Fügt einen Stil der Liste von Stilen hinzu, die Werte von den übergeordneten Stilen erben können.	IStyleManager
		registerParentDisplayListInvalidatingStyle(styleName:String):void Fügt einen Stil der Liste von Stilen zu, die sich auf die Darstellung oder das Layout des übergeordneten Containers der Komponente auswirken können.	IStyleManager
		registerParentSizeInvalidatingStyle(styleName:String):void Fügt einen Stil der Liste von Stilen zu, die sich auf die gemessene Größe des übergeordneten Containers der Komponente auswirken können.	IStyleManager
		registerSizeInvalidatingStyle(styleName:String):void Fügt einen Stil der Liste von Stilen zu, die sich auf die gemessene Größe der Komponente auswirken können.	IStyleManager
		setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void Legt das CSSStyleDeclaration-Objekt fest, in dem die Regeln für den angegebenen CSS-Selektor gespeichert sind.	IStyleManager
		unloadStyleDeclarations(url:String, update:Boolean = true):void Entlädt eine Stil-SWF.	IStyleManager

Methodendetails

clearStyleDeclaration

()

Methode

public function clearStyleDeclaration(selector:String, update:Boolean):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Löscht das CSSStyleDeclaration-Objekt, das die Regeln für den angegebenen CSS-Selektor speichert.

Ist der angegebene Selektor ein Klassenselektor (beispielsweise „.bigMargins“ oder „.myStyle“), muss die selector-Eigenschaft mit einem Punkt (.) beginnen.

Ist der angegebene Selektor ein Typselektor (beispielsweise „Button“), darf die selector-Eigenschaft nicht mit einem Punkt beginnen.

Der globale Selektor ist dem Typselektor ähnlich und beginnt nicht mit einem Punkt.

Parameter

	`selector:String` — Der Name des CSS-Selektors, der gelöscht werden soll.

	`update:Boolean` — Setzen Sie diesen Parameter auf `true`, um eine sofortige Aktualisierung der Stile zu erzwingen. Setzen Sie diesen Parameter auf `false`, um eine sofortige Aktualisierung der Stile zu verhindern. Weitere Informationen zu dieser Methode finden Sie in der Beschreibung zur `setStyleDeclaration()`-Methode.

Verwandte API-Elemente

setStyleDeclaration()

getColorName

()

Methode

public function getColorName(colorName:Object):uint

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt den numerischen RGB-Farbwert zurück, der dem angegebenen Farbstring entspricht. Der Farbstring kann ein Farbname wie "red", "Blue" oder "haloGreen" (Klein- oder Großschreibung ist nicht von Bedeutung), ein hexadezimaler Wert wie 0xFF0000 oder ein #-hexadezimaler Wert wie "#FF0000" sein.

Diese Methode gibt einen uint-Wert wie 4521830 zurück, der eine Farbe darstellt. Sie können diesen uint-Wert in einen hexadezimalen Wert konvertieren, indem Sie die numerische Basis (in diesem Fall 16) der toString()-Methode der uint-Klasse übergeben, wie im folgenden Beispiel gezeigt:

      import mx.styles.StyleManager;
      private function getNewColorName():void {
          StyleManager.registerColorName("soylentGreen",0x44FF66);
          trace(StyleManager.getColorName("soylentGreen").toString(16));
      }

Parameter

colorName:Object — Der Name der Farbe.

Rückgabewerte

uint — Gibt eine vorzeichenlose Ganzzahl zurück, die dem Farbwert oder NOT_A_COLOR entspricht, wenn der Wert der colorName-Eigenschaft kein Alias für eine Farbe ist.

getColorNames

()

Methode

public function getColorNames(colors:Array):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konvertiert jedes Element des Farbarrays von einem Farbnamen in einen numerischen RGB-Farbwert. Jeder Farbstring kann ein Farbname wie "red", "Blue" oder "haloGreen" (Klein- oder Großschreibung ist nicht von Bedeutung), ein hexadezimaler Wert wie 0xFF0000 oder ein #-hexadezimaler Wert wie "#FF0000" sein.

Parameter

colors:Array — Ein Array von Farbnamen.

getStyleDeclaration

()

Methode

public function getStyleDeclaration(selector:String):CSSStyleDeclaration

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ruft das CSSStyleDeclaration-Objekt ab, in dem die Regeln für den angegegebenen CSS-Selektor gespeichert sind.

Wenn der selector-Parameter mit einem Punkt (.) beginnt, ist die zurückgegebene CSSStyleDeclaration ein Klassenselektor und nur auf Instanzen anwendbar, in deren styleName-Eigenschaft dieser Selektor (ohne Punkt) angegeben ist. Beispielsweise ist der Klassenselektor ".bigMargins" auf jede UIComponent anwendbar, deren styleName dem Wert "bigMargins" entspricht.

Wenn der selector-Parameter nicht mit einem Punkt beginnt, ist die zurückgegebene CSSStyleDeclaration ein Typselektor und auf alle Instanzen dieses Typs anwendbar. Beispielsweise ist der Typselektor "Button" auf jede Button-Instanz und deren Unterklassen anwendbar.

Der globale Selektor ist dem Typselektor ähnlich und beginnt nicht mit einem Punkt.

Parameter

selector:String — Der Name des CSS-Selektors.

Rückgabewerte

CSSStyleDeclaration — Die Stildeklaration, deren Name der selector-Eigenschaft entspricht.

isColorName

()

Methode

public function isColorName(colorName:String):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Überprüft, ob der angegebene String ein Alias für einen Farbwert ist. Beispielsweise ist der String „blue“ standardmäßig ein Alias für 0x0000FF.

Parameter

colorName:String — Der zu überprüfende Farbname. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Rückgabewerte

Boolean — Gibt true zurück, wenn colorName ein Alias für eine Farbe ist.

isInheritingStyle

()

Methode

public function isInheritingStyle(styleName:String):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Überprüft, ob ein Stil erbt.

Parameter

styleName:String — Der Name des zu überprüfenden Strings.

Rückgabewerte

Boolean — Gibt den Wert true zurück, wenn der angegebene String erbt.

isInheritingTextFormatStyle

()

Methode

public function isInheritingTextFormatStyle(styleName:String):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Überprüft, ob ein TextFormat-Stil erbt.

Parameter

styleName:String — Der Name des zu überprüfenden Strings.

Rückgabewerte

Boolean — Gibt den Wert true zurück, wenn der angegebene TextFormat-Stil erbt.

isParentDisplayListInvalidatingStyle

()

Methode

public function isParentDisplayListInvalidatingStyle(styleName:String):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Überprüft, ob der Stil sich auf den übergeordneten Container der Komponente auswirkt, sodass dieser bei einer Stiländerung neu gezeichnet wird.

Wenn einer dieser Stile mit setStyle() festgelegt wurde, wird automatisch die invalidateDisplayList()-Methode des übergeordneten Containers der Komponente aufgerufen, um die untergeordneten Elemente neu zu zeichnen und/oder das Layout neu festzulegen.

Parameter

styleName:String — Der name des zu überprüfenden Stils.

Rückgabewerte

Boolean — Gibt den Wert true zurück, wenn der angegebene Stil die Darstellung oder das Layout des übergeordneten Containers der Komponente bestimmt.

isParentSizeInvalidatingStyle

()

Methode

public function isParentSizeInvalidatingStyle(styleName:String):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Überprüft, ob der Stil die Größe des übergeordneten Containers der Komponente ändert.

Wenn einer dieser Stile mit setStyle() festgelegt wurde, wird automatisch die invalidateSize()-Methode des übergeordneten Containers der Komponente aufgerufen, um die gemessene Größe später neu zu berechnen.

Parameter

styleName:String — Der name des zu überprüfenden Stils.

Rückgabewerte

Boolean — Gibt den Wert true zurück, wenn der angegebene Stil die gemessene Größe des übergeordneten Containers der Komponente bestimmt.

isSizeInvalidatingStyle

()

Methode

public function isSizeInvalidatingStyle(styleName:String):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Überprüft, ob ein Stil die Größe einer Komponente ändert.

Wenn einer dieser Stile mit dersetStyle()-Methode festgelegt wurde, wird automatisch die invalidateSize()-Methode aufgerufen, um die gemessene Größe später neu zu berechnen.

Parameter

styleName:String — Der name des zu überprüfenden Stils.

Rückgabewerte

Boolean — Gibt den Wert true zurück, wenn der angegebene Stil die gemessene Größe der Komponente bestimmt.

isValidStyleValue

()

Methode

public function isValidStyleValue(value:*):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bestimmt, ob ein angegebener Parameter eine gültige Stileigenschaft ist. Beispiel:

      trace(StyleManager.isValidStyleValue(myButton.getStyle("color")).toString());

Dies kann nützlich sein, da einige Stile auf Werte wie 0, NaN, den leeren String ("") oder null gesetzt werden können, die zum Fehlschlagen einer if (value)-Überprüfung führen können.

Parameter

value:* — Die zu überprüfende Stileigenschaft.

Rückgabewerte

Boolean — Wenn Sie den durch einen getStyle()-Methodenaufruf zurückgegebenen Wert an diese Methode übergeben, wird true zurückgegeben, wenn der Stil festgelegt wurde, andernfalls false.

loadStyleDeclarations

()

Methode

 public function loadStyleDeclarations(url:String, update:Boolean = true, trustContent:Boolean = false, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 9, AIR 1.1

Lädt eine Stil-SWF.

Parameter

	`url:String` — Speicherort der Stil-SWF.

	`update:Boolean` (default = `true`) — Setzen Sie diesen Parameter auf `true`, um eine sofortige Aktualisierung der Stile zu erzwingen. Setzen Sie diesen Parameter auf `false`, um eine sofortige Aktualisierung der Stile zu verhindern. Dieser Parameter ist optional und standardmäßig auf `true` gesetzt. Weitere Informationen zu diesem Parameter finden Sie in der Beschreibung zur `setStyleDeclaration()`-Methode.

	`trustContent:Boolean` (default = `false`) — Veraltet, wird nicht mehr verwendet. Dieser Parameter ist optional und standardmäßig `false`.

	`applicationDomain:ApplicationDomain` (default = `null`) — Die ApplicationDomain, die an die `load()`-Methode der IModuleInfo-Klasse übergeben wurde, die die Stil-SWF lädt. Dieser Parameter ist optional und standardmäßig `null`.

	`securityDomain:SecurityDomain` (default = `null`) — Die SecurityDomain, die an die `load()`-Methode der IModuleInfo-Klasse übergeben wurde, die die Stil-SWF lädt. Dieser Parameter ist optional und standardmäßig `null`.

Rückgabewerte

IEventDispatcher — Eine IEventDispatcher-Implementierung, die StyleEvent.PROGRESS, StyleEvent.COMPLETE und StyleEvent.ERROR unterstützt.

Verwandte API-Elemente

setStyleDeclaration()

registerColorName

()

Methode

public function registerColorName(colorName:String, colorValue:uint):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fügt der Liste der Farbaliasse einen Farbnamen hinzu.

Parameter

	`colorName:String` — Der Name der hinzuzufügenden Farbe, beispielsweise „blau“. Bei einem späteren Zugriff auf den Farbnamen ist die Groß- oder Kleinschreibung nicht von Bedeutung.

	`colorValue:uint` — Farbwert, beispielsweise 0x0000FF.

registerInheritingStyle

()

Methode

public function registerInheritingStyle(styleName:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fügt einen Stil der Liste von Stilen hinzu, die Werte von den übergeordneten Stilen erben können.

Hinweis: Vermeiden Sie doppelte Stilnamen, da Konflikte die Leistung verringern können, wenn ein bereits verwendeter Stil vererbt wird.

Parameter

styleName:String — Der Name des Stils, der der Liste von Stilen hinzugefügt wird, die Werte erben können.

registerParentDisplayListInvalidatingStyle

()

Methode

public function registerParentDisplayListInvalidatingStyle(styleName:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fügt einen Stil der Liste von Stilen zu, die sich auf die Darstellung oder das Layout des übergeordneten Containers der Komponente auswirken können. Wenn einer dieser Stile mit setStyle() festgelegt wurde, wird automatisch die invalidateDisplayList()-Methode des übergeordneten Containers der Komponente aufgerufen, um die untergeordneten Elemente neu zu zeichnen und/oder das Layout neu festzulegen.

Parameter

styleName:String — Der Name des zu registrierenden Stils.

registerParentSizeInvalidatingStyle

()

Methode

public function registerParentSizeInvalidatingStyle(styleName:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fügt einen Stil der Liste von Stilen zu, die sich auf die gemessene Größe des übergeordneten Containers der Komponente auswirken können.

Parameter

styleName:String — Der Name des zu registrierenden Stils.

registerSizeInvalidatingStyle

()

Methode

public function registerSizeInvalidatingStyle(styleName:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fügt einen Stil der Liste von Stilen zu, die sich auf die gemessene Größe der Komponente auswirken können. Wenn einer dieser Stile mit setStyle() festgelegt wurde, wird automatisch die invalidateSize()-Methode aufgerufen, um die gemessene Größe später neu zu berechnen.

Parameter

styleName:String — Der Name des Stils, den Sie der Liste hinzufügen.

setStyleDeclaration

()

Methode

public function setStyleDeclaration(selector:String, styleDeclaration:CSSStyleDeclaration, update:Boolean):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Legt das CSSStyleDeclaration-Objekt fest, in dem die Regeln für den angegebenen CSS-Selektor gespeichert sind.

Wenn der selector-Parameter mit einem Punkt (.) beginnt, ist der angegebene Selektor ein Klassenselektor und nur für Instanzen anwendbar, in deren styleName-Eigenschaft dieser Selektor angegeben ist (ohne Punkt). Beispielsweise ist der Klassenselektor ".bigMargins" auf jede UIComponent anwendbar, deren styleName dem Wert "bigMargins" entspricht.

Wenn der selector-Parameter nicht mit einem Punkt beginnt, ist der angegebene Selektor ein Typselektor und auf alle Instanzen dieses Typs anwendbar. Beispielsweise ist der Typselektor "Button" auf jede Button-Instanz und deren Unterklassen anwendbar.

Der globale Selektor ist dem Typselektor ähnlich und beginnt nicht mit einem Punkt.

Parameter

	`selector:String` — Der Name des CSS-Selektors.

	`styleDeclaration:CSSStyleDeclaration` — Die neue Stildeklaration.

	`update:Boolean` — Setzen Sie diesen Parameter auf `true`, um eine sofortige Aktualisierung der Stile zu erzwingen. Intern ruft Flex die `styleChanged()`-Methode der UIComponent auf. Setzen Sie diesen Parameter auf `false`, um eine sofortige Aktualisierung der Stile zu verhindern. Diese Stile werden aktualisiert, wenn eine der folgenden Methoden das nächste Mal aufgerufen wird und ihre `update`-Eigenschaft auf `true` gesetzt ist: `clearStyleDeclaration()` `loadStyleDeclarations()` `setStyleDeclaration()` `unloadStyleDeclarations()` Wenn Sie eine dieser Methoden mehrmals aufrufen, setzen Sie diese Eigenschaft normalerweise nur beim letzten Aufruf auf `true`, sodass Flex die `styleChanged()`-Methode nicht mehrmals ausführt. Wenn Sie die `getStyle()`-Methode aufrufen, gibt Flex den Stilwert zurück, der zuletzt auf die UIComponent durch einen Aufruf der `styleChanged()`-Methode angewendet wurde. Die Darstellung der Komponente entspricht möglicherweise nicht dem durch die `getStyle()`-Methode zurückgegebenen Wert. Das kann daran liegen, dass diese Stildeklarationsmethoden noch nicht aktualisiert wurden (`update`-Eigenschaft auf `true` gesetzt).

unloadStyleDeclarations

()

Methode

public function unloadStyleDeclarations(url:String, update:Boolean = true):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Entlädt eine Stil-SWF.

Parameter

	`url:String` — Speicherort der Stil-SWF.

	`update:Boolean` (default = `true`) — Setzen Sie diesen Parameter auf `true`, um eine sofortige Aktualisierung der Stile zu erzwingen. Setzen Sie diesen Parameter auf `false`, um eine sofortige Aktualisierung der Stile zu verhindern. Weitere Informationen zu dieser Methode finden Sie in der Beschreibung zur `setStyleDeclaration()`-Methode.

Verwandte API-Elemente

setStyleDeclaration()

Rechtliche Hinweise | Onlinedatenschutzerklärung

IStyleManager - AS3 Flex

Klassen x

clearStyleDeclaration

getColorName

getColorNames

getStyleDeclaration

isColorName

isInheritingStyle

isInheritingTextFormatStyle

isParentDisplayListInvalidatingStyle

isParentSizeInvalidatingStyle

isSizeInvalidatingStyle

isValidStyleValue

loadStyleDeclarations

registerColorName

registerInheritingStyle

registerParentDisplayListInvalidatingStyle

registerParentSizeInvalidatingStyle

registerSizeInvalidatingStyle

setStyleDeclaration

unloadStyleDeclarations