ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.media 

MediaPromise  - AS3

Paketflash.media
Klassepublic class MediaPromise
VererbungMediaPromise Inheritance EventDispatcher Inheritance Object
Implementiert IFilePromise

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2.5

Die MediaPromise-Klasse repräsentiert die Zusage, ein Medienobjekt bereitzustellen.

Die data-Eigenschaft eines MediaEvent-Objekts ist eine MediaPromise-Instanz. Sie können die MediaPromise-Methoden verwenden, um auf das zugesagte Medienobjekt zuzugreifen. Die unterstützten Medienformate sind Standbilder und Videos.

Sie können MediaPromise-Objekte nicht erstellen. Der Aufruf von new MediaPromise() generiert einen Laufzeitfehler.

Verwandte API-Elemente

MediaEvent
IFilePromise
Loader.LoadFilePromise()
IDataInput
CameraRoll.browseForImage()
CameraUI

Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
      file : File
[schreibgeschützt] Die File-Instanz, die das Medienobjekt repräsentiert, falls eines vorhanden ist.
MediaPromise
      isAsync : Boolean
[schreibgeschützt] Gibt an, ob die zugrunde liegende Datenquelle asynchron oder synchron ist.
MediaPromise
      mediaType : String
[schreibgeschützt] Der allgemeine Medientyp, entweder Bild oder Video.
MediaPromise
      relativePath : String
[schreibgeschützt] Der Dateiname des Medienobjekts, falls eines vorhanden ist.
MediaPromise
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
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.
EventDispatcher
  
    close():void
Schließt die Datenquelle.
MediaPromise
 Inherited
dispatchEvent(event:Event):Boolean
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
hasEventListener(type:String):Boolean
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
    open():IDataInput
Öffnet die zugrunde liegende Datenquelle und gibt die IDataInput-Instanz zurück, mit der sie gelesen werden kann.
MediaPromise
 Inherited
propertyIsEnumerable(name:String):Boolean
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
  
    reportError(e:ErrorEvent):void
Wird von der Laufzeitumgebung verwendet, um Fehler zu melden.
MediaPromise
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
toLocaleString():String
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
toString():String
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
valueOf():Object
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
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.
EventDispatcher
Ereignisse
Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.
 Ereignis Übersicht Definiert von
 Inherited
activate
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
  
    close
Ein MediaPromise-Objekt setzt ein close-Ereignis ab, wenn der zugrunde liegende Datenstream geschlossen wurde.MediaPromise
  
    complete
Ein MediaPromise-Objekt setzt ein complete-Ereignis ab, wenn alle Daten gelesen wurden.MediaPromise
 Inherited
deactivate
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
  
    ioError
Ein MediaPromise-Objekt setzt ein ioError-Ereignis ab, wenn beim Lesen des zugrunde liegenden Datenstreams ein Fehler auftritt.MediaPromise
  
    progress
Ein MediaPromise-Objekt setzt progress-Ereignisse ab, wenn die Daten verfügbar werden.MediaPromise
Eigenschaftendetails
    

file

Eigenschaft
file:File  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2.5

Die File-Instanz, die das Medienobjekt repräsentiert, falls eines vorhanden ist.

Die Eigenschaft verweist auf ein File-Objekt, wenn die zugrunde liegende Datenquelle dateibasiert ist und die Datei für die Anwendung zugänglich ist. Andernfalls ist die Eigenschaft null.



Implementierung
    public function get file():File
    

isAsync

Eigenschaft 
isAsync:Boolean  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2.5

Gibt an, ob die zugrunde liegende Datenquelle asynchron oder synchron ist.



Implementierung
    public function get isAsync():Boolean
    

mediaType

Eigenschaft 
mediaType:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2.5

Der allgemeine Medientyp, entweder Bild oder Video.

Die Konstanten in der MediaType-Klasse definieren mögliche Werte für diese Eigenschaft:

  • MediaType.IMAGE
  • MediaType.VIDEO



Implementierung
    public function get mediaType():String

Verwandte API-Elemente

MediaType
    

relativePath

Eigenschaft 
relativePath:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2.5

Der Dateiname des Medienobjekts, falls eines vorhanden ist.

Ein Dateiname ist verfügbar, wenn die zugrunde liegende Datenquelle dateibasiert ist und die Datei für die Anwendung zugänglich ist. Andernfalls ist die Eigenschaft null.



Implementierung
    public function get relativePath():String
Methodendetails

    close

()Methode
public function close():void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2.5

Schließt die Datenquelle.

    open

()Methode 
public function open():IDataInput

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2.5

Öffnet die zugrunde liegende Datenquelle und gibt die IDataInput-Instanz zurück, mit der sie gelesen werden kann.

Wenn die zugrunde liegende Datenquelle asynchron ist, setzt das MediaPromise-Objekt progress- und complete-Ereignisse ab, um anzuzeigen, ob Daten zum Lesen verfügbar sind. Wenn die Datenquelle synchron ist, sind alle Daten sofort verfügbar, weshalb diese Ereignisse nicht abgesetzt werden.

Hinweis: Sie können ein MediaPromise-Objekt mit der loadFilePromise()-Methode der Loader-Klasse laden, anstatt die Daten manuell zu lesen.

Rückgabewerte
IDataInput

Verwandte API-Elemente

Loader.loadFilePromise()

    reportError

()Methode 
public function reportError(e:ErrorEvent):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2.5

Wird von der Laufzeitumgebung verwendet, um Fehler zu melden.

Anwendungscode sollte diese Methode nicht aufrufen.

Parameter

e:ErrorEvent — Das abzusetzende Fehlerereignis.

Ereignisdetails
    

close

 Ereignis
Ereignisobjekttyp: flash.events.Event
Eigenschaft Event.type = flash.events.Event.CLOSE

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2.5

Ein MediaPromise-Objekt setzt ein close-Ereignis ab, wenn der zugrunde liegende Datenstream geschlossen wurde.

Die Event.CLOSE-Konstante definiert den Wert der type-Eigenschaft eines close-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Objekt, dessen Verbindung geschlossen wurde.
    

complete

 Ereignis  
Ereignisobjekttyp: flash.events.Event
Eigenschaft Event.type = flash.events.Event.COMPLETE

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2.5

Ein MediaPromise-Objekt setzt ein complete-Ereignis ab, wenn alle Daten gelesen wurden. Das Ereignis zeigt an, dass im zugrunde liegenden Stream keine weiteren Daten verfügbar sind.

Ein complete-Ereignis wird nicht von einer synchronen Datenquelle abgesetzt.

Die Event.COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines complete-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Netzwerkobjekt, dessen Ladevorgang beendet ist.
    

ioError

 Ereignis  
Ereignisobjekttyp: flash.events.IOErrorEvent
Eigenschaft IOErrorEvent.type = flash.events.IOErrorEvent.IOERROR

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2.5

Ein MediaPromise-Objekt setzt ein ioError-Ereignis ab, wenn beim Lesen des zugrunde liegenden Datenstreams ein Fehler auftritt. Nachdem dieses Ereignis abgesetzt wurde, können keine Daten mehr gelesen werden.

    

progress

 Ereignis  
Ereignisobjekttyp: flash.events.ProgressEvent
Eigenschaft ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 2.5

Ein MediaPromise-Objekt setzt progress-Ereignisse ab, wenn die Daten verfügbar werden.

Die bytesTotal-Eigenschaft aller progress-Ereignisse mit Ausnahme des letzten hat den Wert 0. Wenn alle Daten sofort verfügbar sind, werden keine progress-Ereignisse abgesetzt. Von synchronen Datenquellen werden keine progress-Ereignisse abgesetzt.

Definiert den Wert der Eigenschaft type eines progress-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
bytesLoadedDie Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.
bytesTotalDie Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang schließlich geladen werden.
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Objekt, dessen Fortschritt protokolliert wird.



© 2015 Adobe Systems Incorporated. All rights reserved.
Tue Jun 12 2018, 10:04 AM Z
 

 

Rechtliche Hinweise | Onlinedatenschutzerklärung
[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.