Paket | mx.core |
Klasse | public class UIComponentDescriptor |
Vererbung | UIComponentDescriptor ComponentDescriptor Object |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die meisten Tags in einer MXML-Datei beschreiben eine aus UIComponent-Objekten bestehende Baumstruktur. Beispiel: Das <mx:Application>
-Tag repräsentiert ein UIComponent-Objekt, und seine untergeordneten Container und Steuerelemente sind alle UIComponent-Objekte.
Der MXML-Compiler kompiliert jedes dieser MXML-Tags in einer UIComponentDescriptor-Instanz. Genauer gesagt, generiert der MXML-Compiler automatisch eine ActionScript-Datenstruktur, welche eine Baumstruktur bestehend aus UIComponentDescriptor-Objekten ist.
Während der Laufzeit verwendet die createComponentsFromDescriptors()
-Methode der Container-Klasse die Informationen in den UIComponentDescriptor-Objekten im childDescriptors
-Array des Containers, um die tatsächlichen UIComponent-Objekte, die untergeordneten Elemente des Containers, sowie untergeordnete Elemente tieferer Ebenen zu erstellen. Abhängig vom Wert der creationPolicy
-Eigenschaft des Containers können die untergeordneten Elemente beim Anwendungsstart erstellt werden, wenn ein Teil der Komponente in Kürze sichtbar wird oder wenn der Anwendungsentwickler die createComponentsFromDescriptors()
-Methode manuell aufruft.
Sie erstellen UIComponentDescriptor-Instanzen normalerweise nicht selbst. Sie können auf diejenigen zugreifen, die der MXML-Compiler automatisch mithilfe des childDescriptors
-Arrays der Container-Klasse generiert.
Verwandte API-Elemente
mx.core.Container.creationPolicy
mx.core.Container.createComponentsFromDescriptors()
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
document : Object
Ein Verweis auf das Dokumentenobjekt, in dem die Komponente erstellt werden soll. | ComponentDescriptor | ||
effects : Array
Ein Array, das die Effekte für die Komponente wie in MXML angegeben enthält. | UIComponentDescriptor | ||
events : Object
Ein Objekt, das Name/Wert-Paare für die Ereignisprozeduren der Komponente entsprechend der Angaben in MXML enthält. | ComponentDescriptor | ||
id : String
Der Bezeichner der Komponente, wie in MXML angegeben. | ComponentDescriptor | ||
properties : Object [schreibgeschützt]
Ein Objekt, das Name/Wert-Paare für die Eigenschaften der Komponente entsprechend der Angaben in MXML enthält. | ComponentDescriptor | ||
propertiesFactory : Function
Eine Funktion, die ein Objekt zurückgibt, das Name/Wert-Paare für die Eigenschaften der Komponente entsprechend der Angaben in MXML enthält. | ComponentDescriptor | ||
stylesFactory : Function
Eine Funktion, die ein Objekt konstruiert, das Name/Wert-Paare für die Instanzstile für die Komponente entsprechen der Angaben in MXML enthält. | UIComponentDescriptor | ||
type : Class
Die Klasse der Komponente, entsprechend den Angaben in MXML. | ComponentDescriptor |
Methode | Definiert von | ||
---|---|---|---|
UIComponentDescriptor(descriptorProperties:Object)
Konstruktor. | UIComponentDescriptor | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Macht die properties-Eigenschaft im Cache ungültig. | ComponentDescriptor | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt den String „ComponentDescriptor_“ und den Wert der ID-Eigenschaft an. | ComponentDescriptor | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
effects | Eigenschaft |
public var effects:Array
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ein Array, das die Effekte für die Komponente wie in MXML angegeben enthält.
Betrachten Sie beispielsweise, was passiert, wenn Sie folgenden Code schreiben:
<mx:TextInput showEffect="Fade" hideEffect="Fade"/>
Die effects
-Eigenschaft des Deskriptors ist das Array [ "showEffect", "hideEffect" ]
.
Die effects
-Eigenschaft ist null
, wenn für die Komponente keine MXML-Effekte angegeben wurden.
Beachten Sie, dass die Werte der Effektattribute nicht in dieser Eigenschaft festgelegt werden. Stattdessen werden Effekte wie Stile behandelt und sind deshalb in der stylesFactory
-Eigenschaft enthalten. Das effect
-Array verfolgt einfach, welche Stile in der stylesFactory
eigentlich Effekte sind.
Diese Eigenschaft wird von der Container-Methode createComponentsFromDescriptors()
verwendet, um die Effekte beim EffectManager zu registrieren.
stylesFactory | Eigenschaft |
public var stylesFactory:Function
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Eine Funktion, die ein Objekt konstruiert, das Name/Wert-Paare für die Instanzstile für die Komponente entsprechen der Angaben in MXML enthält.
Betrachten Sie beispielsweise, was passiert, wenn Sie folgenden Code schreiben:
<mx:TextInput borderColor="0x888888" color="0xDDDDDD"/>
Die stylesFactory
-Eigenschaft des Deskriptors ist die Funktion:
function():void { this.borderColor = 0x888888; this.color = 0xDDDDDD };
Die stylesFactory
-Eigenschaft ist null
, wenn für die Komponenteninstanz keine MXML-Stile angegeben wurden.
UIComponentDescriptor | () | Konstruktor |
public function UIComponentDescriptor(descriptorProperties:Object)
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
ParameterdescriptorProperties:Object — Ein Objekt, das Name/Wert-Paare für die Eigenschaften des UIComponentDescriptor-Objekts enthält, wie etwa type , id , propertiesFactory , events , stylesFactory und effects .
|
Tue Jun 12 2018, 10:04 AM Z