| Paquete | fl.core |
| Clase | public class UIComponent |
| Herencia | UIComponent  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Subclases | BaseButton, BaseScrollPane, ColorPicker, ComboBox, IndeterminateBar, Label, NumericStepper, ProgressBar, ScrollBar, Slider, TextArea, TextInput, UILoader |
| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
La tecla Tabulador y las teclas de flecha se pueden utilizar para mover la selección a un componente interactivo; un componente interactivo puede aceptar eventos de nivel bajo tales como las entradas del ratón y el teclado. Un componente interactivo también se puede desactivar para que no reciba las entradas del ratón y el teclado.
Propiedades públicas
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 | |
| 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 | |
| constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| 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 | |
| enabled : Boolean
Obtiene o define un valor que indica si el componente puede aceptar la interacción del usuario. | UIComponent | ||
| filters : Array
Conjunto indexado que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización. | DisplayObject | |
| focusEnabled : Boolean
Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él. | UIComponent | ||
| focusManager : IFocusManager
Obtiene o define la clase FocusManager que controla la selección de este componente y sus homólogos. | UIComponent | ||
| 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 | |
| height : Number [override]
Obtiene o define la altura del componente, expresada en píxeles. | UIComponent | ||
| hitArea : Sprite
Designa otro elemento sprite para que actúe como área activa de un elemento sprite. | Sprite | |
| 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 | |
| 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 | |
| mouseFocusEnabled : Boolean
Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él. | UIComponent | ||
| 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 | |
| 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 | |
| parent : DisplayObjectContainer [solo lectura]
Indica el objeto DisplayObjectContainer que contiene este objeto de visualización. | DisplayObject | |
| 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 | |
| scale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente. | DisplayObject | |
| scaleX : Number [override]
Multiplica la anchura actual del componente por un factor de escala. | UIComponent | ||
| scaleY : Number [override]
Multiplica la altura actual del componente por un factor de escala. | UIComponent | ||
| scaleZ : Number
Indica la escala de profundidad (porcentaje) de un objeto aplicada desde el punto de registro del objeto. | DisplayObject | |
| scrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización. | DisplayObject | |
| 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 | |
| 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 | |
| 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 | |
| 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 | |
| visible : Boolean [override]
Obtiene o define un valor que indica si la instancia del componente actual es visible. | UIComponent | ||
| width : Number [override]
Obtiene o define la anchura del componente, expresada en píxeles. | UIComponent | ||
| x : Number [override]
Obtiene o define la coordenada x que representa la posición del componente a lo largo del eje x en su contenedor principal. | UIComponent | ||
| y : Number [override]
Obtiene o define la coordenada y que representa la posición del componente a lo largo del eje y en su contenedor principal. | UIComponent | ||
| 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étodos públicos
| Método | Definido por | ||
|---|---|---|---|
Crea una nueva instancia del componente UIComponent. | UIComponent | ||
|
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 | |
Elimina una propiedad de estilo de esta instancia de componente. | UIComponent | ||
|
Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia. | DisplayObjectContainer | |
|
Distribuye un evento en el flujo del evento. | EventDispatcher | |
Muestra u oculta el indicador de selección en este componente. | UIComponent | ||
Inicia de forma inmediata una operación de dibujo, sin invalidarlo todo como ocurre con invalidateNow. | UIComponent | ||
|
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 | |
Recupera el objeto que está seleccionado actualmente. | UIComponent | ||
|
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 | |
Recupera una propiedad de estilo que se define en la cadena de búsqueda de estilo del componente. | UIComponent | ||
[estática]
Devuelve la asignación de estilos predeterminada del componente actual. | UIComponent | ||
|
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 | |
|
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 | |
Marca una propiedad como no válida y vuelve a dibujar el componente en el siguiente fotograma a menos que se especifique lo contrario. | UIComponent | ||
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
|
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 | |
[estática]
Combina los estilos de varias clases en un objeto. | UIComponent | ||
Mueve el componente a la posición especificada dentro de su elemento principal. | UIComponent | ||
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
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 | |
Selecciona este componente. | UIComponent | ||
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
Define el componente en la anchura y altura especificadas. | UIComponent | ||
Define una propiedad de estilo en esta instancia de componente. | UIComponent | ||
|
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 | |
Valida y actualiza las propiedades y el diseño de este objeto y lo vuelve a dibujar, si es necesario. | UIComponent | ||
|
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 | |
Métodos protegidos
| Método | Definido por | ||
|---|---|---|---|
Devuelve el estilo especificado para un componente; tiene en cuenta todos los estilos definidos en el nivel global, en el nivel de componentes y en el nivel de instancias. | UIComponent | ||
Eventos
| 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 | ||
| 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 | ||
| Se distribuye cuando la visibilidad del componente cambia de visible a invisible. | UIComponent | |||
| 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 | ||
| 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 | ||
| Se distribuye cuando se mueve el componente. | UIComponent | |||
| 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 se cambia el tamaño del componente. | UIComponent | |||
| 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 | ||
| 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 cuando la visibilidad del componente cambia de invisible a visible. | UIComponent | |||
| 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 | ||
Estilos
Los estilos son comunes o están asociados a un tema específico. Si el estilo es común, se puede utilizar con cualquier tema. Si un estilo está asociado a un tema específico, solo se puede utilizar si la aplicación usa dicho tema.
Estilos comunes
| Estilo | Descripción | Definido por | ||
|---|---|---|---|---|
disabledTextFormat | Tipo: flash.text.TextFormat Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El objeto TextFormat que se utilizará para representar la etiqueta del componente cuando el botón esté desactivado. El valor predeterminado es TextFormat("_sans", 11, 0x999999, false, false, false, '', '', TextFormatAlign.LEFT, 0, 0, 0, 0). | UIComponent | ||
focusRectPadding | Tipo: Number Formato: Length Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El relleno que separa los límites externos del componente de los bordes externos del indicador de selección, expresado en píxeles. El valor predeterminado es 2. | UIComponent | ||
focusRectSkin | Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El aspecto que se utilizará para mostrar los indicadores de selección. El valor predeterminado es focusRectSkin. | UIComponent | ||
textFormat | Tipo: flash.text.TextFormat Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El objeto TextFormat que se utilizará para representar la etiqueta del componente. El valor predeterminado es TextFormat("_sans", 11, 0x000000, false, false, false, '', '', TextFormatAlign.LEFT, 0, 0, 0, 0). | UIComponent | ||
Constantes públicas
| Constante | Definido por | ||
|---|---|---|---|
| version : String = "3.0.3.1"
Número de versión de los componentes. | UIComponent | ||
Información sobre propiedades
enabled | propiedad |
enabled:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Obtiene o define un valor que indica si el componente puede aceptar la interacción del usuario. Un valor true indica que el componente puede aceptar la interacción del usuario; un valor false indica que no puede aceptarla.
Si la propiedad enabled se define como false, el color del contenedor aparece atenuado y la entrada del usuario está bloqueada (con la excepción de los componentes Label y ProgressBar).
El valor predeterminado es true.
Implementación
public function get enabled():Boolean public function set enabled(value:Boolean):voidfocusEnabled | propiedad |
focusEnabled:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él. Un valor true indica que puede recibir selecciones; un valor false indica que no puede recibirlas.
Si esta propiedad es false, se transfiere la selección al primer elemento principal cuya propiedad mouseFocusEnabled se haya definido como true.
El valor predeterminado es true.
Implementación
public function get focusEnabled():Boolean public function set focusEnabled(value:Boolean):voidElementos de API relacionados
focusManager | propiedad |
focusManager:IFocusManager| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Obtiene o define la clase FocusManager que controla la selección de este componente y sus homólogos. Cada componente emergente mantiene su propio bucle de selección y su instancia de FocusManager. Utilice esta propiedad para acceder a la instancia de FocusManager correcta para este componente.
Implementación
public function get focusManager():IFocusManager public function set focusManager(value:IFocusManager):voidheight | propiedad |
height:Number[override] | Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Obtiene o define la altura del componente, expresada en píxeles.
La definición de esta propiedad provoca que se distribuya un evento resize. Consulte el evento resize para obtener información detallada sobre cuándo se distribuirá.
Si la propiedad scaleY del componente no es 1.0, la altura del componente que se obtiene de sus coordenadas internas no coincidirá con el valor de altura de las coordenadas principales. Por ejemplo, un componente que tiene 100 píxeles de altura y una propiedad scaleY de 2, tiene un valor de 100 píxeles en la coordenada principal, aunque internamente almacena un valor que indica que su altura es de 50 píxeles.
Implementación
override public function get height():Number override public function set height(value:Number):voidmouseFocusEnabled | propiedad |
mouseFocusEnabled:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él. Un valor true indica que puede recibir selecciones; un valor false indica que no puede recibirlas.
Si esta propiedad es false, se transfiere la selección al primer elemento principal cuya propiedad mouseFocusEnabled se haya definido como true.
El valor predeterminado es true.
Implementación
public function get mouseFocusEnabled():Boolean public function set mouseFocusEnabled(value:Boolean):voidElementos de API relacionados
scaleX | propiedad |
scaleX:Number[override] | Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Multiplica la anchura actual del componente por un factor de escala.
Implementación
override public function get scaleX():Number override public function set scaleX(value:Number):voidElementos de API relacionados
scaleY | propiedad |
scaleY:Number[override] | Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Multiplica la altura actual del componente por un factor de escala.
Implementación
override public function get scaleY():Number override public function set scaleY(value:Number):voidElementos de API relacionados
visible | propiedad |
visible:Boolean[override] | Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Obtiene o define un valor que indica si la instancia del componente actual es visible. Un valor true indica que el componente actual es visible; un valor false indica que no lo es.
Cuando esta propiedad se define como true, el objeto distribuye un evento show. Cuando esta propiedad se define como false, el objeto distribuye un evento hide. En ambos casos, los elementos secundarios del objeto no generan un evento show o hide a menos que el objeto escriba específicamente una implementación para hacerlo.
El valor predeterminado es true.
Implementación
override public function get visible():Boolean override public function set visible(value:Boolean):voidElementos de API relacionados
width | propiedad |
width:Number[override] | Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Obtiene o define la anchura del componente, expresada en píxeles.
La definición de esta propiedad provoca que se distribuya un evento resize. Consulte el evento resize para obtener información detallada sobre cuándo se distribuirá.
Si la propiedad scaleX del componente no es 1.0, la anchura del componente que se obtiene de sus coordenadas internas no coincidirá con el valor de anchura de las coordenadas principales. Por ejemplo, un componente que tiene 100 píxeles de anchura y una propiedad scaleX de 2, tiene un valor de 100 píxeles en la coordenada principal, aunque internamente almacena un valor que indica que su anchura es de 50 píxeles.
Implementación
override public function get width():Number override public function set width(value:Number):voidElementos de API relacionados
x | propiedad |
x:Number[override] | Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Obtiene o define la coordenada x que representa la posición del componente a lo largo del eje x en su contenedor principal. Este valor se describe en píxeles y se calcula desde la izquierda.
La definición de esta propiedad provoca que se distribuya el evento ComponentEvent.MOVE.
El valor predeterminado es 0.
Implementación
override public function get x():Number override public function set x(value:Number):voidElementos de API relacionados
y | propiedad |
y:Number[override] | Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Obtiene o define la coordenada y que representa la posición del componente a lo largo del eje y en su contenedor principal. Este valor se describe en píxeles y se calcula desde la parte superior.
La definición de esta propiedad provoca que se distribuya el evento move.
Implementación
override public function get y():Number override public function set y(value:Number):voidElementos de API relacionados
Información sobre constructores
UIComponent | () | Información sobre |
public function UIComponent()| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Crea una nueva instancia del componente UIComponent.
Información sobre métodos
clearStyle | () | método |
public function clearStyle(style:String):void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Elimina una propiedad de estilo de esta instancia de componente.
No provoca necesariamente que el método getStyle() devuelva un valor undefined.
Parámetros
style:String — Nombre de la propiedad de estilo.
|
Elementos de API relacionados
drawFocus | () | método |
public function drawFocus(focused:Boolean):void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Muestra u oculta el indicador de selección en este componente.
La clase UIComponent implementa este método mediante la creación y posición de una instancia de la clase que se especifica mediante el estilo focusSkin.
Parámetros
focused:Boolean — Especifica si se muestra o se oculta el indicador de selección. Si este valor es true, se mostrará el indicador de selección; si el valor es false, quedará oculto.
|
drawNow | () | método |
public function drawNow():void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Inicia de forma inmediata una operación de dibujo, sin invalidarlo todo como ocurre con invalidateNow.
getFocus | () | método |
public function getFocus():InteractiveObject| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Recupera el objeto que está seleccionado actualmente.
Observe que este método no devuelve necesariamente el componente que está seleccionado. Puede devolver el subcomponente interno del componente seleccionado. Para obtener el componente que está seleccionado, utilice la propiedad focusManager.focus.
InteractiveObject — El objeto que está seleccionado; de lo contrario, este método devuelve null.
|
getStyle | () | método |
public function getStyle(style:String):Object| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Recupera una propiedad de estilo que se define en la cadena de búsqueda de estilo del componente.
El tipo que este método devuelve varía según la propiedad de estilo que dicho método recupere. En el rango de tipos posibles se incluyen Boolean; String; Number; int; un uint para un color RGB; un tipo Class para un aspecto o cualquier objeto.
Si llama a este método para recuperar una propiedad de estilo específica, ésta será de un tipo conocido que puede almacenar en una variable del mismo tipo. No es necesaria una conversión del tipo. En lugar de ello, bastará con una sentencia de asignación sencilla como la siguiente:
var backgroundColor:uint = getStyle("backgroundColor");Si la propiedad de estilo no se ha definido en la cadena de búsqueda de estilo, este método devolverá un valor undefined. Observe que undefined es un valor especial distinto a false, "", NaN, 0 o null. undefined no es un valor de estilo válido. Puede utilizar el método estático StyleManager.isValidStyleValue() para comprobar si se ha definido un valor.
Parámetros
style:String — Nombre de la propiedad de estilo.
|
Object — Valor de estilo.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea una instancia del componente DataGrid y se muestran los estilos predeterminados y actuales para un componente ComboBox:
import fl.controls.ComboBox;
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
var myComboBox:ComboBox = new ComboBox();
myComboBox.setStyle("textPadding", 6);
myComboBox.setStyle("disabledAlpha", 0.8);
var styleObject:Object = ComboBox.getStyleDefinition();
var styleDP:DataProvider = new DataProvider();
var styleName:String;
var styleDefaultValue:String;
var styleCurrentValue:String;
for (styleName in styleObject) {
styleDefaultValue = String(styleObject[styleName]);
styleCurrentValue = String(myComboBox.getStyle(styleName));
styleDP.addItem({name:styleName, defaultValue:styleDefaultValue, currentValue:styleCurrentValue});
}
styleDP.sortOn("name", Array.CASEINSENSITIVE);
var c1:DataGridColumn = new DataGridColumn("name");
c1.headerText = "Style name:";
var c2:DataGridColumn = new DataGridColumn("defaultValue");
c2.headerText = "Default style value:";
var c3:DataGridColumn = new DataGridColumn("currentValue");
c3.headerText = "Current style value:"
var styleDataGrid:DataGrid = new DataGrid();
styleDataGrid.addColumn(c1); // name
styleDataGrid.addColumn(c2); // defaultValue
styleDataGrid.addColumn(c3); // currentValue
styleDataGrid.dataProvider = styleDP;
styleDataGrid.setSize(stage.stageWidth - 20, stage.stageHeight - 20);
styleDataGrid.move(10, 10);
addChild(styleDataGrid);
getStyleDefinition | () | método |
public static function getStyleDefinition():Object| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Devuelve la asignación de estilos predeterminada del componente actual. La asignación de estilos contiene el tipo adecuado para el componente, en función del estilo que ese componente utilice. Por ejemplo, el estilo disabledTextFormat contiene un valor null o un objeto TextFormat. Puede utilizar estos estilos y llamar a setStyle() en el componente actual. El código siguiente sustituye el estilo predeterminado disabledTextFormat en el componente especificado:
componentInstance.setStyle("disabledTextFormat", new TextFormat());Object — Objeto de estilos predeterminados.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea un navegador de estilos para varias clases de componentes:
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;
var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } );
dp.addItem( { label: "Button", data:Button } );
dp.addItem( { label: "CellRenderer", data:CellRenderer } );
dp.addItem( { label: "CheckBox", data:CheckBox } );
dp.addItem( { label: "ColorPicker", data:ColorPicker } );
dp.addItem( { label: "ComboBox", data:ComboBox } );
dp.addItem( { label: "DataGrid", data:DataGrid } );
dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } );
dp.addItem( { label: "ImageCell", data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label", data:Label } );
dp.addItem( { label: "List", data:List } );
dp.addItem( { label: "NumericStepper", data:NumericStepper } );
dp.addItem( { label: "ProgressBar", data:ProgressBar } );
dp.addItem( { label: "RadioButton", data:RadioButton } );
dp.addItem( { label: "ScrollPane", data:ScrollPane } );
dp.addItem( { label: "Slider", data:Slider } );
dp.addItem( { label: "TextArea", data:TextArea } );
dp.addItem( { label: "TextInput", data:TextInput } );
dp.addItem( { label: "TileList", data:TileList } );
dp.addItem( { label: "UILoader", data:UILoader } );
dp.addItem( { label: "UIComponent", data:UIComponent } );
var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);
var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);
function showStyleDefinition(e:Event):void {
var componentClass:Class = e.target.selectedItem.data as Class;
var styles:Object = componentClass["getStyleDefinition"].call(this);
trace(styles.toString());
var styleData:DataProvider = new DataProvider();
for(var i:* in styles) {
trace(i + " : " + styles[i]);
styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
}
styleData.sortOn("StyleName");
dg.dataProvider = styleData;
}
getStyleValue | () | método |
protected function getStyleValue(name:String):Object| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Devuelve el estilo especificado para un componente; tiene en cuenta todos los estilos definidos en el nivel global, en el nivel de componentes y en el nivel de instancias.
Por ejemplo, si un componente tiene un conjunto de estilos en el nivel global establecidos como myStyle y se llama a getStyle("myStyle") en una instancia que no tenga ningún ajuste de instancia, devuelve null. Si llama a getStyleValue("myStyle"), devuelve "myStyle", ya que está activo en el nivel global.
Parámetros
name:String |
Object |
invalidate | () | método |
public function invalidate(property:String, callLater:Boolean = true):void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Marca una propiedad como no válida y vuelve a dibujar el componente en el siguiente fotograma a menos que se especifique lo contrario.
Parámetros
property:String (default = NaN) | |
callLater:Boolean (default = true)true.
|
mergeStyles | () | método |
public static function mergeStyles(... list):Object| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Combina los estilos de varias clases en un objeto. Si un estilo se define en varios objetos, se utilizará el primero de ellos que se encuentre.
Parámetros
... list — Lista de objetos separados por comas que contienen los estilos predeterminados que se van a combinar.
|
Object — Objeto de estilo predeterminado que contiene los estilos combinados.
|
move | () | método |
public function move(x:Number, y:Number):void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Mueve el componente a la posición especificada dentro de su elemento principal. Esto produce el mismo efecto que si se cambiara la ubicación del componente mediante la definición de sus propiedades x e y. La llamada a este método desencadena el evento ComponentEvent.MOVE que se distribuirá.
Para sustituir el método updateDisplayList() en un componente personalizado, utilice el método move() en lugar de definir las propiedades x e y, ya que una llamada al método move() provoca que un objeto de evento move se distribuya inmediatamente después de que finalice la operación de movimiento. En cambio, cuando se cambia la ubicación del componente mediante la definición de las propiedades x e y, el objeto de evento se distribuye en la siguiente actualización de pantalla.
Parámetros
x:Number — Valor de la coordenada x que especifica la posición del componente dentro de su elemento principal, expresado en píxeles. Este valor se calcula desde la izquierda.
| |
y:Number — Valor de la coordenada y que especifica la posición del componente dentro de su elemento principal, expresado en píxeles. Este valor se calcula desde la parte superior.
|
Elementos de API relacionados
setFocus | () | método |
public function setFocus():void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Selecciona este componente. A su vez, el componente puede asignar la selección a un subcomponente.
Nota: sólo los componentes TextInput y TextArea muestran un indicador de selección cuando este método realiza la selección. Todos los componentes muestran un indicador de selección cuando el usuario usa el tabulador para acceder al componente.
setSize | () | método |
public function setSize(width:Number, height:Number):void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Define el componente en la anchura y altura especificadas.
Parámetros
width:Number — Anchura del componente, en píxeles.
| |
height:Number — Altura del componente, en píxeles.
|
setStyle | () | método |
public function setStyle(style:String, value:Object):void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Define una propiedad de estilo en esta instancia de componente. Este estilo puede sustituir a otro que se definió de forma global.
La llamada a este método puede producir una reducción en el rendimiento. Utilícelo sólo cuando sea necesario.
Parámetros
style:String — Nombre de la propiedad de estilo.
| |
value:Object — Valor del estilo.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se define un botón para que utilice la fuente Georgia:
import fl.controls.Button;
var myFormat:TextFormat = new TextFormat();
myFormat.font = "Georgia";
var b:Button = new Button();
b.label = "Hello World";
b.setStyle("textFormat", myFormat);
addChild(b);
En el ejemplo siguiente, se crea una instancia del componente Button y se carga dinámicamente una imagen de icono externa:
import fl.controls.Button;
var flashIcon:Loader = new Loader();
flashIcon.contentLoaderInfo.addEventListener(Event.COMPLETE, completeHandler);
flashIcon.load(new URLRequest("http://www.helpexamples.com/flash/images/logo.png"));
var myButton:Button = new Button();
myButton.label = "Flash";
myButton.move(10, 10);
addChild(myButton);
function completeHandler(event:Event):void {
flashIcon.width = 16;
flashIcon.height = 16;
myButton.setStyle("icon", flashIcon);
}
validateNow | () | método |
public function validateNow():void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Valida y actualiza las propiedades y el diseño de este objeto y lo vuelve a dibujar, si es necesario.
Las propiedades que requieren una computación sustancial normalmente no se procesan hasta que se termina de ejecutar el script. Esto se debe a que para la definición de una propiedad se podría requerir el procesamiento de otras propiedades. Por ejemplo, para definir la propiedad width puede que sea necesario volver a calcular las anchuras de los elementos secundarios o principales del objeto. Y si el script vuelve a calcular la anchura del objeto más de una vez, es posible que también se deban volver a calcular estas propiedades interdependientes. Utilice este método para sustituir manualmente este comportamiento.
Información sobre eventos
hide | Evento |
Tipo de objeto de evento:
propiedad ComponentEvent.type =
Ejemplo ( Cómo utilizar este ejemplo )
fl.events.ComponentEventpropiedad ComponentEvent.type =
fl.events.ComponentEvent.HIDE| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Se distribuye cuando la visibilidad del componente cambia de visible a invisible.
Define el valor de la propiedadtype para un objeto de evento hide.
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 | Error que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento. |
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea un componente Button que activa la visibilidad de un componente List:
import fl.controls.Button;
import fl.controls.List;
import fl.events.ComponentEvent;
import fl.events.ListEvent;
var toggleButton:Button = new Button();
toggleButton.label = "toggle visibility";
toggleButton.toggle = true;
toggleButton.selected = true;
toggleButton.emphasized = toggleButton.selected;
toggleButton.addEventListener(Event.CHANGE, changeHandler);
toggleButton.width = 150;
toggleButton.move(10, 10);
addChild(toggleButton);
var myList:List = new List();
myList.addItem({label:"Item 1"});
myList.addItem({label:"Item 2"});
myList.addItem({label:"Item 3"});
myList.addItem({label:"Item 4"});
myList.addItem({label:"Item 5"});
myList.move(10, 40);
myList.addEventListener(ComponentEvent.HIDE, hideHandler);
myList.addEventListener(ComponentEvent.SHOW, showHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
addChild(myList);
function changeHandler(event:Event):void {
toggleButton.emphasized = toggleButton.selected;
myList.visible = toggleButton.selected;
}
function hideHandler(event:ComponentEvent):void {
trace("hiding list");
myList.removeEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myList.removeEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
}
function showHandler(event:ComponentEvent):void {
trace("showing list");
myList.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
}
function itemRollOverHandler(event:ListEvent):void {
trace(event.type + ":", event.item.label);
}
function itemRollOutHandler(event:ListEvent):void {
trace(event.type + ":", event.item.label);
}
Elementos de API relacionados
move | Evento |
Tipo de objeto de evento:
propiedad ComponentEvent.type =
Ejemplo ( Cómo utilizar este ejemplo )
fl.events.ComponentEventpropiedad ComponentEvent.type =
fl.events.ComponentEvent.MOVE| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Se distribuye cuando se mueve el componente.
Define el valor de la propiedadtype para un objeto de evento move.
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 | Error que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento. |
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se cambia de posición una instancia del componente UILoader en el escenario en función del valor de un componente Slider:
import fl.controls.Slider;
import fl.containers.UILoader;
import fl.events.ComponentEvent;
import fl.events.SliderEvent;
var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.move(10, 20);
myUILoader.addEventListener(ComponentEvent.MOVE, moveHandler);
addChild(myUILoader);
var mySlider:Slider = new Slider();
mySlider.liveDragging = true;
mySlider.minimum = myUILoader.x;
mySlider.maximum = myUILoader.x + 200;
mySlider.snapInterval = 1;
mySlider.tickInterval = 10;
mySlider.move(10, 10);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);
function changeHandler(event:SliderEvent):void {
myUILoader.x = event.value;
}
function moveHandler(event:ComponentEvent):void {
trace("[move] x:" + event.currentTarget.x + ", y:" + event.currentTarget.y);
}
resize | Evento |
Tipo de objeto de evento:
propiedad ComponentEvent.type =
Ejemplo ( Cómo utilizar este ejemplo )
fl.events.ComponentEventpropiedad ComponentEvent.type =
fl.events.ComponentEvent.RESIZE| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Se distribuye cuando se cambia el tamaño del componente.
Define el valor de la propiedadtype de un objeto de evento resize.
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 | Error que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento. |
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se carga una imagen externa en una instancia del componente UILoader y se centra en el escenario con el evento
resize y el método move():
import fl.containers.UILoader;
import fl.events.ComponentEvent;
var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.addEventListener(ComponentEvent.RESIZE, resizeHandler);
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
addChild(myUILoader);
function resizeHandler(event:ComponentEvent):void {
var myImg:UILoader = event.currentTarget as UILoader;
var newX:uint = (stage.stageWidth - myImg.width) / 2;
var newY:uint = (stage.stageHeight - myImg.height) / 2;
myImg.move(newX, newY);
}
show | Evento |
Tipo de objeto de evento:
propiedad ComponentEvent.type =
Ejemplo ( Cómo utilizar este ejemplo )
fl.events.ComponentEventpropiedad ComponentEvent.type =
fl.events.ComponentEvent.SHOW| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Se distribuye cuando la visibilidad del componente cambia de invisible a visible.
Define el valor de la propiedadtype para un objeto de evento show.
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 | Error que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento. |
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea un componente Button que activa la visibilidad de un componente List:
import fl.controls.Button;
import fl.controls.List;
import fl.events.ComponentEvent;
import fl.events.ListEvent;
var toggleButton:Button = new Button();
toggleButton.label = "toggle visibility";
toggleButton.toggle = true;
toggleButton.selected = true;
toggleButton.emphasized = toggleButton.selected;
toggleButton.addEventListener(Event.CHANGE, changeHandler);
toggleButton.width = 150;
toggleButton.move(10, 10);
addChild(toggleButton);
var myList:List = new List();
myList.addItem({label:"Item 1"});
myList.addItem({label:"Item 2"});
myList.addItem({label:"Item 3"});
myList.addItem({label:"Item 4"});
myList.addItem({label:"Item 5"});
myList.move(10, 40);
myList.addEventListener(ComponentEvent.HIDE, hideHandler);
myList.addEventListener(ComponentEvent.SHOW, showHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
addChild(myList);
function changeHandler(event:Event):void {
toggleButton.emphasized = toggleButton.selected;
myList.visible = toggleButton.selected;
}
function hideHandler(event:ComponentEvent):void {
trace("hiding list");
myList.removeEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myList.removeEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
}
function showHandler(event:ComponentEvent):void {
trace("showing list");
myList.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
}
function itemRollOverHandler(event:ListEvent):void {
trace(event.type + ":", event.item.label);
}
function itemRollOutHandler(event:ListEvent):void {
trace(event.type + ":", event.item.label);
}
Elementos de API relacionados
Información sobre constantes
version | Constante |
public const version:String = "3.0.3.1"| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flash CS3 |
| Versiones de motor de ejecución: | Flash Player 9.0.28.0, AIR 1.0 |
Número de versión de los componentes.
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se obtiene el número de versión de la instancia del componente CheckBox:
import fl.controls.CheckBox; var myCheckBox:CheckBox = new CheckBox(); trace(myCheckBox.version);
Tue Jun 12 2018, 02:12 PM Z