IFlexDisplayObject  - AS3 Flex

Las opciones de accesibilidad actuales para este objeto de visualización. Si modifica la propiedad accessibilityProperties o alguno de los campos contenidos en accessibilityProperties, deberá llamar al método Accessibility.updateProperties() para que los cambios surtan efecto.

Nota: en el caso de un objeto creado en el entorno de edición de Flash, el valor de accessibilityProperties se rellena previamente con la información que haya introducido en el panel Accesibilidad para dicho objeto.

Indica el valor de transparencia alfa del objeto especificado. Los valores válidos son los comprendidos entre 0 (totalmente transparente) y 1 (totalmente opaco). El valor predeterminado es 1. Los objetos de visualización que tienen alpha configurado con el valor 0 están activos, aunque no sean visibles.

Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse. Un mapa de bits puede dibujarse internamente de dos formas. Si tiene un modo de mezcla o una máscara de recorte externa, el mapa de bits se dibuja añadiendo una figura cuadrada rellena con un mapa de bits al procesador de vectores. Si intenta establecer esta propiedad con un valor no válido, los motores de ejecución de Flash establecerán el valor como BlendMode.NORMAL.

La propiedad blendMode afecta a cada píxel del objeto de visualización. Cada píxel consta de los tres colores primarios (rojo, verde y azul). Cada color primario tiene un valor comprendido entre 0x00 y 0xFF. Flash Player o Adobe AIR compara cada color primario de un píxel del clip de película con el color correspondiente del píxel en el fondo. Por ejemplo, si blendMode se define como BlendMode.LIGHTEN, Flash Player o Adobe AIR compara el valor de rojo del objeto de visualización con el valor de rojo del fondo y utiliza el color más claro de los dos como valor del componente rojo para el color de visualización.

La tabla siguiente describe los valores de blendMode: La clase BlendMode define los valores de cadena que puede utilizar. Las ilustraciones de la tabla muestran los valores blendMode aplicados a un objeto de visualización circular (2) superpuesto a otro objeto de visualización (1).

Constante BlendMode	Ilustración	Descripción
BlendMode.NORMAL		El objeto de visualización aparece delante del fondo. Los valores de píxel del objeto de visualización anulan a los del fondo. Cuando el objeto de visualización sea transparente, el fondo será visible.
BlendMode.LAYER		Fuerza la creación de un grupo de transparencia para el objeto de visualización. Esto significa que el objeto de visualización se compone previamente en un búfer temporal antes de proseguir su procesamiento. Esto se hace automáticamente si el objeto de visualización cuenta con un caché previo a través de caché de mapa de bits o si el objeto de visualización es un contenedor de objeto de visualización con al menos un objeto secundario que tenga una configuración de blendMode distinta de BlendMode.NORMAL. No se admite en procesamiento de GPU.
BlendMode.MULTIPLY		Multiplica los valores de los colores primarios del objeto de visualización por los del color del fondo y luego normaliza el resultado dividiéndolo por 0xFF, lo que da como resultado colores más oscuros. Este valor se suele utilizar para efectos de sombras y profundidad. Por ejemplo, si un color primario (como el rojo) de un píxel del objeto de visualización y el color correspondiente del píxel del fondo tienen ambos el valor 0x88, el resultado de la multiplicación será 0x4840. Al dividir por 0xFF el resultado es 0x48 para dicho color primario, consiguiéndose un tono más oscuro que el del objeto de visualización o el del fondo.
BlendMode.SCREEN		Multiplica el complemento (inverso) del color del objeto de visualización por el complemento del color de fondo, con lo que se obtiene un efecto de decoloración. Este valor se suele utilizar para los resaltados o para eliminar áreas de color negro del objeto de visualización.
BlendMode.LIGHTEN		Selecciona el color primario más claro del objeto de visualización y el color del fondo (los colores que tengan mayores valores). Este valor suele emplearse para el tipo de superposición. Por ejemplo, si el objeto de visualización tiene un píxel con un valor RGB de 0xFFCC33, y el píxel del fondo tiene un valor RGB de 0xDDF800, el valor RGB resultante para el píxel mostrado es de 0xFFF833 (debido a que 0xFF > 0xDD, 0xCC > 0xF8 y 0x33 > 0x00 = 33). No se admite en procesamiento de GPU.
BlendMode.DARKEN		Selecciona el color primario más oscuro del objeto de visualización y el color del fondo (los colores que tengan valores más bajos). Este valor suele emplearse para el tipo de superposición. Por ejemplo, si el objeto de visualización tiene un píxel con un valor RGB de 0xFFCC33, y el píxel del fondo tiene un valor RGB de 0xDDF800, el valor RGB resultante para el píxel mostrado es de 0xDDCC00 (debido a que 0xFF > 0xDD, 0xCC < 0xF8 y 0x33 > 0x00 = 33). No se admite en procesamiento de GPU.
BlendMode.DIFFERENCE		Compara los colores primarios del objeto de visualización con los del fondo y resta el valor más oscuro del valor más claro de los colores primarios. Este valor suele emplearse en los colores más vivos. Por ejemplo, si el objeto de visualización tiene un píxel con un valor RGB de 0xFFCC33, y el píxel del fondo tiene un valor RGB de 0xDDF800, el valor RGB resultante para el píxel mostrado es de 0x222C33 (debido a que 0xFF - 0xDD = 0x22, 0xF8 - 0xCC = 0x2C y 0x33 - 0x00 = 0x33).
BlendMode.ADD		Añade los valores de los colores primarios del objeto de visualización a los del fondo con un límite de 0xFF. Este valor suele emplearse para animar una disolución de aclarado entre dos objetos. Por ejemplo, si el objeto de visualización tiene un píxel con un valor RGB de 0xAAA633, y el píxel del fondo tiene un valor RGB de 0xDD2200, el valor RGB resultante para el píxel mostrado es de 0xFFC833 (debido a que 0xAA + 0xDD > 0xFF, 0xA6 + 0x22 = 0xC8 y 0x33 + 0x00 = 0x33).
BlendMode.SUBTRACT		Resta los valores de los colores primarios del objeto de visualización de los valores del color de fondo, aplicando un límite inferior de 0. Suele utilizarse para animar una disolución de oscurecimiento entre dos imágenes. Por ejemplo, si el objeto de visualización tiene un píxel con un valor RGB de 0xAA2233, y el píxel del fondo tiene un valor RGB de 0xDDA600, el valor RGB resultante para el píxel mostrado es de 0x338400 (debido a que 0xDD - 0xAA = 0x33, 0xA6 - 0x22 = 0x84 y 0x00 - 0x33 < 0x00).
BlendMode.INVERT		Invierte el fondo.
BlendMode.ALPHA		Aplica el valor alfa de cada píxel del objeto de visualización al fondo. Esto requiere que la configuración de blendMode del objeto de visualización principal se establezca como BlendMode.LAYER. Por ejemplo, en la ilustración, el objeto de visualización principal, un fondo blanco, tiene blendMode = BlendMode.LAYER. No se admite en procesamiento de GPU.
BlendMode.ERASE		Borra el fondo en función del valor alfa del objeto de visualización. Esto requiere que la configuración de blendMode del objeto de visualización principal se establezca como BlendMode.LAYER. Por ejemplo, en la ilustración, el objeto de visualización principal, un fondo blanco, tiene blendMode = BlendMode.LAYER. No se admite en procesamiento de GPU.
BlendMode.OVERLAY		Ajusta el color de cada píxel en función de la oscuridad del fondo. Si el fondo es más claro que un 50% de gris, los colores del objeto de visualización y del fondo se tamizan, consiguiéndose un color más claro. Si el fondo es más oscuro que un 50% de gris, los colores del clip de película y del fondo se multiplican, consiguiéndose un color más oscuro. Este valor suele emplearse para conseguir efectos de sombreado. No se admite en procesamiento de GPU.
BlendMode.HARDLIGHT		Ajusta el color de cada píxel en función de la oscuridad del objeto de visualización. Si el objeto de visualización es más claro que un 50% de gris, los colores del objeto de visualización y del fondo se tamizan, consiguiéndose un color más claro. Si el objeto de visualización es más oscuro que un 50% de gris, los colores del clip de película y del fondo se multiplican, consiguiéndose un color más oscuro. Este valor suele emplearse para conseguir efectos de sombreado. No se admite en procesamiento de GPU.
BlendMode.SHADER	N/D	Ajusta el color por medio de una rutina personalizada de sombreado. El sombreado que se utiliza se especifica como la instancia de Shader asignada a la propiedad blendShader. Establecer la propiedad blendShader de un objeto de visualización como una instancia de Shader define automáticamente la propiedad blendMode del objeto de visualización en BlendMode.SHADER. Si la propiedad blendMode se establece como BlendMode.SHADER sin definir primero la propiedad blendShader, la propiedad blendMode se establecerá como BlendMode.NORMAL. No se admite en procesamiento de GPU.

Si se define como true, los motores de ejecución de Flash guardan en caché una representación interna de mapa de bits del objeto de visualización. Este caché puede aumentar el rendimiento de los objetos de visualización que tienen contenido vectorial complejo.

Todos los datos vectoriales de un objeto de visualización con un mapa de bits en caché se dibujan en el mapa de bits, no en la visualización principal. Si cacheAsBitmapMatrix es null o no se admite, el mapa de bits se copia en la visualización principal como píxeles no expandidos ni rotados, pero ajustados a los límites del píxel más cercano. Los píxeles se asignan de 1 a 1 con el objeto principal. Si los límites del mapa de bits cambian, el mapa de bits se vuelve a crear en lugar de expandirse.

Si cacheAsBitmapMatrix no es null y se admite, el objeto se dibuja en el mapa de bits fuera de la pantalla con dicha matriz y los resultados estirados/girados de la representación se utilizan para dibujar el objeto en la pantalla principal.

No se crea ningún mapa de bits interno a menos que la propiedad cacheAsBitmap esté definida como true.

Después de definir la propiedad cacheAsBitmap como true, la representación no varía, pero el objeto de visualización realiza automáticamente el ajuste en píxeles. La velocidad de animación puede ser notablemente mayor según la complejidad del contenido vectorial.

La propiedad cacheAsBitmap se establece automáticamente en true siempre que se aplica un filtro a un objeto de visualización (cuando su conjunto filter no está vacía) y, si un objeto de visualización tiene aplicado un filtro, cacheAsBitmap será true para ese objeto de visualización, aunque la propiedad se haya configurado como false. Si borra todos los filtros de un objeto de visualización, la configuración de cacheAsBitmap cambia a su valor anterior.

Un objeto de visualización no utiliza un mapa de bits aunque la propiedad cacheAsBitmap se haya definido como true, sino que se representa a partir de datos vectoriales en los siguientes casos:

• El mapa de bits es demasiado grande. En AIR 1.5 y en Flash Player 10, el tamaño máximo de una imagen de mapa de bits es 8.191 píxeles de anchura o de altura, y el número total de píxeles no puede superar los 16.777.215. (De modo que si una imagen de mapa de bits tiene una anchura de 8.191 píxeles, puede tener una altura máxima de 2.048.) En Flash Player 9 y en versiones anteriores, la limitación es de 2.880 píxeles de altura y 2.880 de anchura.
• El mapa de bits no puede asignarse (error de memoria insuficiente).

La propiedad cacheAsBitmap es idónea con clips de película que tienen sobre todo contenido estático y no cambian de escala ni giran con frecuencia. Con estos clips, cacheAsBitmap puede aumentar el rendimiento cuando se convierte el clip de película (cuando se modifica la posición de x e y).

Conjunto indexado que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización. El paquete flash.filters contiene varias clases que definen filtros específicos que puede utilizar.

Los filtros pueden aplicarse en tiempo de diseño en Flash Professional o en tiempo de ejecución mediante código ActionScript. Para aplicar un filtro con ActionScript, debe realizar una copia temporal de todo el conjunto filters, modificar el conjunto temporal y volver a asignar el valor del conjunto temporal al conjunto filters. Al conjunto filters no se le pueden añadir directamente objetos filter nuevos.

Para añadir un filtro con ActionScript, debe seguir estos pasos (suponiendo que el objeto de visualización de destino se denomina myDisplayObject):

1. Cree un nuevo objeto de filtro con el método constructor de la clase de filtro que haya elegido.
2. Asigne el valor del conjunto myDisplayObject.filters a un conjunto temporal, denominado por ejemplo myFilters.
3. Añada el nuevo objeto filter al conjunto temporal, myFilters.
4. Asigne el valor del conjunto temporal al conjunto myDisplayObject.filters.

Si el conjunto filters no está definida, no tendrá que utilizar un conjunto temporal. En lugar de ello, podrá asignar directamente un literal de conjunto que contenga uno o varios objetos filter que ha creado. El primer ejemplo de la sección Ejemplos añade un filtro de sombra mediante código que gestiona conjuntos filters tanto definidos como no definidos.

Para modificar un objeto de filtro existente, debe utilizar la técnica de modificación de una copia del conjunto filters:

1. Asigne el valor del conjunto filters a un conjunto temporal denominado, por ejemplo, myFilters.
2. Modifique la propiedad utilizando el conjunto temporal, myFilters. Por ejemplo, para establecer la propiedad quality del primer filtro del conjunto, podría utilizar el código siguiente: myFilters[0].quality = 1;
3. Asigne el valor del conjunto temporal al conjunto filters.

Durante la carga, si un objeto de visualización tiene un filtro asociado, se marca para guardarlo en caché como mapa de bits transparente. Desde ese momento, siempre y cuando el objeto de visualización tenga una lista de filtros válida, el reproductor guardará el objeto de visualización en caché como mapa de bits. Este mapa de bits de origen se utiliza como imagen de origen para los efectos de filtro. Normalmente, un objeto de visualización tiene dos mapas de bits: uno con el objeto de visualización de origen sin filtrar (original) y otro con la imagen final una vez filtrada. La imagen final es la que se utiliza en representaciones. Mientras el objeto de visualización no cambie, la imagen final no necesita actualización.

El paquete flash.filters incluye clases para filtros. Por ejemplo, para crear un filtro DropShadow, deberá escribir:

     import flash.filters.DropShadowFilter
     var myFilter:DropShadowFilter = new DropShadowFilter (distance, angle, color, alpha, blurX, blurY, quality, inner, knockout)
     

Puede utilizar el operador is para determinar el tipo de filtro asignado a cada posición de índice en el conjunto filter. Por ejemplo, el siguiente código muestra cómo determinar la posición del primer filtro del conjunto filters que es un filtro DropShadowFilter:

     import flash.text.TextField;
     import flash.filters.*;
     var tf:TextField = new TextField();
     var filter1:DropShadowFilter = new DropShadowFilter();
     var filter2:GradientGlowFilter = new GradientGlowFilter();
     tf.filters = [filter1, filter2];
     
     tf.text = "DropShadow index: " + filterPosition(tf, DropShadowFilter).toString(); // 0
     addChild(tf)
     
     function filterPosition(displayObject:DisplayObject, filterClass:Class):int {
         for (var i:uint = 0; i < displayObject.filters.length; i++) {
             if (displayObject.filters[i] is filterClass) {
                 return i;
             }
         }
         return -1;
     }
     

Nota: como no puede añadir directamente un nuevo objeto de filtro al conjuntoDisplayObject.filters, el siguiente código no afecta de ninguna manera al objeto de visualización de destino, denominado myDisplayObject:

     myDisplayObject.filters.push(myDropShadow);
     

Indica la altura del objeto de visualización, expresada en píxeles. La anchura se calcula según los límites del contenido del objeto de visualización. Cuando define la propiedad height, la propiedad scaleY se ajusta en consecuencia, tal y como se muestra en el siguiente código:

    var rect:Shape = new Shape();
    rect.graphics.beginFill(0xFF0000);
    rect.graphics.drawRect(0, 0, 100, 100);
    trace(rect.scaleY) // 1;
    rect.height = 200;
    trace(rect.scaleY) // 2;

Excepto en lo que respecta a los objetos TextField y Video, un objeto de visualización sin contenido (como un sprite vacío) tiene una altura de 0, incluso si intenta definir height en un valor diferente.

Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización. La propiedad loaderInfo sólo se define para el objeto de visualización raíz de un archivo SWF o para un mapa de bits cargado (no para un mapa de bits dibujado con ActionScript). Para encontrar el objeto loaderInfo asociado al archivo SWF que contiene un objeto de visualización llamado myDisplayObject, utilice myDisplayObject.root.loaderInfo.

Un archivo SWF grande puede controlar su descarga llamando a this.root.loaderInfo.addEventListener(Event.COMPLETE, func).

El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado. Para asegurarse de que el enmascaramiento funciona al aplicar escala al escenario, el objeto de visualización mask debe encontrarse en una parte activa de la lista de visualización. El objeto mask propiamente dicho no se dibuja. Establezca mask con el valor null para quitar la máscara.

Para permitir la aplicación de escala a un objeto de máscara, éste debe estar en la lista de visualización. Para poder arrastrar un objeto Sprite de máscara (llamando a su método startDrag()), éste debe encontrarse en la lista de visualización. Para llamar al método startDrag() para una sprite de máscara en un evento mouseDown distribuido por la sprite, establezca la propiedad buttonMode de la sprite con el valor true.

Cuando objetos de visualización se almacenan en caché estableciendo la propiedad cacheAsBitmap como true y la propiedad cacheAsBitmapMatrix como objeto Matrix, tanto la máscara como el objeto de visualización que se está enmascarando deberá formar parte de la misma mapa de bits en caché. Por consiguiente, si el objeto de visualización se almacena en la caché, la máscara debe ser un elemento secundario del objeto de visualización. Si un antecesor del objeto de visualización de la lista está en caché, la máscara debe ser un elemento secundario de dicho antecesor o uno de sus descendientes. Si se almacena en caché más de un antecesor del objeto enmascarado, la máscara debe ser un descendiente de contenedor guardado en caché más cercano al objeto enmascarado en la lista de visualización.

Nota: no se puede utilizar un solo objeto mask para enmascarar más de un objeto de visualización de llamada. Cuando se asigna el objeto mask a un segundo objeto de visualización, se quita, ya que la máscara del primer objeto y la propiedad mask del objeto pasan a ser null.

The measured height of this object.

This is typically hard-coded for graphical skins because this number is simply the number of pixels in the graphic. For code skins, it can also be hard-coded if you expect to be drawn at a certain size. If your size can change based on properties, you may want to also be an ILayoutManagerClient so a measure() method will be called at an appropriate time, giving you an opportunity to compute a measuredHeight.

The measured width of this object.

This is typically hard-coded for graphical skins because this number is simply the number of pixels in the graphic. For code skins, it can also be hard-coded if you expect to be drawn at a certain size. If your size can change based on properties, you may want to also be an ILayoutManagerClient so a measure() method will be called at an appropriate time, giving you an opportunity to compute a measuredHeight.

Indica la coordenada x de la posición del ratón o del dispositivo de entrada del usuario, en píxeles.

Nota: en un objeto DisplayObject girado, la coordenada x devuelta reflejará el objeto sin girar.

Indica la coordenada y de la posición del ratón o del dispositivo de entrada del usuario, en píxeles.

Nota: en un objeto DisplayObject girado, la coordenada y devuelta reflejará el objeto sin girar.

Indica el nombre de instancia de DisplayObject. El objeto puede identificarse en la lista de elementos secundarios de su contenedor de objeto de visualización principal llamando al método getChildByName() del contenedor de objeto de visualización.

Especifica si el objeto de visualización es opaco con un determinado color de fondo. Un mapa de bits transparente contiene datos en el canal alfa y se dibuja de forma transparente. Un mapa de bits opaco no tiene canal alfa (por lo que se muestra más rápido que un mapa de bits transparente). Si el mapa de bits es opaco, deberá especificar el color de fondo.

Si se establece con un número como valor, la superficie será opaca (no transparente) y tendrá el color de fondo RGB que especifique el número. Si se establece con el valor null (el predeterminado), el objeto de visualización tendrá un fondo transparente.

La propiedad opaqueBackground está pensada principalmente para su uso con la propiedad cacheAsBitmap con el fin de optimizar la representación. En objetos de visualización en los que la propiedad cacheAsBitmap se ha establecido como true, la definición de opaqueBackground puede mejorar el rendimiento de la representación.

La región de fondo opaca no halla correspondencias al llamar al método hitTestPoint() con el parámetro shapeFlag definido en true.

La región de fondo opaca no responde a los eventos del ratón.

Indica el objeto DisplayObjectContainer que contiene este objeto de visualización. Utilice la propiedad parent para especificar una ruta de acceso relativa a los objetos de visualización que se encuentran por encima del objeto de visualización en la jerarquía de la lista de visualización.

Puede utilizar parent para subir múltiples niveles en la lista de visualización, como se muestra a continuación:

     this.parent.parent.alpha = 20;
     

Para un objeto de visualización en un archivo SWF cargado, la propiedadroot 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. Para un objeto Bitmap que representa a un archivo de imagen cargado, la propiedad root es el objeto Bitmap en sí mismo. Para la instancia de la clase principal del primer archivo SWF cargado, la propiedad root es el objeto de visualización en sí mismo. La propiedad root del objeto Stage es el objeto Stage en sí mismo. La propiedad root se establece con el valor null para los objetos de visualización que no se hayan añadido a la lista de visualización, a no ser que se hayan añadido a un contenedor de objeto de visualización que esté fuera de la lista de visualización pero que sea un elemento secundario del objeto de visualización de nivel más alto en un archivo SWF cargado.

Por ejemplo, si crea un nuevo objeto Sprite llamando al método constructor Sprite(), su propiedad root se establece con el valor null hasta que lo añada a la lista de visualización (o a un contenedor de objeto de visualización que esté fuera de la lista de visualización pero que sea un elemento secundario del objeto de visualización de nivel más alto en un archivo SWF).

Para un archivo SWF cargado, aunque el objeto Loader utilizado para cargar el archivo puede no estar en la lista de visualización, el objeto de visualización de nivel más alto en el archivo SWF tiene configurada la propiedad root como sí mismo. El objeto Loader no tiene la propiedad root configurada hasta que se añade como elemento secundario de un objeto de visualización para el que se ha establecido la propiedad root.

Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original. Los valores comprendidos entre 0 y 180 representan un giro en el sentido de las agujas del reloj, mientras que los comprendidos entre 0 y -180 representan un giro en sentido contrario al de las agujas del reloj. Los valores situados fuera de este rango se suman o restan de 360 para obtener un valor que sí esté comprendido en el rango. Por ejemplo, la sentencia my_video.rotation = 450 es igual que my_video.rotation = 90.

La cuadrícula de escala aplicada actualmente. Si se establece como null, la escala de todo el objeto de visualización se aplicará normalmente cuando se aplique cualquier transformación de escala.

Cuando se define la propiedad scale9Grid, el objeto de visualización se divide en una cuadrícula con nueve regiones, basadas en el rectángulo scale9Grid, que define la región central de la cuadrícula. Las otras ocho regiones de la cuadrícula son las siguientes áreas:

• La esquina superior izquierda fuera del rectángulo
• El área situada por encima del rectángulo
• La esquina superior derecha fuera del rectángulo
• El área a la izquierda del rectángulo
• El área a la derecha del rectángulo
• La esquina inferior izquierda fuera del rectángulo
• El área situada por debajo del rectángulo
• La esquina inferior derecha fuera del rectángulo

Puede considerar las ocho regiones externas al centro (que define el rectángulo) como si fueran el marco de un cuadro con reglas especiales cuando se le aplica escala.

Cuando se establece la propiedad scale9Grid y se aplica escala a un objeto de visualización, se aplica escala a todo el texto y los degradados normalmente. Sin embargo, se aplican las reglas siguientes a otros tipos de objetos:

• El contenido de la región central se escala normalmente.
• El contenido de las esquinas no se escala.
• El contenido de las regiones superior e inferior se escala sólo en horizontal. El contenido de las regiones izquierda y derecha se escala sólo en vertical.
• Todos los rellenos (incluidos mapas de bits, vídeo y degradados) se expanden para ajustarse a su forma.

Si se gira un objeto de visualización, todo el escalado posterior será normal (y se omitirá la propiedad scale9Grid).

Por ejemplo, imagine el siguiente objeto de visualización y un rectángulo que se aplica como propiedad scale9Grid del objeto de visualización:

El objeto de visualización.

El rectángulo rojo muestra la cuadrícula scale9Grid.

Cuando el objeto de visualización cambia la escala o se expande, los objetos del interior del rectángulo cambian de escala con normalidad, pero los objetos del exterior cambian de escala según las normas de scale9Grid:

Cambio de escala al 75%:
Cambio de escala al 50%:
Cambio de escala al 25%:
Expandido horizontalmente un 150%:

Normalmente, scale9Grid se define cuando se configura un objeto de visualización que se va a utilizar como componente en el que las zonas del borde conservan la misma anchura si el componente cambia de escala.

Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro. El punto de registro predeterminado es (0,0). 1.0 equivale al 100% de la escala.

La escala del sistema de coordenadas local afecta a los valores de las propiedades x e y, que se definen en píxeles completos.

Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto. El punto de registro predeterminado es (0,0). 1.0 equivale al 100% de la escala.

La escala del sistema de coordenadas local afecta a los valores de las propiedades x e y, que se definen en píxeles completos.

Los límites del rectángulo de desplazamiento del objeto de visualización. El objeto de visualización se recorta al tamaño definido por el rectángulo y se desplaza dentro del rectángulo al cambiar las propiedades x e y del objeto scrollRect.

Las propiedades del objeto Rectangle scrollRect utilizan el espacio de coordenadas del objeto de visualización y cambian de escala al igual que el resto del objeto de visualización. Los límites de esquina de la ventana recortada del objeto de visualización en desplazamiento son el origen del objeto de visualización (0,0) y el punto definido por la anchura y la altura del rectángulo. Estos no están centrados en torno al origen, sino que utilizan el origen para definir la esquina superior izquierda del área. Un objeto de visualización desplazado siempre se desplaza en incrementos de píxeles completos.

Puede desplazar un objeto a izquierda y a derecha estableciendo la propiedad x del objeto Rectangle scrollRect. Puede desplazar un objeto hacia arriba y hacia abajo estableciendo la propiedad y del objeto Rectangle scrollRect. Si el objeto de visualización se gira 90° y lo desplaza a izquierda y derecha, el objeto de visualización se desplazará realmente hacia arriba y hacia abajo.

Tenga en cuenta que los cambios en la propiedad scrollRect sólo se procesan cuando se representa el objeto. En consecuencia, los métodos como localToGlobal pueden no producir el resultado esperado si se les llama inmediatamente después de modificar scrollRect.

Nota: a partir de Flash Player 11.4 /AIR 3.4, los valores negativos para el ancho o el alto del rectángulo se han cambiado a 0.

El escenario del objeto de visualización. Una aplicación en tiempo de ejecución de Flash sólo tiene un objeto Stage. Por ejemplo, puede crear y cargar varios objetos de visualización en la lista de visualización y que la propiedad stage de cada objeto de visualización haga referencia al mismo objeto Stage (aunque el objeto de visualización pertenezca a un archivo SWF cargado).

Si un objeto de visualización no se añade a la lista de visualización, su propiedad stage se establece como null.

Objeto con propiedades pertenecientes a una matriz, transformación de color y límites de píxel de un objeto de visualización. Las propiedades específicas matrix, colorTransform y tres propiedades de sólo lectura (concatenatedMatrix, concatenatedColorTransform y pixelBounds) se describen en la entrada de la clase Transform.

Cada una de las propiedades del objeto transform es un objeto en sí. Este concepto es importante porque el único modo de definir nuevos valores para objetos matrix o colorTransform es crear un nuevo objeto y copiarlo en la propiedad transform.matrix o transform.colorTransform.

Por ejemplo, para aumentar el valor tx de la matriz de un objeto de visualización, debe realizar una copia del objeto de matriz completo y después copiar el objeto nuevo en la propiedad matrix del objeto transform:

    var myMatrix:Matrix = myDisplayObject.transform.matrix;  
    myMatrix.tx += 10; 
    myDisplayObject.transform.matrix = myMatrix;  
    

La propiedad tx no puede configurarse directamente. El código siguiente no tiene efecto en myDisplayObject:

    myDisplayObject.transform.matrix.tx += 10;
    

También puede copiar un objeto transform completo y asignarlo a la propiedad transform de otro objeto de visualización. Por ejemplo, el código siguiente copia el objeto transform completo de myOldDisplayObj a myNewDisplayObj:

El objeto de visualización resultante, myNewDisplayObj, tiene ahora los mismos valores de matriz, transformación de color y límites de píxel que el antiguo objeto de visualización, myOldDisplayObj.

Hay que tener en cuenta que los dispositivos de AIR para TV utilizan la aceleración de hardware, si está disponible, por transformaciones de color.

Indica si el objeto de visualización es visible. Los objetos de visualización que no son visibles se desactivan. Por ejemplo, si visible=false para una instancia de InteractiveObject, no es posible hacer clic en él.

Indica la anchura del objeto de visualización, expresada en píxeles. La anchura se calcula según los límites del contenido del objeto de visualización. Cuando define la propiedad width, la propiedad scaleX se ajusta en consecuencia, tal y como se muestra en el siguiente código:

    var rect:Shape = new Shape();
    rect.graphics.beginFill(0xFF0000);
    rect.graphics.drawRect(0, 0, 100, 100);
    trace(rect.scaleX) // 1;
    rect.width = 200;
    trace(rect.scaleX) // 2;

Excepto en lo que respecta a los objetos TextField y Video, un objeto de visualización sin contenido (como un sprite vacío) tiene una anchura de 0, incluso si intenta definir width en un valor diferente.

Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal. Si el objeto está dentro de un DisplayObjectContainer que incluye transformaciones, estará en el sistema de coordenadas local del DisplayObjectContainer en el que está contenido. Por consiguiente, en el caso de un DisplayObjectContainer con un giro de 90° en sentido contrario al de las agujas del reloj, los elementos secundarios de DisplayObjectContainer heredarán un sistema de coordenadas con un giro de 90° en sentido contrario al de las agujas del reloj. Las coordenadas del objeto hacen referencia a la posición del punto de registro.

Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal. Si el objeto está dentro de un DisplayObjectContainer que incluye transformaciones, estará en el sistema de coordenadas local del DisplayObjectContainer en el que está contenido. Por consiguiente, en el caso de un DisplayObjectContainer con un giro de 90° en sentido contrario al de las agujas del reloj, los elementos secundarios de DisplayObjectContainer heredarán un sistema de coordenadas con un giro de 90° en sentido contrario al de las agujas del reloj. Las coordenadas del objeto hacen referencia a la posición del punto de registro.

Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace. Observe el siguiente código, en el que se muestra cómo el rectángulo devuelto puede variar en función del parámetro targetCoordinateSpace que pase al método:

     var container:Sprite = new Sprite();
     container.x = 100;
     container.y = 100;
     this.addChild(container);
     var contents:Shape = new Shape();
     contents.graphics.drawCircle(0,0,100);
     container.addChild(contents);
     trace(contents.getBounds(container));
      // (x=-100, y=-100, w=200, h=200)
     trace(contents.getBounds(this));
      // (x=0, y=0, w=200, h=200)
     

Nota: utilice localToGlobal() y globalToLocal() para convertir las coordenadas locales del objeto de visualización en coordenadas de visualización, o las coordenadas de visualización en coordenadas locales, respectivamente.

El método getBounds() es similar al método getRect(); sin embargo, el rectángulo devuelto por el método getBounds() incluye los trazos en las formas, mientras que el rectángulo devuelto por getRect() no los incluye. Para ver un ejemplo, consulte la descripción del método getRect().

Parámetros

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. Los valores devueltos por el método getRect() son iguales o menores que los devueltos por el método getBounds().

Nota:utilice los métodos localToGlobal() y globalToLocal() para convertir las coordenadas locales del objeto de visualización en coordenadas de escenario o las coordenadas de escenario en coordenadas locales, respectivamente.

Parámetros

Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).

Para utilizar este método, cree primero una instancia de la clase Point. Los valores x e y que asigne representarán coordenadas globales, ya que se refieren al origen (0,0) del área de visualización principal. Seguidamente, pase la instancia de Point como parámetro al método globalToLocal(). El método devuelve un nuevo objeto Point con valores x e y relativos al origen del objeto de visualización, no al origen del escenario.

Parámetros

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.

Parámetros

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. Los parámetros x e y especifican un punto en el espacio de coordenadas del escenario, no el contenedor del objeto de visualización que contiene el objeto de visualización (a no ser que el contenedor del objeto de visualización sea el escenario).

Parámetros

Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).

Este método permite convertir unos valores cualesquiera de las coordenadas x e y de valores relativos al origen (0,0) de un objeto de visualización determinado (coordenadas locales) a valores relativos al origen del escenario (coordenadas globales).

Para utilizar este método, cree primero una instancia de la clase Point. Los valores x e y que asigne representarán coordenadas locales, ya que se refieren al origen del objeto de visualización.

Seguidamente, pase la instancia de Point que ha creado como parámetro al método localToGlobal(). El método devuelve un nuevo objeto Point con valores x e y relativos al origen del escenario en lugar de al origen del objeto de visualización.

Parámetros

Moves this object to the specified x and y coordinates.

Parámetros

Sets the actual size of this object.

This method is mainly for use in implementing the updateDisplayList() method, which is where you compute this object's actual size based on its explicit size, parent-relative (percent) size, and measured size. You then apply this actual size to the object by calling setActualSize().

In other situations, you should be setting properties such as width, height, percentWidth, or percentHeight rather than calling this method.

Parámetros