| Paquete | fl.controls |
| Clase | public class TextInput |
| Herencia | TextInput  UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Implementa | IFocusManagerComponent |
| Subclases | DataGridCellEditor |
| 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 |
Es posible activar o desactivar el componente TextInput en una aplicación. Si TextInput está desactivado, no puede recibir la entrada del ratón ni del teclado. Cuando está activado, implementa las reglas de selección y navegación al igual que un objeto TextField de ActionScript.
Puede utilizar estilos para personalizar el componente TextInput; por ejemplo, cambiando su aspecto cuando está desactivado. Entre otras personalizaciones que se pueden aplicar a este componente se incluyen la aplicación de formato con HTML o su definición para ser un campo de contraseña cuyo texto debe estar oculto.
Elementos de API relacionados
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 | |
| alwaysShowSelection : Boolean
Obtiene o define un valor booleano que indica cómo se muestra una selección cuando el campo de texto no se ha seleccionado. | TextInput | ||
| 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 booleano que indica si se deben eliminar espacios en blanco adicionales de un componente TextInput con texto HTML. | TextInput | ||
| 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 | |
| displayAsPassword : Boolean
Obtiene o define un valor booleano que indica si la instancia actual de TextInput se ha creado para incluir una contraseña o para contener texto. | TextInput | ||
| 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 | |
| editable : Boolean
Obtiene o define un valor booleano que indica si el usuario puede modificar el campo de texto. | TextInput | ||
| enabled : Boolean [override]
Obtiene o define un valor que indica si el componente puede aceptar la interacción del usuario. | TextInput | ||
| 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 | |
| horizontalScrollPosition : int
Obtiene o define la posición del deslizador de la barra de desplazamiento horizontal. | TextInput | ||
| htmlText : String
Contiene la representación HTML de la cadena que incluye el campo de texto. | TextInput | ||
| imeMode : String
Obtiene o define el modo del editor de método de entrada (IME). | TextInput | ||
| length : int [solo lectura]
Obtiene el número de caracteres de un componente TextInput. | TextInput | ||
| 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 | |
| maxChars : int
Obtiene o define el número máximo de caracteres que puede introducir un usuario en el campo de texto. | TextInput | ||
| maxHorizontalScrollPosition : int [solo lectura]
Obtiene un valor que describe la posición máxima a la que el campo de texto se puede desplazar hacia la derecha. | TextInput | ||
| 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 | |
| restrict : String
Obtiene o define la cadena de caracteres que el campo de texto acepta del usuario. | TextInput | ||
| 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 | |
| selectionBeginIndex : int [solo lectura]
Obtiene el valor de índice del primer carácter seleccionado en una selección de uno o varios caracteres. | TextInput | ||
| selectionEndIndex : int [solo lectura]
Obtiene la posición del índice del último carácter seleccionado en una selección de uno o varios caracteres. | TextInput | ||
| 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 una cadena que incluye el texto que está actualmente en el componente TextInput. | TextInput | ||
| textField : flash.text:TextField
Referencia al campo de texto interno del componente TextInput. | TextInput | ||
| textHeight : Number [solo lectura]
La altura del texto, expresada en píxeles. | TextInput | ||
| textSnapshot : flash.text:TextSnapshot [solo lectura]
Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer. | DisplayObjectContainer | |
| textWidth : Number [solo lectura]
La anchura del texto, expresada en píxeles. | TextInput | ||
| 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 instancia de componente TextInput nueva. | TextInput | ||
|
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 | |
Añade la cadena especificada después del último carácter que incluye TextArea. | TextInput | ||
|
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 | |
[override]
Muestra u oculta el indicador de selección en este componente. | TextInput | ||
|
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 | |
Recupera información sobre una línea de texto específica. | TextInput | ||
|
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. | TextInput | ||
|
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 | |
Establece el rango de una selección realizada en un área de texto que se ha seleccionado. | TextInput | ||
|
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 la entrada del usuario cambia el texto en el componente TextInput. | TextInput | |||
| 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 | ||
| Se distribuye cuando el usuario presiona la tecla Intro. | TextInput | |||
| [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 el usuario introduce texto. | TextInput | |||
| 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 | ||
|---|---|---|---|---|
disabledSkin | 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 nombre de la clase que se utiliza como fondo para el componente TextInput cuando su propiedad enabled está definida como false.
El valor predeterminado es TextInput_disabledSkin. | TextInput | ||
| 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. | TextInput | ||
| 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 | ||
textPadding | 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 el borde del componente del texto, expresado en píxeles. El valor predeterminado es 0. | TextInput | ||
upSkin | 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 nombre de la clase que se utiliza como fondo para el componente TextInput. El valor predeterminado es TextInput_upSkin. | TextInput | ||
Constantes públicas
Información sobre propiedades
alwaysShowSelection | propiedad |
alwaysShowSelection: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 cómo se muestra una selección cuando el campo de texto no se ha seleccionado.
Cuando este valor se establece como true y el campo de texto no está seleccionado, Flash Player resalta la selección del campo de texto en color gris. Cuando este valor se establece como false y el campo de texto no está seleccionado, Flash Player no resalta la selección del campo de texto.
El valor predeterminado es false.
Implementación
public function get alwaysShowSelection():Boolean public function set alwaysShowSelection(value:Boolean):voidEjemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea un componente TextInput y se selecciona texto mediante el método
setSelection():
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.alwaysShowSelection = true; myTextInput.setSelection(16, 19); myTextInput.move(10, 10); addChild(myTextInput);
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 booleano que indica si se deben eliminar espacios en blanco adicionales de un componente TextInput con texto HTML. Entre los ejemplos de espacios en blanco adicionales del componente se incluyen espacios y saltos de línea. true indica que se eliminan los espacios en blanco adicionales; false determina lo contrario.
Esta propiedad sólo afecta al texto definido con la propiedad htmlText; no afecta al texto que se establece 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
displayAsPassword | propiedad |
displayAsPassword: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 la instancia actual de TextInput se ha creado para incluir una contraseña o para contener texto. El valor true indica que la instancia de componente es un campo de texto de contraseña; false indica que la instancia de componente es un campo de texto normal.
Si esta propiedad se define como true, para cada carácter que introduce el usuario en el campo de texto, la instancia de TextInput muestra un asterisco. Asimismo, los comandos Cortar y Copiar y sus correspondientes métodos abreviados de teclado están desactivados. Estas medidas evitan la obtención de una contraseña en un equipo en el que no haya nadie presente.
El valor predeterminado es false.
Implementación
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):voidElementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crean dos instancias de componente TextInput, una con la propiedad
displayAsPassword definida como true y la otra con la propiedad definida como false:
import fl.controls.Label; import fl.controls.TextInput; var usernameLabel:Label = new Label(); usernameLabel.text = "User name:"; usernameLabel.move(10, 10); addChild(usernameLabel); var usernameTextInput:TextInput = new TextInput(); usernameTextInput.move(90, 10); addChild(usernameTextInput); var passwordLabel:Label = new Label(); passwordLabel.text = "Password:"; passwordLabel.move(10, 40); addChild(passwordLabel); var passwordTextInput:TextInput = new TextInput(); passwordTextInput.displayAsPassword = true; passwordTextInput.move(90, 40); addChild(passwordTextInput);
editable | propiedad |
editable: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 usuario puede modificar el campo de texto. El valor true indica que el usuario puede modificar el campo de texto; false indica que el usuario no puede realizar esta operación.
El valor predeterminado es true.
Implementación
public function get editable():Boolean public function set editable(value:Boolean):voidenabled | propiedad |
enabled: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 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).
Implementación
override public function get enabled():Boolean override public function set enabled(value:Boolean):voidhorizontalScrollPosition | propiedad |
horizontalScrollPosition:int| 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 posición del deslizador de la barra de desplazamiento horizontal.
El valor predeterminado es 0.
Implementación
public function get horizontalScrollPosition():int public function set horizontalScrollPosition(value:int):voidElementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea una instancia de componente TextInput y se muestra el valor actual de las propiedades
horizontalScrollPosition y maxHorizontalScrollPosition:
import fl.controls.Label;
import fl.controls.Slider;
import fl.controls.TextInput;
import fl.events.SliderEvent;
var myTextInput:TextInput = new TextInput();
myTextInput.text = "The quick brown fox jumped over the lazy dog.";
myTextInput.width = 120;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, textInputChangeHandler);
myTextInput.textField.addEventListener(Event.SCROLL, scrollHandler);
addChild(myTextInput);
var mySlider:Slider = new Slider();
mySlider.snapInterval = 1;
mySlider.tickInterval = 10;
mySlider.minimum = 0;
mySlider.maximum = myTextInput.maxHorizontalScrollPosition;
mySlider.value = myTextInput.horizontalScrollPosition;
mySlider.liveDragging = true;
mySlider.addEventListener(SliderEvent.CHANGE, sliderChangeHandler);
mySlider.width = 120;
mySlider.move(10, 40);
addChild(mySlider);
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 50);
addChild(myLabel);
getScrollPosition();
function getScrollPosition():void {
myTextInput.drawNow();
var scrollPos:uint = myTextInput.horizontalScrollPosition;
var maxScrollPos:uint = myTextInput.maxHorizontalScrollPosition;
myLabel.text = "scrollPosition: " + scrollPos + " of " + maxScrollPos;
mySlider.value = scrollPos;
mySlider.maximum = maxScrollPos;
}
function scrollHandler(event:Event):void {
getScrollPosition();
}
function sliderChangeHandler(event:SliderEvent):void {
myTextInput.horizontalScrollPosition = event.value;
getScrollPosition();
}
function textInputChangeHandler(event:Event):void {
getScrollPosition();
}
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 |
Contiene la representación HTML de la cadena que incluye el campo de texto.
El valor predeterminado es "".
Implementación
public function get htmlText():String public function set htmlText(value:String):voidElementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea un componente TextInput no editable y se define la propiedad
htmlText para aplicar el formato HTML al texto del campo:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.editable = false; myTextInput.enabled = false; myTextInput.htmlText = "(<i>auto assigned</i>)"; myTextInput.move(10, 10); addChild(myTextInput);
imeMode | propiedad |
imeMode: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 modo del editor de método de entrada (IME). IME posibilita que el usuario utilice un teclado occidental estándar (QWERTY) para introducir caracteres de los idiomas japonés, chino y coreano.
Flash establece IME en el modo especificado cuando se selecciona el componente y restaura su valor original cuando el componente ya no está seleccionado.
La clase flash.system.IMEConversionMode define las constantes para los valores válidos de esta propiedad. Defina esta propiedad como null para evitar el uso de IME con el componente.
Implementación
public function get imeMode():String public function set imeMode(value:String):voidlength | propiedad |
length:int [solo lectura] | 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 el número de caracteres de un componente TextInput.
El valor predeterminado es 0.
Implementación
public function get length():intElementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea un componente TextInput y se definen las propiedades
maxChars y restrict para restringir los caracteres que se pueden introducir:
import fl.controls.Label;
import fl.controls.TextInput;
var myTextInput:TextInput = new TextInput();
myTextInput.restrict = "0-9A-F";
myTextInput.maxChars = 6;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextInput);
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
myLabel.move(10, 30);
addChild(myLabel);
function changeHandler(event:Event):void {
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
}
maxChars | propiedad |
maxChars:int| 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 número máximo de caracteres que puede introducir un usuario en el campo de texto.
El valor predeterminado es 0.
Implementación
public function get maxChars():int public function set maxChars(value:int):voidElementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea un componente TextInput y se definen las propiedades
maxChars y restrict para restringir los caracteres que se pueden introducir:
import fl.controls.Label;
import fl.controls.TextInput;
var myTextInput:TextInput = new TextInput();
myTextInput.restrict = "0-9A-F";
myTextInput.maxChars = 6;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextInput);
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
myLabel.move(10, 30);
addChild(myLabel);
function changeHandler(event:Event):void {
myLabel.text = myTextInput.length + " of " + myTextInput.maxChars;
}
maxHorizontalScrollPosition | propiedad |
maxHorizontalScrollPosition:int [solo lectura] | 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 un valor que describe la posición máxima a la que el campo de texto se puede desplazar hacia la derecha.
El valor predeterminado es 0.
Implementación
public function get maxHorizontalScrollPosition():intElementos de API relacionados
restrict | propiedad |
restrict: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 la cadena de caracteres que el campo de texto acepta del usuario. Tenga en cuenta que los caracteres que no se incluyen en esta cadena se aceptan en el campo de texto si se introducen mediante programación.
Los caracteres de la cadena se leen de izquierda a derecha. Se puede especificar un rango de caracteres utilizando el carácter de guión (-).
Si el valor de esta propiedad es null, el campo de texto acepta todos los caracteres. Si esta propiedad se define como una cadena vacía (""), el campo de texto no aceptará caracteres.
Si la cadena empieza por un carácter de intercalación (^), en un principio se aceptan todos los caracteres; los caracteres posteriores de la cadena se excluyen del conjunto de caracteres aceptados. Si la cadena no empieza por un carácter de intercalación (^), inicialmente no se acepta ningún carácter; los caracteres posteriores de la cadena se incluyen en el conjunto de caracteres aceptados.
El valor predeterminado es null.
Implementación
public function get restrict():String public function set restrict(value:String):voidElementos de API relacionados
selectionBeginIndex | propiedad |
selectionBeginIndex:int [solo lectura] | 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 el valor de índice del primer carácter seleccionado en una selección de uno o varios caracteres.
La posición de índice de un carácter seleccionado se basa en cero y se calcula a partir del primer carácter que aparece en el área de texto. Si no hay selección, este valor se establece en la posición del carácter de intercalación.
El valor predeterminado es 0.
Implementación
public function get selectionBeginIndex():intElementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea un componente Label que muestra las propiedades
selectionBeginIndex y selectionEndIndex de un componente TextInput. El ejemplo también crea dos instancias de componente Slider que se pueden utilizar para definir los índices de inicio y fin de selección mediante programación a través del método setSelection():
import fl.controls.Label;
import fl.controls.Slider;
import fl.controls.TextInput;
import fl.events.SliderEvent;
var myTextInput:TextInput = new TextInput();
myTextInput.alwaysShowSelection = true;
myTextInput.text = "The quick brown fox jumped over the lazy dog.";
myTextInput.width = 120;
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
myTextInput.addEventListener(FocusEvent.FOCUS_IN, focusInHandler);
myTextInput.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler);
addChild(myTextInput);
var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 30);
addChild(myLabel);
var beginSlider:Slider = new Slider();
beginSlider.maximum = myTextInput.length;
beginSlider.snapInterval = 1;
beginSlider.liveDragging = true;
beginSlider.width = 120;
beginSlider.move(10, 65);
beginSlider.addEventListener(SliderEvent.CHANGE, beginChangeHandler);
addChild(beginSlider);
var endSlider:Slider = new Slider();
endSlider.maximum = myTextInput.length;
endSlider.snapInterval = 1;
endSlider.liveDragging = true;
endSlider.width = 120;
endSlider.move(10, 85);
endSlider.addEventListener(SliderEvent.CHANGE, endChangeHandler);
addChild(endSlider);
var t:Timer = new Timer(50);
t.addEventListener(TimerEvent.TIMER, timerHandler);
function changeHandler(event:Event):void {
beginSlider.maximum = myTextInput.length;
endSlider.maximum = myTextInput.length;
updateUI();
}
function focusInHandler(event:FocusEvent):void {
t.start();
}
function focusOutHandler(event:FocusEvent):void {
t.stop();
}
function beginChangeHandler(event:SliderEvent):void {
myTextInput.setSelection(event.value, myTextInput.selectionEndIndex);
updateUI();
}
function endChangeHandler(event:SliderEvent):void {
myTextInput.setSelection(myTextInput.selectionBeginIndex, event.value);
updateUI();
}
function timerHandler(event:TimerEvent):void {
updateUI();
}
function updateUI():void {
myLabel.text = "selectionBeginIndex:" + myTextInput.selectionBeginIndex + "\n";
myLabel.text += "selectionEndIndex:" + myTextInput.selectionEndIndex;
beginSlider.value = myTextInput.selectionBeginIndex;
endSlider.value = myTextInput.selectionEndIndex;
}
selectionEndIndex | propiedad |
selectionEndIndex:int [solo lectura] | 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 la posición del índice del último carácter seleccionado en una selección de uno o varios caracteres.
La posición de índice de un carácter seleccionado se basa en cero y se calcula a partir del primer carácter que aparece en el área de texto. Si no hay selección, este valor se establece en la posición del carácter de intercalación.
El valor predeterminado es 0.
Implementación
public function get selectionEndIndex():intElementos de API relacionados
text | 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 una cadena que incluye el texto que está actualmente en el componente TextInput. Esta propiedad contiene texto sin formato y no dispone de etiquetas HTML. Para recuperar este texto en formato HTML, utilice la propiedad htmlText.
El valor predeterminado es "".
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 TextInput.
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea una instancia de componente TextInput y se utiliza la propiedad
textField para acceder al objeto TextField nativo de ActionScript subyacente y llamar al método replaceText():
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.textField.replaceText(41, 44, "fox"); myTextInput.textField.replaceText(16, 19, "dog"); addChild(myTextInput);
textHeight | propiedad |
textHeight:Number [solo lectura] | 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 altura del texto, expresada en píxeles.
El valor predeterminado es 0.
Implementación
public function get textHeight():NumberElementos de API relacionados
textWidth | propiedad |
textWidth:Number [solo lectura] | 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 anchura del texto, expresada en píxeles.
El valor predeterminado es 0.
Implementación
public function get textWidth():NumberElementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea una instancia de componente TextInput y se realiza el seguimiento de las propiedades
textWidth y textHeight cuando cambia el contenido del campo de texto:
import fl.controls.TextInput;
var myTextInput:TextInput = new TextInput();
myTextInput.move(10, 10);
myTextInput.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextInput);
function changeHandler(event:Event):void {
trace("textWidth:" + myTextInput.textWidth + ", textHeight:" + myTextInput.textHeight);
}
Información sobre constructores
TextInput | () | Información sobre |
public function TextInput()| 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 TextInput nueva.
Información sobre métodos
appendText | () | método |
public function appendText(text: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 |
Añade la cadena especificada después del último carácter que incluye TextArea. Este método resulta más eficaz que concatenar dos cadenas utilizando una asignación de suma en una propiedad de texto; por ejemplo, myTextArea.text += moreText. Este método es especialmente útil cuando el componente TextArea incluye una cantidad importante de contenido.
Parámetros
text:String — Cadena que se va a añadir al texto existente.
|
drawFocus | () | método |
override public function drawFocus(draw: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
draw: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.
|
getLineMetrics | () | método |
public function getLineMetrics(index:int):flash.text:TextLineMetrics| 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 información sobre una línea de texto específica.
Parámetros
index:int — Número de línea para el que se va a recuperar información.
|
flash.text:TextLineMetrics |
Ejemplo ( Cómo utilizar este ejemplo )
En el siguiente ejemplo, se dibuja un rectángulo rojo sobre un valor ascendente de la entrada de texto desde la línea base y un rectángulo azul sobre su valor descendente desde la línea base:
var format:TextFormat = new TextFormat();
format.size = 72;
format.font = "Georgia";
import fl.controls.TextInput;
var ti:TextInput = new TextInput();
addChild(ti);
ti.setSize(393,82);
ti.move(10,10);
ti.setStyle("textFormat",format);
ti.text = "Hello World";
ti.drawNow();
var metrics:TextLineMetrics = ti.getLineMetrics(0);
var ascenderColoring:Shape = new Shape();
var descenderColoring:Shape = new Shape();
ti.addChild(ascenderColoring);
ti.addChild(descenderColoring);
ascenderColoring.graphics.clear();
ascenderColoring.graphics.beginFill(0xFF0000,0.2);
ascenderColoring.graphics.drawRect(0, 0, metrics.width, metrics.ascent);
descenderColoring.graphics.clear();
descenderColoring.graphics.beginFill(0x0000FF,0.2);
descenderColoring.graphics.drawRect(0, metrics.ascent + 2, metrics.width, metrics.descent);
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;
}
setSelection | () | método |
public function setSelection(beginIndex:int, endIndex:int):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 |
Establece el rango de una selección realizada en un área de texto que se ha seleccionado. El rango de selección comienza en el índice que se especifica mediante el parámetro start y termina en el índice indicado con el parámetro end. Si los valores de parámetro que especifican el rango de selección son los mismos, este método establece el punto de inserción del texto del mismo modo que la propiedad caretIndex.
El texto seleccionado se considera como una cadena de caracteres basada en cero en la que el primer carácter seleccionado se sitúa en el índice 0, el segundo carácter en el índice 1 y así sucesivamente.
Este método no surte efecto si el campo de texto no se ha seleccionado.
Parámetros
beginIndex:int — La ubicación del índice del primer carácter de la selección.
| |
endIndex:int — La ubicación del índice del último carácter de la selección.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se introduce texto en una instancia TextInput y se define la selección en la segunda palabra:
import fl.controls.TextInput; var ti:TextInput = new TextInput(); addChild(ti); ti.text = "Hello World"; ti.setFocus(); ti.setSelection(6, 11);
En el ejemplo siguiente, se crea un componente TextInput y se selecciona texto mediante el método
setSelection():
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.alwaysShowSelection = true; myTextInput.setSelection(16, 19); myTextInput.move(10, 10); addChild(myTextInput);
Información sobre eventos
change | Evento |
Tipo de objeto de evento:
propiedad Event.type =
flash.events.Eventpropiedad Event.type =
flash.events.Event.CHANGE| 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 entrada del usuario cambia el texto en el componente TextInput.
Nota: este evento no tiene lugar si ActionScript se utiliza para modificar el texto.
La constanteEvent.CHANGE define el valor de la propiedad type de un objeto de evento change.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto al que se ha modificado su valor. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
enter | Evento |
Tipo de objeto de evento:
propiedad ComponentEvent.type =
fl.events.ComponentEventpropiedad ComponentEvent.type =
fl.events.ComponentEvent.ENTER| 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 el usuario presiona la tecla Intro.
Define el valor de la propiedadtype para un objeto de evento enter.
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. |
textInput | Evento |
Tipo de objeto de evento:
propiedad TextEvent.type =
flash.events.TextEventpropiedad TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| 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 el usuario introduce texto.
Define el valor de la propiedadtype de un objeto de evento textInput.
Nota: este evento no se distribuye para las teclas Supr o Retroceso.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | true; llama al método preventDefault() para cancelar el comportamiento predeterminado. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Campo de texto en el que se introducen los caracteres. El destino no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
text | Carácter o secuencia de caracteres introducidos por el usuario. |
Ejemplos Cómo utilizar este ejemplo
TextInputExample.as
En este ejemplo, se muestra cómo crear un sistema de conexión básico utilizando la clase TextInput
- Añada los componentes TextInput, Label y Button a la biblioteca
- Guarde este código como TextInputExample.as en el mismo directorio que el archivo FLA
- Establece la clase DocumentClass del archivo FLA como TextInputExample
package
{
import flash.display.Sprite;
import flash.events.MouseEvent;
import flash.events.Event;
import fl.controls.TextInput;
import fl.controls.Label;
import fl.controls.Button;
public class TextInputExample extends Sprite
{
private var ti1:TextInput;
private var ti2:TextInput;
private var label1:Label;
private var label2:Label;
private var submitBtn:Button;
public function TextInputExample() {
setupLabels();
setupInputFields();
setupButton();
}
private function setupInputFields():void {
ti1 = new TextInput();
ti2 = new TextInput();
ti1.move(50,10);
ti2.move(50,40);
ti2.displayAsPassword = true;
ti1.addEventListener(Event.CHANGE, textEntered);
ti2.addEventListener(Event.CHANGE, textEntered);
addChild(ti1);
addChild(ti2);
}
private function setupLabels():void {
label1 = new Label();
label2 = new Label();
label1.move(10,10);
label2.move(10,40);
label1.text = "User:";
label2.text = "Pass:"
addChild(label1);
addChild(label2);
}
private function setupButton():void {
submitBtn = new Button();
submitBtn.move(150,70);
submitBtn.label = "Go";
submitBtn.enabled = false;
submitBtn.setSize(50,20);
submitBtn.addEventListener(MouseEvent.CLICK, submitLogin);
addChild(submitBtn);
}
private function textEntered(e:Event):void {
if(ti1.text != "" && ti2.text != "") {
submitBtn.enabled = true;
}
else {
submitBtn.enabled = false;
}
}
private function submitLogin(e:MouseEvent):void {
var submitLabel:Label = new Label();
submitLabel.move(10,70);
submitLabel.autoSize = "left";
submitLabel.text = "Login has been submitted."
addChild(submitLabel);
submitBtn.removeEventListener(MouseEvent.CLICK, submitLogin);
}
}
}
Tue Jun 12 2018, 02:12 PM Z