flash.htmlHTMLSWFCapability La classe HTMLSWFCapability contient les valeurs possibles de la propriété swfCapability d’un objet HTMLLoader.Object La classe HTMLSWFCapability contient les valeurs possibles de la propriété swfCapability d’un objet HTMLLoader. Elle définit également les valeurs de la propriété errorID d’un objet ErrorEvent distribué lors d’un échec de tentative de chargement du contenu SWF. HTMLLoader.swfCapabilityERROR_INSTALLED_PLAYER_NOT_FOUND Aucune version d’Adobe Flash Player n’est détectée.3221int Aucune version d’Adobe Flash Player n’est détectée. Un objet HTMLLoader ne peut pas afficher de contenu PDF. ERROR_INSTALLED_PLAYER_TOO_OLD Adobe Flash Player a bien été détecté, mais sa version est trop ancienne.3222int Adobe Flash Player a bien été détecté, mais sa version est trop ancienne. Un objet HTMLLoader n’est pas en mesure d’afficher le contenu SWF. STATUS_OK Une version suffisamment récente d’Adobe Flash Player est détectée et le contenu SWF peut être chargé dans un objet HTMLLoader.0int Une version suffisamment récente d’Adobe Flash Player est détectée et le contenu SWF peut être chargé dans un objet HTMLLoader. HTMLHistoryItem Un objet HTMLHistoryItem décrit un emplacement dans l’historique de navigation d’un objet HTMLLoader.Object Un objet HTMLHistoryItem décrit un emplacement dans l’historique de navigation d’un objet HTMLLoader. HTMLLoaderHTMLWindowCreateOptionsisPost Indique si la page HTML comprend des données POST.Boolean Indique si la page HTML comprend des données POST. originalUrl URL originale de la page HTML, avant toute redirection.String URL originale de la page HTML, avant toute redirection. title Titre de la page HTML.String Titre de la page HTML. url URL de la page HTML.String URL de la page HTML. HTMLHost Un objet HTMLHost définit le comportement d’un objet HTMLLoader pour les éléments de l’interface utilisateur pouvant être contrôlés en définissant divers paramètres ou en appelant diverses méthodes de l’objet window de la page HTML.Object Un objet HTMLHost définit le comportement d’un objet HTMLLoader pour les éléments de l’interface utilisateur pouvant être contrôlés en définissant divers paramètres ou en appelant diverses méthodes de l’objet window de la page HTML. Ces méthodes et propriétés sont :
  • window.blur()
  • window.focus()
  • window.moveBy()
  • window.moveTo()
  • window.location
  • window.close()
  • window.open()
  • window.resizeBy()
  • window.resizeTo()
  • window.status
  • window.document.title

Les méthodes de la classe HTMLHost permettent de gérer les modifications apportées à chacun de ces paramètres window. Pour utiliser cette classe, créez une nouvelle classe (une sous-classe) qui étende la classe HTMLHost et qui remplace les méthodes pour lesquelles vous souhaitez définir des comportements. Les méthodes de la classe HTMLHost gèrent les propriétés et les méthodes JavaScript comme suit :

Propriété ou méthode JavaScriptMéthode HTMLHostwindow.blur()windowBlur()window.focus()windowFocuswindow.locationupdateLocationwindow.close()windowClosewindow.open()createWindowwindow.statusupdateStatuswindow.document.titleupdateTitle

Pour répondre aux modifications des méthodes window.moveBy(), window.moveTo(), window.resizeBy() et window.resizeTo(), remplacez la méthode set windowRect() dans la sous-classe de HTMLHost.

Chaque objet HTMLHost peut être associé à au moins un objet HTMLLoader. L’affectation d’une occurrence HTMLHost à la propriété htmlHost de l’objet HTMLLoader établit cette relation. Affecter null à la propriété htmlHost de l’objet HTMLLoader ou définir l’objet HTMLHost comme propriété htmlHost d’un autre objet HTMLLoader supprime l’occurrence HTMLHost du premier objet HTMLLoader.

Le code suivant définit CustomHost, une sous-classe de HTMLHost. Les méthodes de la classe CustomHost remplacent les méthodes héritées de la classe HTMLHost pour définir les actions prises lorsque le code JavaScript de la page HTMLLoader définit des propriétés ou appelle des méthodes de l’objet window : package { import flash.html.HTMLHost; import flash.html.HTMLLoader; import flash.display.NativeWindow; import flash.display.NativeWindowInitOptions; import flash.display.StageScaleMode; import flash.geom.Rectangle; import flash.text.TextField; public class CustomHost extends HTMLHost { import flash.html.*; public var statusField:TextField; public function CustomHost(defaultBehaviors:Boolean=true) { super(defaultBehaviors); } override public function windowClose():void { htmlLoader.stage.window.close(); } override public function createWindow(windowCreateOptions:HTMLWindowCreateOptions):HTMLLoader { var initOptions:NativeWindowInitOptions = new NativeWindowInitOptions(); var window:NativeWindow = new NativeWindow(initOptions); window.visible = true; var htmlLoader2:HTMLLoader = new HTMLLoader(); htmlLoader2.width = window.width; htmlLoader2.height = window.height; window.stage.scaleMode = StageScaleMode.NO_SCALE; window.stage.addChild(htmlLoader2); return htmlLoader2; } override public function updateLocation(locationURL:String):void { trace(locationURL); } override public function set windowRect(value:Rectangle):void { htmlLoader.stage.nativeWindow.bounds = value; } override public function updateStatus(status:String):void { statusField.text = status; } override public function updateTitle(title:String):void { htmlLoader.stage.nativeWindow.title = title + "- Example Application"; } override public function windowBlur():void { htmlLoader.alpha = 0.5; } override public function windowFocus():void { htmlLoader.alpha = 1; } } } Créez la classe suivante, qui ajoute un objet HTMLLoader sur la scène, ainsi qu’un objet TextField nommé statusBar. L’objet HTMLLoader définit un objet CustomHost pour sa propriété htmlHost : package { import flash.display.Sprite; public class SimpleHTMLBox extends Sprite { import flash.html.HTMLHost; import flash.html.HTMLLoader; import flash.text.TextField; import flash.net.URLRequest; import CustomHost; private var host:CustomHost; private var statusField:TextField; private var html:HTMLLoader; public function SimpleHTMLBox() { html = new HTMLLoader(); var url:String = "Test.html"; var urlReq:URLRequest = new URLRequest(url); html.load(urlReq); host = new CustomHost(); html.htmlHost = host; statusField = new TextField(); host.statusField = statusField; configureUI(); } private function configureUI():void { html.width = 400; html.height = 200; statusField.width = 400; statusField.height = 24; statusField.border = true; statusField.y = 200; addChild(html); addChild(statusField); } } }

Développez une application AIR qui ajoute un objet défini par cette classe sur la scène de la fenêtre principale.

Créez une page HTML nommée Test.html dans le répertoire des ressources de l’application (le répertoire contenant le fichier descripteur d’application), puis ajoutez-y le contenu suivant :

<html> <head> <title>Test</title> </head> <body> <a href="#" onclick="window.open('Test.html')">window.open('Test.html')</a> <br/><a href="#" onclick="window.document.location = 'www.adobe.com'">window.document.location = 'www.adobe.com'</a> <br/><a href="#" onclick="window.moveBy(6, 12)">moveBy(6, 12)</a> <br/><a href="#" onclick="window.close()">window.close()</a> <br/><a href="#" onclick="window.blur()">window.blur()</a> <br/><a href="#" onclick="window.focus()">window.focus()</a> <br/><a href="#" onclick="window.status = new Date().toString()">window.status = new Date().toString()</a> </body> </html>

Lorsque vous testez l’application, la classe CustomHost gère l’interface utilisateur liée aux paramètres JavaScript de la page HTML.

HTMLLoaderHTMLWindowCreateOptionsHTMLHost Crée un objet HTMLHost.defaultBehaviorsBooleantrueIndique si les comportements du contenu racine doivent être fournis par défaut. Crée un objet HTMLHost. createWindow Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader appelle la méthode window.open().Objet HTMLLoader contenant la nouvelle page HTML. En général, vous créez un nouvel objet HTMLLoader dans cette méthode, vous l’ajoutez sur la scène d’un nouvel objet NativeWindow, puis vous le renvoyez. flash.html:HTMLLoaderwindowCreateOptionsflash.html:HTMLWindowCreateOptionsObjet contenant les propriétés de la chaîne transmise en tant que paramètre features de l’appel à la méthode window.open(). Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader appelle la méthode window.open().

Par défaut, un appel JavaScript à la méthode window.open() dans la page HTML d’un objet HTMLLoader n’ouvre pas de nouvel objet NativeWindow dans le moteur d’exécution. Vous pouvez ouvrir un nouvel objet NativeWindow dans le moteur d’exécution en créant un nouvel objet NativeWindow dans la méthode createWindow remplacée dans la sous-classe de la classe HTMLHost.

updateLocation Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader définit la propriété window.location.locationURLStringValeur sur laquelle est définie la propriété location de la propriété window de l’objet HTMLLoader. Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader définit la propriété window.location. updateStatus Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader définit la propriété window.status.statusStringValeur sur laquelle est définie la propriété status de la propriété window de l’objet HTMLLoader. Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader définit la propriété window.status. updateTitle Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader définit la propriété window.document.title, ou lorsque l’élément title change, via le DOM ou du fait du chargement d’une nouvelle page.titleStringValeur sur laquelle est définie la propriété window.document.title de l’objet HTMLLoader. Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader définit la propriété window.document.title, ou lorsque l’élément title change, via le DOM ou du fait du chargement d’une nouvelle page. windowBlur Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader appelle la méthode window.blur(). Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader appelle la méthode window.blur(). windowClose Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader appelle la méthode window.close(). Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader appelle la méthode window.close().

Par défaut, un appel JavaScript à la méthode window.close() dans la page HTML d’un objet HTMLLoader ferme les fenêtres contenant l’objet HTMLLoader.

windowFocus Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader appelle la méthode window.focus(). Fonction appelée lorsque le code JavaScript de l’objet HTMLLoader appelle la méthode window.focus(). htmlLoader Objet HTMLLoader auquel s’applique cet objet HostControl.flash.html:HTMLLoader Objet HTMLLoader auquel s’applique cet objet HostControl. La propriété htmlHost de cet objet HTMLLoader est définie sur cet objet HostControl. HTMLLoader.htmlHostwindowRect Propriété modifiée lorsque le code JavaScript de l’objet HTMLLoader appelle la méthode window.moveBy(), window.moveTo(), window.resizeBy() ou window.resizeTo().flash.geom:Rectangle Propriété modifiée lorsque le code JavaScript de l’objet HTMLLoader appelle la méthode window.moveBy(), window.moveTo(), window.resizeBy() ou window.resizeTo().

Dans la sous-classe de HTMLHost, remplacez la méthode set windowRect() pour gérer les nouvelles limites de la fenêtre, selon les besoins.

HTMLPDFCapability La classe HTMLPDFCapability contient les valeurs possibles de la propriété pdfCapability d’un objet HTMLLoader.Object La classe HTMLPDFCapability contient les valeurs possibles de la propriété pdfCapability d’un objet HTMLLoader. Elle définit également les valeurs de la propriété errorID d’un objet ErrorEvent distribué lors d’un échec de tentative de chargement du contenu PDF. HTMLLoader.pdfCapabilityERROR_CANNOT_LOAD_READER Le système d’exploitation a renvoyé une erreur lors de la tentative de chargement de l’application Reader ou Adobe Acrobat ou de l’une de leurs bibliothèques nécessaires.3204int Le système d’exploitation a renvoyé une erreur lors de la tentative de chargement de l’application Reader ou Adobe Acrobat ou de l’une de leurs bibliothèques nécessaires.

Remarque : cette erreur n’est pas renvoyée par HTMLLoader.pdfCapability, mais en tant que propriété errorID d’un objet ErrorEvent distribué lorsqu’un objet HTMLLoader tente de charger le contenu PDF et que le système d’exploitation renvoie une erreur. HTMLLoader.pdfCapability peut renvoyer PDFCapability.STATUS_OK puisqu’il examine uniquement la configuration et ne tente pas de charger des bibliothèques.

ERROR_INSTALLED_READER_NOT_FOUND Aucune version d’Adobe Reader n’est détectée.3201int Aucune version d’Adobe Reader n’est détectée. Un objet HTMLLoader ne peut pas afficher de contenu PDF. ERROR_INSTALLED_READER_TOO_OLD Adobe Reader a bien été détecté, mais la version est trop ancienne.3202int Adobe Reader a bien été détecté, mais la version est trop ancienne. Un objet HTMLLoader ne peut pas afficher de contenu PDF. ERROR_PREFERRED_READER_TOO_OLD Une version appropriée d’Adobe Reader ou Acrobat (8.1 ou ultérieure) a bien été détectée, mais la version d’Adobe Reader configurée pour gérer le contenu PDF est antérieure à Adobe Reader ou Acrobat 8.1.3203int Une version appropriée d’Adobe Reader (8.1 ou ultérieure) ou Acrobat a bien été détectée, mais la version d’Adobe Reader configurée pour gérer le contenu PDF est antérieure à Adobe Reader ou Acrobat 8.1. Un objet HTMLLoader ne peut pas afficher du contenu PDF.
HTMLLoader La classe HTMLLoader définit un type d’objet d’affichage correspondant à un conteneur du contenu HTML.flash.display:Sprite La classe HTMLLoader définit un type d’objet d’affichage correspondant à un conteneur du contenu HTML.

Prise en charge du profil AIR : cette fonctionnalité est prise en charge sur tous les systèmes d’exploitation de bureau, mais ne l’est pas sur les périphériques mobiles ou sur les périphériques AIR pour TV. Vous pouvez tester la prise en charge lors de l’exécution à l’aide de la propriété HTMLLoader.isSupported. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.

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 4 096 pixels de haut sur 4 096 pixels de large. Si vous définissez la propriété width ou height d’un objet HTMLLoader sur une valeur supérieure à 4 095, l’objet HTMLLoader renvoie une exception ArgumentError. (Remarque : avant AIR 2, la taille maximale de l’objet HTMLLoader était de 2 880 pixels.)

Remarque : lorsqu’il est affiché dans une fenêtre transparente, le contenu SWF incorporé dans une page HTML doit être incorporé à l’aide du paramètre wmode transparent ou opaque. La valeur par défaut du paramètre wmode est window ; par conséquent, si vous ne spécifiez aucune valeur, il est possible que le contenu SWF ne s’affiche pas. Sous Windows et Linux, le contenu SWF s’affiche toujours au-dessus d’un autre contenu lorsque wmode est défini sur window ou sur opaque. Il est impossible d’afficher le contenu PDF dans une fenêtre transparente, quel que soit le paramètre wmode utilisé.

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); } } }
htmlDOMInitialize Signale que le DOM HTML a été créé en réponse à une opération de chargement.flash.events.Event.HTML_DOM_INITIALIZEflash.events.Event 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. loadString()load()uncaughtScriptException Signale qu’une exception JavaScript non interceptée s’est produite dans l’objet HTMLLoader.flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTIONflash.events.HTMLUncaughtScriptExceptionEvent 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. loadString()load()scroll Signale que la propriété scrollH ou scrollV a été modifiée par l’objet HTMLLoader.flash.events.Event.SCROLLflash.events.Event 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.

htmlBoundsChange Signale que l’une des propriétés contentWidth et contentHeight, ou les deux, ont été modifiées.flash.events.Event.HTML_BOUNDS_CHANGEflash.events.Event 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.

contentWidthcontentHeight
locationChange Signale que la propriété location de l’objet HTMLLoader a été modifiée.flash.events.LocationChangeEvent.LOCATION_CHANGEflash.events.LocationChangeEventSignale que la propriété location de l’objet HTMLLoader a été modifiée. 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.

Un événement locationChange de type LocationChangeEvent est distribué par l’objet HTMLLoader dans les applications qui utilisent l’espace de noms d’AIR 2.7 et versions ultérieures. Dans les versions antérieures d’AIR, l’objet d’événement distribué est une occurrence de la classe Event.

loadString()load()
locationChange Signale que la propriété location de l’objet HTMLLoader a été modifiée.flash.events.Event.LOCATION_CHANGEflash.events.EventSignale que la propriété location de l’objet HTMLLoader a été modifiée. 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.

Un événement locationChange de type Event est distribué par l’objet HTMLLoader dans les applications qui utilisent l’espace de noms de versions AIR antérieures à 2.7. Dans AIR 2.7 et les versions ultérieures, l’objet d’événement est une occurrence de la classe LocationChangeEvent, qui fournit une autre propriété location définie sur l’URL de la nouvelle page.

loadString()load()
locationChanging Indique que la propriété location de l’objet HTMLLoader est sur le point de changer.flash.events.LocationChangeEvent.LOCATION_CHANGINGflash.events.LocationChangeEventIndique que la propriété location de l’objet HTMLLoader est sur le point de changer. Indique que la propriété location de l’objet HTMLLoader est sur le point de changer.

Un événement locationChanging est distribué uniquement lorsque le changement d’emplacement est initié par le biais d’une interaction de l’utilisateur (notamment lorsqu’un utilisateur clique sur un lien) ou lorsque le code s’exécute à l’intérieur de l’objet HTMLLoader (notamment dans le cas d’une redirection côté client). Par défaut, le nouvel emplacement est affiché dans cet objet HTMLLoader. Vous pouvez appeler la méthode preventDefault() de l’objet d’événement pour annuler le comportement par défaut. Par exemple, vous pouvez utiliser la fonction flash.net.navigateToURL() pour ouvrir la page dans le navigateur système en fonction de la propriété location de l’objet d’événement..

L’événement locationChanging() n’est pas distribué lorsque vous appelez les méthodes suivantes :

  • load()
  • loadString()
  • reload()
  • historyBack()
  • historyForward()
  • historyGo()

En outre, cet événement n’est pas distribué lorsque la propriété navigateInSystemBrowser est définie sur true et lorsque la page de destination est ouverte dans le navigateur système, car l’emplacement de l’objet HTMLLoader ne change pas.

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 : Si l’utilisateur (ou JavaScript sur la page) tente d’atteindre une URL qui ne démarre pas avec l’URL de base, la navigation est impossible : package{ import flash.display.Sprite; import flash.html.HTMLLoader; import flash.net.URLRequest; public class LocationChanging extends Sprite { var htmlLoader:HTMLLoader = new HTMLLoader(); public function LocationChanging() { htmlLoader.width = stage.stageWidth; htmlLoader.height = stage.stageHeight; htmlLoader.addEventListener( LocationChangeEvent.LOCATION_CHANGING, onLocationChanging ); htmlLoader.load( new URLRequest( "http://www.adobe.com" ) ); this.addChild( htmlLoader ); } private function onLocationChanging( event:LocationChangeEvent ):void { trace( "Location changing: " + event.location ); if ( event.location.indexOf( "http://www.adobe.com" ) < 0 ) { event.preventDefault(); } } } }
htmlRender Signale que le rendu du contenu de l’objet HTMLLoader est entièrement à jour.flash.events.Event.HTML_RENDERflash.events.Event 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.

complete Signale que la dernière opération de chargement demandée par la méthode loadString ou load est terminée.flash.events.Event.COMPLETEflash.events.Event 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. loadString()load()HTMLLoader Crée un objet HTMLLoader. Crée un objet HTMLLoader. cancelLoad Annule les opérations de chargement en cours. Annule les opérations de chargement en cours. createRootWindow Crée un nouvel objet NativeWindow contenant un objet HTMLLoader.Nouvel objet HTMLLoader situé sur la scène du nouvel objet NativeWindow. flash.html:HTMLLoadervisibleBooleantrueSpécifie si la fenêtre est visible. windowInitOptionsflash.display:NativeWindowInitOptionsnullSpécifie les options d’initialisation de la fenêtre ; si null utilise les valeurs NativeWindowInitOptions par défaut. scrollBarsVisibleBooleantrueIndique si la fenêtre fournit des barres de défilement. boundsflash.geom:RectanglenullSi 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. 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.

Lorsque la fenêtre charge du contenu et applique des feuilles de style, il est possible que des problèmes graphiques surviennent. Pour éviter que ce type de discontinuités soit visible, définissez le paramètre visible sur false. Lorsque la fenêtre a chargé et préparé son contenu, affichez-le en définissant la propriété window.nativeWindow.visible sur true ou appelez la méthode window.nativeWindow.activate().

getHistoryAt Renvoie l’entrée de l’historique à la position spécifiée.Objet URLRequest pour l’entrée de l’historique à la position spécifiée. flash.html:HTMLHistoryItempositionuintPosition dans la liste de l’historique. Renvoie l’entrée de l’historique à la position spécifiée. historyPositionhistoryBack Revient en arrière dans l’historique du navigateur, si possible. 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.

historyPosition
historyForward Avance dans l’historique du navigateur, si possible. 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.

historyPosition
historyGo Navigue parmi le nombre d’étapes spécifiées dans l’historique du navigateur.stepsintNombre d’étapes dans la liste de l’historique à parcourir vers l’avant (positif) ou vers l’arrière (négatif). 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.

historyPosition
loadString Charge l’objet HTMLLoader avec le contenu HTML renfermé dans la chaîne HTML.htmlContentStringChaîne contenant le contenu HTML à charger dans l’objet HTMLLoader. 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.

placeLoadStringContentInApplicationSandbox
load Charge l’objet HTMLLoader avec les données provenant du site spécifié par le paramètre urlRequestToLoad.urlRequestToLoadflash.net:URLRequestObjet 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. 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.

flash.net.URLRequest
reload Recharge la page à partir de l’emplacement en cours. Recharge la page à partir de l’emplacement en cours. authenticate 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.Booleaninitialized from URLRequestDefaults.authenticate 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. flash.net.URLRequest.authenticateflash.net.URLRequestDefaults.authenticatecacheResponse Spécifie si les données de réponse doivent être mises en cache pour les requêtes HTTP publiées par cet objet.Booleaninitialized from URLRequestDefaults.cacheResponse 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. flash.net.URLRequestDefaults.cacheResponsecontentHeight Hauteur, en pixels, du contenu HTML.Number 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. contentWidth Largeur, en pixels, du contenu HTML.Number 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. hasFocusableContent Indique si tout contenu de l’objet HTMLLoader peut recevoir le focus.Boolean Indique si tout contenu de l’objet HTMLLoader peut recevoir le focus. height Spécifie la hauteur du rectangle des canevas HTML restitués.Number Spécifie la hauteur du rectangle des canevas HTML restitués. La valeur de cette propriété correspond à la hauteur de l’objet d’affichage HTMLLoader, en pixels. La valeur height maximale est de 4 095 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).

historyLength Longueur totale de la liste de l’historique, avec les entrées précédentes et suivantes.uint 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. historyPositionhistoryPosition Position actuelle dans la liste de l’historique.uint 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. getHistoryAt()historyBack()historyGo()historyForward()historyLengthhtmlHost 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.flash.html:HTMLHostObjet 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. 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. Classe HTMLHostidleTimeout Spécifie la valeur du délai d’inactivité (en millisecondes) pour les requêtes HTTP provenant de cet objet.Numberinitialized from URLRequestDefaults.idleTimeout Spécifie la valeur du délai d’inactivité (en millisecondes) pour les requêtes HTTP provenant de cet objet.

Le délai d’inactivité correspond au laps de temps que le client attend une réponse du serveur, une fois la connexion établie et avant l’abandon de la requête.

URLRequestDefaults.idleTimeout
isSupported Indique si la classe HTMLLoader est prise en charge sur le système client.Boolean Indique si la classe HTMLLoader est prise en charge sur le système client. loaded 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.Boolean 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é. location URL du contenu chargé dans l’objet HTMLLoader.String URL du contenu chargé dans l’objet HTMLLoader. manageCookies Spécifie si la pile de protocoles HTTP doit gérer les cookies pour cet objet.Booleaninitialized from URLRequestDefaults.manageCookies 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. flash.net.URLRequest.manageCookiesflash.net.URLRequestDefaults.manageCookiesnavigateInSystemBrowser 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).Booleanfalse Indique si la navigation de l’image racine du contenu HTML entraîne une navigation dans l’objet HTMLLoader (false) ou dans le navigateur Web par défaut du système (true). 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). paintsDefaultBackground Spécifie si l’arrière-plan du document HTMLLoader est blanc opaque (true) ou non (false).BooleanDétermine si l’arrière-plan du document HTMLLoader est blanc opaque (true) ou non (false). 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. pdfCapability Type de prise en charge PDF dans le système de l’utilisateur, définie sous forme de valeur de code d’entier.int 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 PDFCapabilitySignificationSTATUS_OKUne 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_FOUNDAucune 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_OLDAcrobat 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_OLDUne 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.
Classe HTMLPDFCapability
placeLoadStringContentInApplicationSandbox 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).Booleanfalse 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 :

  • Il est autorisé à charger du contenu depuis le réseau (mais pas depuis le système de fichiers).
  • Il ne peut pas charger des données à l’aide de XMLHttpRequest.
  • La propriété window.location est définie sur "about:blank".
  • Le contenu ne peut pas accéder à la propriété window.runtime (comme le contenu se trouvant dans un sandbox non-applicatif).

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.

loadString()
runtimeApplicationDomain Domaine d’application à utiliser pour l’objet window.runtime dans le code JavaScript de la page HTML.flash.system:ApplicationDomainSi l’objet ApplicationDomain ne provient pas du domaine de sécurité de l’appelant. SecurityErrorSecurityErrorDomaine d’application à utiliser pour l’objet window.runtime dans le code JavaScript de la page HTML. 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.

flash.system.ApplicationDomainflash.system.SecurityDomain
scrollH Position de défilement horizontal du contenu HTML dans l'objet HTMLLoader.Number Position de défilement horizontal du contenu HTML dans l'objet HTMLLoader. scrollV Position de défilement vertical du contenu HTML dans l’objet HTMLLoader.Number Position de défilement vertical du contenu HTML dans l’objet HTMLLoader. swfCapability Type de prise en charge SWF dans le système de l’utilisateur, défini sous forme de valeur de code d’entier.int Type de prise en charge SWF dans le système de l’utilisateur, défini sous forme de valeur de code d’entier. Un objet HTMLLoader ne peut afficher du contenu SWF que si la valeur de cette propriété est HTMLSWFCapability.STATUS_OK. La classe HTMLSWFCapability définit des constantes pour les valeurs possibles de la propriété swfCapability, comme suit : Constante HTMLSWFCapabilitySignificationSTATUS_OKUne version suffisamment récente d’Adobe Flash Player est détectée et le contenu SWF peut être chargé dans un objet HTMLLoader.ERROR_INSTALLED_PLAYER_NOT_FOUNDAucune version d’Adobe Flash Player n’est détectée. Un objet HTMLLoader n’est pas en mesure d’afficher le contenu SWF.ERROR_INSTALLED_PLAYER_TOO_OLDAdobe Flash Player a bien été détecté, mais la version est trop ancienne. Un objet HTMLLoader n’est pas en mesure d’afficher le contenu SWF. Classe HTMLSWFCapabilitytextEncodingFallback Codage de caractères utilisé par le contenu HTMLLoader lorsque la page HTML ne spécifie aucun codage de caractères.String 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 textEncodingOverride, le contenu HTML utilise l’encodage ISO-8859-1.

textEncodingOverride
textEncodingOverride Codage de caractères utilisé par le contenu HTMLLoader, remplaçant tous les paramètres de la page HTML.String 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.

textEncodingFallback
useCache 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.Booleaninitialized from URLRequestDefaults.useCache 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. flash.net.URLRequest.useCacheflash.net.URLRequestDefaults.useCacheuserAgent Chaîne d’agent utilisateur à utiliser dans les requêtes de contenu entrantes provenant de cet objet HTMLLoader.String 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 :

  • "Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
  • "Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
  • "Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
flash.net.URLRequest.userAgentflash.net.URLRequestDefaults.userAgent
width Spécifie la largeur du rectangle des canevas HTML restitués.Number 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. La valeur width maximale est de 4 095 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). window Objet JavaScript global du contenu chargé dans le contrôle HTML.Object Objet JavaScript global du contenu chargé dans le contrôle HTML.
HTMLWindowCreateOptions Cette classe définit les options qui peuvent être spécifiées lorsque du code JavaScript s’exécutant dans un objet HTMLLoader tente de créer une nouvelle fenêtre HTML en appelant la méthode window.open().Object Cette classe définit les options qui peuvent être spécifiées lorsque du code JavaScript s’exécutant dans un objet HTMLLoader tente de créer une nouvelle fenêtre HTML en appelant la méthode window.open().

Cette classe définit les propriétés et les méthodes qui correspondent aux options du paramètre features transmis à la méthode window.open() dans JavaScript.

Par exemple, le code JavaScript d’un document HTML (dans un objet HTMLLoader) peut inclure l’appel suivant à window.open(), dans lequel le paramètre features (le troisième) énumère certaines options :

window.open("http://www.adobe.com", "AdobeWindow", "scrollbars=1,menubar=1,location=0,status=0")

Utilisez la classe HTMLWindowCreateOptions pour remplacer la méthode createWindow() d’une sous-classe de la classe HTMLHost. L’objet HTMLLoader transmet un objet HTMLWindowCreateOptions en tant que paramètre windowCreateOptions de la méthode createWindow() de l’objet HTMLHost.

HTMLHost#createWindow()fullscreen Indique si la fenêtre doit être affichée en plein écran.falseBoolean Indique si la fenêtre doit être affichée en plein écran. Cette propriété est définie sur true si la chaîne features de l’appel JavaScript à la méthode window.open() inclut "fullscreen", "fullscreen=1" ou "fullscreen=y". height Spécifie la hauteur initiale de la nouvelle fenêtre.NaNNumber Spécifie la hauteur initiale de la nouvelle fenêtre. La hauteur est définie sur la valeur height dans la chaîne features de l’appel JavaScript à la méthode window.open(). Si la valeur est NaN, paramètre par défaut lorsque aucune valeur height n’est spécifiée dans la chaîne features, la hauteur de la fenêtre par défaut est utilisée. locationBarVisible Indique si une barre d’emplacement doit être affichée.falseBoolean Indique si une barre d’emplacement doit être affichée. Cette propriété est définie sur true si la chaîne features de l’appel JavaScript à la méthode window.open() inclut "location", "location=1" ou "location=y". menuBarVisible Indique si une barre de menus doit être affichée.falseBoolean Indique si une barre de menus doit être affichée. Cette propriété est définie sur true si la chaîne features de l’appel JavaScript à la méthode window.open() inclut "menubar", "menubar=1" ou "menubar=y". resizable Indique si la taille de la fenêtre est modifiable.falseBoolean Indique si la taille de la fenêtre est modifiable. Cette propriété est définie sur true si la chaîne features de l’appel JavaScript à la méthode window.open() inclut "resizable", "resizable=1" ou "resizable=y". scrollBarsVisible Indique si des barres de défilement doivent être affichées.trueBoolean Indique si des barres de défilement doivent être affichées. Cette propriété est définie sur true si la chaîne features de l’appel JavaScript à la méthode window.open() inclut "scrollbars", "scrollbars=1" ou "scrollbars=y". statusBarVisible Indique si une barre d’état doit être affichée.falseBoolean Indique si une barre d’état doit être affichée. Cetxte propriété est définie sur true si la chaîne features de l’appel JavaScript à la méthode window.open() inclut "status", "status=1" ou "status=y". toolBarVisible Indique si une barre d’outils doit être affichée.falseBoolean Indique si une barre d’outils doit être affichée. Cette propriété est définie sur true si la chaîne features de l’appel JavaScript à la méthode window.open() inclut "toolbar", "toolbar=1" ou "toolbar=y". width Spécifie la largeur initiale de la nouvelle fenêtre.NaNNumber Spécifie la largeur initiale de la nouvelle fenêtre. La largeur est définie sur la valeur width dans la chaîne features de l’appel JavaScript à la méthode window.open(). Si la valeur est NaN, paramètre par défaut lorsque aucune valeur width n’est spécifiée dans la chaîne features, la largeur de la fenêtre par défaut est utilisée. x Spécifie la position x initiale désirée de la nouvelle fenêtre à l’écran.NaNNumber Spécifie la position x initiale désirée de la nouvelle fenêtre à l’écran. Cette position est définie sur la valeur spécifiée pour left ou screenX dans la chaîne features de l’appel JavaScript à la méthode window.open(). Si la valeur est NaN, paramètre par défaut lorsque aucune valeur left ou screenX n’est spécifiée dans la chaîne features, la position x de la fenêtre par défaut est utilisée. y Spécifie la position y initiale désirée de la nouvelle fenêtre à l’écran.NaNNumber Spécifie la position y initiale désirée de la nouvelle fenêtre à l’écran. Cette position est définie sur la valeur spécifiée pour top ou screenY dans la chaîne features de l’appel JavaScript à la méthode window.open(). Si la valeur est NaN, paramètre par défaut lorsque aucune valeur left ou screenX n’est spécifiée dans la chaîne features, la position x de la fenêtre par défaut est utilisée.