| Package | fl.display |
| Classe | public class ProLoaderInfo |
| Héritage | ProLoaderInfo  EventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Certains membres de cette classe, notamment childSandboxBridge et parentSandboxBridge, ne sont pas pris en charge dans toutes les versions de Flash Player et AIR. Appelez ces propriétés uniquement lorsque votre version d’AIR ou de Flash Player publiée les prend en charge. L’appel à ces propriétés dans d’autres contextes entraîne des erreurs d’exécution.
Informations complémentaires
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
| actionScriptVersion : uint [lecture seule]
Version ActionScript du fichier SWF chargé. | ProLoaderInfo | ||
| applicationDomain : ApplicationDomain [lecture seule]
Lorsqu’un fichier SWF externe est chargé, toutes les définitions ActionScript 3.0 que contient la classe chargée sont enregistrées dans la propriété applicationDomain. | ProLoaderInfo | ||
| bytes : ByteArray [lecture seule]
Octets associés à un objet ProLoaderInfo. | ProLoaderInfo | ||
| bytesLoaded : uint [lecture seule]
Nombre d’octets chargés pour le média. | ProLoaderInfo | ||
| bytesTotal : uint [lecture seule]
Avant que l’objet ProLoader correspondant à cet objet ne distribue le premier événement progress, bytesTotal est défini sur 0. | ProLoaderInfo | ||
| childAllowsParent : Boolean [lecture seule]
Exprime la relation de confiance qui lie le contenu (l’enfant) à l’objet ProLoader (le parent). | ProLoaderInfo | ||
| childSandboxBridge : Object
Objet pouvant être défini par le code du contenu chargé pour exposer des propriétés et des méthodes auxquelles le code dans le sandbox de l’objet ProLoader peut accéder. | ProLoaderInfo | ||
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| content : DisplayObject [lecture seule]
Objet chargé associé à cet objet ProLoaderInfo. | ProLoaderInfo | ||
| contentType : String [lecture seule]
Type MIME du fichier chargé. | ProLoaderInfo | ||
| frameRate : Number [lecture seule]
Cadence nominale, en images par seconde, du fichier SWF chargé. | ProLoaderInfo | ||
| height : int [lecture seule]
Hauteur nominale du fichier chargé. | ProLoaderInfo | ||
| isURLInaccessible : Boolean [lecture seule]
Indique si la propriété ProLoaderInfo.url a été tronquée. | ProLoaderInfo | ||
| loader : ProLoader [lecture seule]
Objet ProLoader associé à cet objet ProLoaderInfo. | ProLoaderInfo | ||
| loaderURL : String [lecture seule]
URL du fichier SWF qui a initié le chargement du média décrit par l’objet ProLoaderInfo. | ProLoaderInfo | ||
| parameters : Object [lecture seule]
Objet contenant des paires nom-valeur qui représentent les paramètres fournis au fichier SWF chargé. | ProLoaderInfo | ||
| parentAllowsChild : Boolean [lecture seule]
Exprime la relation de confiance qui lie l’objet ProLoader (le parent) au contenu (l’enfant). | ProLoaderInfo | ||
| parentSandboxBridge : Object
Objet pouvant être défini par le code dans le sandbox de l’objet ProLoader pour exposer les propriétés et les méthodes auxquelles le code du contenu chargé peut accéder. | ProLoaderInfo | ||
| sameDomain : Boolean [lecture seule]
Exprime la relation entre les domaines de l’objet loader et du contenu : true s’ils proviennent du même domaine ; false dans tous les autres cas. | ProLoaderInfo | ||
| sharedEvents : EventDispatcher [lecture seule]
Des problèmes de temporisation lors du chargement du contenu provoquent le préchargement du fichier RSL ; il est donc recommandé d’attendre la réception de l’événement init pour ajouter des écouteurs d’événement à l’objet sharedEvents, ou pour les rajouter une fois l’événement init reçu. | ProLoaderInfo | ||
| swfVersion : uint [lecture seule]
Version du format du fichier SWF chargé. | ProLoaderInfo | ||
| url : String [lecture seule]
URL du média en cours de chargement. | ProLoaderInfo | ||
| width : int [lecture seule]
Largeur nominale du contenu chargé. | ProLoaderInfo | ||
actionScriptVersion | propriété |
actionScriptVersion:uint [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Version ActionScript du fichier SWF chargé. La version du langage est spécifiée par le biais des énumérations de la classe ActionScriptVersion, telles que ActionScriptVersion.ACTIONSCRIPT2 et ActionScriptVersion.ACTIONSCRIPT3.
Remarque : cette propriété possède toujours la valeur ActionScriptVersion.ACTIONSCRIPT2 ou ActionScriptVersion.ACTIONSCRIPT3. ActionScript 1.0 et 2.0 correspondent tous deux à ActionScriptVersion.ACTIONSCRIPT2 (version 2.0). Cette propriété se contente de distinguer ActionScript 1.0 et 2.0 d’ActionScript 3.0.
Implémentation
public function get actionScriptVersion():uintEléments de l’API associés
applicationDomain | propriété |
applicationDomain:ApplicationDomain [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Lorsqu’un fichier SWF externe est chargé, toutes les définitions ActionScript 3.0 que contient la classe chargée sont enregistrées dans la propriété applicationDomain.
L’ensemble du code d’un fichier SWF est défini de sorte à exister dans un domaine d’application. Votre application principale s’exécute dans le domaine d’application en cours. Le domaine du système contient tous les domaines d’application, y compris le domaine actuel et toutes les classes utilisées par Flash Player ou Adobe AIR.
A l’exception du domaine du système, tous les domaines d’application sont associés à un domaine du parent. Le domaine du parent de la propriété applicationDomain de votre application principale est le domaine système. Les classes chargées ne sont définies que si leur parent ne les définit pas encore. Vous ne pouvez pas remplacer une définition de classe chargée par une définition plus récente.
Pour obtenir des exemples d’utilisation de domaines d’application, voir le chapitre « Environnement du système client » du Guide du développeur d’ActionScript 3.0.
Implémentation
public function get applicationDomain():ApplicationDomainEléments de l’API associés
bytes | propriété |
bytesLoaded | propriété |
bytesLoaded:uint [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Nombre d’octets chargés pour le média. Lorsque ce nombre atteint la valeur de bytesTotal, tous les octets sont chargés.
Implémentation
public function get bytesLoaded():uintEléments de l’API associés
bytesTotal | propriété |
bytesTotal:uint [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Avant que l’objet ProLoader correspondant à cet objet ne distribue le premier événement progress, bytesTotal est défini sur 0. Après que l’objet ProLoader a distribué le premier événement progress, bytesTotal indique le nombre réel d’octets à télécharger.
Implémentation
public function get bytesTotal():uintEléments de l’API associés
childAllowsParent | propriété |
childAllowsParent:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Exprime la relation de confiance qui lie le contenu (l’enfant) à l’objet ProLoader (le parent). Renvoie true si l’enfant a autorisé l’accès du parent, false dans le cas contraire. Cette propriété est définie sur true si l’objet enfant a appelé la méthode allowDomain() pour accorder une autorisation d’accès au domaine parent, ou si un fichier de régulation d’URL chargé dans le domaine enfant accorde une autorisation d’accès au domaine parent. Si l’enfant et le parent appartiennent au même domaine, cette propriété est réglée sur true.
Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).
Implémentation
public function get childAllowsParent():BooleanEléments de l’API associés
childSandboxBridge | propriété |
childSandboxBridge:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | AIR 1.0 |
Objet pouvant être défini par le code du contenu chargé pour exposer des propriétés et des méthodes auxquelles le code dans le sandbox de l’objet ProLoader peut accéder. Ce pont de sandboxpermet au contenu d’un domaine qui n’est pas un domaine d’application de bénéficier d’un accès contrôlé aux scripts dans le sandbox de l’application AIR, et vice-versa. Le pont de sandbox sert de passerelle entre les sandboxes, fournissant une interaction explicite entre les sandboxes de sécurité de l’application et les autres.
Implémentation
public function get childSandboxBridge():Object public function set childSandboxBridge(value:Object):voidValeur émise
SecurityError — Seul le contenu dans le sandbox du contenu chargé peut définir cette propriété.
|
Eléments de l’API associés
content | propriété |
content:DisplayObject [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Objet chargé associé à cet objet ProLoaderInfo.
Implémentation
public function get content():DisplayObjectEléments de l’API associés
contentType | propriété |
contentType:String [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Type MIME du fichier chargé. Le paramètre est défini sur null si le pourcentage chargé du fichier est insuffisant pour déterminer le type. La liste suivante répertorie les valeurs gérées :
"application/x-shockwave-flash""image/jpeg""image/gif""image/png"
Implémentation
public function get contentType():StringEléments de l’API associés
frameRate | propriété |
frameRate:Number [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Cadence nominale, en images par seconde, du fichier SWF chargé. Cette valeur correspond souvent, mais pas nécessairement, à un entier.
Elle peut être différente de la cadence utilisée. Flash Player ou Adobe AIR utilise la même cadence pour tous les fichiers SWF chargés. Cette valeur est déterminée par la cadence nominale du fichier SWF principal. De même, la cadence principale risque de ne pas pouvoir être atteinte, selon le matériel, la synchronisation du son, et d’autres facteurs.
Implémentation
public function get frameRate():NumberEléments de l’API associés
height | propriété |
height:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Hauteur nominale du fichier chargé. Elle peut être différente de la hauteur réelle du contenu affiché, car le contenu chargé ou ses objets d’affichage parent risquent d’avoir été redimensionnés.
Implémentation
public function get height():intEléments de l’API associés
isURLInaccessible | propriété |
isURLInaccessible:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Indique si la propriété ProLoaderInfo.url a été tronquée. Lorsque la valeur isURLInaccessible est définie sur true, la valeur ProLoaderInfo.url correspond uniquement au domaine de l’URL finale à partir de laquelle le contenu a été chargé. Par exemple, la propriété est tronquée si le contenu est chargé à partir de http://www.adobe.com/assets/hello.swf, et la propriété ProLoaderInfo.url a la valeur http://www.adobe.com. La valeur isURLInaccessible est définie sur true uniquement lorsque toutes les affirmations suivantes sont également vraies :
- Une redirection HTTP s’est produite lors du chargement du contenu.
- Le fichier SWF qui appelle
ProLoader.load()provient d’un domaine différent de celui de l’URL finale du contenu. - Le fichier SWF qui appelle
ProLoader.load()n’est pas autorisé à accéder au contenu. L’autorisation d’accéder au contenu s’obtient de la même façon que l’autorisation d’accéder àBitmapData.draw(): appelezSecurity.allowDomain()pour accéder à un fichier SWF (ou pour le contenu des fichiers non SWF, créez un fichier de régulation et utilisez la propriétéLoaderContext.checkPolicyFile).
Remarque : la propriété isURLInaccessible a été ajoutée à Flash Player 10.1 et AIR 2.0. Toutefois, cette propriété est disponible pour les fichiers SWF de toutes les versions lorsque le moteur d’exécution de Flash la prend en charge. Ainsi, l’utilisation de certains outils de création en « mode strict » entraîne une erreur de compilation. Pour contourner cette erreur, utilisez la syntaxe indirecte myLoaderInfo["isURLInaccessible"] ou désactivez le mode strict. Si vous utilisez Flash Professional CS5 ou le kit SDK Flex version 4.1, vous pouvez utiliser et compiler cette API pour les moteurs d’exécution publiés avant Flash Player 10.1 et AIR 2.
Pour le contenu de l’application dans AIR, la valeur de cette propriété est toujours false.
Implémentation
public function get isURLInaccessible():BooleanEléments de l’API associés
loader | propriété |
loader:ProLoader [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Objet ProLoader associé à cet objet ProLoaderInfo. Si cet objet ProLoaderInfo figure dans la propriété loaderInfo de l’occurrence de la classe principale du fichier SWF, il n’est associé à aucun objet ProLoader.
Implémentation
public function get loader():ProLoaderEléments de l’API associés
loaderURL | propriété |
loaderURL:String [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
URL du fichier SWF qui a initié le chargement du média décrit par l’objet ProLoaderInfo. Pour l’occurrence de la classe principale du fichier SWF, cette URL correspond à l’URL du fichier SWF.
Implémentation
public function get loaderURL():StringEléments de l’API associés
parameters | propriété |
parameters:Object [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Objet contenant des paires nom-valeur qui représentent les paramètres fournis au fichier SWF chargé.
L’utilisation d’une boucle for-in vous permet d’extraire tous les noms et toutes les valeurs de l’objet parameters.
Les deux sources de paramètres sont : la chaîne de requête que contient l’URL du fichier SWF principal et la valeur du paramètre HTML FlashVars (qui n’affecte que le fichier SWF principal).
La propriété parameters remplace la technique ActionScript 1.0 et 2.0 qui consistait à utiliser des paramètres de fichier SWF en tant que propriétés du scénario principal.
La valeur de la propriété parameters est null pour les objets ProLoader qui contiennent des fichiers SWF faisant appel à ActionScript 1.0 ou 2.0. Elle est différente de null pour les objets ProLoader qui contiennent des fichiers SWF ayant recours à ActionScript 3.0.
Implémentation
public function get parameters():ObjectEléments de l’API associés
parentAllowsChild | propriété |
parentAllowsChild:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Exprime la relation de confiance qui lie l’objet ProLoader (le parent) au contenu (l’enfant). Renvoie true si le parent a autorisé l’accès de l’enfant, false dans le cas contraire. Cette propriété est définie sur true si l’objet parent a appelé la méthode allowDomain() pour accorder une autorisation d’accès au domaine enfant, ou si un fichier de régulation d’URL chargé dans le domaine parent accorde une autorisation d’accès au domaine enfant. Si l’enfant et le parent appartiennent au même domaine, cette propriété est réglée sur true.
Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).
Implémentation
public function get parentAllowsChild():BooleanValeur émise
Error — Exception renvoyée si le pourcentage téléchargé du fichier n’est pas suffisant pour extraire les informations requises.
|
Eléments de l’API associés
parentSandboxBridge | propriété |
parentSandboxBridge:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | AIR 1.0 |
Objet pouvant être défini par le code dans le sandbox de l’objet ProLoader pour exposer les propriétés et les méthodes auxquelles le code du contenu chargé peut accéder. Ce pont de sandboxpermet au contenu d’un domaine qui n’est pas un domaine d’application de bénéficier d’un accès contrôlé aux scripts dans le sandbox de l’application AIR, et vice-versa. Le pont de sandbox sert de passerelle entre les sandboxes, fournissant une interaction explicite entre les sandboxes de sécurité de l’application et les autres.
Implémentation
public function get parentSandboxBridge():Object public function set parentSandboxBridge(value:Object):voidValeur émise
SecurityError — Seul le contenu dans le sandbox de l’objet ProLoader peut définir cette propriété.
|
Eléments de l’API associés
sameDomain | propriété |
sameDomain:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Exprime la relation entre les domaines de l’objet loader et du contenu : true s’ils proviennent du même domaine ; false dans tous les autres cas.
Implémentation
public function get sameDomain():BooleanEléments de l’API associés
sharedEvents | propriété |
sharedEvents:EventDispatcher [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Des problèmes de temporisation lors du chargement du contenu provoquent le préchargement du fichier RSL ; il est donc recommandé d’attendre la réception de l’événement init pour ajouter des écouteurs d’événement à l’objet sharedEvents, ou pour les rajouter une fois l’événement init reçu.
Implémentation
public function get sharedEvents():EventDispatcherEléments de l’API associés
swfVersion | propriété |
swfVersion:uint [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Version du format du fichier SWF chargé. Le format du fichier est spécifié par le biais des énumérations de la classe SWFVersion, telles que SWFVersion.FLASH7 et SWFVersion.FLASH9.
Implémentation
public function get swfVersion():uintEléments de l’API associés
url | propriété |
url:String [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
URL du média en cours de chargement.
Avant la distribution du premier événement progress par l’objet ProLoader correspondant à cet objet ProLoaderInfo, la valeur de la propriété url risque de refléter uniquement l’URL initiale spécifiée par l’appel de la méthode load() de l’objet ProLoader. Après la distribution du premier événement progress, la propriété url reflète l’URL finale du média, suite à la résolution de toute redirection et URL relative.
Dans certains cas, la valeur de la propriété url est tronquée. Voir la propriété isURLInaccessible pour plus d’informations.
Implémentation
public function get url():Stringwidth | propriété |
width:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flash CS5.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Largeur nominale du contenu chargé. Elle peut être différente de la largeur réelle du contenu affiché, car le contenu chargé ou ses objets d’affichage parent risquent d’avoir été redimensionnés.
Implémentation
public function get width():intEléments de l’API associés
Tue Jun 12 2018, 09:30 AM Z