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

Paket	mx.modules
Schnittstelle	public interface IModuleInfo extends IEventDispatcher

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Eine Schnittstelle, die als Handle für ein bestimmtes Modul fungiert. Über diese Schnittstelle kann der Modulstatus abgefragt, seine innere Factory abgerufen und es kann ge- und entladen werden.

Öffentliche Eigenschaften

	Eigenschaft		Definiert von
		data : Object Benutzerdaten, die für eine gegebene URL mit dem Singleton-IModuleInfo verknüpft werden können.	IModuleInfo
		error : Boolean [schreibgeschützt] Ein Flag, welches „true“ ist, wenn während des Ladens eines Moduls ein Fehler auftrat.	IModuleInfo
		factory : IFlexModuleFactory [schreibgeschützt] Die IFlexModuleFactory-Implementierung, welche im Modul definiert wurde.	IModuleInfo
		loaded : Boolean [schreibgeschützt] Ein Flag, das „true“ ist, wenn die load()-Methode für dieses Modul aufgerufen wurde.	IModuleInfo
		ready : Boolean [schreibgeschützt] Ein Flag, das „true“ ist, wenn das Modul ausreichend geladen ist, um einen Handle zur mit ihm verknüpften IFlexModuleFactory-Implementierung zu erhalten und seine create()-Methode aufzurufen.	IModuleInfo
		setup : Boolean [schreibgeschützt] Ein Flag, das true ist, wenn das Modul ausreichend geladen ist, um einen Handle zur mit ihm verknüpften IFlexModuleFactory-Implementierung zu erhalten und seine info()-Methode aufzurufen.	IModuleInfo
		url : String [schreibgeschützt] Die mit diesem Modul verknüpfte URL (z. B.: „MyImageModule.swf“ oder „http://somedomain.com/modules/MyImageModule.swf“).	IModuleInfo

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		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.	IEventDispatcher
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	IEventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	IEventDispatcher
		load(applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null, bytes:ByteArray = null, moduleFactory:IFlexModuleFactory = null):void Fordert an, dass das Modul geladen wird.	IModuleInfo
		publish(factory:IFlexModuleFactory):void Veröffentlicht eine Schnittstelle an den ModuleManager.	IModuleInfo
		release():void Löst den aktuellen Verweis auf das Modul.	IModuleInfo
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	IEventDispatcher
		unload():void Entlädt das Modul.	IModuleInfo
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	IEventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

	Übersicht	Definiert von
error	Wird von der ModuleInfo ausgelöst, wenn es während des Ladens des Moduls zu einem Fehler kam.	IModuleInfo
progress	Wird in regelmäßigen Abständen von der ModuleInfo ausgelöst, während das Modul geladen wird.	IModuleInfo
ready	Wird von der ModuleInfo ausgelöst, sobald das Modul soweit geladen ist, dass es die IModuleInfo.factory()-Methode und die IFlexModuleFactory.create()-Methode aufrufen kann.	IModuleInfo
setup	Wird von der ModuleInfo ausgelöst, sobald das Modul soweit geladen ist, dass es die IModuleInfo.factory()-Methode und die IFlexModuleFactory.info()-Methode aufrufen kann.	IModuleInfo
unload	Wird von der ModuleInfo ausgelöst, wenn die Moduldaten entladen werden.	IModuleInfo

Eigenschaftendetails

data	Eigenschaft

data:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Benutzerdaten, die für eine gegebene URL mit dem Singleton-IModuleInfo verknüpft werden können.

Implementierung
public function get data():Object
public function set data(value:Object):void

error

Eigenschaft

error:Boolean [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ein Flag, welches true ist, wenn während des Ladens eines Moduls ein Fehler auftrat.

Das Flag ist true, wenn der ModuleManager das ModuleEvent.ERROR-Ereignis auslöst.

Implementierung
public function get error():Boolean

factory

Eigenschaft

factory:IFlexModuleFactory [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die IFlexModuleFactory-Implementierung, welche im Modul definiert wurde. Dies wird erst nicht-null, nachdem das ModuleEvent.SETUP-Ereignis ausgelöst wurde (oder die IModuleInfo.setup()-Methode true zurückgegeben hat). An diesem Punkt kann die IFlexModuleFactory.info()-Methode aufgerufen werden. Erst wenn das ModuleEvent.READY-Ereignis ausgelöst wurde (oder die IModuleInfo.ready()-Methode true zurückgegeben hat), ist es möglich, die IFlexModuleFactory.create()-Methode aufzurufen.

Implementierung
public function get factory():IFlexModuleFactory

loaded

Eigenschaft

loaded:Boolean [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ein Flag, das true ist, wenn die load()-Methode für dieses Modul aufgerufen wurde.

Implementierung
public function get loaded():Boolean

ready

Eigenschaft

ready:Boolean [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ein Flag, das true ist, wenn das Modul ausreichend geladen ist, um einen Handle zur mit ihm verknüpften IFlexModuleFactory-Implementierung zu erhalten und seine create()-Methode aufzurufen.

Das Flag ist true, wenn der ModuleManager das ModuleEvent.READY-Ereignis auslöst.

Implementierung
public function get ready():Boolean

setup

Eigenschaft

setup:Boolean [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ein Flag, das true ist, wenn das Modul ausreichend geladen ist, um einen Handle zur mit ihm verknüpften IFlexModuleFactory-Implementierung zu erhalten und seine info()-Methode aufzurufen.

Das Flag ist true, wenn der ModuleManager das ModuleEvent.SETUP-Ereignis auslöst.

Implementierung
public function get setup():Boolean

url

Eigenschaft

url:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die mit diesem Modul verknüpfte URL (z. B.: „MyImageModule.swf“ oder „http://somedomain.com/modules/MyImageModule.swf“). Die URL kann lokal oder remote sein. Wenn sie remote ist, müssen Sie Vertrauen zwischen der Domäne des Moduls und der Anwendung, die es lädt, herstellen.

Implementierung
public function get url():String

Methodendetails

load

()

Methode

 public function load(applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null, bytes:ByteArray = null, moduleFactory:IFlexModuleFactory = null):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fordert an, dass das Modul geladen wird. Wenn das Modul schon geladen ist, hat der Aufruf keine Auswirkung. Wenn nicht, beginnt das Modul zu laden und löst während des Ladefortschritts progress-Ereignisse aus.

Parameter

	`applicationDomain:ApplicationDomain` (default = `null`) — Die aktuelle Anwendungsdomäne, in welcher Ihr Code ausgeführt wird.

	`securityDomain:SecurityDomain` (default = `null`) — Die aktuelle Sicherheits-Sandbox.

	`bytes:ByteArray` (default = `null`) — 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. Wenn dieser Parameter „null“ ist, wird das Modul aus der URL geladen, welche in der URL-Eigenschaft festgelegt war.

	`moduleFactory:IFlexModuleFactory` (default = `null`) — Die moduleFactory des Aufrufers. Die moduleFactory kann beispielsweise dazu verwendet werden, um den übergeordneten Stilmanager des geladenen Moduls zu bestimmen.

publish

()

Methode

public function publish(factory:IFlexModuleFactory):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Veröffentlicht eine Schnittstelle an den ModuleManager. Dies lässt späte (oder entkoppelte) Abonnements von Factorys mit einem String-Handle zu. Verwenden Sie eine URL die mit publish:// beginnt, um Factorys zu referenzieren, welche auf diese Weise veröffentlicht werden.

Parameter

factory:IFlexModuleFactory — Die Klasse, welche die IFlexModuleFactory-Schnittstelle des Moduls implementiert.

Verwandte API-Elemente

mx.modules.ModuleManager

release

()

Methode

public function release():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Löst den aktuellen Verweis auf das Modul. Dies entlädt das Modul nicht, es sei denn, dass keine anderen offenen Verweise darauf bestehen und der ModuleManager so eingestellt ist, dass er nur eine begrenzte Anzahl an geladenen Modulen besitzt.

Verwandte API-Elemente

mx.modules.ModuleManager

unload

()

Methode

public function unload():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Entlädt das Modul. Flash Player und AIR entladen dieses Modul nicht vollständig und es wird auch nicht vom Garbagekollektor entfernt, wenn ausstehende Verweise auf Definitionen innerhalb des Moduls gegeben sind.

Ereignisdetails

error

Ereignis

Ereignisobjekttyp: mx.events.ModuleEvent
Eigenschaft ModuleEvent.type = mx.events.ModuleEvent.ERROR

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird von der ModuleInfo ausgelöst, wenn es während des Ladens des Moduls zu einem Fehler kam.

Wird ausgelöst, wenn beim Herunterladen des Moduls ein Fehler auftritt. Die ModuleEvent.ERROR-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein error-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`bytesLoaded`	Leer
`bytesTotal`	Leer
`cancelable`	false
`currentTarget`	Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise `myButton.addEventListener()` zur Registrierung eines Ereignis-Listeners verwenden, weist `currentTarget` den Wert „myButton“ auf.
`errorText`	Die Fehlermeldung.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die `currentTarget`-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

progress

Ereignis

Ereignisobjekttyp: mx.events.ModuleEvent
Eigenschaft ModuleEvent.type = mx.events.ModuleEvent.PROGRESS.

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird in regelmäßigen Abständen von der ModuleInfo ausgelöst, während das Modul geladen wird.

ready

Ereignis

Ereignisobjekttyp: mx.events.ModuleEvent
Eigenschaft ModuleEvent.type = mx.events.ModuleEvent.READY

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird von der ModuleInfo ausgelöst, sobald das Modul soweit geladen ist, dass es die IModuleInfo.factory()-Methode und die IFlexModuleFactory.create()-Methode aufrufen kann.

Wird nach dem erfolgreichen Herunterladen des Moduls ausgelöst. Die ModuleEvent.READY-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein complete-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`bytesLoaded`	Die Anzahl der geladenen Bytes.
`bytesTotal`	Die Gesamtzahl der zu ladenden Bytes.
`cancelable`	false
`currentTarget`	Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise `myButton.addEventListener()` zur Registrierung eines Ereignis-Listeners verwenden, weist `currentTarget` den Wert „myButton“ auf.
`errorText`	Leer
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die `currentTarget`-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

setup

Ereignis

Ereignisobjekttyp: mx.events.ModuleEvent
Eigenschaft ModuleEvent.type = mx.events.ModuleEvent.SETUP

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird von der ModuleInfo ausgelöst, sobald das Modul soweit geladen ist, dass es die IModuleInfo.factory()-Methode und die IFlexModuleFactory.info()-Methode aufrufen kann.

Wird ausgelöst, wenn genügend Moduldaten heruntergeladen wurden, um Informationen zum Modul zu erhalten. Rufen Sie dazu die IFlexModuleFactory.info()-Methode für das Modul auf. Die ModuleEvent.SETUP-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein setup-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`bytesLoaded`	Leer
`bytesTotal`	Leer
`cancelable`	false
`currentTarget`	Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise `myButton.addEventListener()` zur Registrierung eines Ereignis-Listeners verwenden, weist `currentTarget` den Wert „myButton“ auf.
`errorText`	Eine Fehlermeldung
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die `currentTarget`-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

unload

Ereignis

Ereignisobjekttyp: mx.events.ModuleEvent
Eigenschaft ModuleEvent.type = mx.events.ModuleEvent.UNLOAD

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird von der ModuleInfo ausgelöst, wenn die Moduldaten entladen werden.

Wird ausgelöst, wenn das Modul entladen wird. Die ModuleEvent.UNLOAD-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein unload-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`bytesLoaded`	Leer
`bytesTotal`	Leer
`cancelable`	false
`currentTarget`	Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise `myButton.addEventListener()` zur Registrierung eines Ereignis-Listeners verwenden, weist `currentTarget` den Wert „myButton“ auf.
`errorText`	Eine Fehlermeldung
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die `currentTarget`-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

Rechtliche Hinweise | Onlinedatenschutzerklärung

IModuleInfo - AS3 Flex

Klassen x

data

error

factory

loaded

ready

setup

url

load

publish

release

unload

error

progress

ready

setup

unload