| Paquete | flash.html |
| Clase | public class HTMLLoader |
| Herencia | HTMLLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Subclases | FlexHTMLLoader |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Compatibilidad con perfil de AIR: esta característica se admite en todos los sistemas operativos de escritorio, pero no en dispositivos móviles o en dispositivos de AIR para TV. Puede comprobar la compatibilidad en tiempo de ejecución mediante la propiedad HTMLLoader.isSupported. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.
En equipos de escritorio (en perfiles de escritorio y escritorio ampliado), la clase HTMLLoader utiliza el motor interno AIR WebKit. Las funciones disponibles y el aspecto del procesamiento son iguales que en la clase StageWebView; y además con estrecha integración y script puente entre ActionScript y JavaScript. Dado que la clase StageWebView utiliza el control web del sistema proporcionado por el plugin de Flash Player, no es aconsejable el uso simultáneo de StageWebView y HTMLLoader, ya que su comportamiento no está definido y podría provocar el cierre de la aplicación.
Las dimensiones predeterminadas de una clase HTMLLoader son 0 x 0 píxeles. Defina las propiedades de achura y altura width y height de forma que el objeto HTMLLoader resulte visible.
El tamaño máximo de un objeto HTMLLoader es 4.096 píxeles de altura y 4.096 de anchura. Al definir los parámetros width o height de un objeto HTMLLoader en un número que supere 4.095 hace que el objeto HTMLLoader emita una excepción ArgumentError. (Tenga en cuenta que en versiones anteriores a AIR 2, el tamaño máximo del objeto HTMLLoader era 2.880 píxeles.)
Nota: cuando se muestra en una ventana transparente, el contenido SWF incorporado en una página HTML debe estar incrustado mediante el wmode transparent o opaque. El valor predeterminado de wmode es window, así que si no especifica ningún valor, el contenido SWF puede que no se visualice. En Windows y Linux, el contenido SWF siempre aparece sobre el resto de contenido cuando wmode se establece en window o en opaque. El contenido PDF no se puede mostrar en una ventana transparente independientemente del ajuste de wmode utilizado.
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
La implementación actual de accesibilidad (AccessibilityImplementation) para esta instancia de InteractiveObject. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización. | DisplayObject | |
| alpha : Number
Indica el valor de transparencia alfa del objeto especificado. | DisplayObject | |
| authenticate : Boolean
Especifica si se deben controlar las peticiones de autenticación (true) o no (false) para las peticiones HTTP emitidas por este objeto. | HTMLLoader | ||
| blendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse. | DisplayObject | |
| blendShader : Shader [solo escritura]
Define un sombreado para utilizarlo en la mezcla del primer plano y del fondo. | DisplayObject | |
| buttonMode : Boolean
Especifica el modo de botón de este elemento sprite. | Sprite | |
| cacheAsBitmap : Boolean
Si se define como true, los motores de ejecución de Flash dejan en caché una representación interna de mapa de bits del objeto de visualización. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Si su valor no es null, este objeto Matrix define cómo un objeto de visualización se procesa cuando cacheAsBitmap se define como true. | DisplayObject | |
| cacheResponse : Boolean
Especifica si se deben guardar en caché los datos de respuesta correctos para las peticiones HTTP emitidas por este objeto. | HTMLLoader | ||
| constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| contentHeight : Number [solo lectura]
Altura, en píxeles, del contenido HTML. | HTMLLoader | ||
| contentWidth : Number [solo lectura]
Anchura, en píxeles, del contenido HTML. | HTMLLoader | ||
| contextMenu : NativeMenu
Especifica el menú contextual asociado a este objeto. | InteractiveObject | |
| doubleClickEnabled : Boolean
Especifica si este objeto recibe eventos doubleClick. | InteractiveObject | |
| dropTarget : DisplayObject [solo lectura]
Especifica el objeto de visualización sobre el que se está arrastrando el elemento sprite o sobre el que se ha colocado el elemento sprite. | Sprite | |
| filters : Array
Conjunto indexado que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización. | DisplayObject | |
| focusRect : Object
Especifica si este objeto muestra un rectángulo de selección. | InteractiveObject | |
| graphics : Graphics [solo lectura]
Especifica el objeto Graphics que pertenece a este elemento sprite, donde pueden ejecutarse comandos de dibujo vectorial. | Sprite | |
| hasFocusableContent : Boolean [solo lectura]
Indica si existe contenido en el objeto HTMLLoader que pueda seleccionarse. | HTMLLoader | ||
| height : Number [override]
Especifica la altura del rectángulo del lienzo HTML que se está representando. | HTMLLoader | ||
| historyLength : uint [solo lectura]
La longitud total de la lista del historial, incluidas las entradas de avance y retroceso. | HTMLLoader | ||
| historyPosition : uint
La posición actual en la lista del historial. | HTMLLoader | ||
| hitArea : Sprite
Designa otro elemento sprite para que actúe como área activa de un elemento sprite. | Sprite | |
| htmlHost : flash.html:HTMLHost
El objeto HTMLHost utilizado para controlar los cambios de ciertos elementos de la interfaz de usuario, por ejemplo la propiedad window.document.title del objeto HTMLLoader. | HTMLLoader | ||
| idleTimeout : Number
Especifica el valor espera de inactividad (en milisegundos) para las peticiones HTTP emitidas por este objeto. | HTMLLoader | ||
| isSupported : Boolean [estática] [solo lectura]
Indica si la clase HTMLLoader se admite en el sistema del cliente. | HTMLLoader | ||
| loaded : Boolean [solo lectura]
Indica si el evento load de JavaScript correspondiente a la llamada anterior al método load() o loadString() se ha entregado en el DOM HTML del objeto HTMLLoader. | HTMLLoader | ||
| loaderInfo : LoaderInfo [solo lectura]
Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización. | DisplayObject | |
| location : String [solo lectura]
URL para el contenido cargado en el objeto HTMLLoader. | HTMLLoader | ||
| manageCookies : Boolean
Especifica si la pila del protocolo HTTP debe administrar las cookies de este objeto. | HTMLLoader | ||
| mask : DisplayObject
El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado. | DisplayObject | |
| metaData : Object
Obtiene el objeto de metadatos de la instancia de DisplayObject si los metadatos se almacenaron con la instancia de este objeto DisplayObject en el archivo SWF a través de una etiqueta PlaceObject4. | DisplayObject | |
| mouseChildren : Boolean
Determina si los elementos secundarios del objeto están activados para acciones de ratón o de dispositivo de entrada de usuario. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Especifica si este objeto recibe la entrada del ratón, la entrada del usuario o mensajes. | InteractiveObject | |
| mouseX : Number [solo lectura]
Indica la coordenada x de la posición del ratón o del dispositivo de entrada del usuario, en píxeles. | DisplayObject | |
| mouseY : Number [solo lectura]
Indica la coordenada y de la posición del ratón o del dispositivo de entrada del usuario, en píxeles. | DisplayObject | |
| name : String
Indica el nombre de instancia de DisplayObject. | DisplayObject | |
| navigateInSystemBrowser : Boolean
Indica si la navegación del fotograma raíz del contenido HTML (por ejemplo, cuando el usuario hace clic en un vínculo, cuando se establece la propiedad window.location o cuando se llama al método window.open()), el resultado es la navegación en el objeto HTMLLoader (false) o en el navegador web predeterminado del sistema (true). | HTMLLoader | ||
| needsSoftKeyboard : Boolean
Especifica si un teclado virtual (teclado en pantalla) se debe mostrar cuando esta instancia de InteractiveObject recibe la selección. | InteractiveObject | |
| numChildren : int [solo lectura]
Devuelve el número de elementos secundarios de este objeto. | DisplayObjectContainer | |
| opaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo. | DisplayObject | |
| paintsDefaultBackground : Boolean
Especifica si el fondo del documento HTMLLoader es blanco opaco (true) o no (false). | HTMLLoader | ||
| parent : DisplayObjectContainer [solo lectura]
Indica el objeto DisplayObjectContainer que contiene este objeto de visualización. | DisplayObject | |
| pdfCapability : int [estática] [solo lectura]
Tipo de compatibilidad con PDF en el sistema del usuario, definido como valor de código entero. | HTMLLoader | ||
| placeLoadStringContentInApplicationSandbox : Boolean
Especifica si el contenido cargado mediante el método loadString() se coloca en el entorno limitado de la aplicación (true) o un entorno limitado ajeno a la aplicación (false). | HTMLLoader | ||
| root : DisplayObject [solo lectura]
Para un objeto de visualización en un archivo SWF cargado, la propiedad root es el objeto de visualización de nivel más alto en la parte de la estructura de árbol de la lista de visualización representada por dicho archivo SWF. | DisplayObject | |
| rotation : Number
Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original. | DisplayObject | |
| rotationX : Number
Indica la rotación del eje x de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D. | DisplayObject | |
| rotationY : Number
Indica la rotación del eje y de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D. | DisplayObject | |
| rotationZ : Number
Indica la rotación del eje z de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D. | DisplayObject | |
| runtimeApplicationDomain : ApplicationDomain
Dominio de aplicación que se utiliza en el objeto window.runtime en JavaScript en la página HTML. | HTMLLoader | ||
| scale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente. | DisplayObject | |
| scaleX : Number
Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro. | DisplayObject | |
| scaleY : Number
Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto. | DisplayObject | |
| scaleZ : Number
Indica la escala de profundidad (porcentaje) de un objeto aplicada desde el punto de registro del objeto. | DisplayObject | |
| scrollH : Number
Posición de desplazamiento horizontal del contenido HTML en el objeto HTMLLoader. | HTMLLoader | ||
| scrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización. | DisplayObject | |
| scrollV : Number
Posición de desplazamiento vertical del contenido HTML en el objeto HTMLLoader. | HTMLLoader | ||
| softKeyboard : String
Controla la apariencia del teclado virtual. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Define el área que debe permanecer en pantalla cuando se muestra un teclado virtual (no disponible en iOS). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Controla el sonido dentro de este elemento sprite. | Sprite | |
| stage : Stage [solo lectura]
El escenario del objeto de visualización. | DisplayObject | |
| swfCapability : int [estática] [solo lectura]
Tipo de compatibilidad con SWF en el sistema del usuario, definido como valor de código entero. | HTMLLoader | ||
| tabChildren : Boolean
Determina si los elementos secundarios del objeto están habilitados para tabulación. | DisplayObjectContainer | |
| tabEnabled : Boolean
Especifica si este objeto está en el orden de tabulación. | InteractiveObject | |
| tabIndex : int
Especifica el orden de tabulación de los objetos de un archivo SWF. | InteractiveObject | |
| textEncodingFallback : String
La codificación de caracteres utilizada por el contenido de HTMLLoader si una página HTML no especifica ninguna codificación de caracteres concreta. | HTMLLoader | ||
| textEncodingOverride : String
Codificación de caracteres empleada por el contenido de HTMLLoader; anula cualquier configuración de la página HTML. | HTMLLoader | ||
| textSnapshot : flash.text:TextSnapshot [solo lectura]
Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer. | DisplayObjectContainer | |
| transform : flash.geom:Transform
Objeto con propiedades pertenecientes a una matriz, transformación de color y límites de píxel de un objeto de visualización. | DisplayObject | |
| useCache : Boolean
Especifica si se debe consultar la caché local antes de que las peticiones HTTP emitidas por el objeto comiencen a capturar datos. | HTMLLoader | ||
| useHandCursor : Boolean
Valor booleano que indica si debe aparecer la mano que señala (cursor de mano) cuando el puntero pasa por encima de un elemento sprite en el que la propiedad buttonMode se ha definido con el valor true. | Sprite | |
| userAgent : String
Cadena de agente de usuario que se utiliza en futuras peticiones de contenido desde este objeto HTMLLoader. | HTMLLoader | ||
| visible : Boolean
Indica si el objeto de visualización es visible. | DisplayObject | |
| width : Number [override]
Especifica la anchura del rectángulo del lienzo HTML que se está representando. | HTMLLoader | ||
| window : Object [solo lectura]
Objeto global de JavaScript para el contenido cargado en el control HTML. | HTMLLoader | ||
| x : Number
Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal. | DisplayObject | |
| y : Number
Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal. | DisplayObject | |
| z : Number
Indica la posición de la coordenada z en el eje z de la instancia de DisplayObject relativa al contenedor principal 3D. | DisplayObject | |
| Método | Definido por | ||
|---|---|---|---|
Crea un objeto HTMLLoader. | HTMLLoader | ||
|
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer. | DisplayObjectContainer | |
|
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer. | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | EventDispatcher | |
|
Indica si las restricciones de seguridad provocarían la omisión de objetos de visualización de la lista devuelta al llamar al método DisplayObjectContainer.getObjectsUnderPoint() con el punto point especificado. | DisplayObjectContainer | |
Cancela cualquier operación de carga en curso. | HTMLLoader | ||
|
Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia. | DisplayObjectContainer | |
createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader [estática]
Crea un nuevo objeto NativeWindow que contiene un objeto HTMLLoader. | HTMLLoader | ||
|
Distribuye un evento en el flujo del evento. | EventDispatcher | |
|
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace. | DisplayObject | |
|
Devuelve la instancia del objeto de visualización secundario que sale del índice especificado. | DisplayObjectContainer | |
|
Devuelve el objeto de visualización secundario que sale con el nombre especificado. | DisplayObjectContainer | |
|
Devuelve la posición de índice de una instancia secundaria de DisplayObject. | DisplayObjectContainer | |
Devuelve la entrada del historial en la posición especificada. | HTMLLoader | ||
|
Devuelve un conjunto de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer. | DisplayObjectContainer | |
|
Devuelve un rectángulo que define el límite del objeto de visualización, basado en el sistema de coordenadas definido por el parámetro targetCoordinateSpace, excluyendo los trazos en las formas. | DisplayObject | |
|
Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales). | DisplayObject | |
|
Convierte un punto bidimensional de las coordenadas (globales) del escenario en coordenadas (locales) de un objeto tridimensional. | DisplayObject | |
|
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
Retrocede en el historial del navegador (si es posible). | HTMLLoader | ||
Avanza en el historial del navegador (si es posible). | HTMLLoader | ||
Navega el número de pasos especificados en el historial del navegador. | HTMLLoader | ||
|
Calcula el cuadro delimitador del objeto de visualización para ver si se solapa o corta con el cuadro delimitador del objeto de visualización obj. | DisplayObject | |
|
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el punto especificado por los parámetros x e y. | DisplayObject | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
Carga el objeto HTMLLoader con los datos desde el sitio especificado por el parámetro urlRequestToLoad. | HTMLLoader | ||
Carga el objeto HTMLLoader con el contenido HTML dentro de la cadena HTML. | HTMLLoader | ||
|
Convierte un punto tridimensional de las coordenadas (locales) del objeto de visualización tridimensional en un punto bidimensional en las coordenadas (globales) del escenario. | DisplayObject | |
|
Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales). | DisplayObject | |
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
Vuelve a cargar la página desde la ubicación actual. | HTMLLoader | ||
|
Elimina la instancia child de DisplayObject especificada de la lista de elementos secundarios de la instancia de DisplayObjectContainer. | DisplayObjectContainer | |
|
Elimina una instancia de DisplayObject secundaria de la posición de índice especificada en la lista de elementos secundarios de DisplayObjectContainer. | DisplayObjectContainer | |
|
Elimina todas las instancias child de DisplayObject especificadas de la lista de elementos secundarios de la instancia de DisplayObjectContainer. | DisplayObjectContainer | |
|
Elimina un detector del objeto EventDispatcher. | EventDispatcher | |
|
Muestra un teclado virtual. | InteractiveObject | |
|
Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización. | DisplayObjectContainer | |
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Permite al usuario arrastrar el elemento sprite especificado. | Sprite | |
|
Permite al usuario arrastrar el elemento sprite especificado en un dispositivo táctil. | Sprite | |
|
Se detiene gradualmente la ejecución de línea de tiempo de todos los objetos MovieClip con raíz en este objeto. | DisplayObjectContainer | |
|
Finaliza el método startDrag(). | Sprite | |
|
Finaliza el método startTouchDrag() para su uso con dispositivos táctiles. | Sprite | |
|
Intercambia el orden z (de delante a atrás) de los dos objetos secundarios especificados. | DisplayObjectContainer | |
|
Intercambia el orden z (de delante a atrás) de los objetos secundarios situados en las posiciones de índice especificadas en la lista de elementos secundarios. | DisplayObjectContainer | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
|
Devuelve el valor simple del objeto especificado. | Object | |
|
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher | |
| Evento | Resumen | Definido por | ||
|---|---|---|---|---|
| [evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | ||
| Se distribuye cuando un objeto de visualización se añade a la lista de visualización. | DisplayObject | ||
| Se distribuye cuando un objeto de visualización se añade a la lista de visualización del escenario, bien directamente o a través de un subárbol que contiene el objeto de visualización. | DisplayObject | ||
| Se distribuye cuando el usuario selecciona 'Borrar' (o 'Eliminar') en el menú contextual. | InteractiveObject | ||
| Se distribuye cuando un usuario pulsa y suelta el botón principal del dispositivo de señalización sobre el mismo objeto InteractiveObject. | InteractiveObject | ||
| Indica que la última operación de carga solicitada por el método loadString o load ha finalizado correctamente. | HTMLLoader | |||
| Se distribuye cuando un gesto de usuario activa el menú contextual asociado al objeto interactivo la aplicación de AIR. | InteractiveObject | ||
| Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para copiar elementos, o bien cuando el usuario elige la opción 'Copiar' en el menú contextual. | InteractiveObject | ||
| Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para cortar elementos, o bien cuando el usuario elige la opción 'Cortar' en el menú contextual. | InteractiveObject | ||
| [evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | ||
| Se distribuye cuando un usuario pulsa y suelta el botón principal de un dispositivo de señalización dos veces en una sucesión rápida sobre el mismo objeto InteractiveObject cuando el indicador doubleClickEnabled de dicho objeto se ha definido como true. | InteractiveObject | ||
| [evento de difusión] Se distribuye cuando la cabeza lectora entra en un nuevo fotograma. | DisplayObject | ||
| [evento de difusión] Se distribuye cuando la cabeza lectora sale del fotograma actual. | DisplayObject | ||
| Se distribuye después de que un objeto de visualización quede seleccionado. | InteractiveObject | ||
| Se distribuye después de que un objeto de visualización deje de estar seleccionado. | InteractiveObject | ||
| [evento de difusión] Se distribuye una vez ejecutados los constructores de los objetos de visualización del fotograma, pero antes de que se ejecuten los scripts de fotograma. | DisplayObject | ||
| Se distribuye cuando el usuario crea un punto de contacto a lo largo del borde de la superficie de toque con una instancia de InteractiveObject (por ejemplo, toque a lo largo del borde de la superficie de toque en el servidor de Siri para Apple TV). Algunos dispositivos también pueden interpretar este contacto como una combinación de varios eventos táctiles. | InteractiveObject | ||
| Se distribuye cuando el usuario presiona dos puntos de contacto en la misma instancia de InteractiveObject en un dispositivo táctil (como, por ejemplo, pulsar y soltar dos dedos sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | ||
| Se distribuye cuando el usuario mueve un punto de contacto sobre la instancia de InteractiveObject de un dispositivo táctil (como mover los dedos de izquierda a derecha sobre un objeto de visualización en un teléfono móvil o dispositivo con pantalla táctil). | InteractiveObject | ||
| Se distribuye cuando el usuario realiza un gesto de zoom en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con dos dedos y girarlos sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | ||
| Se distribuye cuando el usuario realiza un gesto de barrido en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con tres dedos y, a continuación, moverlos en paralelo sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | ||
| Se distribuye cuando el usuario crea un punto de contacto con una instancia de InteractiveObject, seguidamente toca un dispositivo táctil (como colocar varios dedos sobre un objeto de visualización para abrir un menú y, a continuación, toca con un dedo para seleccionar un elemento de menú en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | ||
| Se distribuye cuando el usuario realiza un gesto de zoom en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con dos dedos y, a continuación, separarlos rápidamente sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | ||
| Indica que ha cambiado una o ambas propiedades contentWidth y contentHeight de un objeto HTMLLoader. | HTMLLoader | |||
| Indica que el DOM HTML se ha creado en respuesta a una operación de carga. | HTMLLoader | |||
| Indica que la representación del contenido de un objeto HTMLLoader está totalmente actualizada. | HTMLLoader | |||
| Este evento se distribuye a cualquier cliente app que admite entrada en línea con un IME | InteractiveObject | ||
| Se distribuye cuando el usuario pulsa una tecla. | InteractiveObject | ||
| Se distribuye cuando el usuario intenta cambiar la selección empleando la navegación mediante teclado. | InteractiveObject | ||
| Se distribuye cuando el usuario suelta una tecla. | InteractiveObject | ||
| Indica que la propiedad location de un objeto HTMLLoader ha cambiado. | HTMLLoader | |||
| Indica que la propiedad location de un objeto HTMLLoader ha cambiado. | HTMLLoader | |||
| Indica que la propiedad location del objeto HTMLLoader está a punto de cambiar. | HTMLLoader | |||
| Se distribuye cuando un usuario pulsa y suelta el botón central del dispositivo de señalización sobre el mismo objeto InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando el usuario pulsa el botón central del dispositivo señalador sobre una instancia de InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando el usuario intenta cambiar la selección empleando un dispositivo de señalización. | InteractiveObject | ||
| Se distribuye cuando el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando se presiona la rueda del ratón sobre una instancia de InteractiveObject. | InteractiveObject | ||
| Distribuido por el objeto InteractiveObject iniciador de arrastre cuando el usuario suelta el botón y finaliza el arrastre. | InteractiveObject | ||
| Distribuido por el objeto InteractiveObject de destino cuando un objeto arrastrado se coloca sobre el objeto y la colocación se acepta con una llamada a DragManager.acceptDragDrop(). | InteractiveObject | ||
| Distribuido por un objeto InteractiveObject cuando la acción de arrastre entra en sus límites. | InteractiveObject | ||
| Distribuido por un objeto InteractiveObject cuando la acción de arrastre se sale de los límites. | InteractiveObject | ||
| Distribuido continuamente por un objeto InteractiveObject mientras la operación de arrastre se mantiene dentro de sus límites. | InteractiveObject | ||
| Distribuido al comienzo de una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag(). | InteractiveObject | ||
| Distribuido durante una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag(). | InteractiveObject | ||
| Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para pegar elementos, o bien cuando el usuario elige la opción 'Pegar' en el menú contextual. | InteractiveObject | ||
| Se distribuye cuando el usuario baja un lápiz stylus activo más allá del umbral de detección de proximidad de la pantalla. | InteractiveObject | ||
| Se distribuye cuando el usuario levanta un lápiz stylus activo por encima del umbral de detección de proximidad de la pantalla. | InteractiveObject | ||
| Se distribuye cuando el usuario pasa un lápiz stylus activo por encima de la pantalla sin salir del umbral de detección de proximidad. | InteractiveObject | ||
| Se distribuye cuando el usuario quita un lápiz stylus activo de encima de este objeto InteractiveObject permaneciendo dentro del umbral de detección de proximidad de la pantalla. | InteractiveObject | ||
| Se distribuye cuando el usuario pasa un lápiz stylus activo directamente por encima de este objeto InteractiveObject permaneciendo dentro del umbral de detección de proximidad de la pantalla. | InteractiveObject | ||
| Se distribuye cuando el usuario quita un lápiz stylus activo de encima de este objeto InteractiveObject y sus elementos secundarios permaneciendo dentro del umbral de detección de proximidad de la pantalla. | InteractiveObject | ||
| Se distribuye cuando el usuario pasa un lápiz stylus activo por encima de este objeto InteractiveObject desde fuera del árbol de descendientes del objeto en la lista de visualización (permaneciendo dentro del umbral de detección de proximidad de la pantalla). | InteractiveObject | ||
| Se distribuye cuando el usuario suelta el botón del dispositivo señalador por primera vez después de que el usuario presiona el botón sobre una instancia de InteractiveObject y, a continuación, mueve el dispositivo de señalización fuera de la instancia de InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización. | DisplayObject | ||
| Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización, bien directamente o a través de la eliminación de un subárbol que contiene el objeto de visualización. | DisplayObject | ||
| [evento de difusión] Se distribuye cuando la lista de visualización se va a actualizar y representar. | DisplayObject | ||
| Se distribuye cuando un usuario pulsa y suelta el botón derecho del dispositivo de señalización sobre el mismo objeto InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject. | InteractiveObject | ||
| Se distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject. | InteractiveObject | ||
| Indica que el objeto HTMLLoader ha cambiado la propiedad scrollH o scrollV. | HTMLLoader | |||
| Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para seleccionar todos los elementos, o bien cuando el usuario elige la opción 'Seleccionar todo' en el menú contextual. | InteractiveObject | ||
| Se distribuye inmediatamente una vez mostrado el teclado en pantalla. | InteractiveObject | ||
| Se distribuye inmediatamente antes de que se muestre el teclado en pantalla. | InteractiveObject | ||
| Se distribuye inmediatamente una vez oculto el teclado en pantalla. | InteractiveObject | ||
| Se distribuye cuando cambia el valor del indicador tabChildren del objeto. | InteractiveObject | ||
| Se distribuye cuando cambia el indicador tabEnabled del objeto. | InteractiveObject | ||
| Se distribuye cuando cambia el valor de la propiedad tabIndex del objeto. | InteractiveObject | ||
| Se distribuye cuando un usuario escribe uno o varios caracteres de texto. | InteractiveObject | ||
| Se distribuye cuando el usuario toca por primera vez un dispositivo táctil (por ejemplo, toca un teléfono móvil o dispositivo con pantalla táctil con un dedo). | InteractiveObject | ||
| Se distribuye cuando el usuario elimina el contacto con un dispositivo táctil (como levantar un dedo de un teléfono móvil o dispositivo con pantalla táctil). | InteractiveObject | ||
| Se distribuye cuando el usuario toca el dispositivo y se distribuye constantemente hasta que desaparece el punto de contacto. | InteractiveObject | ||
| Se distribuye cuando el usuario retira el punto de contacto de una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un objeto de visualización a otro en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | ||
| Se distribuye cuando el usuario mueve el punto de contacto sobre una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un punto fuera de un objeto de visualización en un punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | ||
| Se distribuye cuando el usuario retira el punto de contacto de una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un objeto de visualización a un punto fuera del objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | ||
| Se distribuye cuando el usuario mueve el punto de contacto sobre una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un punto fuera de un objeto de visualización en un punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | ||
| Se distribuye cuando el usuario levanta el punto de contacto en la misma instancia de InteractiveObject en la que se inició el contacto en un dispositivo táctil (como, por ejemplo, pulsar y soltar un dedo desde un único punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | ||
| Indica que se ha producido una excepción de JavaScript no detectada en el objeto HTMLLoader. | HTMLLoader | |||
authenticate | propiedad |
authenticate:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Especifica si se deben controlar las peticiones de autenticación (true) o no (false) para las peticiones HTTP emitidas por este objeto. Si es false, el intento de autenticación devuelve un error HTTP.
El valor predeterminado es initialized from URLRequestDefaults.authenticate.
Implementación
public function get authenticate():Boolean public function set authenticate(value:Boolean):voidElementos de API relacionados
cacheResponse | propiedad |
cacheResponse:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Especifica si se deben guardar en caché los datos de respuesta correctos para las peticiones HTTP emitidas por este objeto. Si se establece en true, el objeto HTMLLoader utiliza la caché HTTP del sistema operativo.
El valor predeterminado es initialized from URLRequestDefaults.cacheResponse.
Implementación
public function get cacheResponse():Boolean public function set cacheResponse(value:Boolean):voidElementos de API relacionados
contentHeight | propiedad |
contentHeight:Number [solo lectura] | Versiones de motor de ejecución: | AIR 1.0 |
Altura, en píxeles, del contenido HTML. Esta propiedad puede cambiar si cambian las dimensiones del objeto HTMLLoader. Por ejemplo, una página HTML utiliza a menudo toda la altura del objeto HTMLLoader y la propiedad contentHeight puede cambiar si cambia la altura del objeto HTMLLoader.
Implementación
public function get contentHeight():Number contentWidth | propiedad |
contentWidth:Number [solo lectura] | Versiones de motor de ejecución: | AIR 1.0 |
Anchura, en píxeles, del contenido HTML. Esta propiedad puede cambiar si cambian las dimensiones del objeto HTMLLoader. Por ejemplo, una página HTML utiliza a menudo toda la anchura del objeto HTMLLoader y la propiedad contentWidth puede cambiar si cambia la anchura del objeto HTMLLoader.
Implementación
public function get contentWidth():Number hasFocusableContent | propiedad |
height | propiedad |
height:Number[override] | Versiones de motor de ejecución: | AIR 1.0 |
Especifica la altura del rectángulo del lienzo HTML que se está representando. Este valor de propiedad es la altura del objeto de visualización HTMLLoader, en píxeles. El valor máximo de height es 4.095 píxeles. Si cambia esta propiedad, el objeto HTMLLoader vuelve a representar el documento HTML. Los eventos htmlBoundsChange se pueden distribuir como respuesta a modificaciones en esta propiedad.
Cuando establece la propiedad width o height de un objeto HTMLLoader, los límites del objeto cambian, pero el contenido no se escala (como ocurre con otros tipos de objetos de visualización).
Implementación
override public function get height():Number override public function set height(value:Number):void historyLength | propiedad |
historyLength:uint [solo lectura] | Versiones de motor de ejecución: | AIR 1.0 |
La longitud total de la lista del historial, incluidas las entradas de avance y retroceso. Esta propiedad tiene el mismo valor que la propiedad window.history.length de JavaScript de la página HTML.
Implementación
public function get historyLength():uintElementos de API relacionados
historyPosition | propiedad |
historyPosition:uint| Versiones de motor de ejecución: | AIR 1.0 |
La posición actual en la lista del historial. La lista del historial corresponde al objeto window.history de la página HTML. Las entradas anteriores a la posición actual forman la lista de "retroceso" y las posteriores, la lista de "avance". Al intentar definir la posición fuera de estos límites, se mueve al final.
Implementación
public function get historyPosition():uint public function set historyPosition(value:uint):voidElementos de API relacionados
htmlHost | propiedad |
htmlHost:flash.html:HTMLHost| Versiones de motor de ejecución: | AIR 1.0 |
El objeto HTMLHost utilizado para controlar los cambios de ciertos elementos de la interfaz de usuario, por ejemplo la propiedad window.document.title del objeto HTMLLoader. Para anular los comportamientos predeterminados del objeto HTMLLoader, cree una subclase de la clase HTMLHost y anule sus funciones de miembro a fin de controlar los diferentes cambios de interfaz de usuario en el contenido HTML.
Implementación
public function get htmlHost():flash.html:HTMLHost public function set htmlHost(value:flash.html:HTMLHost):voidElementos de API relacionados
idleTimeout | propiedad |
idleTimeout:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2 |
Especifica el valor espera de inactividad (en milisegundos) para las peticiones HTTP emitidas por este objeto.
El tiempo espera de inactividad es el tiempo que cliente espera una respuesta del servidor, una vez establecida la conexión, antes de abandonar la petición.
El valor predeterminado es initialized from URLRequestDefaults.idleTimeout.
Implementación
public function get idleTimeout():Number public function set idleTimeout(value:Number):voidElementos de API relacionados
isSupported | propiedad |
loaded | propiedad |
loaded:Boolean [solo lectura] | Versiones de motor de ejecución: | AIR 1.0 |
Indica si el evento load de JavaScript correspondiente a la llamada anterior al método load() o loadString() se ha entregado en el DOM HTML del objeto HTMLLoader. Esta propiedad es true antes de que se distribuya el evento complete. Es posible que esta propiedad nunca sea true. Esto ocurre en los mismos casos en que el evento complete no se distribuye nunca.
Implementación
public function get loaded():Boolean location | propiedad |
manageCookies | propiedad |
manageCookies:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Especifica si la pila del protocolo HTTP debe administrar las cookies de este objeto. Si es true, las cookies se agregan a la petición y se recuerdan las cookies de la respuesta. Si es false, las cookies no se añaden a la petición y no se recuerdan las cookies de respuesta.
El valor predeterminado es initialized from URLRequestDefaults.manageCookies.
Implementación
public function get manageCookies():Boolean public function set manageCookies(value:Boolean):voidElementos de API relacionados
navigateInSystemBrowser | propiedad |
navigateInSystemBrowser:Boolean| Versiones de motor de ejecución: | AIR 1.0 |
Indica si la navegación del fotograma raíz del contenido HTML (por ejemplo, cuando el usuario hace clic en un vínculo, cuando se establece la propiedad window.location o cuando se llama al método window.open()), el resultado es la navegación en el objeto HTMLLoader (false) o en el navegador web predeterminado del sistema (true). Establezca esta propiedad como true si quiere que la navegación se realice en el navegador web predeterminado del sistema (no en el objeto HTMLLoader).
El valor predeterminado es false.
Implementación
public function get navigateInSystemBrowser():Boolean public function set navigateInSystemBrowser(value:Boolean):void paintsDefaultBackground | propiedad |
paintsDefaultBackground:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Especifica si el fondo del documento HTMLLoader es blanco opaco (true) o no (false). Con esta propiedad establecida en false, el objeto HTMLLoader utiliza su contenedor de objetos de visualización como fondo para el HTML y recurre a la opacidad (valor alpha) del contenedor de objetos de visualización como fondo del HTML. Ahora bien, si el elemento body o cualquier otro elemento del documento HTML tiene un color de fondo opaco (indicado por style="background-color:gray", por ejemplo), dicha porción de HTML representado utilizará el color de fondo opaco especificado.
Implementación
public function get paintsDefaultBackground():Boolean public function set paintsDefaultBackground(value:Boolean):void pdfCapability | propiedad |
pdfCapability:int [solo lectura] | Versiones de motor de ejecución: | AIR 1.0 |
Tipo de compatibilidad con PDF en el sistema del usuario, definido como valor de código entero. Un objeto HTMLLoader puede mostrar contenido PDF sólo si esta propiedad tiene como resultado PDFCapability.STATUS_OK. La clase PDFCapability define constantes para posibles valores de la propiedad pdfCapability del modo siguiente:
| Constante PDFCapability | Significado |
|---|---|
STATUS_OK | Se detecta una versión suficiente (8.1 o posterior) de Acrobat o Adobe Reader y el contenido PDF se puede cargar en un objeto HTMLLoader.
Nota: en Windows, si se está ejecutando en el sistema del usuario la versión 7.x o superior de Acrobat o Adobe Reader, se utilizará dicha versión, aunque se instale una versión posterior compatible con la carga de PDF en un objeto HTMLLoader. En este caso, si el valor de la propiedad |
ERROR_INSTALLED_READER_NOT_FOUND | No se ha detectado ninguna versión de Acrobat o Adobe Reader. Un objeto HTMLLoader no puede mostrar contenido PDF. |
ERROR_INSTALLED_READER_TOO_OLD | Se ha detectado Acrobat o Adobe Reader pero la versión es demasiado antigua. Un objeto HTMLLoader no puede mostrar contenido PDF. |
ERROR_PREFERED_READER_TOO_OLD | Se ha detectado una versión suficiente (8.1 o posterior) de Acrobat o Adobe Reader, pero la versión de Acrobat o Adobe Reader configurada para controlar el contenido PDF es anterior a la versión 8.1. Un objeto HTMLLoader no puede mostrar contenido PDF. |
Implementación
public static function get pdfCapability():intElementos de API relacionados
placeLoadStringContentInApplicationSandbox | propiedad |
placeLoadStringContentInApplicationSandbox:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.5 |
Especifica si el contenido cargado mediante el método loadString() se coloca en el entorno limitado de la aplicación (true) o un entorno limitado ajeno a la aplicación (false).
Cuando esta propiedad se establece como false, el contenido cargado con el método loadString() se coloca en un entorno limitado ajeno a la aplicación con las siguientes características:
- Dispone de acceso para cargar contenido de la red (pero no del sistema de archivos).
- No puede cargar datos con XMLHttpRequest.
- La propiedad
window.locationse establece en"about:blank". - El contenido no puede acceder a la propiedad
window.runtime(como el contenido de un entorno limitado ajeno a la aplicación).
Si esta propiedad se establece como true, el contenido cargado con el método loadString() se coloca en el entorno limitado de la aplicación con tiene acceso a la propiedad window.runtime y a todas las API de AIR. Debe asegurarse de que el origen de datos de la cadena utilizada en la llamada al método loadString() sea de confianza. Las sentencias de código de la cadena HTML se ejecutan con privilegios completos de aplicación si la propiedad se establece como true. Sólo se debe establecer esta propiedad como true cuando se está seguro de que la cadena no contiene código malicioso.
En aplicaciones compiladas con los SDK de AIR 1.0 o AIR 1.1, el contenido cargado con el método loadString() se coloca en el entorno limitado de la aplicación.
El valor predeterminado es false.
Implementación
public function get placeLoadStringContentInApplicationSandbox():Boolean public function set placeLoadStringContentInApplicationSandbox(value:Boolean):voidElementos de API relacionados
runtimeApplicationDomain | propiedad |
runtimeApplicationDomain:ApplicationDomain| Versiones de motor de ejecución: | AIR 1.0 |
Dominio de aplicación que se utiliza en el objeto window.runtime en JavaScript en la página HTML.
Si su valor es null, o si el contenido HTML procede de un dominio de seguridad diferente al del contenido SWF que incluye el objeto HTMLLoader, la página utilizará un dominio de aplicación predeterminado como su dominio.
Implementación
public function get runtimeApplicationDomain():ApplicationDomain public function set runtimeApplicationDomain(value:ApplicationDomain):voidEmite
SecurityError — si el objeto ApplicationDomain no pertenece al dominio de seguridad de la llamada.
|
Elementos de API relacionados
scrollH | propiedad |
scrollV | propiedad |
swfCapability | propiedad |
swfCapability:int [solo lectura] | Versiones de motor de ejecución: | AIR 2 |
Tipo de compatibilidad con SWF en el sistema del usuario, definido como valor de código entero. Un objeto HTMLLoader puede mostrar contenido SWF sólo si esta propiedad tiene como resultado HTMLSWFCapability.STATUS_OK. La clase HTMLSWFCapability define constantes para posibles valores de la propiedad swfCapability del modo siguiente:
| Constante HTMLSWFCapability | Significado |
|---|---|
STATUS_OK | Se detecta una versión suficiente de Adobe Flash Player y el contenido SWF se puede cargar en un objeto HTMLLoader. |
ERROR_INSTALLED_PLAYER_NOT_FOUND | No se ha detectado ninguna versión de Adobe Flash Player. Un objeto HTMLLoader no puede mostrar contenido SWF. |
ERROR_INSTALLED_PLAYER_TOO_OLD | Se ha detectado una versión de Adobe Flash Player pero es demasiado antigua. Un objeto HTMLLoader no puede mostrar contenido SWF. |
Implementación
public static function get swfCapability():intElementos de API relacionados
textEncodingFallback | propiedad |
textEncodingFallback:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
La codificación de caracteres utilizada por el contenido de HTMLLoader si una página HTML no especifica ninguna codificación de caracteres concreta. Una página HTML especifica la codificación de caracteres en una etiqueta meta, tal como se indica a continuación:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
Los valores se definen en la lista IANA de conjuntos de caracteres válidos.
Si no se especifica ninguna codificación en la página HTML mediante las propiedades textEncodingFallback o textEncodingOverride, el contenido HTML utiliza la codificación ISO-8859-1.
Implementación
public function get textEncodingFallback():String public function set textEncodingFallback(value:String):voidElementos de API relacionados
textEncodingOverride | propiedad |
textEncodingOverride:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Codificación de caracteres empleada por el contenido de HTMLLoader; anula cualquier configuración de la página HTML. Una página HTML especifica la codificación de caracteres en una etiqueta meta, tal como se indica a continuación:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
Esta configuración también anula los ajustes de la propiedad textEncodingFallback.
Los valores se definen en la lista IANA de conjuntos de caracteres válidos.
Define la propiedad textEncodingOverride una vez cargado el contenido HTML para que AIR pueda actualizarlo con la codificación especificada. Cuando el objeto HTMLLoader accede a una nueva página, es necesario volver a establecer la propiedad si quiere utilizar una codificación específica en la nueva página.
Si no se especifica ninguna codificación en la página HTML mediante las propiedades textEncodingFallback o textEncodingOverride, el contenido HTML utiliza la codificación ISO-8859-1.
Al establecer la propiedad textEncodingOverride como null, se restaura el comportamiento predeterminado.
Implementación
public function get textEncodingOverride():String public function set textEncodingOverride(value:String):voidElementos de API relacionados
useCache | propiedad |
useCache:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Especifica si se debe consultar la caché local antes de que las peticiones HTTP emitidas por el objeto comiencen a capturar datos.
El valor predeterminado es initialized from URLRequestDefaults.useCache.
Implementación
public function get useCache():Boolean public function set useCache(value:Boolean):voidElementos de API relacionados
userAgent | propiedad |
userAgent:String| Versiones de motor de ejecución: | AIR 1.0 |
Cadena de agente de usuario que se utiliza en futuras peticiones de contenido desde este objeto HTMLLoader.
Para definir la cadena de agente de usuario, establezca la propiedad userAgent del objeto HTMLLoader antes de llamar al método load(). La propiedad userAgent del objeto URLRequest transferido al método load() no se utiliza.
Puede establecer la cadena de agente de usuario predeterminada que utilizan todos los objetos HTMLLoader de un dominio de aplicación por medio de la propiedad URLRequestDefaults.userAgent. Si no se define ningún valor para la propiedad userAgent del objeto HTMLLoader (o si el valor se establece como null), la cadena de agente de usuario se define en el valor de la propiedad estática URLRequestDefaults.userAgent.
Si no hay ningún valor definido para la propiedad userAgent del objeto HTMLLoader ni para URLRequestDefaults.userAgent, se utiliza un valor predeterminado como cadena de agente de usuario. Este valor predeterminado varía según el sistema operativo basado en el motor de ejecución (como Mac OS, Windows o Linux), el lenguaje y la versión del motor de ejecución como en los siguientes ejemplos:
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, como Gecko) AdobeAIR/1.5""Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, como Gecko) AdobeAIR/1.5""Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
Implementación
public function get userAgent():String public function set userAgent(value:String):voidElementos de API relacionados
width | propiedad |
width:Number[override] | Versiones de motor de ejecución: | AIR 1.0 |
Especifica la anchura del rectángulo del lienzo HTML que se está representando. Anchura del objeto de visualización HTMLLoader, en píxeles. El valor máximo de width es 4.095 píxeles. Si cambia esta propiedad, el objeto HTMLLoader vuelve a representar el documento HTML. Los eventos htmlBoundsChange se pueden distribuir como respuesta a modificaciones en esta propiedad. Cuando establece las propiedades width y height de un objeto HTMLLoader, los límites del objeto cambian, pero el contenido no se escala (como ocurre con otros tipos de objetos de visualización).
Implementación
override public function get width():Number override public function set width(value:Number):void window | propiedad |
HTMLLoader | () | Información sobre |
public function HTMLLoader()| Versiones de motor de ejecución: | AIR 1.0 |
Crea un objeto HTMLLoader.
cancelLoad | () | método |
public function cancelLoad():void| Versiones de motor de ejecución: | AIR 1.0 |
Cancela cualquier operación de carga en curso.
createRootWindow | () | método |
public static function createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader| Versiones de motor de ejecución: | AIR 1.0 |
Crea un nuevo objeto NativeWindow que contiene un objeto HTMLLoader. Utilice el objeto HTMLLoader que devuelve este método para cargar contenido HTML.
De forma predeterminada (cuando no se establece ningún parámetro al llamar a este método), la nueva ventana utiliza el fondo cromático estándar del sistema e incluye controles de barra de desplazamiento para el contenido. Puede establecer los parámetros para cambiar las propiedades de la nueva ventana.
Como la ventana carga contenido y aplica hojas de estilo, se pueden producir pequeños problemas gráficos. Para evitar que estas discontinuidades sean visible,s establezca el parámetro visible como false. Cuando la ventana se ha cargado y ha mostrado su contenido, libérelo estableciendo la propiedad window.nativeWindow.visible como true o llame al método window.nativeWindow.activate().
Parámetros
visible:Boolean (default = true) | |
windowInitOptions:NativeWindowInitOptions (default = null)null utiliza los valores NativeWindowInitOptions predeterminados.
| |
scrollBarsVisible:Boolean (default = true) | |
bounds:Rectangle (default = null)null, indica los límites de la ventana. Si cualquiera de los valores x, y, width o height es NaN, la dimensión correspondiente de la ventana conserva su valor predeterminado.
|
flash.html:HTMLLoader — Un nuevo objeto HTMLLoader situado en el escenario de un nuevo objeto NativeWindow.
|
getHistoryAt | () | método |
public function getHistoryAt(position:uint):flash.html:HTMLHistoryItem| Versiones de motor de ejecución: | AIR 1.0 |
Devuelve la entrada del historial en la posición especificada.
Parámetros
position:uint — La posición de la lista del historial.
|
flash.html:HTMLHistoryItem — Un objeto URLRequest para la entrada del historial en la posición especificada.
|
Elementos de API relacionados
historyBack | () | método |
public function historyBack():void| Versiones de motor de ejecución: | AIR 1.0 |
Retrocede en el historial del navegador (si es posible).
Llamar a este método del objeto HTMLLoader tiene el mismo efecto que llamar al método back() de la propiedad window.history en JavaScript en la página HTML.
Este función no emite ningún error.
Elementos de API relacionados
historyForward | () | método |
public function historyForward():void| Versiones de motor de ejecución: | AIR 1.0 |
Avanza en el historial del navegador (si es posible).
Llamar a este método del objeto HTMLLoader tiene el mismo efecto que llamar al método forward() de la propiedad window.history en JavaScript en la página HTML.
Este función no emite ningún error.
Elementos de API relacionados
historyGo | () | método |
public function historyGo(steps:int):void| Versiones de motor de ejecución: | AIR 1.0 |
Navega el número de pasos especificados en el historial del navegador. Navega hacia delante si es positivo, o hacia atrás si es negativo. Si no se produce navegación, se fuerza una operación de recarga.
Este método equivale a llamar al método go() de la propiedad window.history en JavaScript en la página HTML.
Este función no emite ningún error.
Parámetros
steps:int — Número de pasos de la lista del historial que se deben avanzar (positivo) o retroceder (negativo).
|
Elementos de API relacionados
load | () | método |
public function load(urlRequestToLoad:URLRequest):void| Versiones de motor de ejecución: | AIR 1.0 |
Carga el objeto HTMLLoader con los datos desde el sitio especificado por el parámetro urlRequestToLoad. Cuando se llama a este método, primero establece la propiedad loaded como false. Este método inicia una operación que siempre finaliza de forma asíncrona.
Una llamada a este método cancela de forma implícita cualquier operación de carga previa iniciada con este método o con el método loadString(). El evento complete de la operación de carga previa no se entrega nunca.
Es posible que el evento complete no se distribuya nunca. Esto ocurre si el contenido HTML cargado en el objeto HTMLLoader no se descarga nunca por completo. Esto puede suceder si el contenido HTML hace referencia a una URL en un script CGI que genera contenido indefinidamente.
Parámetros
urlRequestToLoad:URLRequest — El objeto URLRequest que contiene la información sobre la URL que se va a cargar. Además de la URL que se va a cargar, un objeto URLRequest contiene propiedades que definen el método de envío de formularios HTTP (GET o POST), todos los datos que se transmiten con la petición y los encabezados de la petición.
|
Elementos de API relacionados
loadString | () | método |
public function loadString(htmlContent:String):void| Versiones de motor de ejecución: | AIR 1.0 |
Carga el objeto HTMLLoader con el contenido HTML dentro de la cadena HTML. Cuando finaliza la representación del HTML en la cadena, se distribuye el evento complete. El evento complete siempre se distribuye de forma asíncrona.
Una llamada a este método cancela de forma implícita cualquier operación de carga previa iniciada con este método o con el método load(). El evento complete de la operación de carga previa no se entrega nunca.
Si el HTML especificado en la cadena no tiene referencias a recursos externos, este método representa el HTML de forma sincrónica. No obstante, el evento complete se sigue distribuyendo de forma asíncrona. Si la propiedad loaded de esta clase es true inmediatamente después de llamar a esta función, el contenido HTML especificado en el argumento htmlContent se representa de forma sincrónica.
Es posible que el evento complete no se distribuya nunca. Esto ocurre si el contenido HTML cargado en el objeto HTMLLoader no se descarga nunca por completo. Esto puede suceder si el contenido HTML hace referencia a una URL en un script CGI que genera contenido indefinidamente.
El contenido cargado con el método loadString() se coloca en el entorno limitado de seguridad de la aplicación únicamente si la propiedad placeLoadStringContentInApplicationSandbox se ha establecido como true.
Parámetros
htmlContent:String — La cadena que contiene el contenido HTML que se va a cargar en el objeto HTMLLoader.
|
Elementos de API relacionados
reload | () | método |
public function reload():void| Versiones de motor de ejecución: | AIR 1.0 |
Vuelve a cargar la página desde la ubicación actual.
complete | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.COMPLETE| Versiones de motor de ejecución: | AIR 1.0 |
Indica que la última operación de carga solicitada por el método loadString o load ha finalizado correctamente. El evento se distribuye después de que se haya activado el evento load de JavaScript en el DOM HTML del objeto HTMLLoader. Este evento siempre se distribuye de forma asíncrona. El controlador de eventos de este evento puede llamar a cualquier método o acceder a cualquier propiedad del objeto HTMLLoader.
Event.COMPLETE define el valor de la propiedad type de un objeto de evento complete.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto de red que ha terminado de cargarse. |
Elementos de API relacionados
htmlBoundsChange | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.HTML_BOUNDS_CHANGE| Versiones de motor de ejecución: | AIR 1.0 |
Indica que ha cambiado una o ambas propiedades contentWidth y contentHeight de un objeto HTMLLoader. Puede ser el resultado de cargar una nueva imagen o contenido adicional. Los controladores de eventos pueden llamar a cualquier método o acceder a cualquier propiedad del objeto HTMLLoader.
El objeto HTMLLoader puede distribuir este evento en cualquier momento una vez iniciada la operación de carga, incluso si el objeto ya ha distribuido el evento complete.
Event.HTML_BOUNDS_CHANGE define el valor de la propiedad type de un objeto de evento htmlBoundsChange.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto HTMLLoader. |
target | El objeto HTMLLoader. |
Elementos de API relacionados
htmlDOMInitialize | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.HTML_DOM_INITIALIZE| Versiones de motor de ejecución: | AIR 1.0 |
Indica que el DOM HTML se ha creado en respuesta a una operación de carga. Los métodos load() y loadString() del objeto HTMLLoader emiten una excepción mientras se distribuye el evento. Cualquier propiedad o método de un objeto JavaScript accesible desde la propiedad window del objeto HTMLLoader que controla la URL cargada en el objeto HTMLLoader emite una excepción si se define o se llama durante la distribución del evento. Por ejemplo, al establecer window.location mediante la propiedad window del objeto HTMLLoader, el resultado es una excepción de JavaScript.
Event.HTML_DOM_INITIALIZE define el valor de la propiedad type de un objeto de evento htmlDOMInitialize.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto HTMLLoader. |
target | El objeto HTMLLoader. |
Elementos de API relacionados
htmlRender | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.HTML_RENDER| Versiones de motor de ejecución: | AIR 1.0 |
Indica que la representación del contenido de un objeto HTMLLoader está totalmente actualizada. Este evento se puede distribuir con frecuencia, siempre que se realice cualquier cambio de representación en el contenido HTML. Por ejemplo, este evento se distribuye cuando se muestra nuevo contenido cuando el usuario hace clic en un vínculo o cuando el código JavaScript de la página representa HTML. Los detectores de eventos pueden llamar a cualquier método o acceder a cualquier propiedad del objeto HTMLLoader.
Los controladores de este evento debe comprobar las propiedades contentWidth y contentHeight del objeto HTMLLoader para actualizar cualquier barra de desplazamiento asociada al él.
El objeto HTMLLoader puede distribuir este evento en cualquier momento una vez iniciada la operación de carga, incluso si el objeto ya ha distribuido el evento complete.
Event.HTML_RENDER define el valor de la propiedad type de un objeto de evento htmlRender.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto HTMLLoader. |
target | El objeto HTMLLoader. |
locationChange | Evento |
flash.events.LocationChangeEventpropiedad LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE| Versiones de motor de ejecución: | AIR 2.7 |
Indica que la propiedad location de un objeto HTMLLoader ha cambiado. El controlador de eventos de este evento puede llamar a cualquier método o acceder a cualquier propiedad del objeto HTMLLoader.
HTMLLoader distribuye un evento locationChange de tipo LocationChangeEvent en las aplicaciones que utilizan el espacio de nombres de AIR 2.7 y versiones posteriores. En versiones anteriores de AIR, el objeto de evento distribuido es una instancia de la clase Event.
Elementos de API relacionados
locationChange | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.LOCATION_CHANGE| Versiones de motor de ejecución: | AIR 1.0 |
Indica que la propiedad location de un objeto HTMLLoader ha cambiado. El controlador de eventos de este evento puede llamar a cualquier método o acceder a cualquier propiedad del objeto HTMLLoader.
HTMLLoader distribuye un evento locationChange de tipo Event en las aplicaciones que utilizan el espacio de nombres de AIR anteriores a la versión 2.7. En AIR 2.7 y versiones posteriores, el objeto de evento es de la clase LocationChangeEvent y proporciona una propiedad location adicional establecida en la URL de la nueva página.
Event.LOCATION_CHANGE define el valor de la propiedad type de un objeto de evento locationChange.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto HTMLLoader. |
target | El objeto HTMLLoader. |
Elementos de API relacionados
locationChanging | Evento |
flash.events.LocationChangeEventpropiedad LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.7 |
Indica que la propiedad location del objeto HTMLLoader está a punto de cambiar.
Un evento locationChanging se distribuye sólo cuando el cambio de la ubicación se inicia mediante la interacción con el usuario, por ejemplo, cuando un usuario hace clic en un vínculo o código que se ejecuta dentro del objeto HTMLLoader, como una redirección del lado del cliente. De forma predeterminada, la nueva ubicación se muestra en este objeto HTMLLoader. Se puede llamar al método preventDefault() del objeto de evento para cancelar el comportamiento predeterminado. Por ejemplo, podría utilizar la función flash.net.navigateToURL() para abrir la página en el navegador del sistema basado en la propiedad location del objeto de evento.
Un evento locationChanging() no se distribuye cuando se llama a los siguientes métodos:
- load()
- loadString()
- reload()
- historyBack()
- historyForward()
- historyGo()
Además, este evento no se distribuye si la propiedad navigateInSystemBrowser es truey cuando la página de destino se abre en el navegador del sistema, dado que la ubicación de HTMLLoader no cambia.
LOCATION_CHANGING define el valor del objeto LocationChangeEvent de la propiedad type antes de un cambio en la ubicación de la página.
Ejemplo ( Cómo utilizar este ejemplo )
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();
}
}
}
}
scroll | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.SCROLL| Versiones de motor de ejecución: | AIR 1.0 |
Indica que el objeto HTMLLoader ha cambiado la propiedad scrollH o scrollV. El objeto HTMLLoader distribuye este evento cuando el código JavaScript que se ejecuta en el objeto HTMLLoader invoca el método scrollTo() del objeto window y la ubicación deseada deja de estar visible. El evento no se distribuye cuando el código ActionScript cambia la propiedad scrollH o scrollV. Los controladores de eventos pueden llamar a cualquier método o acceder a cualquier propiedad del objeto HTMLLoader.
Los controladores de eventos de este evento deben comprobar las propiedades scrollH y scrollV para actualizar cualquier barra de desplazamiento asociada al objeto HTMLLoader.
El objeto HTMLLoader puede distribuir este evento en cualquier momento una vez iniciada la operación de carga, incluso si el objeto ya ha distribuido el evento complete.
Event.SCROLL define el valor de la propiedad type de un objeto de evento scroll.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto TextField que se desplaza. La propiedad target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
uncaughtScriptException | Evento |
flash.events.HTMLUncaughtScriptExceptionEventpropiedad HTMLUncaughtScriptExceptionEvent.type =
flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION| Versiones de motor de ejecución: | AIR 1.0 |
Indica que se ha producido una excepción de JavaScript no detectada en el objeto HTMLLoader. Los controladores de eventos pueden llamar a cualquier método o acceder a cualquier propiedad del objeto HTMLLoader. Este evento se puede cancelar y su comportamiento predeterminado cuando se ejecuta en AIR Debug Launcher es enviar la pila de JavaScript a la salida del trazado.
La constanteHTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION define el valor de la propiedad type de un objeto de evento uncaughtScriptException.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
exceptionValue | Resultado de evaluar la expresión de la declaración throw resultante de la excepción no detectada. |
stackTrace | Conjunto de objetos que representan el trazado de pila en el momento en que se produjo la declaración throw que produjo como resultado la ejecución de la excepción no detectada. |
target | El objeto HTMLLoader. |
Elementos de API relacionados
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);
}
}
}
Tue Jun 12 2018, 02:12 PM Z