| Paquete | fl.controls |
| Clase | public class Label |
| Herencia | Label  UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher 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 |
La previsualización dinámica de cada instancia de Label refleja los cambios de parámetros realizados durante la edición en el inspector de propiedades o componentes. Debido a que los componentes Label no tienen bordes, el único modo de ver la previsualización dinámica de una instancia Label es definir la propiedad text. La propiedad autoSize no se admite en la previsualización dinámica.
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 | |
| autoSize : String
Obtiene o define una cadena que indica cómo cambia de tamaño y se alinea una etiqueta para que encaje el valor de su propiedad text. | Label | ||
| 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 | |
| condenseWhite : Boolean
Obtiene o define un valor que indica si se deben eliminar espacios en blanco adicionales como, por ejemplo, espacios y saltos de línea, de un componente Label con texto HTML. | Label | ||
| 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. | Label | ||
| hitArea : Sprite
Designa otro elemento sprite para que actúe como área activa de un elemento sprite. | Sprite | |
| htmlText : String
Obtiene o define el texto mostrado por el componente Label, incluido el lenguaje de marcado HTML que indica los estilos del texto. | Label | ||
| 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 | |
| selectable : Boolean
Obtiene o define un valor que indica si el texto se puede seleccionar. | Label | ||
| 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 | |
| text : String
Obtiene o define el texto sin formato que mostrará el componente Label. | Label | ||
| textField : flash.text:TextField
Referencia al campo de texto interno del componente Label. | Label | ||
| 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. | Label | ||
| wordWrap : Boolean
Obtiene o define un valor que indica si el campo de texto admite ajuste de texto. | Label | ||
| 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 | ||
|---|---|---|---|
Label()
Crea una instancia de componente Label nueva. | Label | ||
|
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. | Label | ||
|
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
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 tras un cambio de altura o anchura del componente. | Label | |||
| 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 | ||
|---|---|---|---|---|
| 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. | UIComponent | ||
embedFonts | Tipo: Boolean 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 Indica si se utilizan contornos de fuentes incorporadas para representar el campo de texto. Si este valor es true, Flash Player representa el campo de texto utilizando contornos de fuentes incorporados. Si es false, Flash Player representa el campo de texto mediante fuentes del dispositivo.
Si define la propiedad false. | Label | ||
| 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. | UIComponent | ||
| 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. | UIComponent | ||
| 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. | UIComponent | ||
Constantes públicas
Información sobre propiedades
autoSize | propiedad |
autoSize:String| 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 una cadena que indica cómo cambia de tamaño y se alinea una etiqueta para que encaje el valor de su propiedad text. Los valores siguientes son válidos:
TextFieldAutoSize.NONE: la etiqueta no cambia de tamaño ni se alinea para que encaje el texto.TextFieldAutoSize.LEFT: los lados derecho e inferior de la etiqueta cambian de tamaño para que encaje el texto. Los lados izquierdo y superior no cambian de tamaño.TextFieldAutoSize.CENTER: los lados izquierdo y derecho de la etiqueta cambian de tamaño para que encaje el texto. El centro horizontal de la etiqueta permanece fijo en su posición central horizontal original.TextFieldAutoSize.RIGHT: los lados izquierdo e inferior de la etiqueta cambian de tamaño para que encaje el texto. Los lados superior y derecho no cambian de tamaño.
El valor predeterminado es TextFieldAutoSize.NONE.
Implementación
public function get autoSize():String public function set autoSize(value:String):voidElementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el siguiente ejemplo, se muestra la diferencia entre establecer autoSize a la izquierda, centro o derecha:
import flash.text.TextFieldAutoSize; import fl.controls.Label; var testString:String = "Lorem ipsum dolor sit amet."; var label1:Label = new Label(); var label2:Label = new Label(); var label3:Label = new Label(); label1.move(10,10); label2.move(10,50); label3.move(10,90); label1.width = stage.stageWidth - 20; label2.width = stage.stageWidth - 20; label3.width = stage.stageWidth - 20; label1.text = testString; label2.text = testString; label3.text = testString; label1.autoSize = TextFieldAutoSize.LEFT; label2.autoSize = TextFieldAutoSize.CENTER; label3.autoSize = TextFieldAutoSize.RIGHT; addChild(label1); addChild(label2); addChild(label3);
condenseWhite | propiedad |
condenseWhite: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 se deben eliminar espacios en blanco adicionales como, por ejemplo, espacios y saltos de línea, de un componente Label con texto HTML. true indica que el espacio en blanco se va a eliminar; false determina lo contrario.
La propiedad condenseWhite sólo afecta al texto definido con htmlText, no con la propiedad text. Si utiliza la propiedad text para definir texto, condenseWhite se omitirá.
Si establece la propiedad condenseWhite como true, debe utilizar comandos HTML estándar, como <br> y <p>, para incluir saltos de línea en el campo de texto.
El valor predeterminado es false.
Implementación
public function get condenseWhite():Boolean public function set condenseWhite(value:Boolean):voidElementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se muestra la diferencia entre una etiqueta que condensa los espacios en blanco y otra que no:
import fl.controls.Label; var testString:String = " Hello World"; var label1:Label = new Label(); label1.move(10,10); label1.htmlText = testString; addChild(label1); var label2:Label = new Label(); label2.move(10,40); label2.condenseWhite = true; label2.htmlText = testString; addChild(label2);
height | 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):voidElementos de API relacionados
htmlText | propiedad |
htmlText:String| 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 el texto mostrado por el componente Label, incluido el lenguaje de marcado HTML que indica los estilos del texto. Puede especificar texto HTML en esta propiedad con el subconjunto de etiquetas HTML admitido por el objeto TextField.
Si el valor predeterminado de la propiedad text cambia en el inspector de propiedades, este valor modificado tiene prioridad sobre cualquier valor de la propiedad htmlText en el inspector. Para utilizar la propiedad htmlText en el inspector de propiedades, el campo de la propiedad text debe incluir el valor Label, exactamente como se muestra. Cuando se codifica con ActionScript, no es necesario establecer el valor de la propiedad text; el valor predeterminado es Label.
El valor predeterminado es "".
Implementación
public function get htmlText():String public function set htmlText(value:String):voidElementos de API relacionados
selectable | propiedad |
selectable: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 texto se puede seleccionar. El valor true determina que se puede seleccionar; false indica lo contrario.
El texto que el usuario puede seleccionar, se puede copiar desde el componente Label.
El valor predeterminado es false.
Implementación
public function get selectable():Boolean public function set selectable(value:Boolean):voidtext | propiedad |
text:String| 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 el texto sin formato que mostrará el componente Label.
Tenga en cuenta que los caracteres que representan marcado HTML no tienen formato especial en la cadena y se muestran tal y como se introducen.
Para mostrar texto que incluya etiquetas HTML, utilice la propiedad htmlText. HTML sustituirá todo el texto definido con la propiedad htmlText y text devolverá una versión sin formato del texto HTML con todas las etiquetas HTML eliminadas.
Si text cambia a partir del valor predeterminado en el inspector de propiedades, tiene prioridad sobre la propiedad htmlText en el inspector.
El valor predeterminado es "Label".
Implementación
public function get text():String public function set text(value:String):voidElementos de API relacionados
textField | propiedad |
public var textField:flash.text:TextField| 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 |
Referencia al campo de texto interno del componente Label.
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
wordWrap | propiedad |
wordWrap: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 campo de texto admite ajuste de texto. true determina que así es; false indica lo contrario.
El valor predeterminado es false.
Implementación
public function get wordWrap():Boolean public function set wordWrap(value:Boolean):voidEjemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea una instancia de componente Label de varias líneas y se define la propiedad
text como el contenido de un archivo de texto externo:
import fl.controls.Label;
var url:String = "http://www.helpexamples.com/flash/text/lorem.txt";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.width = 530;
myLabel.move(10, 10);
myLabel.wordWrap = true;
var ldr:URLLoader = new URLLoader();
ldr.addEventListener(Event.COMPLETE, completeHandler);
ldr.load(new URLRequest(url));
function completeHandler(event:Event):void {
myLabel.text = URLLoader(event.currentTarget).data;
}
Información sobre constructores
Label | () | Información sobre |
public function Label()| 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 instancia de componente Label nueva.
Información sobre métodos
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;
}
Información sobre eventos
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 tras un cambio de altura o anchura del componente.
Nota: este evento no tiene lugar si se utiliza código ActionScript para modificar el texto de la etiqueta.
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 crea una instancia Label nueva y se detecta el evento
resize:
import fl.controls.Label;
import fl.events.ComponentEvent;
var myLabel:Label = new Label();
myLabel.text = "The quick brown fox jumped over the lazy dog.";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.wordWrap = true;
myLabel.move(10, 10);
myLabel.addEventListener(ComponentEvent.RESIZE, resizeHandler);
addChild(myLabel);
function resizeHandler(event:ComponentEvent):void {
var lbl:Label = event.currentTarget as Label;
trace("width:" + lbl.width, "height:" + lbl.height); // width:100 height:46
}
Ejemplos Cómo utilizar este ejemplo
LabelExample.as
En este ejemplo, se muestra cómo definir el texto de una etiqueta, con y sin contenido HTML.
- Añada los componentes Label y Button a la biblioteca.
- Guarde este código como LabelExample.as en el mismo directorio que el archivo FLA.
- Establece la clase DocumentClass del archivo FLA como LabelExample.
package
{
import flash.events.MouseEvent;
import flash.text.TextField;
import flash.text.TextFieldAutoSize;
import flash.display.Sprite;
import fl.controls.Label;
import fl.controls.Button;
public class LabelExample extends Sprite
{
private var simpleLabel:Label;
private var b1:Button;
private var b2:Button;
private var htmlData:String = "<br>This label displays <b>bold</b> and <i>italic</i> HTML-formatted text.";
public function LabelExample() {
setupLabel();
setupButtons();
}
private function setupButtons():void {
b1 = new Button();
b2 = new Button();
b1.move(10,50);
b2.move(10,80);
b1.setSize(120,22);
b2.setSize(120,22);
b1.label = "Make Normal Label";
b2.label = "Make HTML Label";
b1.addEventListener(MouseEvent.CLICK,buttonClick);
b2.addEventListener(MouseEvent.CLICK,buttonClick);
addChild(b1);
addChild(b2);
}
private function setupLabel():void {
simpleLabel = new Label();
simpleLabel.move(10,10);
simpleLabel.autoSize = TextFieldAutoSize.LEFT;
addChild(simpleLabel);
}
// Event handler function to change the image size.
private function displayHTML():void {
simpleLabel.htmlText = htmlData;
}
// Event handler function to change the image size.
private function displayText():void {
simpleLabel.text = "This Label displays plain text.";
}
private function buttonClick(e:MouseEvent):void {
switch(e.target) {
case b1:
displayText();
break;
case b2:
displayHTML();
break;
default:
break;
}
}
}
}
Tue Jun 12 2018, 02:12 PM Z