| Pakket | flash.media |
| Klasse | public class MediaPromise |
| Overerving | MediaPromise  EventDispatcher Object |
| Implementatie | IFilePromise |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.5 |
De eigenschap data van en MediaEvent-object is een MediaPromise-instantie. Via de MediaPromise-methoden krijgt u toegang tot de mediaobjectpromise. Tot de ondersteunde media-indelingen behoren foto's en video.
Er kan geen MediaPromise-object worden gemaakt. Als u new MediaPromise() aanroept, wordt een runtimefout gegenereerd.
Verwante API-elementen
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergeven| Eigenschap | Gedefinieerd door | ||
|---|---|---|---|
 | constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | |
| file : File [alleen-lezen]
De File-instantie die staat voor het mediaobject, indien er een mediaobject is. | MediaPromise | ||
| isAsync : Boolean [alleen-lezen]
Meldt of de onderliggende gegevensbron asynchroon of synchroon is. | MediaPromise | ||
| mediaType : String [alleen-lezen]
Het algemene type media (afbeelding of video). | MediaPromise | ||
| relativePath : String [alleen-lezen]
De bestandsnaam van het mediaobject, indien er een mediaobject is. | MediaPromise | ||
| Methode | Gedefinieerd door | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | |
Hiermee wordt de gegevensbron gesloten. | MediaPromise | ||
|
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | |
|
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | |
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
Hiermee wordt de onderliggende gegevensbron geopend en de IDataInput-instantie geretourneerd, zodat u deze kunt lezen. | MediaPromise | ||
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
|
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | |
Wordt gebruikt door de runtime om fouten te melden. | MediaPromise | ||
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
|
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | |
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
|
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher | |
| Gebeurtenis | Overzicht | Gedefinieerd door | ||
|---|---|---|---|---|
| [uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | ||
| Wanneer de onderliggende gegevensstroom is gesloten, wordt een close-gebeurtenis verzonden door een MediaPromise-object. | MediaPromise | |||
| Wanneer alle gegevens zijn gelezen, wordt de gebeurtenis 'complete' verzonden door een MediaPromise-object. | MediaPromise | |||
| [uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | ||
| Wanneer een fout optreedt bij het lezen van de onderliggende gegevensstroom, wordt een ioError-gebeurtenis verzonden door een MediaPromise-object. | MediaPromise | |||
| Naarmate gegevens beschikbaar komen, worden 'progress'-gebeurtenissen verzonden door een MediaPromise-object. | MediaPromise | |||
file | eigenschap |
file:File [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.5 |
De File-instantie die staat voor het mediaobject, indien er een mediaobject is.
Deze eigenschap verwijst naar een File-object als de onderliggende gegevensbron is gebaseerd op een bestand dat toegankelijk is voor uw toepassing. In alle andere gevallen is de waarde van de eigenschap null.
Implementatie
public function get file():File isAsync | eigenschap |
mediaType | eigenschap |
mediaType:String [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.5 |
Het algemene type media (afbeelding of video).
Met de constanten in de MediaType-klasse worden de mogelijke waarden van deze eigenschap gedefinieerd:
- MediaType.IMAGE
- MediaType.VIDEO
Implementatie
public function get mediaType():StringVerwante API-elementen
relativePath | eigenschap |
relativePath:String [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.5 |
De bestandsnaam van het mediaobject, indien er een mediaobject is.
Er is een bestandsnaam beschikbaar als de onderliggende gegevensbron is gebaseerd op een bestand dat toegankelijk is voor uw toepassing. In alle andere gevallen is de waarde van de eigenschap null.
Implementatie
public function get relativePath():Stringclose | () | methode |
public function close():void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.5 |
Hiermee wordt de gegevensbron gesloten.
open | () | methode |
public function open():IDataInput| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.5 |
Hiermee wordt de onderliggende gegevensbron geopend en de IDataInput-instantie geretourneerd, zodat u deze kunt lezen.
Als de onderliggende gegevensbron asynchroon is, verzendt het MediaPromise-object de gebeurtenissen progress en complete om aan te geven of de gegevens beschikbaar zijn en kunnen worden gelezen. Als de gegevensbron synchroon is, zijn alle gegevens direct beschikbaar en worden deze gebeurtenissen niet verzonden.
Opmerking: u kunt een MediaPromise-object laden met de methode loadFilePromise() van de Loader-klasse; u hoeft de gegevens dus niet handmatig te lezen.
IDataInput |
Verwante API-elementen
reportError | () | methode |
public function reportError(e:ErrorEvent):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.5 |
Wordt gebruikt door de runtime om fouten te melden.
Deze methode moet niet worden aangeroepen door de toepassingscode.
Parameters
e:ErrorEvent — de error-gebeurtenis die moet worden verzonden.
|
close | Gebeurtenis |
flash.events.Eventeigenschap Event.type =
flash.events.Event.CLOSE| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.5 |
Wanneer de onderliggende gegevensstroom is gesloten, wordt een close-gebeurtenis verzonden door een MediaPromise-object.
Event.CLOSE definieert de waarde van de eigenschap type van een close-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
| Eigenschap | Waarde |
|---|---|
bubbles | false |
cancelable | false; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het object waarvan de verbinding is gesloten. |
complete | Gebeurtenis |
flash.events.Eventeigenschap Event.type =
flash.events.Event.COMPLETE| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.5 |
Wanneer alle gegevens zijn gelezen, wordt de gebeurtenis complete verzonden door een MediaPromise-object. Deze gebeurtenis geeft aan dat er niet meer gegevens beschikbaar zijn in de onderliggende gegevensstroom.
Er wordt geen complete-gebeurtenis verzonden door een synchrone gegevensbron.
Event.COMPLETE definieert de waarde van de eigenschap type van een complete-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
| Eigenschap | Waarde |
|---|---|
bubbles | false |
cancelable | false; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het netwerkobject dat klaar is met laden. |
ioError | Gebeurtenis |
flash.events.IOErrorEventeigenschap IOErrorEvent.type =
flash.events.IOErrorEvent.IOERROR| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.5 |
Wanneer een fout optreedt bij het lezen van de onderliggende gegevensstroom, wordt een ioError-gebeurtenis verzonden door een MediaPromise-object. Nadat deze gebeurtenis is verzonden, kunnen er niet meer gegevens worden gelezen.
progress | Gebeurtenis |
flash.events.ProgressEventeigenschap ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 2.5 |
Naarmate gegevens beschikbaar komen, worden progress-gebeurtenissen verzonden door een MediaPromise-object.
De eigenschap bytesTotal van alle (behalve de laatste) 'progress'-gebeurtenissen heeft de waarde 0. Als alle gegevens direct beschikbaar zijn, worden er wellicht geen progress-gebeurtenissen verzonden. Er worden geen progress-gebeurtenissen verzonden door synchrone gegevensbronnen.
type van een gebeurtenisobject progress.
Deze gebeurtenis heeft de volgende eigenschappen:
| Eigenschap | Waarde |
|---|---|
bubbles | false |
bytesLoaded | Het aantal items of bytes dat wordt geladen wanneer de listener de gebeurtenis verwerkt. |
bytesTotal | Het totale aantal items of bytes dat uiteindelijk wordt geladen wanneer het laadproces is voltooid. |
cancelable | false; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het object dat de voortgang rapporteert. |
Wed Jun 13 2018, 11:42 AM Z