Uso del componente UILoader

El componente UILoader es un contenedor que puede mostrar archivos SWF, JPEG, JPEG progresivo, PNG y GIF. Se puede utilizar el componente UILoader cuando sea necesario recuperar contenido de una ubicación remota e insertarla en una aplicación Flash. Por ejemplo, se puede utilizar el componente UILoader para añadir el logotipo de una empresa (archivo JPEG) a un formulario. Asimismo, se podría utilizar un componente UILoader en una aplicación que muestre fotografías. El método load() se utiliza para cargar contenido, la propiedad percentLoaded para determinar la cantidad de contenido que se ha cargado y el evento complete para determinar cuándo ha terminado la carga.

Es posible ajustar la escala del contenido de UILoader, o bien cambiar el tamaño de UILoader para que se ajuste al tamaño del contenido. De forma predeterminada, se cambia la escala del contenido para que se ajuste a UILoader. También se puede cargar el contenido en tiempo de ejecución y controlar el progreso de carga (aunque después de que el contenido se haya cargado, se almacena en la caché y el progreso salta al 100% rápidamente). Si se especifica una ubicación al cargar contenido en UILoader, se debe especificar dicha ubicación (coordenadas X e Y) como 0,0.

Interacción del usuario con el componente UILoader

El componente UILoader no puede seleccionarse. Sin embargo, sí se puede seleccionar el contenido cargado en el componente UILoader e interactuar con él. Para obtener más información sobre el control de la selección, consulte la clase FocusManager en la Referencia de ActionScript 3.0 para Flash Professional y en Trabajo con FocusManager .

Parámetros del componente UILoader

Puede establecer los siguientes parámetros de edición para cada instancia del componente UILoader en el inspector de propiedades o en el inspector de componentes: autoLoad , maintainAspectRatio , source y scaleContent . Cada uno de estos parámetros tiene una propiedad de ActionScript del mismo nombre.

La previsualización dinámica de cada instancia de UILoader refleja los cambios de parámetros realizados durante la edición en el inspector de propiedades o el inspector de componentes.

Se puede escribir código ActionScript para definir opciones adicionales para instancias de UILoader con sus métodos, propiedades y eventos. Para obtener más información, consulte la clase UILoader en la Referencia de ActionScript 3.0 para Flash Professional .

Creación de una aplicación con el componente UILoader

En el procedimiento siguiente se explica cómo añadir un componente UILoader a una aplicación durante la edición. En este ejemplo, se carga una imagen GIF de un logotipo.

  1. Cree un nuevo documento de Flash (ActionScript 3.0).

  2. Arrastre un componente UILoader del panel Componentes al escenario.

  3. En el inspector de propiedades, introduzca el nombre de instancia aUI .

  4. Seleccione el cargador en el escenario y en el inspector de componentes, e introduzca http://www.helpexamples.com/images/logo.gif para el parámetro source .

Creación de una instancia del componente UILoader con ActionScript

En este ejemplo, se crea un componente UILoader mediante ActionScript y se carga una imagen JPEG de una flor. Cuando se produce el evento complete , muestra el número de bytes cargados en el panel Salida.

  1. Cree un nuevo documento de Flash (ActionScript 3.0).

  2. Arrastre el componente UILoader del panel Componentes al panel Biblioteca.

  3. Abra el panel Acciones, seleccione el fotograma 1 en la línea de tiempo principal e introduzca el código ActionScript siguiente: 

    import fl.containers.UILoader; 
 
var aLoader:UILoader = new UILoader(); 
aLoader.source = "http://www.flash-mx.com/images/image1.jpg"; 
aLoader.scaleContent = false; 
addChild(aLoader); 
 
aLoader.addEventListener(Event.COMPLETE, completeHandler); 
function completeHandler(event:Event) { 
    trace("Number of bytes loaded: " + aLoader.bytesLoaded); 
}

  4. Seleccione Control > Probar película.