| <?xml version="1.0" encoding="UTF-8"?> |
| <!-- |
| |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| |
| --> |
| <apiPackage id="mx.modules"><apiName>mx.modules</apiName><apiDetail/><apiClassifier id="mx.modules:ModuleLoader"><apiName>ModuleLoader</apiName><shortdesc> |
| ModuleLoader ist eine Komponente, die sich ähnlich einem SWFLoader verhält, mit dem Unterschied, dass sie einer Vereinbarung mit den geladenen Inhalten folgt.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion><Alternative owner="mx.modules:ModuleLoader" replacement="spark.modules.ModuleLoader" since="4.5"> |
| </Alternative></asMetadata></prolog><apiClassifierDetail><apiClassifierDef><apiAccess value="public"/><apiStatic/><apiBaseInterface>mx.core:IDeferredInstantiationUIComponent</apiBaseInterface><apiBaseClassifier>mx.containers:VBox</apiBaseClassifier></apiClassifierDef><apiDesc> |
| ModuleLoader ist eine Komponente, die sich ähnlich einem SWFLoader verhält, mit dem Unterschied, dass sie einer Vereinbarung mit den geladenen Inhalten folgt. Diese Vereinbarung schreibt vor, dass die untergeordnete SWF-Datei IFlexModuleFactory implementiert und dass diese benutzt werden kann, um bei Bedarf mehrere Instanzen der Unterklasse zu erzeugen. |
| <p>Der ModuleLoader ist mit zurückgestellter Instanziierung verbunden und stellt sicher, dass durch ModuleManager-Singleton nicht mehr als eine Kopie der Module SWF-Datei über das Netzwerk übertragen wird.</p> |
| |
| </apiDesc></apiClassifierDetail><related-links><link href="" invalidHref="mx.modules.ModuleManager.xml"><linktext>mx.modules.ModuleManager</linktext></link><link href="" invalidHref="mx.controls.SWFLoader.xml"><linktext>mx.controls.SWFLoader</linktext></link></related-links><adobeApiEvent id="mx.modules:ModuleLoader_mx.events.ModuleEvent.UNLOAD_unload"><apiName>unload</apiName><shortdesc> |
| Wird ausgelöst, wenn die Moduldaten entladen werden.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.ModuleEvent.UNLOAD</apiEventType><adobeApiEventClassifier>mx.events.ModuleEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc> |
| Wird ausgelöst, wenn die Moduldaten entladen werden. |
| </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.modules:ModuleLoader_mx.events.ModuleEvent.PROGRESS_progress"><apiName>progress</apiName><shortdesc> |
| Wird in regelmäßigen Abständen ausgelöst, während das Modul lädt.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.ModuleEvent.PROGRESS.</apiEventType><adobeApiEventClassifier>mx.events.ModuleEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc> |
| Wird in regelmäßigen Abständen ausgelöst, während das Modul lädt. |
| </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.modules:ModuleLoader_mx.events.ModuleEvent.ERROR_error"><apiName>error</apiName><shortdesc> |
| Wird ausgelöst, wenn das Modul einen Fehler ausgibt.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.ModuleEvent.ERROR</apiEventType><adobeApiEventClassifier>mx.events.ModuleEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc> |
| Wird ausgelöst, wenn das Modul einen Fehler ausgibt. |
| </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.modules:ModuleLoader_mx.events.ModuleEvent.READY_ready"><apiName>ready</apiName><shortdesc> |
| Wird ausgelöst, wenn das Laden des Moduls beendet ist.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.ModuleEvent.READY</apiEventType><adobeApiEventClassifier>mx.events.ModuleEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc> |
| Wird ausgelöst, wenn das Laden des Moduls beendet ist. |
| </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.modules:ModuleLoader_mx.events.ModuleEvent.SETUP_setup"><apiName>setup</apiName><shortdesc> |
| Wird ausgelöst, wenn Informationen über das Modul (mit der info()-Methode) verfügbar sind, das Modul jedoch noch nicht bereit ist.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.ModuleEvent.SETUP</apiEventType><adobeApiEventClassifier>mx.events.ModuleEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc> |
| Wird ausgelöst, wenn Informationen über das Modul (mit der <codeph>info()</codeph>-Methode) verfügbar sind, das Modul jedoch noch nicht bereit ist. |
| </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.modules:ModuleLoader_mx.events.FlexEvent.URL_CHANGED_urlChanged"><apiName>urlChanged</apiName><shortdesc> |
| Wird ausgelöst, wenn dem ModuleLoader eine neue URL zugewiesen wurde.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FlexEvent.URL_CHANGED</apiEventType><adobeApiEventClassifier>flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc> |
| Wird ausgelöst, wenn dem ModuleLoader eine neue URL zugewiesen wurde. |
| </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.modules:ModuleLoader_mx.events.FlexEvent.LOADING_loading"><apiName>loading</apiName><shortdesc> |
| Wird ausgelöst, wenn der ModuleLoader beginnt, eine URL zu laden.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FlexEvent.LOADING</apiEventType><adobeApiEventClassifier>flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc> |
| Wird ausgelöst, wenn der ModuleLoader beginnt, eine URL zu laden. |
| </apiDesc></adobeApiEventDetail></adobeApiEvent><apiConstructor id="mx.modules:ModuleLoader:ModuleLoader"><apiName>ModuleLoader</apiName><shortdesc> |
| Konstruktor.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiConstructorDetail><apiConstructorDef><apiAccess value="public"/></apiConstructorDef><apiDesc> |
| Konstruktor. |
| |
| </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="mx.modules:ModuleLoader:loadModule"><apiName>loadModule</apiName><shortdesc> |
| Lädt das Modul.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>url</apiItemName><apiType value="String"/><apiData>null</apiData><apiDesc>Der Ort des Moduls, als URL ausgedrückt. Dieser Parameter ist optional. Wenn dieser Parameter „null“ ist, wird der Wert der <codeph>url</codeph>-Eigenschaft benutzt. Wenn dieser Parameter bereitgestellt wird, wird die <codeph>url</codeph>-Eigenschaft auf den Wert der URL aktualisiert. |
| |
| </apiDesc></apiParam><apiParam><apiItemName>bytes</apiItemName><apiType value="flash.utils:ByteArray"/><apiData>null</apiData><apiDesc>Ein ByteArray-Objekt. Vom ByteArray wird erwartet, dass es die Bytes einer SWF-Datei enthält, die ein kompiliertes Modul darstellen. Das ByteArray-Objekt kann über die URLLoader-Klasse bezogen werden. Wenn dieser Parameter festgelegt ist, wird das Modul aus dem ByteArray geladen und der URL-Parameter wird benutzt, um das Modul in der <codeph>ModuleManager.getModule()</codeph>-Methode zu identifizieren. Er darf daher nicht „null“ sein. Wenn dieser Parameter „null“ ist, wird das Modul von der URL geladen, entweder über den URL-Parameter, wenn er nicht „null“ ist, oder die URL-Eigenschaft als Fallback. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc> |
| Lädt das Modul. Wenn das Laden des Moduls beendet ist, fügt es der ModuleLoader mithilfe der <codeph>addChild()</codeph>-Methode als untergeordnetes Element hinzu. Dies wird normalerweise mit zurückgestellter Instanziierung ausgelöst. |
| |
| <p>Wenn das Modul bereits geladen ist, hat diese Methode keine Auswirkung. Sie lädt das Modul kein zweites Mal.</p> |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.modules:ModuleLoader:unloadModule"><apiName>unloadModule</apiName><shortdesc> |
| Entlädt das Modul und setzt es auf „null“.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc> |
| Entlädt das Modul und setzt es auf <codeph>null</codeph>. Wenn eine Instanz des Moduls zuvor als untergeordnetes Element hinzugefügt wurde, ruft diese Methode die <codeph>removeChild()</codeph>-Methode für das untergeordnete Element auf. |
| <p>Wenn das Modul nicht existiert oder schon entladen wurde, hat diese Methode keine Auswirkung.</p> |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiValue id="mx.modules:ModuleLoader:applicationDomain"><apiName>applicationDomain</apiName><shortdesc> |
| Die Anwendungsdomäne, in welche das Modul zu laden ist.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiType value="flash.system:ApplicationDomain"/></apiValueDef><apiDesc> |
| Die Anwendungsdomäne, in welche das Modul zu laden ist. Mit Anwendungsdomänen werden Klassen unterteilt, die sich in der gleichen Sicherheitsdomäne befinden. Dies ermöglicht mehrere Definitionen der gleichen Klasse und die Wiederverwendung übergeordneter Definitionen in Unterklassen. |
| |
| </apiDesc></apiValueDetail><related-links><link href="" invalidHref="flash.system.ApplicationDomain.xml"><linktext>flash.system.ApplicationDomain</linktext></link><link href="" invalidHref="flash.system.SecurityDomain.xml"><linktext>flash.system.SecurityDomain</linktext></link></related-links></apiValue><apiValue id="mx.modules:ModuleLoader:child"><apiName>child</apiName><shortdesc> |
| Das von der Modul-Factory erstellte DisplayObject.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiType value="flash.display:DisplayObject"/></apiValueDef><apiDesc> |
| Das von der Modul-Factory erstellte DisplayObject. |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="mx.modules:ModuleLoader:url:get"><apiName>url</apiName><shortdesc> |
| Der Ort des Moduls als URL ausgedrückt.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/></apiValueDef><apiDesc> |
| Der Ort des Moduls als URL ausgedrückt. |
| |
| </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier id="mx.modules:Module"><apiName>Module</apiName><shortdesc> |
| Die Basisklasse für MXML-basierte dynamisch ladbare Module.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion><Alternative owner="mx.modules:Module" replacement="spark.modules.Module" since="4.5"> |
| </Alternative></asMetadata></prolog><apiClassifierDetail><apiClassifierDef><apiAccess value="public"/><apiStatic/><apiBaseInterface>mx.modules:IModule</apiBaseInterface><apiBaseClassifier>mx.core:LayoutContainer</apiBaseClassifier></apiClassifierDef><apiDesc> |
| Die Basisklasse für MXML-basierte dynamisch ladbare Module. Sie erweitern die Klasse in MXML, indem Sie das <codeph><mx:Module></codeph>-Tag in einer MXML-Datei verwenden. Das folgende Beispiel zeigt wie: |
| |
| <pre> |
| <?xml version="1.0"?> |
| <!-- This module loads an image. --> |
| <mx:Module width="100%" height="100%" xmlns:mx="http://www.adobe.com/2006/mxml"> |
| |
| <mx:Image source="trinity.gif"/> |
| |
| </mx:Module> |
| </pre> |
| |
| <p>Das Erweitern der Modulklasse in ActionScript ist dasselbe wie die Benutzung eines <codeph><mx:Module></codeph>-Tags in einer MXML-Datei. Sie erweitern diese Klasse, wenn das Modul mit dem Framework interagiert. Um ein Beispiel einer ActionScript-Klasse zu sehen, welche die Modulklasse erweitert, erstellen Sie eine MXML-Datei mit dem Stamm-Tag <codeph><mx:Module></codeph>. Wenn Sie diese Datei kompilieren, setzen Sie den Wert der <codeph>keep-generated-actionscript</codeph>-Compileroption auf <codeph>true</codeph>. Der Flex-Compiler speichert die generierten ActionScript-Klassen in einem Ordner namens „generated“, welches Sie anschauen können.</p> |
| |
| <p>Wenn Ihr Modul keinen Framework-Code enthält, können Sie eine Klasse erstellen, welche die ModuleBase-Klasse erweitert. Wenn Sie die ModuleBase-Klasse verwenden, wird Ihr Modul normalerweise kleiner, als wenn Sie ein Modul erstellen, das auf der Modulklasse basiert, da es auf diese Weise keine Framework-Klassenabhängigkeiten besitzt.</p> |
| |
| </apiDesc></apiClassifierDetail><related-links><link href="" invalidHref="mx.modules.ModuleBase.xml"><linktext>mx.modules.ModuleBase</linktext></link></related-links><apiConstructor id="mx.modules:Module:Module"><apiName>Module</apiName><shortdesc> |
| Konstruktor.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool description="" name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiConstructorDetail><apiConstructorDef><apiAccess value="public"/></apiConstructorDef><apiDesc> |
| Konstruktor. |
| |
| </apiDesc></apiConstructorDetail></apiConstructor></apiClassifier></apiPackage> |
