| 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()
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| 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