Paquete | flash.text |
Clase | public class TextField |
Herencia | TextField InteractiveObject DisplayObject EventDispatcher Object |
Subclases | FlexTextField |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Para crear un campo de texto dinámicamente, utilice el constructor TextField()
.
Los métodos de la clase TextField permiten establecer, seleccionar y manipular texto de un campo de texto dinámico o de entrada que se cree durante la edición o ejecución.
ActionScript ofrece diversas maneras de dar formato a los textos durante la ejecución. La clase TextFormat permite definir el formato de carácter y de párrafo para los objetos TextField. Se pueden aplicar estilos CSS (Cascading Style Sheets, Hojas de estilos en cascada) a los campos de texto. Para ello, utilice la propiedad TextField.styleSheet
y la clase StyleSheet. Puede utilizar CSS para aplicar un estilo a las etiquetas HTML incorporadas, definir nuevas etiquetas de formato o aplicar estilos. Es posible asignar directamente texto con formato HTML, el cual utiliza de manera opcional estilos CSS, a un campo de texto. El texto HTML que asigna a un campo de texto puede contener elementos multimedia incorporados (clips de película, archivos SWF, GIF, PNG y JPEG). El texto se ajustará alrededor del elemento multimedia incorporado del mismo modo que los navegadores web lo hacen en un documento HTML.
Flash Player también admite un subconjunto de etiquetas HTML que puede utilizar para dar formato al texto. Consulte la lista de etiquetas HTML admitidas en la descripción de la propiedad htmlText
.
Elementos de API relacionados
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
Cuando 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. | TextField | ||
antiAliasType : String
Tipo de suavizado que se utiliza en este campo de texto. | TextField | ||
autoSize : String
Controla la asignación de tamaño y alineación automáticas de los campos de texto. | TextField | ||
background : Boolean
Especifica si el campo de texto tiene relleno de fondo. | TextField | ||
backgroundColor : uint
Color del fondo del campo de texto. | TextField | ||
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 | ||
border : Boolean
Especifica si el campo de texto tiene un borde. | TextField | ||
borderColor : uint
Color del borde del campo de texto. | TextField | ||
bottomScrollV : int [solo lectura]
Un entero (índice basado en uno) que indica la última línea visible en el campo de texto especificado. | TextField | ||
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 | ||
caretIndex : int [solo lectura]
El índice de la posición del punto de inserción (intercalación). | TextField | ||
condenseWhite : Boolean
Un valor booleano que especifica si se eliminarán los espacios en blanco adicionales (espacios, saltos de línea, etc.) en el campo de texto con texto HTML. | TextField | ||
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 | ||
defaultTextFormat : flash.text:TextFormat
Especifica el formato aplicado al texto nuevo insertado, por ejemplo, texto introducido por un usuario o insertado mediante el método replaceSelectedText(). | TextField | ||
displayAsPassword : Boolean
Especifica si el campo de texto es de contraseña. | TextField | ||
doubleClickEnabled : Boolean
Especifica si este objeto recibe eventos doubleClick. | InteractiveObject | ||
embedFonts : Boolean
Especifica si representar utilizando contornos de fuentes incorporadas. | TextField | ||
filters : Array
Conjunto indexado que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización. | DisplayObject | ||
focusRect : Object
Especifica si este objeto muestra un rectángulo de selección. | InteractiveObject | ||
gridFitType : String
Tipo de ajuste de cuadrícula que se utiliza en este campo de texto. | TextField | ||
height : Number
Indica la altura del objeto de visualización, expresada en píxeles. | DisplayObject | ||
htmlText : String
Contiene la representación HTML del contenido del campo de texto. | TextField | ||
length : int [solo lectura]
El número de caracteres de un campo de texto. | TextField | ||
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
El número máximo de caracteres que puede incluir el campo de texto, tal y como los ha introducido el usuario. | TextField | ||
maxScrollH : int [solo lectura]
Valor máximo de scrollH. | TextField | ||
maxScrollV : int [solo lectura]
Valor máximo de scrollV. | TextField | ||
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 | ||
mouseEnabled : Boolean
Especifica si este objeto recibe la entrada del ratón, la entrada del usuario o mensajes. | InteractiveObject | ||
mouseWheelEnabled : Boolean
Valor booleano que indica si Flash Player desplazará automáticamente campos de texto multilínea cuando el usuario haga clic en un campo de texto y gire la rueda del ratón. | TextField | ||
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 | ||
multiline : Boolean
Indica si el campo de texto es multilínea. | TextField | ||
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 | ||
numLines : int [solo lectura]
Define el número de líneas de texto de un campo de varias líneas. | TextField | ||
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
Indica el conjunto de caracteres que los usuarios pueden introducir en el campo de texto. | TextField | ||
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
Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro. | DisplayObject | ||
scaleY : Number
Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto. | DisplayObject | ||
scaleZ : Number
Indica la escala de profundidad (porcentaje) de un objeto aplicada desde el punto de registro del objeto. | DisplayObject | ||
scrollH : int
La posición de desplazamiento horizontal actual. | TextField | ||
scrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización. | DisplayObject | ||
scrollV : int
La posición vertical del texto de un campo de texto. | TextField | ||
selectable : Boolean
Valor booleano que indica si el campo de texto puede seleccionarse. | TextField | ||
selectionBeginIndex : int [solo lectura]
El valor de índice basado en cero del primer carácter de la selección actual. | TextField | ||
selectionEndIndex : int [solo lectura]
El valor de índice basado en cero del último carácter de la selección actual. | TextField | ||
sharpness : Number
La nitidez de los bordes de glifo en este campo de texto. | TextField | ||
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 | ||
stage : Stage [solo lectura]
El escenario del objeto de visualización. | DisplayObject | ||
styleSheet : StyleSheet
Asocia una hoja de estilos al campo de texto. | TextField | ||
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
Una cadena que es el texto actual del campo de texto. | TextField | ||
textColor : uint
El color del texto de un campo de texto, expresado en formato hexadecimal. | TextField | ||
textHeight : Number [solo lectura]
La altura del texto, expresada en píxeles. | TextField | ||
textInteractionMode : String [solo lectura]
La propiedad del modo de interacción; el valor predeterminado es TextInteractionMode.NORMAL. | TextField | ||
textWidth : Number [solo lectura]
La anchura del texto, expresada en píxeles. | TextField | ||
thickness : Number
El grosor de los bordes de glifo en este campo de texto. | TextField | ||
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 | ||
type : String
Tipo del campo de texto. | TextField | ||
useRichTextClipboard : Boolean
Especifica si se copia y se pega el formato del texto junto con el propio texto. | TextField | ||
visible : Boolean
Indica si el objeto de visualización es visible. | DisplayObject | ||
width : Number
Indica la anchura del objeto de visualización, expresada en píxeles. | DisplayObject | ||
wordWrap : Boolean
Valor booleano que indica si el campo de texto tiene ajuste de texto. | TextField | ||
x : Number
Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal. | DisplayObject | ||
y : Number
Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal. | DisplayObject | ||
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étodo | Definido por | ||
---|---|---|---|
Crea una nueva instancia de TextField. | TextField | ||
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 especifica por el parámetro newText al final del texto del campo de texto. | TextField | ||
Distribuye un evento en el flujo del evento. | EventDispatcher | ||
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace. | DisplayObject | ||
Devuelve un rectángulo como recuadro de delimitación del carácter. | TextField | ||
Devuelve un valor de índice basado en cero del carácter en el punto especificado por los parámetros x e y. | TextField | ||
Dado un índice del carácter, devuelve el índice del primer carácter del mismo párrafo. | TextField | ||
Devuelve una referencia DisplayObject para el id dado, ya que se ha añadido una imagen o un archivo SWF a un campo de texto con formato HTML mediante la etiqueta <img>. | TextField | ||
Devuelve un valor de índice basado en cero de la línea en el punto especificado por los parámetros x e y. | TextField | ||
Devuelve un valor de índice basado en cero de la línea que contiene el carácter especificado por el parámetro | TextField | ||
Devuelve el número de caracteres de una línea de texto específica. | TextField | ||
Devuelve información de medidas sobre una línea de texto dada. | TextField | ||
Devuelve el índice de carácter del primer carácter de la línea especificada por el parámetro lineIndex. | TextField | ||
Devuelve el texto de la línea especificada por el parámetro lineIndex. | TextField | ||
Dado un índice de carácter, devuelve la longitud del párrafo que contiene dicho carácter. | TextField | ||
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 | ||
Devuelve un objeto TextFormat que contiene información de formato para el rango de texto especificado por los parámetros beginIndex y endIndex. | TextField | ||
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 | ||
[estática]
Devuelve true si hay disponible una fuente incorporada con las propiedades fontName y fontStyle especificadas, donde Font.fontType sea flash.text.FontType.EMBEDDED. | TextField | ||
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 | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Elimina un detector del objeto EventDispatcher. | EventDispatcher | ||
Reemplaza la selección actual por el contenido del parámetro del valor. | TextField | ||
Reemplaza el rango de caracteres especificados por los parámetros beginIndex y endIndex con el contenido del parámetro newText. | TextField | ||
Muestra un teclado virtual. | InteractiveObject | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Establece como seleccionado el texto designado por los valores de índice de los primeros y últimos caracteres, especificados por los parámetros beginIndex y endIndex. | TextField | ||
Aplica el formato de texto especificado por el parámetro format al texto especificado en un campo de texto. | TextField | ||
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 | ||
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 |
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 emite tras modificar el valor de un control, a diferencia del evento textInput, que se emite antes de modificar el valor. | TextField | |||
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 | |||
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 hace clic en el hipervínculo de un campo de texto compatible con HTML, donde la URL empieza por "event:". | TextField | |||
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 | |||
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 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 | |||
Distribuido por un objeto TextField después de que el usuario se desplace. | TextField | |||
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 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 | |||
Flash Player distribuye el evento textInput cuando un usuario escribe uno o varios caracteres de texto. | TextField | |||
Flash Player distribuye el evento textInteractionModeChange cuando el usuario cambia el modo de interacción de un campo de texto. | TextField | |||
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 |
alwaysShowSelection | propiedad |
alwaysShowSelection:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cuando 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 se define 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):void
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_alwaysShowSelection extends Sprite { public function TextField_alwaysShowSelection() { var label1:TextField = createCustomTextField(0, 20, 200, 20); label1.text = "This text is selected."; label1.setSelection(0, 9); label1.alwaysShowSelection = true; var label2:TextField = createCustomTextField(0, 50, 200, 20); label2.text = "Drag to select some of this text."; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
antiAliasType | propiedad |
antiAliasType:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Tipo de suavizado que se utiliza en este campo de texto. Utilice constantes flash.text.AntiAliasType
para esta propiedad. Sólo puede controlar este parámetro de configuración si la fuente está incorporada (con la propiedad embedFonts
definida como true
). El valor predeterminado es flash.text.AntiAliasType.NORMAL
.
Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:
Valor de la cadena | Descripción |
---|---|
flash.text.AntiAliasType.NORMAL | Aplica el suavizado de texto regular. Este valor equivale al tipo de suavizado que utilizaba Flash Player en la versión 7 y anteriores. |
flash.text.AntiAliasType.ADVANCED | Aplica suavizado avanzado, que aumenta la legibilidad del texto. (Esta función pasó a estar disponible en Flash Player 8.) El suavizado avanzado proporciona máxima calidad de representación para las fuentes de tamaño pequeño. Ofrece mejores resultados con aplicaciones que presentan gran cantidad de texto pequeño. No se recomienda utilizarlo con fuentes de más de 48 puntos. |
Implementación
public function get antiAliasType():String
public function set antiAliasType(value:String):void
Elementos de API relacionados
autoSize | propiedad |
autoSize:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Controla la asignación de tamaño y alineación automáticas de los campos de texto. Los valores válidos para las constantes TextFieldAutoSize
son: TextFieldAutoSize.NONE
(predeterminado), TextFieldAutoSize.LEFT
, TextFieldAutoSize.RIGHT
y TextFieldAutoSize.CENTER
.
Si autoSize
se define como TextFieldAutoSize.NONE
(predeterminado), no se produce cambio de tamaño.
Si autoSize
se define como TextFieldAutoSize.LEFT
, se considerará que el texto está justificado a la izquierda, lo que significa que el lado izquierdo del campo de texto permanecerá fijo y el cambio de tamaño de un campo de texto de una sola línea tendrá lugar en el lado derecho. Si el texto incluye un salto de línea (por ejemplo, "\n"
o "\r"
), también se cambiará el tamaño del lado inferior para dar cabida a la siguiente línea de texto. Si wordWrap
también se ha definido como true
, sólo se cambiará el tamaño del lado inferior del campo de texto, mientras que el lado derecho permanecerá fijo.
Si autoSize
se define como TextFieldAutoSize.RIGHT
, se considerará que el texto está justificado a la izquierda, lo que significa que el lado derecho del campo de texto permanecerá fijo y el cambio de tamaño de un campo de texto de una sola línea tendrá lugar en el lado izquierdo. Si el texto incluye un salto de línea (por ejemplo, "\n" o "\r"
), también se cambiará el tamaño del lado inferior para dar cabida a la siguiente línea de texto. Si wordWrap
también se ha definido como true
, sólo se cambiará el tamaño del lado inferior del campo de texto, mientras que el lado izquierdo permanecerá fijo.
Si autoSize
se define como TextFieldAutoSize.CENTER
, se considerará que el texto está centrado, lo que significa que el cambio de tamaño de un campo de texto de una sola línea se distribuirá por igual entre los márgenes derecho e izquierdo. Si el texto incluye un salto de línea (por ejemplo, "\n"
o "\r"
), también se cambiará el tamaño del lado inferior para dar cabida a la siguiente línea de texto. Si wordWrap
también se define como true
, sólo se cambiará el tamaño del lado inferior del campo de texto, mientras que los lados izquierdo y derecho permanecerán fijos.
Implementación
public function get autoSize():String
public function set autoSize(value:String):void
Emite
ArgumentError — La cadena autoSize especificada no es un miembro de flash.text.TextFieldAutoSize.
|
Elementos de API relacionados
background | propiedad |
background:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica si el campo de texto tiene relleno de fondo. Si es true
, el campo de texto tiene relleno de fondo. Si es false
, el campo de texto no tiene relleno de fondo. Utilice la propiedad backgroundColor
para establecer el color de fondo de un campo de texto.
El valor predeterminado es false.
Implementación
public function get background():Boolean
public function set background(value:Boolean):void
Elementos de API relacionados
backgroundColor | propiedad |
backgroundColor:uint
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Color del fondo del campo de texto. El valor predeterminado es 0xFFFFFF
(blanco). Esta propiedad puede recuperarse o establecerse aunque no haya actualmente ningún fondo, pero el color sólo estará visible si el campo de texto tiene la propiedad background
definida como true
.
Implementación
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
Elementos de API relacionados
border | propiedad |
border:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica si el campo de texto tiene un borde. Si es true
, especifica si el campo de texto tiene un borde. Si es false
, el campo de texto no tiene borde. Utilice la propiedad borderColor
para definir el color del borde.
El valor predeterminado es false.
Implementación
public function get border():Boolean
public function set border(value:Boolean):void
Elementos de API relacionados
borderColor | propiedad |
borderColor:uint
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Color del borde del campo de texto. El valor predeterminado es 0x000000
(negro). Esta propiedad puede recuperarse o definirse aunque no haya actualmente ningún borde, pero el color sólo estará visible si el campo de texto tiene la propiedad border
definida como true
.
Implementación
public function get borderColor():uint
public function set borderColor(value:uint):void
Elementos de API relacionados
bottomScrollV | propiedad |
bottomScrollV:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un entero (índice basado en uno) que indica la última línea visible en el campo de texto especificado. Considere el campo de texto como una ventana en un bloque de texto. La propiedad scrollV
es el índice basado en uno de la primera línea visible en la ventana.
El texto existente entre las líneas indicado por scrollV
y bottomScrollV
está visible actualmente en el campo de texto.
Implementación
public function get bottomScrollV():int
Elementos de API relacionados
caretIndex | propiedad |
caretIndex:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
El índice de la posición del punto de inserción (intercalación). Si no se muestra ningún punto de inserción, el valor es la posición en la que estaría el punto de inserción si se recuperase la selección en el campo (normalmente, la última posición del punto de inserción o un valor 0 si el campo no se ha seleccionado nunca).
Los índices de espacio de selección están basados en cero (por ejemplo, la primera posición es 0, la segunda es 1, etc.).
Implementación
public function get caretIndex():int
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
printCursorPosition
. En ese caso, los valores de las propiedades caretIndex
, selectionBeginIndex
y selectionEndIndex
se proporcionarán como resultado.
Ejecute este ejemplo e intente hacer clic en el objeto TextField para seleccionar texto. A continuación, haga clic en el campo sin seleccionar texto. Al hacer clic en el texto sin realizar la selección, la propiedad caretIndex
indica la posición del punto de inserción y el valor de las propiedades selectionBeginIndex
y selectionEndIndex
es igual que el valor de la propiedad caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
condenseWhite | propiedad |
condenseWhite:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un valor booleano que especifica si se eliminarán los espacios en blanco adicionales (espacios, saltos de línea, etc.) en el campo de texto con texto HTML. El valor predeterminado es false
. La propiedad condenseWhite
sólo afecta al texto definido con la propiedad htmlText
, no con la propiedad text
. Si define texto con la propiedad text
, condenseWhite
se omitirá.
Si la propiedad condenseWhite
se establece como true
, utilice comandos HTML estándar, como <BR>
y <P>
, para incluir saltos de línea en el campo de texto.
Defina la propiedad condenseWhite
antes de hacer lo propio con htmlText
.
Implementación
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
condenseWhite
como false
o como true
:
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_condenseWhite extends Sprite { public function TextField_condenseWhite() { var tf1:TextField = createCustomTextField(0, 0, 200, 50); tf1.condenseWhite = false; tf1.htmlText = "keep on\n\ttruckin'"; var tf2:TextField = createCustomTextField(0, 120, 200, 50); tf2.condenseWhite = true; tf2.htmlText = "keep on\n\ttruckin'"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; addChild(result); return result; } } }
defaultTextFormat | propiedad |
defaultTextFormat:flash.text:TextFormat
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica el formato aplicado al texto nuevo insertado, por ejemplo, texto introducido por un usuario o insertado mediante el método replaceSelectedText()
.
Nota: cuando se seleccionan caracteres para reemplazar con setSelection()
y replaceSelectedText()
, defaultTextFormat
se aplica únicamente si el texto se ha seleccionado hasta el último carácter. A continuación, se muestra un ejemplo:
var my_txt:TextField new TextField(); my_txt.text = "Flash Macintosh version"; var my_fmt:TextFormat = new TextFormat(); my_fmt.color = 0xFF0000; my_txt.defaultTextFormat = my_fmt; my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied my_txt.replaceSelectedText("Windows version");
Cuando se accede a la propiedad defaultTextFormat
, el objeto TextFormat devuelto tiene todas sus propiedades definidas. Ninguna de las propiedades tiene el valor null
.
Nota: no se puede establecer esta propiedad si se aplica una hoja de estilos al campo de texto.
Implementación
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
Emite
Error — Este método no puede utilizarse en un campo de texto con una hoja de estilos.
|
Elementos de API relacionados
displayAsPassword | propiedad |
displayAsPassword:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica si el campo de texto es de contraseña. Si el valor de esta propiedad es true
, el campo de texto se trata como una contraseña y oculta la entrada de caracteres empleando asteriscos en lugar de los caracteres reales. Si su valor es false
, el campo de texto no se trata como una contraseña. Cuando está activado el modo de contraseña, los comandos Cortar y Copiar y sus correspondientes métodos abreviados de teclado no funcionan. Este mecanismo de seguridad impide que un usuario sin escrúpulos pueda utilizar los métodos abreviados para descubrir 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):void
embedFonts | propiedad |
embedFonts:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica si representar utilizando contornos de fuentes incorporadas. Si es false
, Flash Player representa el campo de texto empleando fuentes de dispositivo.
Si define la propiedad embedFonts
como true
para un campo de texto, debe especificar una fuente para ese texto mediante la propiedad font
de un objeto TextFormat aplicado al campo de texto. Si la fuente especificada no está incorporada en el archivo SWF, el texto no se mostrará.
El valor predeterminado es false.
Implementación
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
Elementos de API relacionados
gridFitType | propiedad |
gridFitType:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Tipo de ajuste de cuadrícula que se utiliza en este campo de texto. Esta propiedad sólo se aplica si la propiedad flash.text.AntiAliasType
del campo de texto se define como flash.text.AntiAliasType.ADVANCED
.
El tipo de ajuste de cuadrícula empleado determina si Flash Player hará que las líneas horizontales y verticales se ajusten a una cuadrícula de píxeles o de subpíxeles o si no realizará ningún ajuste.
Para la propiedad flash.text.GridFitType
, puede utilizar los siguientes valores de cadena:
Valor de la cadena | Descripción |
---|---|
flash.text.GridFitType.NONE | Sin ajuste de cuadrícula. Las líneas horizontales y verticales de los glifos no se ajustan a la cuadrícula de píxeles. Se recomienda utilizar este valor con animaciones o tamaños de fuente grandes. |
flash.text.GridFitType.PIXEL | Especifica que las líneas horizontales y verticales intensas se ajustan a la cuadrícula de píxeles. Este parámetro sólo funciona para campos de texto alineados a la izquierda. Para usar este parámetro de configuración, la propiedad flash.dispaly.AntiAliasType del campo de texto debe estar definida como flash.text.AntiAliasType.ADVANCED . En general, es la opción que más facilita la lectura de texto con alineación a la izquierda. |
flash.text.GridFitType.SUBPIXEL | Especifica que las líneas horizontales y verticales intensas se ajusten a la cuadrícula de subpíxeles en monitores LCD. Para usar este parámetro de configuración, la propiedad flash.text.AntiAliasType del campo de texto debe estar definida como flash.text.AntiAliasType.ADVANCED . La configuración de flash.text.GridFitType.SUBPIXEL suele ser una buena opción para texto dinámico con alineación central o alineación a la derecha y en ocasiones ofrece un buen equilibrio entre animación y calidad de texto. |
El valor predeterminado es pixel.
Implementación
public function get gridFitType():String
public function set gridFitType(value:String):void
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
gridFitType
. Cuando utilice este ejemplo, preste atención a la diferencia con la que pueden leerse las dos primeras líneas. Tenga en cuenta también el uso óptimo de GridFitType.PIXEL
en el texto alineado a la izquierda y de GridFitType.SUBPIXEL
en el texto alineado a la derecha.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; public class gridFitTypeExample extends Sprite { public function gridFitTypeExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=12; var tf1:TextField = createCustomTextField(0,0,format1,"NONE",TextFieldAutoSize.LEFT,GridFitType.NONE); var tf2:TextField = createCustomTextField(0,30,format1,"PIXEL",TextFieldAutoSize.LEFT,GridFitType.PIXEL); var tf3:TextField = createCustomTextField(300,60,format1,"SUBPIXEL",TextFieldAutoSize.RIGHT,GridFitType.SUBPIXEL); } private function createCustomTextField(x:Number,y:Number,fm:TextFormat,tl:String,tfs:String,gft:String):TextField { var result:TextField = new TextField(); result.x=x; result.y=y; result.embedFonts=true; result.antiAliasType=AntiAliasType.ADVANCED; result.text="This text uses a gridFitType of " + tl; result.autoSize=tfs; result.gridFitType=gft; result.setTextFormat(fm); addChild(result); return result; } } }
htmlText | propiedad |
htmlText:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Contiene la representación HTML del contenido del campo de texto.
Flash Player admite las siguientes etiquetas HTML:
Etiqueta | Descripción |
---|---|
Etiqueta de anclaje |
La etiqueta <a> crea un vínculo de hipertexto y admite los atributos siguientes:
|
Etiqueta de negrita |
La etiqueta <b> muestra el texto en negrita. Debe haber un tipo de letra en negrita disponible para la fuente utilizada.
|
Etiqueta de salto de línea |
La etiqueta <br> crea un salto de línea en el campo de texto. Configure el campo de texto como multilínea para poder utilizar esta etiqueta.
|
Etiqueta de fuente |
La etiqueta <font> especifica una fuente o una lista de fuentes para mostrar el texto. La etiqueta de fuente admite los atributos siguientes:
|
Etiqueta de imagen |
La etiqueta <img> permite incorporar archivos de imagen externos (JPEG, GIF, PNG), archivos SWF y clips de película en los campos de texto. El texto fluye automáticamente alrededor de las imágenes incorporadas en los campos de texto. Debe configurar el campo de texto como multilínea para que se ajuste el texto en torno a una imagen.
La etiqueta
Flash muestra los medios incorporados en un campo de texto con su tamaño completo. Para especificar las dimensiones de los medios que está incorporando, utilice los atributos En general, las imágenes incorporadas a un campo de texto aparecen en la línea que sigue a la etiqueta En contenido de AIR del entorno limitado de seguridad de la aplicación, AIR omite las etiquetas |
Etiqueta de cursiva |
La etiqueta <i> muestra el texto encerrado en cursiva. Debe haber un tipo de letra en cursiva disponible para la fuente utilizada.
|
Etiqueta de elemento de lista |
La etiqueta <li> coloca un viñeta delante del texto incluido en la etiqueta. Nota: debido a que Flash Player y AIR no reconocen etiquetas de lista ordenadas y no ordenadas (<ol> y <ul> ), no afectan al modo en que se muestra la lista. Todas las listas son no ordenadas y todos sus elementos utilizan viñetas.
|
Etiqueta de párrafo |
La etiqueta <p> crea un párrafo nuevo. El campo de texto se debe configurar como multilínea para poder utilizar esta etiqueta. La etiqueta <p> admite los siguientes atributos:
|
Etiqueta de espacio |
La etiqueta <span> sólo está disponible para uso con los estilos de texto CSS. Admite el atributo siguiente:
|
Etiqueta de formato de texto |
La etiqueta La etiqueta
|
Etiqueta de subrayado |
La etiqueta <u> subraya el texto encerrado.
|
Flash Player y AIR admiten las siguientes entidades HTML:
Entidad | Descripción |
---|---|
< | < (menor que) |
> | > (mayor que) |
& | & (ampersand) |
" | " (comillas dobles) |
' | ' (apóstrofe, comilla simple) |
Flash Player y AIR también admiten códigos de caracteres explícitos, como & (ampersand ASCII) y € (símbolo € Unicode).
Implementación
public function get htmlText():String
public function set htmlText(value:String):void
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
tf1
y se asigna una cadena con formato HTML a su propiedad text
. Si se realiza un seguimiento de la propiedad htmlText
, el resultado es la cadena con formato HTML y con etiquetas adicionales (como <P> y <FONT>) añadidas automáticamente por Flash Player. Si se realiza un seguimiento del valor de la propiedad text
, se muestra la cadena sin formato y sin etiquetas HTML.
Para realizar la comparación, se llevan a cabo los mismos pasos en otro objeto TextField llamado tf2
con una novedad: se asigna un objeto StyleSheet a la propiedad de tf2
styleSheet
antes de definir la propiedad htmlText
. En este caso, cuando se realice el seguimiento de la propiedad htmlText
, sólo incluirá el texto HTML exacto asignado en un principio a la propiedad htmlText
, demostrando así que Flash Player no ha añadido ninguna etiqueta.
package { import flash.display.Sprite; import flash.text.StyleSheet; import flash.text.TextField; public class TextField_text extends Sprite { public function TextField_text() { var tf1:TextField = createCustomTextField(10, 10, 400, 22); tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P> trace("htmlText: " + tf1.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf1.text); var tf2:TextField = createCustomTextField(10, 50, 400, 22); tf2.styleSheet = new StyleSheet(); tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <b>Lorem ipsum dolor sit amet.</b> trace("htmlText: " + tf2.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf2.text); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
length | propiedad |
maxChars | propiedad |
maxChars:int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
El número máximo de caracteres que puede incluir el campo de texto, tal y como los ha introducido el usuario. Un script puede insertar más texto que maxChars
; la propiedad maxChars
sólo indica cuánto texto puede introducir el usuario. Si el valor de esta propiedad es 0
, el usuario puede introducir una cantidad ilimitada de texto.
El valor predeterminado es 0.
Implementación
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | propiedad |
maxScrollV | propiedad |
mouseWheelEnabled | propiedad |
mouseWheelEnabled:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Valor booleano que indica si Flash Player desplazará automáticamente campos de texto multilínea cuando el usuario haga clic en un campo de texto y gire la rueda del ratón. De forma predeterminada, este valor es true
. Esta propiedad resulta útil si desea impedir que la rueda del ratón pueda desplazar campos de texto o si desea implementar su propio desplazamiento de campo de texto.
Implementación
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | propiedad |
multiline:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica si el campo de texto es multilínea. Si el valor es true
, el campo de texto es multilínea; si el valor es false
, se trata de un campo de texto de una sola línea. En un tipo de campo TextFieldType.INPUT
, el valor multiline
determina si la tecla Intro
creará una nueva línea (si el valor es false
, se ignorará la tecla Intro
). Si pega texto en un objeto TextField
cuyo valor multiline
sea false
, las nuevas líneas se eliminarán del texto.
El valor predeterminado es false.
Implementación
public function get multiline():Boolean
public function set multiline(value:Boolean):void
Elementos de API relacionados
numLines | propiedad |
numLines:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Define el número de líneas de texto de un campo de varias líneas. Si la propiedad wordWrap
se establece como true
, el número de líneas aumenta al ajustarse el texto.
Implementación
public function get numLines():int
Elementos de API relacionados
restrict | propiedad |
restrict:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica el conjunto de caracteres que los usuarios pueden introducir en el campo de texto. Si el valor de la propiedad restrict
es null
, puede introducir cualquier carácter. Si el valor de la propiedad restrict
es una cadena vacía, no se puede introducir ningún carácter. Si el valor de la propiedad restrict
es una cadena de caracteres, puede introducir caracteres solamente en la cadena del campo de texto. La cadena se examina de izquierda a derecha. Se puede especificar un rango utilizando el carácter de guión (-). Sólo se limita la interacción del usuario; los scripts pueden incluir cualquier texto en el campo de texto. Esta propiedad no se sincroniza con las opciones de incorporación de fuentes del inspector de propiedades.
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.
En el ejemplo siguiente, sólo se permite que se introduzcan caracteres en mayúsculas, espacios y números en un campo de texto:
my_txt.restrict = "A-Z 0-9";
En el ejemplo siguiente, se incluyen todos los caracteres, con excepción de las letras en mayúsculas:
my_txt.restrict = "^a-z";
Puede utilizar una barra invertida para introducir un ^ o - literalmente. Las secuencias con barras invertidas aceptadas son \-, \^ o \\. La barra invertida debe ser un carácter real de la cadena, por lo que cuando se especifica en ActionScript, se debe utilizar una barra doble. Por ejemplo, el código siguiente incluye sólo el guión (-) y el símbolo de intercalación (^):
my_txt.restrict = "\\-\\^";
El carácter ^ se puede utilizar en cualquier lugar de la cadena para incluir o excluir caracteres. El código siguiente incluye sólo letras en mayúsculas, pero excluye la letra Q en mayúscula:
my_txt.restrict = "A-Z^Q";
Puede usar la secuencia de escape \u
para construir cadenas restrict
. El código siguiente incluye solamente los caracteres desde el ASCII 32 (espacio) al ASCII 126 (tilde).
my_txt.restrict = "\u0020-\u007E";
El valor predeterminado es null.
Implementación
public function get restrict():String
public function set restrict(value:String):void
scrollH | propiedad |
scrollH:int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La posición de desplazamiento horizontal actual. Si la propiedad scrollH
es 0, el texto no se desplazará horizontalmente. El valor de esta propiedad es un entero que representa la posición horizontal, expresada en píxeles.
Las unidades de desplazamiento horizontal son píxeles, mientras que las de desplazamiento vertical son líneas. El desplazamiento horizontal se mide en píxeles porque la mayoría de las fuentes que utiliza normalmente tienen espaciado proporcional, lo que significa que los caracteres tienen anchuras diferentes. Flash Player realiza el desplazamiento vertical por líneas, ya que el usuario normalmente desea ver una línea de texto completa y no sólo parte de ella. Aunque en una línea se utilicen varias fuentes, la altura de la línea se ajusta a la de la fuente más grande.
Nota: la propiedad scrollH
está basada en cero (a diferencia de la propiedad de desplazamiento vertical scrollV
, que está basada en uno).
Implementación
public function get scrollH():int
public function set scrollH(value:int):void
Elementos de API relacionados
scrollV | propiedad |
scrollV:int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La posición vertical del texto de un campo de texto. La propiedad scrollV
es útil para dirigir a los usuarios a un párrafo específico en un pasaje largo o para crear campos de texto con desplazamiento.
Las unidades de desplazamiento vertical son líneas, mientras que las de desplazamiento horizontal son píxeles. Si la primera línea mostrada es la primera línea del campo de texto, scrollV se establece como 1 (no como 0). El desplazamiento horizontal se mide en píxeles porque la mayoría de las fuentes que utiliza tienen espaciado proporcional, lo que significa que los caracteres tienen anchuras diferentes. Flash realiza el desplazamiento vertical por líneas, ya que el usuario normalmente desea ver una línea de texto completa y no sólo parte de ella. Aunque en una línea se utilicen varias fuentes, la altura de la línea se ajusta a la de la fuente más grande.
Implementación
public function get scrollV():int
public function set scrollV(value:int):void
Elementos de API relacionados
selectable | propiedad |
selectable:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Valor booleano que indica si el campo de texto puede seleccionarse. El valor true
indica que el texto se puede seleccionar. La propiedad selectable
controla si un campo de texto se puede seleccionar y no si un campo de texto es editable. Un campo dinámico puede seleccionarse aunque no sea editable. Si un campo de texto dinámico no es seleccionable, el usuario no puede seleccionar su texto.
Si selectable
se define como false
, el texto del campo de texto no responderá a los comandos de selección del ratón o el teclado y el texto no se podrá copiar con el comando Copiar. Si selectable
se define como true
, el texto del campo de texto se puede seleccionar con el ratón o el teclado y se puede copiar utilizando el comando Copiar. Puede seleccionar texto de esta forma aunque el campo de texto sea dinámico en lugar de un campo de entrada de texto.
El valor predeterminado es true.
Implementación
public function get selectable():Boolean
public function set selectable(value:Boolean):void
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
selectable
establecida como true
y el otro campo de texto con la propiedad selectable
establecida como false
. Cuando utilice este ejemplo, intente seleccionar el texto de estos campos con el ratón o con el teclado.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class selectableExample extends Sprite { public function selectableExample() { var tf1:TextField = createCustomTextField(10, 10); tf1.text="This text can be selected"; tf1.selectable=true; var tf2:TextField = createCustomTextField(10, 30); tf2.text="This text cannot be selected"; tf2.selectable=false; } private function createCustomTextField(x:Number, y:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.autoSize=TextFieldAutoSize.LEFT; addChild(result); return result; } } }
selectionBeginIndex | propiedad |
selectionBeginIndex:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
El valor de índice basado en cero del primer carácter de la selección actual. Por ejemplo, el primer carácter es 0, el segundo es 1, etc. Si no hay texto seleccionado, esta propiedad es el valor de caretIndex
.
Implementación
public function get selectionBeginIndex():int
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
printCursorPosition
. En ese caso, los valores de las propiedades caretIndex
, selectionBeginIndex
y selectionEndIndex
se proporcionarán como resultado.
Ejecute este ejemplo e intente hacer clic en el objeto TextField para seleccionar texto. A continuación, haga clic en el campo sin seleccionar texto. Al hacer clic en el texto sin realizar la selección, la propiedad caretIndex
indica la posición del punto de inserción y el valor de las propiedades selectionBeginIndex
y selectionEndIndex
es igual que el valor de la propiedad caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
selectionEndIndex | propiedad |
selectionEndIndex:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
El valor de índice basado en cero del último carácter de la selección actual. Por ejemplo, el primer carácter es 0, el segundo es 1, etc. Si no hay texto seleccionado, esta propiedad es el valor de caretIndex
.
Implementación
public function get selectionEndIndex():int
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
printCursorPosition
. En ese caso, los valores de las propiedades caretIndex
, selectionBeginIndex
y selectionEndIndex
se proporcionarán como resultado.
Ejecute este ejemplo e intente hacer clic en el objeto TextField para seleccionar texto. A continuación, haga clic en el campo sin seleccionar texto. Al hacer clic en el texto sin realizar la selección, la propiedad caretIndex
indica la posición del punto de inserción y el valor de las propiedades selectionBeginIndex
y selectionEndIndex
es igual que el valor de la propiedad caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
sharpness | propiedad |
sharpness:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
La nitidez de los bordes de glifo en este campo de texto. Esta propiedad sólo se aplica si la propiedad flash.text.AntiAliasType
del campo de texto se define como flash.text.AntiAliasType.ADVANCED
. El rango de sharpness
es un número entre -400 y 400. Si intenta definir sharpness
con un valor fuera del rango, Flash selecciona el valor más cercano en el rango (-400 o 400) para la propiedad.
El valor predeterminado es 0.
Implementación
public function get sharpness():Number
public function set sharpness(value:Number):void
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
sharpness
en un objeto TextField. Es necesario incorporar la fuente y establecer la propiedad antiAliasType
como ADVANCED
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class sharpnessExample extends Sprite { public function sharpnessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-400); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,400); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldSharpness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.sharpness=fldSharpness; result..setTextFormat(format); addChild(result); return result; } } }
styleSheet | propiedad |
styleSheet:StyleSheet
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Asocia una hoja de estilos al campo de texto. Para más información sobre la creación de hojas de estilos, consulte la clase StyleSheet y la Guía del desarrollador de ActionScript 3.0.
La hoja de estilos asociada a un campo de texto se puede cambiar en cualquier momento. Si se cambia la hoja de estilos en uso, el campo de texto vuelve a dibujarse utilizando la nueva hoja de estilos. Se puede definir la hoja de estilos como null
o undefined
para eliminarla. Si se elimina la hoja de estilos en uso, el campo de texto vuelve a dibujarse sin ninguna hoja de estilos.
Nota: si se elimina la hoja de estilos, cambia el contenido de TextField.text
y TextField.htmlText
para incorporar el formato aplicado anteriormente por la hoja de estilos. Para conservar el contenido original de TextField.htmlText
sin el formato, guarde el valor en una variable antes de eliminar la hoja de estilos.
Implementación
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
stylesheet
antes de definir el contenido.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.StyleSheet; public class TextStylesheetExample extends Sprite { var myLabel:TextField = new TextField(); var labelText:String = "Hello world."; var newStyle:StyleSheet = new StyleSheet(); public function TextStylesheetExample() { var styleObj:Object = new Object(); styleObj.fontWeight = "bold"; styleObj.color = "#660066"; newStyle.setStyle(".defStyle", styleObj); myLabel.styleSheet=newStyle; myLabel.htmlText=labelText; addChild(myLabel); } } }
text | propiedad |
text:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Una cadena que es el texto actual del campo de texto. Las líneas se separan mediante el carácter de retorno de carro ('\r'
, ASCII 13). La propiedad contiene texto sin formato en el campo de texto, sin etiquetas HTML.
Para obtener el texto en formato HTML, utilice la propiedad htmlText
.
Nota: si se aplica una hoja de estilos al campo de texto, el contenido de la propiedad text
se interpreta como HTML.
Implementación
public function get text():String
public function set text(value:String):void
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
tf1
y se asigna una cadena con formato HTML a su propiedad text
. Si se realiza un seguimiento de la propiedad htmlText
, el resultado es la cadena con formato HTML y con etiquetas adicionales (como <P> y <FONT>) añadidas automáticamente por Flash Player. Si se realiza un seguimiento del valor de la propiedad text
, se muestra la cadena sin formato y sin etiquetas HTML.
Para realizar la comparación, se llevan a cabo los mismos pasos en otro objeto TextField llamado tf2
con una novedad: se asigna un objeto StyleSheet a la propiedad de tf2
styleSheet
antes de definir la propiedad htmlText
. En este caso, cuando se realice el seguimiento de la propiedad htmlText
, sólo incluirá el texto HTML exacto asignado en un principio a la propiedad htmlText
, demostrando así que Flash Player no ha añadido ninguna etiqueta.
package { import flash.display.Sprite; import flash.text.StyleSheet; import flash.text.TextField; public class TextField_text extends Sprite { public function TextField_text() { var tf1:TextField = createCustomTextField(10, 10, 400, 22); tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P> trace("htmlText: " + tf1.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf1.text); var tf2:TextField = createCustomTextField(10, 50, 400, 22); tf2.styleSheet = new StyleSheet(); tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <b>Lorem ipsum dolor sit amet.</b> trace("htmlText: " + tf2.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf2.text); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
textColor | propiedad |
textColor:uint
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
El color del texto de un campo de texto, expresado en formato hexadecimal. El sistema de colores hexadecimal utiliza seis dígitos para representar los valores de color. Cada dígito tiene 16 valores o caracteres posibles. El rango de caracteres oscila entre 0 y 9, y entre A y F. Por ejemplo, el color negro es 0x000000
; el color blanco es 0xFFFFFF
.
El valor predeterminado es 0 (0x000000).
Implementación
public function get textColor():uint
public function set textColor(value:uint):void
Ejemplo ( Cómo utilizar este ejemplo )
textColor
a rojo (0xFF0000
).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textColor extends Sprite { public function TextField_textColor() { var tf:TextField = createCustomTextField(10, 10, 100, 300); tf.text = "This will be red text"; tf.textColor = 0xFF0000; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
textHeight | propiedad |
textHeight:Number
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La altura del texto, expresada en píxeles.
Implementación
public function get textHeight():Number
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
trace
muestran los valores de las propiedades textWidth
y textHeight
. Por motivos de comparación, las propiedades width
y height
también se muestran. (Tenga en cuenta que los valores que ve para textHeight
y textWidth
pueden variar en función de la fuente utilizada en su equipo).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textHeight extends Sprite { public function TextField_textHeight() { var tf:TextField = createCustomTextField(10, 10, 100, 150); tf.text = "Sample text"; trace("textWidth: " + tf.textWidth); // textWidth: 55.75 trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001 trace("width: " + tf.width); // width: 100 trace("height: " + tf.height); // height: 150 } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; result.background = true; addChild(result); return result; } } }
textInteractionMode | propiedad |
textInteractionMode:String
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 11, Flash Lite 4 |
La propiedad del modo de interacción; el valor predeterminado es TextInteractionMode.NORMAL. En plataformas móviles, el modo normal implica que el texto se puede desplazar pero no seleccionar. Se puede cambiar al modo seleccionable a través del menú contextual en el campo de texto. En el escritorio, el modo normal implica que el texto está se puede desplazar y seleccionar.
Implementación
public function get textInteractionMode():String
textWidth | propiedad |
textWidth:Number
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La anchura del texto, expresada en píxeles.
Implementación
public function get textWidth():Number
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
trace
muestran los valores de las propiedades textWidth
y textHeight
. Por motivos de comparación, las propiedades width
y height
también se muestran. (Tenga en cuenta que los valores que ve para textHeight
y textWidth
pueden variar en función de la fuente utilizada en su equipo).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textHeight extends Sprite { public function TextField_textHeight() { var tf:TextField = createCustomTextField(10, 10, 100, 150); tf.text = "Sample text"; trace("textWidth: " + tf.textWidth); // textWidth: 55.75 trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001 trace("width: " + tf.width); // width: 100 trace("height: " + tf.height); // height: 150 } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; result.background = true; addChild(result); return result; } } }
thickness | propiedad |
thickness:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
El grosor de los bordes de glifo en este campo de texto. Esta propiedad sólo se aplica cuando flash.text.AntiAliasType
es flash.text.AntiAliasType.ADVANCED
.
El rango de thickness
es un número entre -200 y 200. Si intenta definir thickness
con un valor fuera del rango, la propiedad se define como el valor más cercano en el rango (-200 ó 200).
El valor predeterminado es 0.
Implementación
public function get thickness():Number
public function set thickness(value:Number):void
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
thickness
en un objeto TextField. Es necesario incorporar la fuente y establecer la propiedad antiAliasType
como ADVANCED
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class thicknessExample extends Sprite { public function thicknessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-200); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,200); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldThickness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.thickness=fldThickness; result.setTextFormat(format); addChild(result); return result; } } }
type | propiedad |
type:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tipo del campo de texto. Puede ser una de las siguientes constantes TextFieldType: TextFieldType.DYNAMIC
, que especifica un campo de texto dinámico que el usuario no puede editar, o bien TextFieldType.INPUT
, que especifica un campo de introducción de texto que el usuario sí puede editar.
El valor predeterminado es dynamic.
Implementación
public function get type():String
public function set type(value:String):void
Emite
ArgumentError — La cadena type especificada no es un miembro de flash.text.TextFieldType.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
tfDynamic
y tfInput
. El texto se introduce en los dos campos. No obstante, tfDynamic
tiene su propiedad type
definida como TextFieldType.DYNAMIC
y tfInput
tiene su propiedad type
definida como TextFieldType.INPUT
, por lo que el usuario puede modificar el texto en tfInput
pero sólo podrá verlo en tfDynamic
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_type extends Sprite { public function TextField_type() { var tfDynamic:TextField = createCustomTextField(10, 10, 100, 20); tfDynamic.type = TextFieldType.DYNAMIC; tfDynamic.text = "hello"; var tfInput:TextField = createCustomTextField(10, 45, 100, 20); tfInput.type = TextFieldType.INPUT; tfInput.text = "world"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
useRichTextClipboard | propiedad |
useRichTextClipboard:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Especifica si se copia y se pega el formato del texto junto con el propio texto. Cuando se establece como true
, Flash Player también copia y pega el formato (alineación, negrita y cursiva) al copiar y pegar entre dos campos de texto. Tanto el campo de texto de origen como el de destino en el procedimiento de copiar y pegar deben tener useRichTextClipboard
definido como true
. El valor predeterminado es false
.
Implementación
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
Ejemplo ( Cómo utilizar este ejemplo )
tf1
) y dos campos de texto dinámico (tf2
y tf3
). El código asigna cada campo de texto dinámico a un objeto TextFormat (fuente Courier negrita). El campo de texto tf2
tiene la propiedad useRichTextClipboard
establecida como false
. El campo de texto tf3
tiene la propiedad useRichTextClipboard
establecida como true
. Cuando copia texto del campo de texto tf2
y lo pega en el campo de texto tf1
, el texto pegado no conserva el formato. Cuando copia texto del campo de texto tf3
(que tiene la propiedad useRichTextClipboard
establecida como true
) y lo pega en el campo de texto tf1
, el texto pegado sí conserva el formato.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; public class useRichTextClipboard extends Sprite { public function useRichTextClipboard() { var format1:TextFormat = new TextFormat(); format1.font="Courier"; format1.bold=true; var tf1:TextField = createCustomTextField(10, 10, 200, 20); tf1.type=TextFieldType.INPUT; tf1.useRichTextClipboard=true; var tf2:TextField = createCustomTextField(220, 10, 200, 20); tf2.text="1.Text loses format"; tf2.setTextFormat(format1); tf2.useRichTextClipboard=false; var tf3:TextField = createCustomTextField(220, 50, 200, 20); tf3.text="2.Text includes format"; tf3.setTextFormat(format1); tf3.useRichTextClipboard=true; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
wordWrap | propiedad |
wordWrap:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Valor booleano que indica si el campo de texto tiene ajuste de texto. Si el valor de wordWrap
es true
, el campo de texto tiene ajuste de texto; si el valor es false
, el campo de texto no tiene ajuste de texto. El valor predeterminado es false
.
Implementación
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
Ejemplo ( Cómo utilizar este ejemplo )
wordWrap
como true
o como false
. Se crean dos instancias de TextField con contenido que supera sus anchuras. La propiedad wordWrap
de la primera instancia (denominada tfWrap
) se define como true
; se define como false
para la segunda instancia (tfNoWrap
).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_wordWrap extends Sprite { public function TextField_wordWrap() { var tfWrap:TextField = createCustomTextField(10, 10, 100, 100); tfWrap.wordWrap = true; tfWrap.text = "(wordWrap = true):\nThis is very long text that will certainly extend beyond the width of this text field"; var tfNoWrap:TextField = createCustomTextField(10, 150, 100, 100); tfNoWrap.wordWrap = false; tfNoWrap.text = "(wordWrap = false):\nThis is very long text that will certainly extend beyond the width of this text field"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
TextField | () | Información sobre |
public function TextField()
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea una nueva instancia de TextField. Tras crear la instancia de TextField, llame al método addChild()
o addChildAt()
de la instancia DisplayObjectContainer principal para colocar la instancia de TextField en la lista de visualización.
El tamaño predeterminado para un campo de texto es de 100 x 100 píxeles.
Ejemplo ( Cómo utilizar este ejemplo )
var theTextField:TextField = new TextField(); theTextField.type = TextFieldType.INPUT; theTextField.border = true; theTextField.x = 10; theTextField.y = 10; theTextField.multiline = true; theTextField.wordWrap = true; addChild(theTextField);
appendText | () | método |
public function appendText(newText:String):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Añade la cadena especificada por el parámetro newText
al final del texto del campo de texto. Este método es más eficaz que una asignación de suma (+=
) en una propiedad text
(por ejemplo, someTextField.text += moreText
), especialmente para un campo de texto que incluye una importante cantidad de contenido.
Parámetros
newText:String — La cadena que se añade al texto existente.
|
Ejemplo ( Cómo utilizar este ejemplo )
El campo de texto outputText
se define para que ajuste automáticamente el texto y cambie el tamaño a texto justificado a la izquierda mediante la propiedad autoSize
. La propiedad outputText.text
escribe la primera línea del contenido y el método appendText()
añade el resto del contenido. (No es necesario comenzar por la propiedad text
. El método appendText()
también se podría utilizar para añadir texto desde el principio.) La definición de la propiedad text
una segunda vez sobrescribirá el texto original. Utilice el operador +=
para añadir contenido con la propiedad text
.
La sentencia if
comprueba si la fecha es sábado (6) o domingo (0). Si no lo es, el método toLocaleTimeString()
devuelve la hora local, que se añade al contenido del campo de texto.
La propiedad length
del campo de texto se utiliza para leer el número de caracteres hasta justo antes de que se llame a la función y la propiedad numLines
se utiliza para realizar el recuento del número de líneas en el campo de texto. Tenga en cuenta que las líneas vacías se cuentan en el número de líneas, mientras que los espacios vacíos y los saltos de línea (\n) se cuentan al determinar la longitud del contenido.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_appendTextExample extends Sprite { public function TextField_appendTextExample() { var outputText:TextField = new TextField(); var today:Date = new Date(); outputText.x = 10; outputText.y = 10; outputText.background = true; outputText.autoSize = TextFieldAutoSize.LEFT; outputText.text = "WHAT TIME IS IT?" + "\n\n"; if((today.day == 0) || (today.day == 6)) { outputText.appendText("It's the weekend."); outputText.appendText("\n\n"); } else { outputText.appendText("The time is: "); outputText.appendText(today.toLocaleTimeString() + ".\n\n"); } outputText.appendText("Number of characters including line breaks and spaces so far: "); outputText.appendText(outputText.length.toString() + "\n"); outputText.appendText("Number of lines in the outputText: "); outputText.appendText(outputText.numLines.toString()); this.addChild(outputText); } } }
getCharBoundaries | () | método |
public function getCharBoundaries(charIndex:int):Rectangle
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve un rectángulo como recuadro de delimitación del carácter.
Parámetros
charIndex:int — El valor de índice basado en cero para el carácter (por ejemplo, la primera posición es 0, la segunda posición es 1, etc.).
|
Rectangle — Un rectángulo con valores máximos y mínimos x e y que definen el recuadro de delimitación del carácter.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
getCharBoundaries()
para marcar (destacar) un carácter seleccionado por el usuario.
La clase define el objeto Shape spotlight
que se utilizará para dibujar un rectángulo alrededor de cada carácter seleccionado. Cuando el usuario hace clic en el campo de texto myTextField
, se invoca el método clickHandler()
.
En el método clickHandler()
, el método getCharIndexAtPoint()
obtiene el índice del carácter seleccionado en función de las coordenadas localX
y localY
del clic del ratón, que es relativa a la clase Sprite
que contiene. El método getCharIndexAtPoint()
devuelve -1
si el punto (clic del mouse) no estaba sobre el carácter. Puesto que el campo de texto podría ser mayor que el texto, se comprueba el entero devuelto (index
) para asegurarse de que el usuario ha hecho clic en un carácter. El entero index
también lo utiliza getCharBoundaries()
para obtener un objeto Rectangle
que contiene el límite del carácter. El método clear()
borra cualquier objeto Shape spotlight
mostrado anteriormente. Se produce un nuevo rectángulo con el tamaño de los límites de altura y anchura del carácter en la ubicación del carácter (desplazamiento de las coordenadas (10, 10)) mediante las coordenadas x e y del rectángulo frame
devuelto. Para marcar el carácter, se rellena el objeto Shape spotlight
de color amarillo y se define la opacidad en el 35%, de modo que se pueda ver el carácter. Tenga en cuenta que los espacios también se consideran caracteres.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.geom.Rectangle; import flash.events.MouseEvent; import flash.text.TextFieldAutoSize; import flash.display.Shape; public class TextField_getCharBoundariesExample extends Sprite { private var myTextField:TextField = new TextField(); private var spotlight:Shape = new Shape(); public function TextField_getCharBoundariesExample() { myTextField.x = 10; myTextField.y = 10; myTextField.border = true; myTextField.selectable = false; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.text = "Selected a character from this text by clicking on it." myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); this.addChild(spotlight); } private function clickHandler (e:MouseEvent):void { var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if (index != -1) { var frame:Rectangle = myTextField.getCharBoundaries(index); spotlight.graphics.clear(); spotlight.graphics.beginFill(0xFFFF00, .35); spotlight.graphics.drawRect((frame.x + 10), (frame.y + 10), frame.width, frame.height); spotlight.graphics.endFill(); } } } }
getCharIndexAtPoint | () | método |
public function getCharIndexAtPoint(x:Number, y:Number):int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve un valor de índice basado en cero del carácter en el punto especificado por los parámetros x
e y
.
Parámetros
x:Number — La coordenada x del carácter.
| |
y:Number — La coordenada y del carácter.
|
int — El valor de índice basado en cero para el carácter (por ejemplo, la primera posición es 0, la segunda es 1, etc.). Devuelve -1 si el punto no está sobre ningún carácter.
|
Ejemplo ( Cómo utilizar este ejemplo )
El primer campo incluye el texto que va a seleccionar el usuario. Para asegurarse de que se hace clic en el texto pero no se selecciona, la propiedad selectable
se define como false. Cuando el usuario hace clic en el campo de texto firstTextField
, se invoca el método clickHandler()
.
En el método clickHandler()
, el método getCharIndexAtPoint()
devuelve el índice del carácter en función de las coordenadas localX
y localY
del clic del ratón. Puesto que el campo de texto podría ser mayor que el texto, se comprueba el entero devuelto (index
) para asegurarse de que el usuario ha hecho clic en un carácter. (El método getCharIndexAtPoint()
devuelve -1
si el punto (clic del mouse) no estaba sobre ningún carácter.) Las coordenadas del ratón se utilizan para definir las coordenadas del nuevo campo de texto en el que aparecerá el carácter duplicado (con eco). El color del carácter en el segundo campo de texto se define en rojo. Finalmente, el texto del segundo campo se define con el carácter seleccionado, que se recupera mediante el método charAt()
. Tenga en cuenta que el uso de la propiedad text
en lugar del método appendText()
sobrescribirá el carácter del segundo campo de texto en lugar de añadirlo.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.geom.Rectangle; import flash.events.MouseEvent; import flash.text.TextFieldAutoSize; public class TextField_getCharIndexAtPointExample extends Sprite { private var firstTextField:TextField = new TextField(); private var secondTextField:TextField = new TextField(); public function TextField_getCharIndexAtPointExample() { firstTextField.x = 100; firstTextField.y = 100; firstTextField.width = 260; firstTextField.height = 20; firstTextField.border = true; firstTextField.background = true; firstTextField.selectable = false; firstTextField.text = "Selected a character from this text by clicking on it." firstTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(firstTextField); this.addChild(secondTextField); } private function clickHandler (e:MouseEvent):void { var index:int = firstTextField.getCharIndexAtPoint(e.localX, e.localY); if (index != -1) { secondTextField.x = mouseX; secondTextField.y = 70; secondTextField.border = true; secondTextField.selectable = false; secondTextField.background = true; secondTextField.textColor = 0xFF0000; secondTextField.autoSize = TextFieldAutoSize.LEFT; secondTextField.text = firstTextField.text.charAt(index); } } } }
getFirstCharInParagraph | () | método |
public function getFirstCharInParagraph(charIndex:int):int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dado un índice del carácter, devuelve el índice del primer carácter del mismo párrafo.
Parámetros
charIndex:int — El valor de índice basado en cero para el carácter (por ejemplo, el primer carácter es 0, el segundo carácter es 1, etc.).
|
int — El valor de índice basado en cero del primer carácter del mismo párrafo.
|
Emite
RangeError — El índice del carácter especificado está fuera de rango.
|
Ejemplo ( Cómo utilizar este ejemplo )
En el constructor, el campo de texto myTextField
se define como ajuste de texto. El método getTextFormat
devuelve el formato original del primer carácter del contenido del campo de texto, que se ubica en el objeto originalFormat
TextFormat. También se define un nuevo objeto TextFormat (newFormat
) y se asigna la propiedad align
como justificada a la derecha. Cuando el usuario hace clic en el campo de texto, se invoca el método clickHandler()
.
En el método clickHandler()
, el método getCharIndexAtPoint()
devuelve el índice del carácter en función de las coordenadas localX
y localY
del clic del ratón. La primera sentencia if
comprueba si el usuario ha hecho clic en el carácter. Con el entero clickIndex
devuelto por el método getCharIndexAtPoint()
, el método getFirstCharInParagraph()
devuelve el índice del primer carácter del párrafo que el usuario ha seleccionado. El índice del último carácter del párrafo se determina mediante la incorporación de la longitud del párrafo (con el método getParagraphLength()
) al índice del primer carácter del párrafo, menos el último carácter (\n
). La segunda sentencia if
comprueba el formato del primer carácter del párrafo. Si su valor de alineación es el mismo que el formato original (justificado a la izquierda), el nuevo formato se aplica a todos los caracteres del párrafo. De lo contrario, el formato del párrafo cambia al formato original. La alineación, junto con opciones de formato como la sangría, viñetas, tabulaciones, márgenes derecho e izquierdo, son formatos específicos de párrafos. Tenga en cuenta que una vez que se utiliza el ajuste de texto o el salto de línea, el formato sólo se aplicará a la primera línea del párrafo si el argumento endIndex
no está definido para el método setTextFormat()
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; import flash.text.TextFormat; import flash.text.TextFormatAlign; public class TextField_getFirstCharInParagraphExample extends Sprite { private var myTextField:TextField = new TextField(); private var originalFormat:TextFormat = new TextFormat(); private var newFormat:TextFormat = new TextFormat(); public function TextField_getFirstCharInParagraphExample() { myTextField.x = 10; myTextField.y = 10; myTextField.border = true; myTextField.wordWrap = true; myTextField.width = 300; myTextField.height = 300; myTextField.background = true; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file " + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n" + "To create a text field dynamically, use the TextField constructor.\n\n" + "The methods of the TextField class let you set, select, and manipulate " + "text in a dynamic or input text field that you create during authoring or at runtime.\n\n"); originalFormat = myTextField.getTextFormat(0); newFormat.align = TextFormatAlign.RIGHT; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); } private function clickHandler(e:MouseEvent):void { var clickIndex:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if(clickIndex != -1) { var paragraphFirstIndex:int = myTextField.getFirstCharInParagraph(clickIndex); var paragraphEndIndex:int = paragraphFirstIndex + ((myTextField.getParagraphLength(clickIndex) - 1)); if (myTextField.getTextFormat(paragraphFirstIndex).align == originalFormat.align) { myTextField.setTextFormat(newFormat, paragraphFirstIndex, paragraphEndIndex); }else { myTextField.setTextFormat(originalFormat, paragraphFirstIndex, paragraphEndIndex); } } } } }
getImageReference | () | método |
public function getImageReference(id:String):DisplayObject
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve una referencia DisplayObject para el id
dado, ya que se ha añadido una imagen o un archivo SWF a un campo de texto con formato HTML mediante la etiqueta <img>
. La etiqueta <img>
tiene el siguiente formato:
<img src = 'filename.jpg' id = 'instanceName' >
Parámetros
id:String — El id que debe coincidir (en el atributo id de la etiqueta <img> ).
|
DisplayObject — El objeto de visualización correspondiente a la imagen o al archivo SWF con el atributo coincidente id en la etiqueta <img> del campo de texto. En medios cargados desde un origen externo, este objeto es un objeto Loader y, una vez cargado, el objeto de medios se convierte en un elemento secundario del objeto Loader. En el caso de medios incorporados al archivo SWF, se trata del objeto cargado. Si no hay ninguna etiqueta <img> con el id coincidente, el método devuelve null .
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
La imagen (image.jpg
) se incluye a través de HTML. (En este caso, se asume que un archivo de imagen está en el mismo directorio que el archivo SWF.) Un atributo id
necesita definirse para la etiqueta img
a fin de tener acceso a la imagen utilizando el método getImageReference()
. La propiedad htmlText
se utiliza para incluir contenido de cadenas con formato HTML. Cuando el usuario hace clic en el campo de texto myTextField
, se invoca el método clickHandler()
.
En el método clickHandler()
, el método getImageReference()
devuelve una referencia a la imagen como DisplayObject
. Esta referencia se puede utilizar para manipular la imagen, como cualquier otro objeto DisplayObject
. En este caso, se establecen las propiedades alpha
(transparencia) yrotation
. También se puede utilizar la propiedad transform
para acceder a los límites de píxel, transformación de color y matriz del objeto de visualización. Tenga también en cuenta que flash.display.DisplayObject
debe importarse.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.Event; import flash.events.MouseEvent; import flash.display.DisplayObject; import flash.text.TextFieldAutoSize; public class TextField_getImageReferenceExample extends Sprite { private var myTextField:TextField = new TextField(); public function TextField_getImageReferenceExample() { var myText1:String = "<p>Here is an image we want to mainpulate: <img src='image.jpg' id='testimage'></p>"; myTextField.x = 10; myTextField.y = 10; myTextField.width = 250; myTextField.height = 250; myTextField.background = true; myTextField.border = true; myTextField.border = true; myTextField.multiline = true; myTextField.htmlText = myText1; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); } private function clickHandler(e:MouseEvent):void { var imageRef:DisplayObject = myTextField.getImageReference("testimage"); imageRef.rotation += 90; imageRef.x = 125; imageRef.y = 125; imageRef.alpha = 0.25; } } }
getLineIndexAtPoint | () | método |
public function getLineIndexAtPoint(x:Number, y:Number):int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve un valor de índice basado en cero de la línea en el punto especificado por los parámetros x
e y
.
Parámetros
x:Number — La coordenada x de la línea.
| |
y:Number — La coordenada y de la línea.
|
int — El valor de índice basado en cero para la línea (por ejemplo, la primera línea es 0, la segunda es 1, etc.). Devuelve -1 si el punto no está sobre ninguna línea.
|
Ejemplo ( Cómo utilizar este ejemplo )
En el constructor, el campo de texto poem
se establece de modo que no se ajuste en líneas continuas (ya que se trata de un poema). También se utiliza la propiedad autoSize
para especificar que el texto se ajuste automáticamente y cambie el tamaño a texto ajustado a la izquierda. El campo de texto poemCopy
se coloca debajo del campo poem
. Cuando el usuario hace clic en una línea del poema, se invoca el método clickHandler()
.
En el método clickHandler()
, el método getLineIndexAtPoint()
devuelve el índice de línea en el que el usuario ha hecho clic según las coordenadas localX
y localY
del clic del ratón. (Puesto que aquí el poema original se ajusta al tamaño del campo de texto, no es necesario comprobar los errores de fuera del rango (RangeError
) emitidos por el método getCharIndexAtPoint()
.) A continuación, se utiliza el índice de línea para obtener el contenido de la línea como cadena con el método getLineText()
, que se añade después al contenido del campo de texto poemCopy
. La acción de copia puede repetirse continuamente pero llegado a un punto, el texto estará fuera del rango de visibilidad del campo de texto poemCopy
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; public class TextField_getLineIndexAtPointExample extends Sprite { private var poem:TextField = new TextField(); private var poemCopy:TextField = new TextField(); public function TextField_getLineIndexAtPointExample() { poem.border = true; poem.autoSize = TextFieldAutoSize.LEFT; poem.x = 10; poem.wordWrap = false; poemCopy.height = 250; poemCopy.width = 270; poemCopy.y = 230; poemCopy.x = 10; poemCopy.background = true; poemCopy.border = true; poemCopy.wordWrap = false; poem.appendText("Let me not to the marriage of true minds\n" + "Admit impediments. love is not love\n" + "Which alters when it alteration finds\n" + "Or bends with the remover to remove:\n" + "O no! it is an ever-fixed mark\n" + "That looks on tempests and is never shaken;\n" + "It is the star to every wandering bark,\n" + "Whose worth's unknown, although his height be taken.\n" + "Love's not Time's fool, though rosy lips and cheeks\n" + "Within his bending sickle's compass come:\n" + "Love alters not with his brief hours and weeks,\n" + "But bears it out even to the edge of doom.\n" + "If this be error and upon me proved,\n" + "I never writ, nor no man ever loved."); poem.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(poem); this.addChild(poemCopy); } private function clickHandler(e:MouseEvent):void { var index:int = poem.getLineIndexAtPoint(e.localX, e.localY); var s:String; s = poem.getLineText(index); poemCopy.appendText(s + "\n"); } } }
getLineIndexOfChar | () | método |
public function getLineIndexOfChar(charIndex:int):int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve un valor de índice basado en cero de la línea que contiene el carácter especificado por el parámetro charIndex
.
Parámetros
charIndex:int — El valor de índice basado en cero para el carácter (por ejemplo, el primer carácter es 0, el segundo carácter es 1, etc.).
|
int — El valor de índice basado en cero de la línea.
|
Emite
RangeError — El índice del carácter especificado está fuera de rango.
|
Ejemplo ( Cómo utilizar este ejemplo )
getLineIndexOfChar()
devuelve los números de línea para los caracteres 100 y 500 del campo de texto.
El campo de texto myTextField
está definido para ajustarse y cambiar el tamaño como texto justificado a la izquierda. El método getLineIndexOfChar()
devuelve el índice de línea para los índices de caracteres especificados (100 y 500). Esta información se añade después del párrafo. Tenga en cuenta que puesto que el índice de línea comienza por 0, el índice (index
) aumenta en 1 para obtener el número de línea. Asimismo, si modifica el tamaño de la visualización, el número de líneas puede cambiar pero la información permanecerá igual, ya que el método sólo se invoca una vez.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_getLineIndexOfCharExample extends Sprite { public function TextField_getLineIndexOfCharExample() { var myTextField:TextField = new TextField(); myTextField.x = 10; myTextField.y = 10; myTextField.width = 200; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file" + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n"); var index:int = myTextField.getLineIndexOfChar(100); myTextField.appendText("100th character is in line: " + (index + 1) + "\n"); index = myTextField.getLineIndexOfChar(500); myTextField.appendText("500th character is in line: " + (index + 1)); this.addChild(myTextField); } } }
getLineLength | () | método |
public function getLineLength(lineIndex:int):int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve el número de caracteres de una línea de texto específica.
Parámetros
lineIndex:int — El número de línea para el que se desea obtener la longitud.
|
int — Número de caracteres de la línea.
|
Emite
RangeError — El número de línea especificado está fuera de rango.
|
Ejemplo ( Cómo utilizar este ejemplo )
Como ilustración, el campo de texto myTextField
, que muestra el texto que se contará, está definido como INPUT
, lo que indica que los usuarios pueden realmente cambiar las líneas, o bien añadir líneas entre las líneas o al final. (Hay una línea vacía creada utilizando el salto de línea (\n
) al final de la última línea.) El campo de texto countLines
, donde se muestra el resultado de contar la longitud de la línea, está establecido debajo de myTextField
y su texto no es seleccionable. Cuando el usuario hace clic en una línea del campo de texto myTextField
, se invoca el método clickHandler()
.
En el método clickHandler()
, el método getLineIndexAtPoint()
devuelve el índice de línea en el que el usuario ha hecho clic utilizando las coordenadas localX
y localY
del clic del ratón. La sentencia if
comprueba si el usuario ha hecho clic en un carácter. Si es así, el método getLineLength()
, mediante el índice de la línea, devuelve el número de caracteres de la línea. Tenga en cuenta que las líneas vacías entre las líneas incluyen el segundo salto de línea (\n
) y tienen un recuento de 1 carácter, mientras que la líneas después de la última línea tienen un recuento de 0. Los espacios también cuentan como un carácter. Los usuarios pueden escribir una nueva línea o cambiar una y obtener el número de caracteres de la línea haciendo clic en ella. Si se utiliza el ajuste de texto y se cambia el tamaño de la pantalla, el índice de línea podría modificarse
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.events.Event; import flash.events.MouseEvent; public class TextField_getLineLengthExample extends Sprite { private var myTextField:TextField = new TextField(); private var countLines:TextField = new TextField(); public function TextField_getLineLengthExample() { myTextField.x = 10; myTextField.y = 10; myTextField.width = 350; myTextField.height = 150; myTextField.background = true; myTextField.border = true; myTextField.type = TextFieldType.INPUT; myTextField.appendText("Click on the lines to count its number of characters:\n\n"); myTextField.appendText("This is a short line.\n"); myTextField.appendText("This is a longer line than the last line.\n\n"); myTextField.appendText("This one is even longer than the one before. It has two sentences.\n"); this.addChild(myTextField); countLines.border = true; countLines.x = 10; countLines.y = 180; countLines.height = 30; countLines.width = 200; countLines.background = true; countLines.selectable = false; this.addChild(countLines); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); } private function clickHandler(e:MouseEvent):void { var index:int = myTextField.getLineIndexAtPoint(e.localX, e.localY); if (index != -1) { var lenght:int = myTextField.getLineLength(index); countLines.text = "Number of characters in the line is: " + lenght.toString(); } } } }
getLineMetrics | () | método |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve información de medidas sobre una línea de texto dada.
Parámetros
lineIndex:int — El número de línea para el que se desea obtener la información de medidas.
|
flash.text:TextLineMetrics — Un objeto TextLineMetrics.
|
Emite
RangeError — El número de línea especificado está fuera de rango.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
El texto añadido consta de dos líneas de Song of Myself de Walt Whitman. Se utiliza un nuevo objeto TextFormat (newFormat
) para establecer el formato de la segunda línea. La primera línea mantiene el formato predefinido. El método getLineMetrics()
devuelve un objeto TextLineMetrics
para una línea específica. (El índice de línea empieza por 0.) Al utilizar los objetos TextLineMetrics metrics1
y metrics2
para la línea uno y dos, respectivamente, se recuperan y muestran los valores ascendente, descendente, de altura y de peso de la línea. Los números resultantes se convierten en cadena pero no se redondean. Tenga en cuenta que este valor es para la línea y no es un carácter específico. Refleja el rango de caracteres de la línea. Por ejemplo, si una línea tiene diferentes caracteres con distintos formatos de altura, el carácter con mayor altura determinará el valor. Esto significa también que si se modifica uno de los formatos del carácter, también podrían cambiar algunos de los valores de métrica.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextLineMetrics; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.TextFormat; public class TextField_getLineMetricsExample extends Sprite { public function TextField_getLineMetricsExample() { var myTextField:TextField = new TextField(); var newFormat:TextFormat = new TextFormat(); myTextField.x = 10; myTextField.y = 10; myTextField.background = true; myTextField.wordWrap = false; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.appendText("A child said What is the grass? fetching it to me with full hands;\n"); myTextField.appendText("How could I answer the child? I do not know what it is any more than he.\n\n"); newFormat.size = 14; newFormat.font = "Arial"; newFormat.italic = true; myTextField.setTextFormat(newFormat, 67, 139); var metrics1:TextLineMetrics = myTextField.getLineMetrics(0); myTextField.appendText("Metrics ascent for the line 1 is: " + metrics1.ascent.toString() + "\n"); myTextField.appendText("Metrics descent is: " + metrics1.descent.toString() + "\n"); myTextField.appendText("Metrics height is: " + metrics1.height.toString() + "\n"); myTextField.appendText("Metrics width is: " + metrics1.width.toString() + "\n\n"); var metrics2:TextLineMetrics = myTextField.getLineMetrics(1); myTextField.appendText("Metrics ascent for the line 2 is: " + metrics2.ascent.toString() + "\n"); myTextField.appendText("Metrics descent is: " + metrics2.descent.toString() + "\n"); myTextField.appendText("Metrics height is: " + metrics2.height.toString() + "\n"); myTextField.appendText("Metrics width is: " + metrics2.width.toString() + "\n"); addChild(myTextField); } } }
getLineOffset | () | método |
public function getLineOffset(lineIndex:int):int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve el índice de carácter del primer carácter de la línea especificada por el parámetro lineIndex
.
Parámetros
lineIndex:int — El valor de índice basado en cero para la línea (por ejemplo, la primera línea es 0, la segunda es 1, etc.).
|
int — El valor de índice basado en cero del primer carácter de la línea.
|
Emite
RangeError — El número de línea especificado está fuera de rango.
|
Ejemplo ( Cómo utilizar este ejemplo )
El campo de texto myTextField
está establecido en ajuste de texto. El campo de texto countField
mostrará el primer carácter de la línea 4. Cuando el usuario hace clic en el campo de texto myTextField
, se invoca el método clickHandler()
.
En el método clickHandler()
, el método getLineOffset()
devuelve el índice del primer carácter en el índice de línea 3, que es la cuarta línea del texto. (La primera línea tiene un índice de 0.) El método charAt()
se utiliza para obtener el carácter utilizando el índice del primer carácter de la cuarta línea. El contenido del campo de texto countField
se actualiza con esta información mediante la propiedad text
del campo de texto countField
. El uso de la propiedad countField.text
implica que cada vez que se haga clic, se sobrescribirá el contenido del campo de texto countField
. Si el usuario cambia el tamaño de la pantalla, se ajustará el contenido y podría cambiar el primer carácter de la línea 4. Si hace clic de nuevo en el campo myTextField
, se actualiza el campo de texto countField
con el primer carácter nuevo para la cuarta línea.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_getLineOffsetExample extends Sprite { private var myTextField:TextField = new TextField(); private var countField:TextField = new TextField(); public function TextField_getLineOffsetExample() { myTextField.x = 10; myTextField.y = 10; myTextField.width = 150; myTextField.height = 300; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; countField.height = 20; countField.width = 200; countField.x = 10; countField.y = 320; countField.selectable = false; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file " + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript."); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); this.addChild(countField); } private function clickHandler(e:MouseEvent):void { var c:String; var index:int; index = myTextField.getLineOffset(3); c = myTextField.text.charAt(index); countField.text = "The first character of line 4 is: " + c; } } }
getLineText | () | método |
public function getLineText(lineIndex:int):String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve el texto de la línea especificada por el parámetro lineIndex
.
Parámetros
lineIndex:int — El valor de índice basado en cero para la línea (por ejemplo, la primera línea es 0, la segunda es 1, etc.).
|
String — La cadena de texto contenida en la línea especificada.
|
Emite
RangeError — El número de línea especificado está fuera de rango.
|
Ejemplo ( Cómo utilizar este ejemplo )
El campo de texto poem
se establece para que se ajuste automáticamente y cambie el tamaño como texto justificado a la izquierda. La propiedad wordWrap
se establece como false
, para que las líneas del poema no se ajusten, aunque normalmente cuando se utiliza la propiedad autoSize
no debería ser un problema. El bucle for
itera por las líneas del soneto mediante la propiedad numLines
del campo de texto. El método getLineText()
devuelve el contenido de la línea como cadena. (Tenga en cuenta que la propiedad numLines
devuelve el número de líneas empezando por la línea 1, mientras que para el método getLineText()
el número de línea empieza por 0.) Con el patrón de expresión normal (/love/i
), la sentencia if
busca cualquier subcadena de la palabra en mayúscula o minúscula. Si se encuentra el patrón, el método search
devuelve el índice de la primera subcadena coincidente; de lo contrario, devuelve -1
(si no hay coincidencias). El número de líneas donde se encontró la palabra "love" ((i + 1)
) se coloca después en la cadena lineResult
. El método de cadena convierte el argumento de número ((i + 1)
) en una cadena con la longitud de otro argumento que sea cadena (" "). El resultado de líneas de la búsqueda incluirá las líneas con las palabras "loved" o "Love's". Si se añadió la cadena "Love was found in lines:" antes del bucle for
, la palabra "Love" de esta línea también se habría incluido.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.utils.Timer; import flash.events.TimerEvent; public class TextField_getLineTextExample extends Sprite { public function TextField_getLineTextExample() { var poem:TextField = new TextField(); var lineResult:String = ""; var pattern:RegExp = /love/i; poem.x = 10; poem.y = 10; poem.background = true; poem.wordWrap = false; poem.autoSize = TextFieldAutoSize.LEFT; poem.text = "Let me not to the marriage of true minds\n" + "Admit impediments. love is not love\n" + "Which alters when it alteration finds\n" + "Or bends with the remover to remove:\n" + "O no! it is an ever-fixed mark\n" + "That looks on tempests and is never shaken;\n" + "It is the star to every wandering bark,\n" + "Whose worth's unknown, although his height be taken.\n" + "Love's not Time's fool, though rosy lips and cheeks\n" + "Within his bending sickle's compass come:\n" + "Love alters not with his brief hours and weeks,\n" + "But bears it out even to the edge of doom.\n" + "If this be error and upon me proved,\n" + "I never writ, nor no man ever loved.\n\n"; for (var i:int = 0; i < poem.numLines; i++) { var s:String = poem.getLineText(i); if(s.search(pattern) != -1) { lineResult += (i + 1) + " "; } } poem.appendText("Love was found in lines: " + lineResult); this.addChild(poem); } } }
getParagraphLength | () | método |
public function getParagraphLength(charIndex:int):int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dado un índice de carácter, devuelve la longitud del párrafo que contiene dicho carácter. La longitud se mide con respecto al primer carácter del párrafo (tal como la devuelve getFirstCharInParagraph()
), no con respecto al índice de carácter.
Parámetros
charIndex:int — El valor de índice basado en cero para el carácter (por ejemplo, el primer carácter es 0, el segundo carácter es 1, etc.).
|
int — Devuelve el número de caracteres del párrafo.
|
Emite
RangeError — El índice del carácter especificado está fuera de rango.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
El campo de texto myTextField
muestra los párrafos que seleccionará el usuario. Cuando el usuario hace clic en el campo de texto, se distribuye el evento MouseEvent.CLICK
y se realiza una llamada al método clickHandler()
. La longitud del párrafo y el número de caracteres "s" aparecerán en el campo de texto countField
, que se ubica debajo del campo de texto myTextField
.
En el método clickHandler()
, el método getCharIndexAtPoint()
devuelve el índice del carácter en función de las coordenadas localX
y localY
del clic del ratón. La primera sentencia if
comprueba si el usuario ha hecho clic en el carácter. El método getFirstCharInParagraph()
utiliza este índice para devolver el índice del primer carácter del mismo párrafo. La longitud de párrafo devuelta por el método getParagraphLength()
se utiliza con índice del primer carácter del párrafo para determinar el índice del final. Un bucle for
itera por el párrafo en busca del número de caracteres "s".
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_getParagraphLengthExample extends Sprite { private var myTextField:TextField = new TextField(); private var countField:TextField = new TextField(); public function TextField_getParagraphLengthExample() { myTextField.x = 10; myTextField.y = 10; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; myTextField.width = 300; myTextField.height = 280; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file" + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n" + "To create a text field dynamically, use the TextField() constructor.\n\n" + "The methods of the TextField class let you set, select, and manipulate " + "text in a dynamic or input text field that you create during authoring or at runtime."); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); countField.x = 10; countField.y = 300; countField.height = 50; countField.width = 250; countField.background = true; countField.selectable = false; this.addChild(myTextField); this.addChild(countField); } private function clickHandler(e:MouseEvent):void { var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if(index != -1) { var beginParag:int = myTextField.getFirstCharInParagraph(index); var paragLength:int = myTextField.getParagraphLength(index); var endParag:int = beginParag + paragLength; var sCount:uint = 0; for (var i:int = beginParag; i <= endParag; i++) { if ((myTextField.text.charAt(i) == "s") || (myTextField.text.charAt(i) == "S")) { sCount++; } countField.text = "Paragraph length is: " + paragLength.toString() + "\n" + "Number of 's' characters in the paragraph: " + sCount.toString(); } } } } }
getTextFormat | () | método |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve un objeto TextFormat que contiene información de formato para el rango de texto especificado por los parámetros beginIndex
y endIndex
. En el objeto TextFormat resultante, sólo se establecen las propiedades que son comunes a todo el texto del campo de texto. Todas las propiedades que sean mixtas, es decir, que tengan valores diferentes en distintos puntos del texto, tendrán el valor null
.
Si no se especifican valores para estos parámetros, el método se aplicará a todo el texto del campo de texto.
La tabla siguiente describe tres posibles usos:
Uso | Descripción |
---|---|
my_textField.getTextFormat() | Devuelve un objeto TextFormat que contiene información de formato para todo el texto de un campo de texto. En el objeto TextFormat resultante, sólo se establecen las propiedades que son comunes a todo el texto del campo de texto. Todas las propiedades que sean mixtas, es decir, que tengan valores diferentes en distintos puntos del texto, tendrán el valor null . |
my_textField.getTextFormat(beginIndex:Number) | Devuelve un objeto TextFormat que contiene una copia del formato del texto del carácter en la posición de beginIndex . |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | Devuelve un objeto TextFormat que contiene información de formato para el texto comprendido entre beginIndex y endIndex-1 . En el objeto TextFormat resultante, sólo se establecen las propiedades que son comunes a todo el texto del rango especificado. Todas las propiedades que sean mixtas (es decir, que tengan valores diferentes en distintos puntos del rango), estarán configuradas con el valor null . |
Parámetros
beginIndex:int (default = -1 ) — Opcional; un entero que especifica la ubicación inicial de un rango de texto en el campo de texto.
| |
endIndex:int (default = -1 ) — Opcional; un entero que especifica la posición del primer carácter después de un fragmento de texto. Según su diseño, si se especifican los valores beginIndex y endIndex , se lee el texto desde beginIndex hasta endIndex-1 .
|
flash.text:TextFormat — El objeto TextFormat que representa las propiedades de formato del texto especificado.
|
Emite
RangeError — Los elementos beginIndex o endIndex especificados están fuera de rango.
|
Elementos de API relacionados
Ejemplo
Cómo utilizar este ejemplo
Consulte el ejemplo de los métodos getFirstCharInParagraph() o setTextFormat() para ver ilustraciones sobre cómo utilizar el método
getTextFormat()
.
isFontCompatible | () | método |
public static function isFontCompatible(fontName:String, fontStyle:String):Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Devuelve true si hay disponible una fuente incorporada con las propiedades fontName
y fontStyle
especificadas, donde Font.fontType
sea flash.text.FontType.EMBEDDED
. A partir de Flash Player 10, pueden aparecer dos tipos de fuentes incorporadas en un archivo SWF. Las fuentes incorporadas normales sólo se utilizan con objetos TextField. Las fuentes incorporadas CFF sólo se utilizan con las clases flash.text.engine. Los dos tipos se diferencian por la propiedad fontType
de la clase Font
, tal y como la devuelve la función enumerateFonts()
.
TextField no puede utilizar un tipo de fuente EMBEDDED_CFF
. Si embedFonts
se establece como true
y la única fuente disponible en tiempo de ejecución con el nombre y el estilo especificados es del tipo EMBEDDED_CFF
, Flash Player no podrá presentar el texto, como si no hubiera disponible ninguna fuente incorporada con ese nombre y ese estilo.
Si existen tanto EMBEDDED
como EMBEDDED_CFF
con el mismo nombre y estilo, se seleccionará la fuente EMBEDDED
y se presentará el texto con la fuente EMBEDDED
.
Parámetros
fontName:String — Nombre de la fuente incorporada que se va a comprobar.
| |
fontStyle:String — Especifica el estilo de fuente que se va a comprobar. Utilice flash.text.FontStyle
|
Boolean — true si hay una fuente incorporada compatible. De lo contrario, se denomina false .
|
Emite
ArgumentError — La propiedad fontStyle especificada no es un miembro de flash.text.FontStyle .
|
Elementos de API relacionados
replaceSelectedText | () | método |
public function replaceSelectedText(value:String):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Reemplaza la selección actual por el contenido del parámetro value
. El texto se inserta en la posición de la selección actual empleando el formato de carácter predeterminado y el formato de párrafo predeterminado actuales. El texto no se crea como HTML.
Puede utilizar el método replaceSelectedText()
para insertar y eliminar texto sin modificar el formato de carácter y de párrafo del resto del texto.
Nota: este método no funcionará si se aplica una hoja de estilos al campo de texto.
Parámetros
value:String — La cadena que reemplazará el texto seleccionado actualmente.
|
Emite
Error — Este método no puede utilizarse en un campo de texto con una hoja de estilos.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
Se crean dos objetos TextField diferentes y se añaden detectores de eventos para los eventos MouseEvent.MOUSE_UP
. El evento Mouse up tiene lugar cuando el usuario suelta el ratón y normalmente sucede después de realizar la selección de un texto. Tenga en cuenta que el parámetro predeterminado del campo de texto es para que se seleccione su texto.
En el método mouseHandler1()
, cuando un usuario suelta el ratón en el campo de texto myTextField1
, el texto se borra sustituyéndolo por una cadena vacía. Esto puede continuar hasta que se borra todo el texto. En el método mouseHandler2()
, cuando un usuario selecciona parte del texto en el campo myTextField2
, se activan las propiedades selectionBeginIndex
y selectionEndIndex
para comprobar si se ha seleccionado algún carácter. (Las propiedades selectionBeginIndex
y selectionEndIndex
no tienen el mismo valor si se ha seleccionado parte del texto.) El texto seleccionado se sustituye a continuación por la cadena "NEW TEXT". Esto puede continuar hasta que todo el texto original del segundo campo de texto se sustituya por la cadena "NEW TEXT".
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_replaceSelectedTextExample extends Sprite { private var myTextField1:TextField = new TextField(); private var myTextField2:TextField = new TextField(); public function TextField_replaceSelectedTextExample() { myTextField1.x = 10; myTextField1.width = 300; myTextField1.height = 50; myTextField1.background = true; myTextField1.border = true; myTextField1.text = "Select the text you want to remove from the line."; myTextField2.x = 10; myTextField2.y = 60; myTextField2.width = 300; myTextField2.height = 50; myTextField2.background = true; myTextField2.border = true; myTextField2.text = "Select the text you want to replace with NEW TEXT."; myTextField1.addEventListener(MouseEvent.MOUSE_UP, mouseHandler1); myTextField2.addEventListener(MouseEvent.MOUSE_UP, mouseHandler2); this.addChild(myTextField1); this.addChild(myTextField2); } private function mouseHandler1(e:MouseEvent):void { myTextField1.replaceSelectedText(""); } private function mouseHandler2(e:MouseEvent):void { if(myTextField2.selectionBeginIndex != myTextField2.selectionEndIndex) { myTextField2.replaceSelectedText("NEW TEXT"); } } } }
replaceText | () | método |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Reemplaza el rango de caracteres especificados por los parámetros beginIndex
y endIndex
con el contenido del parámetro newText.
Según su diseño, se sustituye el texto de beginIndex
a endIndex-1
.
Nota: este método no funcionará si se aplica una hoja de estilos al campo de texto.
Parámetros
beginIndex:int — El valor de índice basado en cero para la posición inicial del rango de sustitución.
| |
endIndex:int — La posición del índice basado en cero del primer carácter después de un fragmento de texto.
| |
newText:String — El texto que va a reemplazar al rango de caracteres especificado.
|
Emite
Error — Este método no puede utilizarse en un campo de texto con una hoja de estilos.
|
Ejemplo ( Cómo utilizar este ejemplo )
replaceText()
para eliminar, sustituir e insertar parte de texto en un campo de texto.
El campo de texto outputText
se establece para que se ajuste automáticamente y cambie el tamaño como texto justificado a la izquierda. Con la primera llamada al método replaceText()
, la primera línea ("This is the wrong heading") se sustituye por "THIS IS THE HEADING FOR EVERYONE". Con la segunda llamada al método, se inserta el texto "CORRECT" entre "THE" y "HEADING". Con la tercera llamada al método, se eliminan las palabras "FOR EVERYONE". Tenga en cuenta que con cada llamada al método appendText()
, se modifican el índice del principio y del final del texto. En este caso, sólo se mostrará el texto final (después de aplicados los cambios).
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_replaceTextExample extends Sprite { public function TextField_replaceTextExample() { var outputText:TextField = new TextField(); outputText.x = 10; outputText.y = 10; outputText.background = true; outputText.autoSize = TextFieldAutoSize.LEFT; outputText.appendText("This is the wrong heading"); outputText.appendText("\n\n"); outputText.appendText("This is the body of the text."); outputText.replaceText(0, 25, "THIS IS THE HEADING FOR EVERYONE"); outputText.replaceText(12, 12, "CORRECT "); outputText.replaceText(27, 40, ""); this.addChild(outputText); } } }
setSelection | () | método |
public function setSelection(beginIndex:int, endIndex:int):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Define como seleccionado el texto designado por los valores de índice de los primeros y últimos caracteres, especificados por los parámetros beginIndex
y endIndex
. Si los dos valores de parámetro coinciden, este método definirá un punto de inserción, del mismo modo que al establecer la propiedad caretIndex
.
Parámetros
beginIndex:int — El valor de índice basado en cero del primer carácter de la selección (por ejemplo, el primer carácter es 0, el segundo carácter es 1, etc.).
| |
endIndex:int — El valor de índice basado en cero del último carácter de la selección.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
Dos detectores de eventos para el campo de texto myTextField
responden a los clics del ratón o a los eventos de ratón soltado del usuario. El evento Mouse up tendrá lugar cuando el usuario suelte el ratón y normalmente sucede después de realizar la selección de un texto. Tenga en cuenta que el parámetro predeterminado del campo de texto es para que se seleccione su texto. Cuando se hace clic en una parte del texto, se invoca el método clickHandler()
. Cuando se selecciona texto y se suelta el ratón, se invoca el método mouseUpHandler()
.
Tanto en los métodos clickHandler()
como mouseUpHandler()
, el método setSelection()
establece que se seleccionen sólo los caracteres entre los índices 54 y 70 (TEXT IN ALL CAPS).
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_setSelectionExample extends Sprite { private var myTextField:TextField = new TextField(); public function TextField_setSelectionExample() { myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS is selected."; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); myTextField.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); this.addChild(myTextField); } private function clickHandler(event:MouseEvent):void { myTextField.setSelection(54, 70); } private function mouseUpHandler(event:MouseEvent):void { myTextField.setSelection(54, 70); } } }
setTextFormat | () | método |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Aplica el formato de texto especificado por el parámetro format
al texto especificado en un campo de texto. El valor de format
debe ser un objeto TextFormat que especifique los cambios de formato deseados del texto. Sólo se aplican al campo de texto las propiedades de format
que no tengan valor null. No se aplicará ninguna propiedad de format
definida como null
. De manera predeterminada, todas las propiedades del objeto TextFormat de nueva creación están configuradas con el valor null
.
Nota: este método no funcionará si se aplica una hoja de estilos al campo de texto.
El método setTextFormat()
cambia el formato de texto aplicado a un rango de caracteres o a todo el cuerpo del texto de un campo de texto. Para aplicar las propiedades del formato a todo el texto del campo de texto, no especifique valores para beginIndex
y endIndex
. Para aplicar las propiedades del formato a un rango de texto, especifique valores para los parámetros beginIndex
y endIndex
. Se puede utilizar la propiedad length
para determinar los valores de índice.
Los dos tipos de información de formato en un objeto TextFormat son el formato de nivel de carácter y el formato de nivel de párrafo. Cada carácter de un campo de texto puede tener su propia configuración de formato de carácter, como nombre de fuente, tamaño de fuente, negrita y cursiva.
En el caso de los párrafos, se examina el primer carácter del párrafo en busca de la configuración de formato de párrafo para el párrafo completo. Margen izquierdo, margen derecho y sangría son ejemplos de configuración de formato de párrafo.
El texto insertado manualmente por el usuario o sustituido mediante el método replaceSelectedText()
recibe el formato predeterminado de campo de texto para texto nuevo, no el formato especificado para el punto de inserción del texto. Para definir el formato predeterminado para texto nuevo, utilice defaultTextFormat
.
Parámetros
format:flash.text:TextFormat — Un objeto TextFormat que contiene información de formato de carácter y de párrafo.
| |||||||||
beginIndex:int (default = -1 ) — Opcional; entero que indica la posición de índice basada en cero especificando el primer carácter del rango de texto deseado.
| |||||||||
endIndex:int (default = -1 ) — Opcional; entero que especifica el primer carácter después de un fragmento de texto. Según el diseño, si se especifican los valores beginIndex y endIndex , se actualiza el texto desde beginIndex hasta endIndex-1 .
Tenga en cuenta que el texto insertado manualmente por el usuario o sustituido mediante el método |
Emite
Error — Este método no puede utilizarse en un campo de texto con una hoja de estilos.
| |
RangeError — Los elementos beginIndex o endIndex especificados están fuera de rango.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
Se añade un detector de eventos al campo de texto myTextField
para que responda a los clics del ratón mediante la invocación del método clickHandler()
. En el método clickHandler()
, el método getTextFormat()
devuelve el formato actual del carácter (índice 55) del rango del texto deseado, que se ubica a continuación en el objeto TextFormat currentTextFormat
. La sentencia if
comprueba el formato de texto currentTextFormat
para ver si se el carácter del rango utiliza el nuevo formato (el punto de fuente se establece en 18). Si no es así, el nuevo formato cambia el tamaño a 18 puntos, el color a rojo y aplica el subrayado y la cursiva al rango de texto entre 54-70 (TEXT IN ALL CAPS). Si el carácter del rango está utilizando el nuevo formato, el formato del rango se establece de nuevo con el formato predeterminado (original) del campo de texto.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.events.MouseEvent; public class TextField_setTextFormatExample extends Sprite { private var myTextField:TextField = new TextField(); private var newFormat:TextFormat = new TextFormat(); public function TextField_setTextFormatExample() { myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.selectable = false; myTextField.background = true; myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS changes format."; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); newFormat.color = 0xFF0000; newFormat.size = 18; newFormat.underline = true; newFormat.italic = true; this.addChild(myTextField); } private function clickHandler(event:MouseEvent):void { var currentTextFormat:TextFormat = myTextField.getTextFormat(55); if(currentTextFormat.size != 18) { myTextField.setTextFormat(newFormat, 54, 70); } else { myTextField.setTextFormat(myTextField.defaultTextFormat); } } } }
change | Evento |
flash.events.Event
propiedad Event.type =
flash.events.Event.CHANGE
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se emite tras modificar el valor de un control, a diferencia del evento textInput
, que se emite antes de modificar el valor. Al contrario de lo que ocurre con la versión del modelo de evento W3C DOM del evento change
, que se distribuye solamente cuando el control ya no está seleccionado, en ActionScript 3.0, la versión del evento change
se distribuye siempre que cambia el control. Por ejemplo, si un usuario escribe texto en un campo de texto, se distribuirá un evento change
cada vez que pulse una tecla.
Event.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. |
Ejemplo ( Cómo utilizar este ejemplo )
Se crean dos campos de texto, uno para la entrada del usuario y el otro (headingTextField
) para la copia de la entrada. También se crea un objeto TextFormat y se asigna al formato de texto predeterminado al campo de texto headingTextField
. Cuando se modifica el contenido del campo de texto, se invoca el método changeHandler()
, que asigna el texto del campo inputTextField
al campo headingTextField
. (Si se llamó al método para el evento TextEvent.TEXT_INPUT
en lugar del evento Event.CHANGE
, sólo se copiará el contenido de la entrada del usuario después de que éste haya introducido más texto.)
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; import flash.text.TextFormatAlign; import flash.events.Event; import flash.events.TextEvent; public class TextField_Event_changeExample extends Sprite { private var inputTextField:TextField = new TextField(); private var headingTextField:TextField = new TextField(); private var newFormat:TextFormat = new TextFormat(); public function TextField_Event_changeExample() { headingTextField.x = 10; headingTextField.y = 10; headingTextField.height = 30; headingTextField.width = 400; headingTextField.background = true; headingTextField.backgroundColor = 0xF5F5DC; headingTextField.selectable = false; inputTextField.x = 10; inputTextField.y = 70; inputTextField.height = 20; inputTextField.width = 230; inputTextField.background = true; inputTextField.border = true; inputTextField.maxChars = 40; inputTextField.wordWrap = true; inputTextField.type = TextFieldType.INPUT; inputTextField.addEventListener(Event.CHANGE, changeHandler); newFormat.bold = true; newFormat.size = 18; newFormat.color = 0xFF0000; newFormat.align = TextFormatAlign.CENTER; headingTextField.defaultTextFormat = newFormat; this.addChild(inputTextField); this.addChild(headingTextField); } private function changeHandler(e:Event):void { headingTextField.text = inputTextField.text; } } }
link | Evento |
flash.events.TextEvent
propiedad TextEvent.type =
flash.events.TextEvent.LINK
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se distribuye cuando un usuario hace clic en el hipervínculo de un campo de texto compatible con HTML, donde la URL empieza por "event:". El resto de la URL después de "event:" se coloca en la propiedad de texto del evento LINK.
Nota: el comportamiento predeterminado (añadir el texto al campo de texto) sólo se produce cuando Flash Player genera el evento (en este caso, ocurrirá cuando el usuario intente introducir texto). No se puede colocar texto en un campo de texto enviando eventos textInput
.
type
de un objeto de evento link
.
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 | El campo de texto que contiene el hipervínculo en el que se ha hecho clic. 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. |
text | El resto de la URL después de "event:" |
Ejemplo ( Cómo utilizar este ejemplo )
playMP3()
. Se crea un objeto TextField denominado list
y se llena con texto HTML. El texto "Track 1"
y "Track 2"
son vínculos dentro del campo de texto. Se llama a la función playMP3() cuando el usuario hace clic en el vínculo. El nombre del archivo MP3, que sigue a la cadena "event:" en el atributo href
de la etiqueta HTML, se pasa al método linkHandler()
como la propiedad text
del objeto de evento link
.
package { import flash.display.Sprite; import flash.errors.IOError; import flash.events.IOErrorEvent; import flash.events.TextEvent; import flash.media.Sound; import flash.media.SoundChannel; import flash.net.URLRequest; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_event_link extends Sprite { private var myMP3:Sound; public function TextField_event_link() { myMP3 = new Sound(); var list:TextField = new TextField(); list.autoSize = TextFieldAutoSize.LEFT; list.multiline = true; list.htmlText = "<a href=\"event:track1.mp3\">Track 1</a><br>"; list.htmlText += "<a href=\"event:track2.mp3\">Track 2</a><br>"; addEventListener(TextEvent.LINK, linkHandler); addChild(list); } private function playMP3(mp3:String):void { try { myMP3.load(new URLRequest(mp3)); myMP3.play(); } catch(err:Error) { trace(err.message); } myMP3.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); } private function linkHandler(linkEvent:TextEvent):void { playMP3(linkEvent.text); } private function errorHandler(errorEvent:IOErrorEvent):void { trace(errorEvent.text); } } }
scroll | Evento |
flash.events.Event
propiedad Event.type =
flash.events.Event.SCROLL
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribuido por un objeto TextField después de que el usuario se desplace.
La constanteEvent.SCROLL
define el valor de la propiedad type
de un objeto de evento scroll
.
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 | El objeto TextField que se desplaza. La propiedad 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. |
Ejemplo ( Cómo utilizar este ejemplo )
mouseDown
y se llama al controlador mouseDownScroll
asociado. El controlador mouseDownScroll()
hace que el desplazamiento en el campo sea posible. Seguidamente, se distribuye el evento scroll
y el controlador scrollHandler()
asociado actualiza el segundo campo de texto para mostrar la posición de desplazamiento actual.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextScrollExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); private var myText:String = "Hello world and welcome to the show. It's really nice to meet you. Take your coat off and stay a while. OK, show is over. Hope you had fun. You can go home now. Don't forget to tip your waiter. There are mints in the bowl by the door. Thank you. Please come again."; public function TextScrollExample() { myTextBox1.text = myText; myTextBox1.width = 200; myTextBox1.height = 50; myTextBox1.multiline = true; myTextBox1.wordWrap = true; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownScroll); myTextBox1.addEventListener(Event.SCROLL, scrollHandler); } public function mouseDownScroll(event:MouseEvent):void { myTextBox1.scrollV++; } public function scrollHandler(event:Event):void { myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; } } }
textInput | Evento |
flash.events.TextEvent
propiedad TextEvent.type =
flash.events.TextEvent.TEXT_INPUT
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Flash Player distribuye el evento textInput
cuando un usuario escribe uno o varios caracteres de texto. Existen diferentes métodos de introducción de texto que pueden generar este evento: teclados estándar, editores de método de entrada (IME), sistemas de reconocimiento de voz e, incluso, la acción de pegar texto sin formato o información de estilos.
type
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. |
Ejemplo ( Cómo utilizar este ejemplo )
textInput
, se llama al controlador textInputHandler()
y los caracteres se visualizan en el segundo campo de texto. Al pegar un bloque de texto en el campo de entrada, el controlador de eventos copia todo el bloque en el otro campo.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextInputExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); public function TextInputExample() { myTextBox1.type = TextFieldType.INPUT; myTextBox1.width = 200; myTextBox1.height = 20; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(TextEvent.TEXT_INPUT,textInputHandler); } public function textInputHandler(event:TextEvent):void { myTextBox2.text=event.text; } } }
textInteractionModeChange | Evento |
flash.events.Event
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 11, Flash Lite 4 |
Flash Player distribuye el evento textInteractionModeChange
cuando el usuario cambia el modo de interacción de un campo de texto. Por ejemplo, en Android, se puede cambiar entre el modo NORMAL y el modo SELECTION utilizando las opciones de menú contextual
TextFieldExample
para mostrar un mensaje de texto. Esto se consigue con los pasos siguientes:
- Se crea una propiedad
label
de tipo TextField. - El constructor de la clase llama a la función
configureLabel()
. - El método
configureLabel()
crea primero un nuevo objeto TextField y lo asigna a la propiedadlabel
; seguidamente, define sus parámetros del modo siguiente:- Justifica a la izquierda el campo de texto.
- Habilita el relleno de fondo.
- Habilita el borde.
- El método
configureLabel()
crea la variableformat
y la asigna a una nueva instancia de TextFormat con los parámetros definidos del siguiente modo:- Tipo de fuente = Verdana
- Color de fuente = continuo rojo
- Tamaño de fuente = 10
- Subrayado de fuente = true
- La propiedad
defaultTextFormat
del campo de textolabel
se define comoformat
y la instancialabel
se añade a la lista de visualización, que muestra inicialmente un campo de texto sin texto en el escenario. - El constructor establece el texto del campo de texto
label
en"Hello world and welcome to the show".
mediante una llamada al métodosetLabel()
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.TextFormat; public class TextFieldExample extends Sprite { private var label:TextField; private var labelText:String = "Hello world and welcome to the show."; public function TextFieldExample() { configureLabel(); setLabel(labelText); } public function setLabel(str:String):void { label.text = str; } private function configureLabel():void { label = new TextField(); label.autoSize = TextFieldAutoSize.LEFT; label.background = true; label.border = true; var format:TextFormat = new TextFormat(); format.font = "Verdana"; format.color = 0xFF0000; format.size = 10; format.underline = true; label.defaultTextFormat = format; addChild(label); } } }
Tue Jun 12 2018, 02:12 PM Z