(AIR uniquement)
Packageflash.html
Classepublic class HTMLLoader
HéritageHTMLLoader Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object

Versions du moteur d'exécution: AIR 1.0

La classe HTMLLoader définit un type d'objet d'affichage correspondant à un conteneur du contenu HTML.

Les dimensions par défaut d'un objet HTMLLoader sont 0 x 0 pixels. Définissez les propriétés width et height pour que l'objet HTMLLoader devienne visible.

La taille maximale d'un objet HTMLLoader est de 2 880 pixels de haut sur 2 880 pixels de large. Si vous définissez la propriété width ou height d'un objet HTMLLoader sur une valeur supérieure à cette limite, l'objet HTMLLoader renvoie une exception ArgumentError.

Consulter les exemples



Propriétés publiques
 PropriétéDéfini par
 InheritedaccessibilityProperties : AccessibilityProperties
Options d'accessibilité actuelles de l'objet d'affichage.
DisplayObject
 Inheritedalpha : Number
Indique la valeur de transparence alpha de l'objet spécifié.
DisplayObject
  AIR-only authenticate : Boolean
Spécifie si les requêtes d'authentification doivent être gérées (true) ou non (false) pour les requêtes HTTP publiées par cet objet.
HTMLLoader
 InheritedblendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fondu à utiliser.
DisplayObject
 InheritedblendShader : Shader
[lecture seule] Définit un shader utilisé pour le fondu de l'arrière-plan et du premier plan.
DisplayObject
 InheritedbuttonMode : Boolean
Spécifie le mode de bouton du sprite.
Sprite
 InheritedcacheAsBitmap : Boolean
Si true est défini, Flash Player ou Adobe AIR place en mémoire cache une version bitmap interne de l’objet d'affichage.
DisplayObject
  AIR-only cacheResponse : Boolean
Spécifie si les données de réponse doivent être mises en cache pour les requêtes HTTP publiées par cet objet.
HTMLLoader
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
  AIR-only contentHeight : Number
[lecture seule] Hauteur, en pixels, du contenu HTML.
HTMLLoader
  AIR-only contentWidth : Number
[lecture seule] Largeur, en pixels, du contenu HTML.
HTMLLoader
 InheritedcontextMenu : NativeMenu
Spécifie le menu contextuel associé à l'objet.
InteractiveObject
 InheriteddoubleClickEnabled : Boolean
Spécifie si l'objet reçoit les événements doubleClick.
InteractiveObject
 InheriteddropTarget : DisplayObject
[lecture seule] Spécifie l'objet d'affichage sur lequel le sprite est glissé ou sur lequel il a été déposé.
Sprite
 Inheritedfilters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l'objet d'affichage.
DisplayObject
 InheritedfocusRect : Object
Spécifie si l'objet affiche un rectangle de focus.
InteractiveObject
 Inheritedgraphics : Graphics
[lecture seule] Spécifie l'objet Graphics appartenant au sprite qui prend en charge les commandes de dessin vectoriel.
Sprite
  AIR-only hasFocusableContent : Boolean
[lecture seule] Indique si tout contenu de l'objet HTMLLoader peut recevoir le focus.
HTMLLoader
  AIR-only height : Number
[override] Spécifie la hauteur du rectangle des canevas HTML restitués.
HTMLLoader
  AIR-only historyLength : uint
[lecture seule] Longueur totale de la liste de l'historique, avec les entrées précédentes et suivantes.
HTMLLoader
  AIR-only historyPosition : uint
Position actuelle dans la liste de l'historique.
HTMLLoader
 InheritedhitArea : Sprite
Désigne un autre sprite qui fera office de zone active d'un sprite.
Sprite
  AIR-only htmlHost : HTMLHost
Objet HTMLHost employé pour gérer les modifications apportées à certains éléments de l'interface utilisateur, par exemple à la propriété window.document.title de l'objet HTMLLoader.
HTMLLoader
  AIR-only loaded : Boolean
[lecture seule] Indique si l'événement JavaScript load correspondant à l'appel précédent de la méthode load() ou loadString() a été délivré au DOM HTML dans l'objet HTMLLoader.
HTMLLoader
 InheritedloaderInfo : LoaderInfo
[lecture seule] Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d'affichage.
DisplayObject
  AIR-only location : String
[lecture seule] URL du contenu chargé dans l'objet HTMLLoader.
HTMLLoader
  AIR-only manageCookies : Boolean
Spécifie si la pile de protocoles HTTP doit gérer les cookies pour cet objet.
HTMLLoader
 Inheritedmask : DisplayObject
L'objet d'affichage appelant est masqué par l'objet mask spécifié.
DisplayObject
 InheritedmouseChildren : Boolean
Détermine si les enfants de l'objet prennent ou non en charge la souris.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Spécifie si l'objet reçoit les messages souris.
InteractiveObject
 InheritedmouseX : Number
[lecture seule] Indique la coordonnée x de la position de la souris, en pixels.
DisplayObject
 InheritedmouseY : Number
[lecture seule] Indique la coordonnée y de la position de la souris, en pixels.
DisplayObject
 Inheritedname : String
Indique le nom d'occurrence de DisplayObject.
DisplayObject
  AIR-only navigateInSystemBrowser : Boolean
Indique si la navigation de l'image racine du contenu HTML (par exemple lorsque l'utilisateur clique sur un lien, lorsque la propriété window.location est définie ou lors d'un appel à window.open()) entraîne une navigation dans l'objet HTMLLoader (false) ou dans le navigateur Web par défaut du système (true).
HTMLLoader
 InheritednumChildren : int
[lecture seule] Renvoie le nombre d'enfants de l'objet.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Indique si l'objet d'affichage est opaque avec une couleur d'arrière-plan spécifique.
DisplayObject
  AIR-only paintsDefaultBackground : Boolean
Spécifie si l'arrière-plan du document HTMLLoader est blanc opaque (true) ou non (false).
HTMLLoader
 Inheritedparent : DisplayObjectContainer
[lecture seule] Indique l'objet DisplayObjectContainer qui contient l'objet d'affichage.
DisplayObject
  AIR-only pdfCapability : int
[statique] [lecture seule] Type de prise en charge PDF dans le système de l'utilisateur, définie sous forme de valeur de code d'entier.
HTMLLoader
  AIR-only placeLoadStringContentInApplicationSandbox : Boolean
Spécifie si le contenu chargé via la méthode loadString() est placé dans le sandbox de l'application (true) ou dans un sandbox non-applicatif (false).
HTMLLoader
 Inheritedprototype : Object
[statique] Référence à l'objet prototype d'un objet de classe ou fonction.
Object
 Inheritedroot : DisplayObject
[lecture seule] Pour un objet d'affichage résidant dans un fichier SWF chargé, la propriété root correspond à l'objet d'affichage de premier niveau dans la partie de la structure arborescente de la liste d'affichage représentée par ce fichier.
DisplayObject
 Inheritedrotation : Number
Indique la rotation de l'occurrence de DisplayObject, en degrés, à partir de son orientation d'origine.
DisplayObject
 InheritedrotationX : Number
Indique la rotation de l'axe des x de l'occurrence DisplayObject, en degrés, à partir de son orientation d'origine par rapport au conteneur 3D parent.
DisplayObject
 InheritedrotationY : Number
Indique la rotation de l'axe des y de l'occurrence DisplayObject, en degrés, à partir de son orientation d'origine par rapport au conteneur 3D parent.
DisplayObject
 InheritedrotationZ : Number
Indique la rotation de l'axe des z de l'occurrence DisplayObject, en degrés, à partir de son orientation d'origine par rapport au conteneur 3D parent.
DisplayObject
  AIR-only runtimeApplicationDomain : ApplicationDomain
Domaine d'application à utiliser pour l'objet window.runtime dans le code JavaScript de la page HTML.
HTMLLoader
 Inheritedscale9Grid : Rectangle
Grille de mise à l'échelle en vigueur.
DisplayObject
 InheritedscaleX : Number
Indique l'échelle horizontale (pourcentage) de l'objet telle qu'elle est appliquée à partir du point d'alignement.
DisplayObject
 InheritedscaleY : Number
Indique le redimensionnement vertical (pourcentage) de l'objet tel qu'il est appliqué à partir du point d'alignement.
DisplayObject
 InheritedscaleZ : Number
Indique l'échelle de profondeur (pourcentage) de l'objet tel qu'elle est appliquée à partir du point d'alignement.
DisplayObject
  AIR-only scrollH : Number
Position de défilement horizontal du contenu HTML dans l'objet HTMLLoader.
HTMLLoader
 InheritedscrollRect : Rectangle
Cadre de délimitation du défilement de l'objet d'affichage.
DisplayObject
  AIR-only scrollV : Number
Position de défilement vertical du contenu HTML dans l'objet HTMLLoader.
HTMLLoader
 InheritedsoundTransform : SoundTransform
Contrôle le son à l'intérieur du sprite.
Sprite
 Inheritedstage : Stage
[lecture seule] Scène de l'objet d'affichage.
DisplayObject
 InheritedtabChildren : Boolean
Détermine si les enfants de l'objet prennent ou non en charge la tabulation.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Indique si cet objet est spécifié dans l'ordre de tabulation.
InteractiveObject
 InheritedtabIndex : int
Spécifie l'ordre de tabulation des objets dans un fichier SWF.
InteractiveObject
  AIR-only textEncodingFallback : String
Codage de caractères utilisé par le contenu HTMLLoader lorsque la page HTML ne spécifie aucun codage de caractères.
HTMLLoader
  AIR-only textEncodingOverride : String
Codage de caractères utilisé par le contenu HTMLLoader, remplaçant tous les paramètres de la page HTML.
HTMLLoader
 InheritedtextSnapshot : TextSnapshot
[lecture seule] Renvoie un objet TextSnapshot pour l'occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inheritedtransform : Transform
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d'un objet d'affichage.
DisplayObject
  AIR-only useCache : Boolean
Spécifie si le cache local doit être consulté avant que les requêtes HTTP publiées par cet objet ne récupèrent des données.
HTMLLoader
 InheriteduseHandCursor : Boolean
Valeur booléenne indiquant si le curseur en forme de main apparaît lorsque la souris survole un sprite dont la propriété buttonMode est réglée sur true.
Sprite
  AIR-only userAgent : String
Chaîne d'agent utilisateur à utiliser dans les requêtes de contenu entrantes provenant de cet objet HTMLLoader.
HTMLLoader
 Inheritedvisible : Boolean
Indique si l'objet d'affichage est visible ou non.
DisplayObject
  AIR-only width : Number
[override] Spécifie la largeur du rectangle des canevas HTML restitués.
HTMLLoader
  AIR-only window : Object
[lecture seule] Objet JavaScript global du contenu chargé dans le contrôle HTML.
HTMLLoader
 Inheritedx : Number
Indique la coordonnée x de l'occurrence de DisplayObject par rapport aux coordonnées locales de l'objet DisplayObjectContainer parent.
DisplayObject
 Inheritedy : Number
Indique la coordonnée y de l'occurrence de DisplayObject par rapport aux coordonnées locales de l'objet DisplayObjectContainer parent.
DisplayObject
 Inheritedz : Number
Indique la position de coordonnée z le long de l'axe des z de l'occurrence DisplayObject par rapport au conteneur 3D parent.
DisplayObject
Méthodes publiques
 MéthodeDéfini par
  
Crée un objet HTMLLoader.
HTMLLoader
 Inherited
Ajoute une occurrence enfant de DisplayObject à cette occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Ajoute une occurrence enfant de DisplayObject à cette occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.
EventDispatcher
 Inherited
Indique si les restrictions de sécurité entraîneraient l'omission des objets d'affichage de la liste renvoyée en appelant la méthode DisplayObjectContainer.getObjectsUnderPoint() avec le point « point » spécifié.
DisplayObjectContainer
  
Annule les opérations de chargement en cours.
HTMLLoader
 Inherited
Détermine si l'objet d'affichage spécifié est un enfant de l'occurrence de DisplayObjectContainer ou l'occurrence en tant que telle.
DisplayObjectContainer
  
AIR-only createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):HTMLLoader
[statique] Crée un nouvel objet NativeWindow contenant un objet HTMLLoader.
HTMLLoader
 Inherited
Distribue un événement dans le flux d'événements.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Renvoie un rectangle qui définit la zone de l'objet d'affichage relativement au système de coordonnées de l'objet targetCoordinateSpace.
DisplayObject
 Inherited
Renvoie l'occurrence enfant de l'objet d'affichage associée à l'index spécifié.
DisplayObjectContainer
 Inherited
Renvoie l'objet d'affichage enfant portant le nom spécifié.
DisplayObjectContainer
 Inherited
Renvoie la position d'index d'une occurrence enfant de DisplayObject.
DisplayObjectContainer
  
Renvoie l'entrée de l'historique à la position spécifiée.
HTMLLoader
 Inherited
Renvoie un tableau d'objets de niveau inférieur au point spécifié et qui sont les enfants (ou les petits-enfants, etc.) de l'occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Renvoie un rectangle qui définit les limites de l'objet d'affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes.
DisplayObject
 Inherited
Convertit l'objet point des coordonnées de scène (globales) vers les coordonnées de l'objet d'affichage (locales).
DisplayObject
 Inherited
Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d'un objet d'affichage tridimensionnel (locales).
DisplayObject
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l'objet EventDispatcher pour un type spécifique d'événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
  
Revient en arrière dans l'historique du navigateur, si possible.
HTMLLoader
  
Avance dans l'historique du navigateur, si possible.
HTMLLoader
  
AIR-only historyGo(steps:int):void
Navigue parmi le nombre d'étapes spécifiées dans l'historique du navigateur.
HTMLLoader
 Inherited
Evalue le cadre de délimitation de l'objet d'affichage pour savoir s'il recouvre ou recoupe le cadre de délimitation de l'objet d'affichage obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Evalue l'objet d'affichage pour savoir s'il recouvre ou recoupe le point spécifié par les paramètres x et y.
DisplayObject
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.
Object
  
AIR-only load(urlRequestToLoad:URLRequest):void
Charge l'objet HTMLLoader avec les données provenant du site spécifié par le paramètre urlRequestToLoad.
HTMLLoader
  
AIR-only loadString(htmlContent:String):void
Charge l'objet HTMLLoader avec le contenu HTML renfermé dans la chaîne HTML.
HTMLLoader
 Inherited
Convertit un point tridimensionnel des coordonnées de l'objet d'affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales).
DisplayObject
 Inherited
Convertit l'objet point des coordonnées de l'objet d'affichage (locales) vers les coordonnées de la scène (globales).
DisplayObject
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
  
Recharge la page à partir de l'emplacement en cours.
HTMLLoader
 Inherited
Supprime l'occurrence enfant de DisplayObject spécifiée de la liste d'enfants de l'occurrence de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Supprime une occurrence enfant de DisplayObject de la position d'index spécifiée dans la liste d'enfants de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l'objet EventDispatcher.
EventDispatcher
 Inherited
Modifie la position d'un enfant existant dans le conteneur d'objet d'affichage.
DisplayObjectContainer
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Permet à l'utilisateur de faire glisser le sprite spécifié.
Sprite
 Inherited
Met fin à la méthode startDrag().
Sprite
 Inherited
Intervertit l'ordre z (ordre d'empilement du premier plan vers l'arrière-plan) des deux objets enfants spécifiés.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Intervertit l'ordre z (ordre d'empilement du premier plan vers l'arrière-plan) des objets enfants aux deux positions d'index spécifiées dans la liste d'enfants.
DisplayObjectContainer
 Inherited
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
 Inherited
Vérifie si un écouteur d'événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d'événement spécifié.
EventDispatcher
Evénements
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l'application Flash Player obtient le focus du système d'exploitation et devient active.EventDispatcher
 InheritedDistribué lorsqu'un objet d'affichage est ajouté à la liste d'affichage.DisplayObject
 InheritedEnvoyé lorsqu'un objet d'affichage est ajouté dans la liste d'affichage de la scène, directement ou par l'intermédiaire d'une arborescence secondaire qui contient l'objet d'affichage.DisplayObject
 InheritedDistribué lorsque l'utilisateur sélectionne 'Effacer' (ou 'Supprimer') dans le menu contextuel.InteractiveObject
 InheritedDistribué lorsque l'utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject.InteractiveObject
  Signale que la dernière opération de chargement demandée par la méthode loadString ou load est terminée.HTMLLoader
 InheritedDistribué lorsque l'action d'un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR.InteractiveObject
 InheritedDistribué lorsque l'utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne 'Copier' dans le menu contextuel.InteractiveObject
 InheritedDistribué lorsque l'utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne 'Couper' dans le menu contextuel.InteractiveObject
 Inherited[Evénement de diffusion] Distribué lorsque l'application Flash Player ou AIR perd le focus du système d'exploitation et devient inactive.EventDispatcher
 InheritedDistribué lorsque l'utilisateur appuie sur le bouton principal d'un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d'InteractiveObject si l'indicateur doubleClickEnabled de cet objet est réglé sur true.InteractiveObject
 Inherited[événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image.DisplayObject
 Inherited[événement de diffusion] Distribué lorsque la tête de lecture quitte l'image en cours.DisplayObject
 InheritedDistribué après la prise de focus par un objet d'affichage.InteractiveObject
 InheritedDistribué après la perte de focus par un objet d'affichage.InteractiveObject
 Inherited[événement de diffusion] Distribué après l'exécution des constructeurs des objets d'affichage d'image, mais avant celle des scripts d'image.DisplayObject
  Signale que l'une des propriétés contentWidth et contentHeight, ou les deux, ont été modifiées.HTMLLoader
  Signale que le DOM HTML a été créé en réponse à une opération de chargement.HTMLLoader
  Signale que le rendu du contenu de l'objet HTMLLoader est entièrement à jour.HTMLLoader
 InheritedDistribué lorsque l'utilisateur appuie sur une touche.InteractiveObject
 InheritedDistribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier.InteractiveObject
 InheritedDistribué lorsque l'utilisateur relâche une touche.InteractiveObject
  Signale que la propriété location de l'objet HTMLLoader a été modifiée.HTMLLoader
 InheritedDistribué lorsque l’utilisateur appuie sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu'un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu'un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu'un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l'utilisateur tente de déplacer le focus à l'aide d'un périphérique de pointage.InteractiveObject
 InheritedDistribué lorsque l'utilisateur déplace le périphérique de pointage placé sur une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l'utilisateur éloigne un périphérique de pointage d'une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu'un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsque la molette d'une souris est actionnée sur une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué par l'initiateur glisser InteractiveObject lorsque l'utilisateur arrête l'opération glisser.InteractiveObject
 InheritedDistribué par l'objet InteractiveObject cible lorsqu'un objet glissé est déposé dessus et que l'opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop().InteractiveObject
 InheritedDistribué par un InteractiveObject lorsqu'une opération glisser entre dans ses limites.InteractiveObject
 InheritedDistribué par un InteractiveObject lorsqu'une opération glisser sort des limites.InteractiveObject
 InheritedDistribué par un objet InteractiveObject de façon continue lorsqu'une opération glisser reste dans ses limites.InteractiveObject
 InheritedDistribué au début d'une opération glisser par l'objet InteractiveObject spécifié comme initiateur de l'action glisser dans l'appel DragManager.doDrag().InteractiveObject
 InheritedDistribué lors d'une opération glisser par l'objet InteractiveObject spécifié comme initiateur de l'action glisser dans l'appel DragManager.doDrag().InteractiveObject
 InheritedDistribué lorsque l'utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de collage ou sélectionne 'Coller' dans le menu contextuel.InteractiveObject
 InheritedDistribué lorsqu'un objet d'affichage est sur le point d'être supprimé de la liste d'affichage.DisplayObject
 InheritedDistribué lorsqu'un objet d'affichage est sur le point d'être supprimé de la liste d'affichage de la scène, directement ou par l'intermédiaire de la suppression d'une arborescence secondaire qui contient l'objet d'affichage.DisplayObject
 Inherited[événement de diffusion] Distribué lorsque la liste d'affichage est sur le point d'être mise à jour et restituée.DisplayObject
 InheritedDistribué lorsque l’utilisateur appuie sur le bouton droit de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu'un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsqu'un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l'utilisateur éloigne un périphérique de pointage d'une occurrence de InteractiveObject.InteractiveObject
 InheritedDistribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject.InteractiveObject
  Signale que la propriété scrollH ou scrollV a été modifiée par l'objet HTMLLoader.HTMLLoader
 InheritedDistribué lorsque l'utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour tout sélectionner ou choisit 'Sélectionner tout' dans le menu contextuel.InteractiveObject
 InheritedDistribué lorsque la valeur de l'indicateur tabChildren de l'objet change.InteractiveObject
 InheritedDistribué lorsque l'indicateur tabEnabled de l'objet change.InteractiveObject
 InheritedDistribué lorsque la valeur de la propriété tabIndex de l’objet change.InteractiveObject
  Signale qu'une exception JavaScript non interceptée s'est produite dans l'objet HTMLLoader.HTMLLoader
Détails de la propriété
AIR-only authenticatepropriété
authenticate:Boolean  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

Spécifie si les requêtes d'authentification doivent être gérées (true) ou non (false) pour les requêtes HTTP publiées par cet objet. Si la valeur est false, les requêtes d'authentification renvoient une erreur HTTP.

La valeur par défaut est initialized from URLRequestDefaults.authenticate.



Implémentation
    public function get authenticate():Boolean
    public function set authenticate(value:Boolean):void

Voir aussi

AIR-only cacheResponsepropriété 
cacheResponse:Boolean  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

Spécifie si les données de réponse doivent être mises en cache pour les requêtes HTTP publiées par cet objet. Si cette propriété est définie sur true, l'objet HTMLLoader utilise le cache HTTP du système d'exploitation.

La valeur par défaut est initialized from URLRequestDefaults.cacheResponse.



Implémentation
    public function get cacheResponse():Boolean
    public function set cacheResponse(value:Boolean):void

Voir aussi

AIR-only contentHeightpropriété 
contentHeight:Number  [lecture seule]

Versions du moteur d'exécution: AIR 1.0

Hauteur, en pixels, du contenu HTML. Cette propriété peut changer lorsque les dimensions de l'objet HTMLLoader sont modifiées. Par exemple, une page HTML utilise souvent la totalité de la hauteur de l'objet HTMLLoader, et la propriété contentHeight peut changer si vous modifiez la hauteur de l'objet HTMLLoader.



Implémentation
    public function get contentHeight():Number
AIR-only contentWidthpropriété 
contentWidth:Number  [lecture seule]

Versions du moteur d'exécution: AIR 1.0

Largeur, en pixels, du contenu HTML. Cette propriété peut changer lorsque les dimensions de l'objet HTMLLoader sont modifiées. Par exemple, une page HTML utilise souvent la totalité de la largeur de l'objet HTMLLoader, et la propriété contentWidth peut changer si vous modifiez la largeur de l'objet HTMLLoader.



Implémentation
    public function get contentWidth():Number
AIR-only hasFocusableContentpropriété 
hasFocusableContent:Boolean  [lecture seule]

Versions du moteur d'exécution: AIR 1.0

Indique si tout contenu de l'objet HTMLLoader peut recevoir le focus.



Implémentation
    public function get hasFocusableContent():Boolean
AIR-only heightpropriété 
height:Number  [lecture-écriture] [override]

Versions du moteur d'exécution: AIR 1.0

Spécifie la hauteur du rectangle des canevas HTML restitués. Il s'agit de la hauteur de l'objet d'affichage HTMLLoader, en pixels. Si cette propriété est modifiée, l'objet HTMLLoader restitue à nouveau le document HTML. La modification de cette propriété peut entraîner le déclenchement d'événements htmlBoundsChanged. Lorsque vous définissez la propriété width ou height d'un objet HTMLLoader, les limites de l'objet changent, mais son contenu n'est pas mis à l'échelle (comme dans le cas des autres types d'objets d'affichage).



Implémentation
    public function get height():Number
    public function set height(value:Number):void
AIR-only historyLengthpropriété 
historyLength:uint  [lecture seule]

Versions du moteur d'exécution: AIR 1.0

Longueur totale de la liste de l'historique, avec les entrées précédentes et suivantes. Cette propriété a la même valeur que la propriété JavaScript window.history.length de la page HTML.



Implémentation
    public function get historyLength():uint

Voir aussi

AIR-only historyPositionpropriété 
historyPosition:uint  [lecture-écriture]

Versions du moteur d'exécution: AIR 1.0

Position actuelle dans la liste de l'historique. La liste de l'historique correspond à l'objet window.history de la page HTML. Les entrées inférieures à la position actuelle sont les entrées « précédentes » de la liste ; les entrées supérieures sont les entrées « suivantes ». Lorsque vous tentez de définir la position au-delà de la fin, elle est définie sur la fin.



Implémentation
    public function get historyPosition():uint
    public function set historyPosition(value:uint):void

Voir aussi

AIR-only htmlHostpropriété 
htmlHost:HTMLHost  [lecture-écriture]

Versions du moteur d'exécution: AIR 1.0

Objet HTMLHost employé·pour gérer les modifications apportées à certains éléments de l'interface utilisateur, par exemple à la propriété window.document.title de l'objet HTMLLoader. Pour remplacer les comportements par défaut de l'objet HTMLLoader, créez une sous-classe de la classe HTMLHost et remplacez ses fonctions de membre pour gérer les différentes modifications de l'interface utilisateur apportées au contenu HTML.



Implémentation
    public function get htmlHost():HTMLHost
    public function set htmlHost(value:HTMLHost):void

Voir aussi

AIR-only loadedpropriété 
loaded:Boolean  [lecture seule]

Versions du moteur d'exécution: AIR 1.0

Indique si l'événement JavaScript load correspondant à l'appel précédent de la méthode load() ou loadString() a été délivré au DOM HTML dans l'objet HTMLLoader. Cette propriété est true avant le déclenchement de l'événement complete. Il est possible que cette propriété ne devienne jamais true. Cela se produit comme lorsque l'événement complete n'est jamais déclenché.



Implémentation
    public function get loaded():Boolean
AIR-only locationpropriété 
location:String  [lecture seule]

Versions du moteur d'exécution: AIR 1.0

URL du contenu chargé dans l'objet HTMLLoader.



Implémentation
    public function get location():String
AIR-only manageCookiespropriété 
manageCookies:Boolean  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

Spécifie si la pile de protocoles HTTP doit gérer les cookies pour cet objet. Si la valeur true est définie, les cookies sont ajoutés à la requête et les cookies de réponse sont mémorisés. Si la valeur est false, les cookies ne sont pas ajoutés à la requête et les cookies de réponse ne sont pas mémorisés.

La valeur par défaut est initialized from URLRequestDefaults.manageCookies.



Implémentation
    public function get manageCookies():Boolean
    public function set manageCookies(value:Boolean):void

Voir aussi

AIR-only navigateInSystemBrowserpropriété 
navigateInSystemBrowser:Boolean  [lecture-écriture]

Versions du moteur d'exécution: AIR 1.0

Indique si la navigation de l'image racine du contenu HTML (par exemple lorsque l'utilisateur clique sur un lien, lorsque la propriété window.location est définie ou lors d'un appel à window.open()) entraîne une navigation dans l'objet HTMLLoader (false) ou dans le navigateur Web par défaut du système (true ). Définissez cette propriété sur true pour que toute la navigation se produise dans le navigateur Web du système (pas dans l'objet HTMLLoader).

La valeur par défaut est false.



Implémentation
    public function get navigateInSystemBrowser():Boolean
    public function set navigateInSystemBrowser(value:Boolean):void
AIR-only paintsDefaultBackgroundpropriété 
paintsDefaultBackground:Boolean  [lecture-écriture]

Versions du moteur d'exécution: AIR 1.0

Spécifie si l'arrière-plan du document HTMLLoader est blanc opaque (true) ou non (false ). Lorsque cette propriété est définie sur false, l'objet HTMLLoader utilise son conteneur d'objet d'affichage comme arrière-plan pour le code HTML et utilise l'opacité (valeur alpha) du conteneur d'objet d'affichage comme arrière-plan HTML. Toutefois, si l'élément body ou tout autre élément du document HTML a une couleur d'arrière-plan opaque (spécifiée par style="background-color:gray", par exemple), cette partie du rendu HTML utilise la couleur d'arrière-plan opaque spécifiée.



Implémentation
    public function get paintsDefaultBackground():Boolean
    public function set paintsDefaultBackground(value:Boolean):void
AIR-only pdfCapabilitypropriété 
pdfCapability:int  [lecture seule]

Versions du moteur d'exécution: AIR 1.0

Type de prise en charge PDF dans le système de l'utilisateur, définie sous forme de valeur de code d'entier. Un objet HTMLLoader ne peut afficher du contenu PDF que si la valeur de cette propriété est PDFCapability.STATUS_OK. La classe PDFCapability définit des constantes pour les valeurs possibles de la propriété pdfCapability, comme suit :

Constante PDFCapabilitySignification
STATUS_OK Une version appropriée d'Acrobat ou Adobe Reader (8.1 ou ultérieure) est détectée et le contenu PDF peut être chargé dans un objet HTMLLoader.

Remarque : sous Windows, si une version Acrobat ou Adobe Reader 7.x ou antérieure est en cours d'exécution sur le système de l'utilisateur, cette version est utilisée même lorsqu'une version ultérieure prenant en charge le chargement PDF dans un objet HTMLLoader est installée. Dans ce cas, si la valeur de la propriété pdfCapability est PDFCapability.STATUS_OK, lorsqu'une application AIR tente de charger du contenu PDF, l'ancienne version d'Acrobat ou d'Adobe Reader affiche une alerte, sans qu'un message d'erreur n'apparaisse dans le moteur d'exécution AIR. Si vos utilisateurs se retrouvent dans cette situation, envisagez de leur demander de fermer Acrobat ou Adobe Reader lorsqu'ils exécutent votre application. Vous pouvez également envisager d'afficher ces instructions si le contenu PDF ne se charge pas dans un délai acceptable.

ERROR_INSTALLED_READER_NOT_FOUND Aucune version d'Acrobat ou d'Adobe Reader n'est détectée. Un objet HTMLLoader ne peut pas afficher de contenu PDF.
ERROR_INSTALLED_READER_TOO_OLD Acrobat ou Adobe Reader a bien été détecté, mais la version est trop ancienne. Un objet HTMLLoader ne peut pas afficher de contenu PDF.
ERROR_PREFERED_READER_TOO_OLD Une version appropriée d'Acrobat ou d'Adobe Reader (8.1 ou ultérieure) a bien été détectée, mais la version configurée pour gérer le contenu PDF est antérieure à 8.1. Un objet HTMLLoader ne peut pas afficher de contenu PDF.



Implémentation
    public static function get pdfCapability():int

Voir aussi

AIR-only placeLoadStringContentInApplicationSandboxpropriété 
placeLoadStringContentInApplicationSandbox:Boolean  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.5

Spécifie si le contenu chargé à l'aide de la méthode loadString() est placé dans le sandbox de l'application (true) ou dans un sandbox non-applicatif (false).

Lorsque cette propriété est définie sur false, le contenu chargé à l'aide de la méthode loadString() est placé dans un sandbox non-applicatif avec les caractéristiques suivantes :

Lorsque cette propriété est définie sur true, le contenu chargé à l'aide de la méthode loadString() est placé dans le sandbox de l'application et peut accéder à la propriété window.runtime, ainsi qu'à toutes les API d'AIR. Vérifiez la fiabilité de la source de données d'une chaîne utilisée lors d'un appel à la méthode loadString(). Les instructions de code dans la chaîne HTML sont exécutées avec des privilèges d'application complets lorsque cette propriété est définie sur true. Définissez cette propriété sur true uniquement si vous êtes certain que la chaîne ne contient aucun code néfaste.

Dans les applications compilées avec les kits de développement AIR 1.0 ou AIR 1.1, le contenu chargé à l'aide de la méthode loadString() est placé dans le sandbox de l'application.

La valeur par défaut est false.



Implémentation
    public function get placeLoadStringContentInApplicationSandbox():Boolean
    public function set placeLoadStringContentInApplicationSandbox(value:Boolean):void

Voir aussi

AIR-only runtimeApplicationDomainpropriété 
runtimeApplicationDomain:ApplicationDomain  [lecture-écriture]

Versions du moteur d'exécution: AIR 1.0

Domaine d'application à utiliser pour l'objet window.runtime dans le code JavaScript de la page HTML.

Si cette propriété est null, ou si le contenu HTML provient d'un autre domaine de sécurité que le contenu SWF contenant l'objet HTMLLoader, la page utilise un domaine d'application par défaut comme domaine.



Implémentation
    public function get runtimeApplicationDomain():ApplicationDomain
    public function set runtimeApplicationDomain(value:ApplicationDomain):void

Valeur émise
SecurityError — Si l'objet ApplicationDomain ne provient pas du domaine de sécurité de l'appelant.

Voir aussi

AIR-only scrollHpropriété 
scrollH:Number  [lecture-écriture]

Versions du moteur d'exécution: AIR 1.0

Position de défilement horizontal du contenu HTML dans l'objet HTMLLoader.



Implémentation
    public function get scrollH():Number
    public function set scrollH(value:Number):void
AIR-only scrollVpropriété 
scrollV:Number  [lecture-écriture]

Versions du moteur d'exécution: AIR 1.0

Position de défilement vertical du contenu HTML dans l'objet HTMLLoader.



Implémentation
    public function get scrollV():Number
    public function set scrollV(value:Number):void
AIR-only textEncodingFallbackpropriété 
textEncodingFallback:String  [lecture-écriture]

Versions du moteur d'exécution: AIR 1.0

Codage de caractères utilisé par le contenu HTMLLoader lorsque la page HTML ne spécifie aucun codage de caractères. Une page HTML définit le codage de caractères dans une balise meta, comme dans l'exemple suivant :

<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

Les valeurs sont définies dans la liste IANA des jeux de caractères valides.

Lorsque aucun encodage n'est spécifié par la page HTML, par la propriété textEncodingFallback ou par la propriété textEncodingOverride, le contenu HTML utilise l'encodage ISO-8859-1.



Implémentation
    public function get textEncodingFallback():String
    public function set textEncodingFallback(value:String):void

Voir aussi

AIR-only textEncodingOverridepropriété 
textEncodingOverride:String  [lecture-écriture]

Versions du moteur d'exécution: AIR 1.0

Codage de caractères utilisé par le contenu HTMLLoader, remplaçant tous les paramètres de la page HTML. Une page HTML définit le codage de caractères dans une balise meta, comme dans l'exemple suivant :

<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

Ce paramètre remplace également tous les paramètres de la propriété textEncodingFallback.

Les valeurs sont définies dans la liste IANA des jeux de caractères valides.

Définissez la propriété textEncodingOverride après le chargement du contenu HTML pour que AIR actualise le contenu HTML à l'aide de l'encodage spécifié. Lorsque HTMLLoader navigue vers une nouvelle page, vous devez redéfinir cette propriété pour que cette nouvelle page utilise un encodage spécifique.

Lorsque aucun encodage n'est spécifié par la page HTML, par la propriété textEncodingFallback ou textEncodingOverride, le contenu HTML utilise l'encodage ISO-8859-1.

La définition de la propriété textEncodingOverride sur null restaure le comportement par défaut.



Implémentation
    public function get textEncodingOverride():String
    public function set textEncodingOverride(value:String):void

Voir aussi

AIR-only useCachepropriété 
useCache:Boolean  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

Spécifie si le cache local doit être consulté avant que les requêtes HTTP publiées par cet objet ne récupèrent des données.

La valeur par défaut est initialized from URLRequestDefaults.useCache.



Implémentation
    public function get useCache():Boolean
    public function set useCache(value:Boolean):void

Voir aussi

AIR-only userAgentpropriété 
userAgent:String  [lecture-écriture]

Versions du moteur d'exécution: AIR 1.0

Chaîne d'agent utilisateur à utiliser dans les requêtes de contenu entrantes provenant de cet objet HTMLLoader.

Pour définir la chaîne d'agent utilisateur, définissez la propriété userAgent de l'objet HTMLLoader avant d'appeler la méthode load(). La propriété userAgent de l'objet URLRequest transmis à la méthode load()n'est pas utilisée.

En définissant la propriété URLRequestDefaults.userAgent, vous pouvez définir la chaîne d'agent utilisateur par défaut employée par tous les objets HTMLLoader dans un domaine d'application. Lorsque aucune valeur n'est définie pour la propriété userAgent de l'objet HTMLLoader (ou si la valeur est définie sur null), la chaîne d'agent utilisateur est définie sur la valeur de la propriété statique URLRequestDefaults.userAgent.

Lorsque aucune valeur n'est définie pour la propriété userAgent de l'objet HTMLLoader et pour URLRequestDefaults.userAgent, une valeur par défaut est employée comme chaîne d'agent utilisateur. Cette valeur par défaut varie selon le système d'exploitation du moteur d'exécution (par exemple, Mac OS, Linux ou Windows), ainsi que du langage et de la version du moteur d'exécution, comme le montrent les exemples suivants :



Implémentation
    public function get userAgent():String
    public function set userAgent(value:String):void

Voir aussi

AIR-only widthpropriété 
width:Number  [lecture-écriture] [override]

Versions du moteur d'exécution: AIR 1.0

Spécifie la largeur du rectangle des canevas HTML restitués. Il s'agit de la largeur de l'objet d'affichage HTMLLoader, en pixels. Si cette propriété est modifiée, l'objet HTMLLoader restitue à nouveau le document HTML. La modification de cette propriété peut entraîner le déclenchement d'événements htmlBoundsChange. Lorsque vous définissez les propriétés width et height d'un objet HTMLLoader, les limites de l'objet changent, mais son contenu n'est pas mis à l'échelle (comme dans le cas des autres types d'objets d'affichage).



Implémentation
    public function get width():Number
    public function set width(value:Number):void
AIR-only windowpropriété 
window:Object  [lecture seule]

Versions du moteur d'exécution: AIR 1.0

Objet JavaScript global du contenu chargé dans le contrôle HTML.



Implémentation
    public function get window():Object
Détails du constructeur
AIR-only HTMLLoader()Constructeur
public function HTMLLoader()

Versions du moteur d'exécution: AIR 1.0

Crée un objet HTMLLoader.

Détails de la méthode
AIR-only cancelLoad()méthode
public function cancelLoad():void

Versions du moteur d'exécution: AIR 1.0

Annule les opérations de chargement en cours.

AIR-only createRootWindow()méthode 
public static function createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):HTMLLoader

Versions du moteur d'exécution: AIR 1.0

Crée un nouvel objet NativeWindow contenant un objet HTMLLoader. Utilisez l'objet HTMLLoader renvoyé par cette méthode pour charger du contenu HTML.

Par défaut, (lorsque vous ne définissez pas de paramètres lors de l'appel à cette méthode), la nouvelle fenêtre utilise le chrome système standard et comprend des contrôles de barres de défilement pour le contenu. Vous pouvez définir les paramètres pour modifier les propriétés de la nouvelle fenêtre.

Paramètres

visible:Boolean (default = true) — Spécifie si la fenêtre est visible.
 
windowInitOptions:NativeWindowInitOptions (default = null) — Spécifie les options d'initialisation de la fenêtre ; si null utilise les valeurs NativeWindowInitOptions par défaut.
 
scrollBarsVisible:Boolean (default = true) — Indique si la fenêtre fournit des barres de défilement.
 
bounds:Rectangle (default = null) — Si non null, spécifie les limites de la fenêtre. Si l'un des paramètres x, y, width ou height est NaN, la dimension correspondante de la fenêtre conserve sa valeur par défaut.

Valeur renvoyée
HTMLLoader — Nouvel objet HTMLLoader situé sur la scène du nouvel objet NativeWindow.
AIR-only getHistoryAt()méthode 
public function getHistoryAt(position:uint):HTMLHistoryItem

Versions du moteur d'exécution: AIR 1.0

Renvoie l'entrée de l'historique à la position spécifiée.

Paramètres

position:uint — Position dans la liste de l'historique.

Valeur renvoyée
HTMLHistoryItem — Objet URLRequest pour l'entrée de l'historique à la position spécifiée.

Voir aussi

AIR-only historyBack()méthode 
public function historyBack():void

Versions du moteur d'exécution: AIR 1.0

Revient en arrière dans l'historique du navigateur, si possible.

Un appel à cette méthode de l'objet HTMLLoader revient à appeler la méthode back() de la propriété window.history dans le code JavaScript de la page HTML.

Cette fonction ne renvoie pas d'erreur.

Voir aussi

AIR-only historyForward()méthode 
public function historyForward():void

Versions du moteur d'exécution: AIR 1.0

Avance dans l'historique du navigateur, si possible.

Un appel à cette méthode de l'objet HTMLLoader revient à appeler la méthode forward() de la propriété window.history dans le code JavaScript de la page HTML.

Cette fonction ne renvoie pas d'erreur.

Voir aussi

AIR-only historyGo()méthode 
public function historyGo(steps:int):void

Versions du moteur d'exécution: AIR 1.0

Navigue parmi le nombre d'étapes spécifiées dans l'historique du navigateur. Navigue vers l'avant si positif, vers l'arrière si négatif. Une navigation par zéro impose un nouveau chargement.

Cette méthode équivaut à appeler la méthode go() de la propriété window.history dans le code JavaScript de la page HTML.

Cette fonction ne renvoie pas d'erreur.

Paramètres

steps:int — Nombre d'étapes dans la liste de l'historique à parcourir vers l'avant (positif) ou vers l'arrière (négatif).

Voir aussi

AIR-only load()méthode 
public function load(urlRequestToLoad:URLRequest):void

Versions du moteur d'exécution: AIR 1.0

Charge l'objet HTMLLoader avec les données provenant du site spécifié par le paramètre urlRequestToLoad. Un appel à cette méthode définit initialement la propriété loaded sur false. Cette méthode déclenche une opération qui se termine toujours de façon asynchrone.

Un appel à cette méthode annule implicitement toute opération de chargement en attente et initiée précédemment avec cette méthode ou avec la méthode loadString(). L'événement complete de l'opération de chargement précédente ne sera jamais distribué.

Il est possible que l'événement complete ne soit jamais distribué. Cela arrive lorsque le contenu HTML chargé dans l'objet HTMLLoader n'est jamais entièrement téléchargé. Ceci peut se produire si le contenu HTML fait référence à une URL qui dirige vers un script CGI générant du contenu indéfiniment et répétitivement.

Paramètres

urlRequestToLoad:URLRequest — Objet URLRequest contenant des informations sur l'URL à charger. En plus de l'URL à charger, un objet URLRequest contient les propriétés qui définissent la méthode de soumission du formulaire HTTP (GET ou POST), toutes les données à transmettre avec la requête et les en-têtes de la requête.

Voir aussi

AIR-only loadString()méthode 
public function loadString(htmlContent:String):void

Versions du moteur d'exécution: AIR 1.0

Charge l'objet HTMLLoader avec le contenu HTML renfermé dans la chaîne HTML. Lorsque la restitution du code HTML de la chaîne est terminé, l'événement complete est déclenché. L'événement complete est toujours distribué de façon asynchrone.

Un appel à cette méthode annule implicitement toute opération de chargement en attente et initiée précédemment avec cette méthode ou avec la méthode load. L'événement complete de l'opération de chargement précédente ne sera jamais distribué.

Si le code HTML spécifié dans la chaîne ne fait pas référence à des ressources externes, cette méthode restitue le code HTML de façon synchrone. Toutefois, l'événement complete est toujours distribué de façon asynchrone. Si la propriété loaded de cette classe est true immédiatement après un appel à cette fonction, le contenu HTML spécifié dans l'argument htmlContent a été restitué de façon synchrone.

Il est possible que l'événement complete ne soit jamais distribué. Cela arrive lorsque le contenu HTML chargé dans l'objet HTMLLoader n'est jamais entièrement téléchargé. Ceci peut se produire si le contenu HTML fait référence à une URL qui dirige vers un script CGI générant du contenu indéfiniment et répétitivement.

Le contenu chargé à l'aide de la méthode loadString() est placé dans le sandbox de sécurité de l'application uniquement si la propriété placeLoadStringContentInApplicationSandbox est définie sur true.

Paramètres

htmlContent:String — Chaîne contenant le contenu HTML à charger dans l'objet HTMLLoader.

Voir aussi

AIR-only reload()méthode 
public function reload():void

Versions du moteur d'exécution: AIR 1.0

Recharge la page à partir de l'emplacement en cours.

Détails de l'événement
AIR-only complete Evénement
Type d'objet événement: flash.events.Event
propriété Event.type = flash.events.Event.COMPLETE

Versions du moteur d'exécution: AIR 1.0

Signale que la dernière opération de chargement demandée par la méthode loadString ou load est terminée. L'événement est déclenché après que l'événement load JavaScript ait été déclenché sur le DOM HTML dans l'objet HTMLLoader. Cet événement est toujours distribué de façon asynchrone. Le gestionnaire de cet événement peut appeler toute méthode ou accéder à toute propriété de l'objet HTMLLoader.

La constante Event.COMPLETE définit la valeur de la propriété type d'un objet événement complete.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubbles false
cancelable false ; il n'existe aucun comportement par défaut à annuler.
currentTarget L'objet qui traite activement l'objet Event avec un écouteur d'événements.
target Objet réseau dont le chargement est terminé.

Voir aussi

AIR-only htmlBoundsChange Evénement  
Type d'objet événement: flash.events.Event
propriété Event.type = flash.events.Event.HTML_BOUNDS_CHANGE

Versions du moteur d'exécution: AIR 1.0

Signale que l'une des propriétés contentWidth et contentHeight, ou les deux, ont été modifiées. Cela peut être le résultat du chargement d'une nouvelle image ou d'un autre contenu, par exemple. Les gestionnaires d'événement peuvent appeler n'importe quelle méthode ou accéder à n'importe quelle propriété de l'objet HTMLLoader.

L'objet HTMLLoader peut déclencher cet événement à tout moment après l'initiation d'une opération de chargement, même après que l'objet ait déclenché l'événement complete.

La constante Event.HTML_BOUNDS_CHANGE définit la valeur de la propriété type d'un objet événement htmlBoundsChange.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubbles false
cancelable false ; il n'existe aucun comportement par défaut à annuler.
currentTarget L'objet HTMLLoader.
target L'objet HTMLLoader.

Voir aussi

AIR-only htmlDOMInitialize Evénement  
Type d'objet événement: flash.events.Event
propriété Event.type = flash.events.Event.HTML_DOM_INITIALIZE

Versions du moteur d'exécution: AIR 1.0

Signale que le DOM HTML a été créé en réponse à une opération de chargement. Les méthodes load() et loadString() de l'objet HTMLLoader renvoient une exception lorsque cet événement est distribué. Toute propriété ou méthode d'un objet JavaScript accessible depuis la propriété window de l'objet HTMLLoader qui contrôle l'URL chargée dans cet objet HTMLLoader renvoie une exception lorsqu'elle est définie ou appelée pendant le déclenchement de cet événement. Par exemple la définition de window.location via la propriété window de l'objet HTMLLoader résulte en une exception JavaScript.

La constante Event.HTML_DOM_INITIALIZE définit la valeur de la propriété type d'un objet événement htmlDOMInitialize.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubbles false
cancelable false ; il n'existe aucun comportement par défaut à annuler.
currentTarget L'objet HTMLLoader.
target L'objet HTMLLoader.

Voir aussi

AIR-only htmlRender Evénement  
Type d'objet événement: flash.events.Event
propriété Event.type = flash.events.Event.HTML_RENDER

Versions du moteur d'exécution: AIR 1.0

Signale que le rendu du contenu de l'objet HTMLLoader est entièrement à jour. Cet événement peut être déclenché assez fréquemment, à chaque modification du rendu du contenu HTML. Par exemple, cet événement est déclenché lorsqu'un nouveau contenu apparaît car l'utilisateur a cliqué sur un lien ou lorsque le code JavaScript de la page est restitué sous forme HTML. Les écouteurs d'événement peuvent appeler toute méthode ou accéder à toute propriété de l'objet HTMLLoader.

Les gestionnaires de cet événement peuvent vérifier les propriétés contentWidth et contentHeight de l'objet HTMLLoader pour mettre à jour ses barres de défilement.

L'objet HTMLLoader peut déclencher cet événement à tout moment après l'initiation d'une opération de chargement, même après que l'objet ait déclenché l'événement complete.

La constante Event.HTML_RENDER définit la valeur de la propriété type d'un objet événement htmlRender.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubbles false
cancelable false ; il n'existe aucun comportement par défaut à annuler.
currentTarget L'objet HTMLLoader.
target L'objet HTMLLoader.
AIR-only locationChange Evénement  
Type d'objet événement: flash.events.Event
propriété Event.type = flash.events.Event.LOCATION_CHANGE

Versions du moteur d'exécution: AIR 1.0

Signale que la propriété location de l'objet HTMLLoader a été modifiée. Le gestionnaire de cet événement peut appeler toute méthode ou accéder à toute propriété de l'objet HTMLLoader.

La constante Event.LOCATION_CHANGE définit la valeur de la propriété type d'un objet événement locationChange.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubbles false
cancelable false ; il n'existe aucun comportement par défaut à annuler.
currentTarget L'objet HTMLLoader.
target L'objet HTMLLoader.

Voir aussi

AIR-only scroll Evénement  
Type d'objet événement: flash.events.Event
propriété Event.type = flash.events.Event.SCROLL

Versions du moteur d'exécution: AIR 1.0

Signale que la propriété scrollH ou scrollV a été modifiée par l'objet HTMLLoader. L'objet HTMLLoader distribue cet événement lorsque le code JavaScript s'exécutant dans l'objet HTMLLoader invoque la méthode scrollTo() de l'objet window et que l'emplacement désiré n'est pas encore visible. L'événement n'est pas déclenché lorsque le code ActionScript modifie la propriété scrollH ou scrollV. Les gestionnaires d'événement peuvent appeler n'importe quelle méthode ou accéder à n'importe quelle propriété de l'objet HTMLLoader.

Les gestionnaires de cet événement peuvent vérifier les propriétés scrollH et scrollV pour mettre à jour les barres de défilement associées à l'objet HTMLLoader.

L'objet HTMLLoader peut déclencher cet événement à tout moment après l'initiation d'une opération de chargement, même après que l'objet ait déclenché l'événement complete.

La constante Event.SCROLL définit la valeur de la propriété type d'un objet événement scroll.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubbles false
cancelable false ; il n'existe aucun comportement par défaut à annuler.
currentTarget L'objet qui traite activement l'objet Event avec un écouteur d'événements.
target Objet Textfield que l'utilisateur a fait défiler. La propriété target ne correspond pas toujours à l'objet de la liste d'affichage qui est associé à l'écouteur d'événement. Utilisez la propriété currentTarget pour accéder à l'objet de la liste d'affichage qui traite actuellement l'événement.
AIR-only uncaughtScriptException Evénement  
Type d'objet événement: flash.events.HTMLUncaughtScriptExceptionEvent
propriété HTMLUncaughtScriptExceptionEvent.type = flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION

Versions du moteur d'exécution: AIR 1.0

Signale qu'une exception JavaScript non interceptée s'est produite dans l'objet HTMLLoader. Les gestionnaires d'événement peuvent appeler toute méthode ou accéder à toute propriété de l'objet HTMLLoader. L'événement peut être annulé et le comportement par défaut lors d'une exécution dans l'application de débogage du lanceur AIR consiste à envoyer la pile JavaScript pour effectuer le suivi du résultat.

La constante HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION définit la valeur de la propriété type d'un objet événement uncaughtScriptException.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubbles false
cancelable false ; il n'existe aucun comportement par défaut à annuler.
exceptionValue Le résultat de l'évaluation de l'expression dans l'instruction throw ayant résulté dans l'exception uncaught.
stackTrace Un tableau d'objets qui représentent la trace de pile au moment de l'exécution de l'instruction throw ayant résulté dans l'exception uncaught.
target L'objet HTMLLoader.

Voir aussi

Exemples Utilisation des exemples
HTMLLoader.1.as

Le code suivant initialise un objet HTMLLoader, configure ses propriétés width et height, charge l'URL http://www.adobe.com et ajoute l'objet dans la liste d'affichage :
package {
    import flash.display.Sprite;
    import flash.html.HTMLLoader;
    import flash.net.URLRequest;

    public class HTMLLoaderExample extends Sprite
    {
        public function HTMLLoaderExample()
        {
            var html:HTMLLoader = new HTMLLoader();
            var urlReq:URLRequest = new URLRequest("http://www.adobe.com/");
            html.width = stage.stageWidth;
            html.height = stage.stageHeight;
            html.load(urlReq); 
            addChild(html);
        }
    }
}