Paqueteflash.text
Clasepublic class TextField
HerenciaTextField Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La clase TextField se utiliza para crear objetos de visualización para mostrar e introducir texto. Todos los campos dinámicos y de entrada de texto de un archivo SWF son instancias de la clase TextField. Puede asignar a un campo de texto un nombre de instancia en el inspector de propiedades y utilizar los métodos y propiedades de la clase TextField para manipularlo con ActionScript. Los nombres de instancias de TextField se muestran en el explorador de películas y en el cuadro de diálogo Insertar ruta de destino del panel Acciones.

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. Puede asignar texto con formato HTML, que opcionalmente puede utilizar estilos CSS, directamente 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.

Ver los ejemplos

Véase también

flash.text.TextFormat
flash.text.StyleSheet
Clases principales de visualización
Fundamentos de la utilización de texto


Propiedades públicas
 PropiedadDefinido por
 InheritedaccessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización.
DisplayObject
 Inheritedalpha : 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
 InheritedblendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.
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
[read-only] Un entero (índice basado en uno) que indica la última línea visible en el campo de texto especificado.
TextField
 InheritedcacheAsBitmap : Boolean
Si se define como true, Flash Player deja en caché una representación interna de mapa de bits del objeto de visualización.
DisplayObject
  caretIndex : int
[read-only] El índice de la posición del punto de inserción (intercalación).
TextField
  condenseWhite : Boolean
Un valor booleano que especifica si se deben eliminar espacios en blanco adicionales (espacios, saltos de línea, etc.) en el campo de texto con texto HTML.
TextField
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 InheritedcontextMenu : ContextMenu
Especifica el menú contextual asociado a este objeto.
InteractiveObject
  defaultTextFormat : TextFormat
Especifica el formato aplicado al texto nuevo insertado, como el insertado con el método replaceSelectedText() o el introducido por un usuario.
TextField
  displayAsPassword : Boolean
Especifica si el campo de texto es de contraseña.
TextField
 InheriteddoubleClickEnabled : Boolean
Especifica si este objeto recibe eventos doubleClick.
InteractiveObject
  embedFonts : Boolean
Especifica si representar utilizando contornos de fuentes incorporadas.
TextField
 Inheritedfilters : Array
Matriz indexada que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.
DisplayObject
 InheritedfocusRect : 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
 Inheritedheight : 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
[read-only] El número de caracteres de un campo de texto.
TextField
 InheritedloaderInfo : LoaderInfo
[read-only] Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización.
DisplayObject
 Inheritedmask : 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
[read-only] Valor máximo de scrollH.
TextField
  maxScrollV : int
[read-only] Valor máximo de scrollV.
TextField
 InheritedmouseEnabled : Boolean
Especifica si este objeto recibe mensajes de ratón.
InteractiveObject
  mouseWheelEnabled : Boolean
Valor booleano que indica si Flash Player debe desplazar automáticamente campos de texto de varias líneas cuando el usuario hace clic en un campo de texto y hace girar la rueda del ratón.
TextField
 InheritedmouseX : Number
[read-only] Indica la coordenada x de la posición del ratón en píxeles.
DisplayObject
 InheritedmouseY : Number
[read-only] Indica la coordenada y de la posición del ratón en píxeles.
DisplayObject
  multiline : Boolean
Indica si el campo de texto consta de varias líneas.
TextField
 Inheritedname : String
Indica el nombre de instancia de DisplayObject.
DisplayObject
  numLines : int
[read-only] Define el número de líneas de texto de un campo de varias líneas.
TextField
 InheritedopaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] Indica el objeto DisplayObjectContainer que contiene este objeto de visualización.
DisplayObject
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  restrict : String
Indica el conjunto de caracteres que los usuarios pueden introducir en el campo de texto.
TextField
 Inheritedroot : DisplayObject
[read-only] 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
 Inheritedrotation : Number
Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original.
DisplayObject
 Inheritedscale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente.
DisplayObject
 InheritedscaleX : Number
Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro.
DisplayObject
 InheritedscaleY : Number
Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto.
DisplayObject
  scrollH : int
La posición de desplazamiento horizontal actual.
TextField
 InheritedscrollRect : 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
[read-only] El valor de índice basado en cero del primer carácter de la selección actual.
TextField
  selectionEndIndex : int
[read-only] 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
 Inheritedstage : Stage
[read-only] El escenario del objeto de visualización.
DisplayObject
  styleSheet : StyleSheet
Asocia una hoja de estilos al campo de texto.
TextField
 InheritedtabEnabled : Boolean
Especifica si este objeto está en el orden de tabulación.
InteractiveObject
 InheritedtabIndex : 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
[read-only] La altura del texto, expresada en píxeles.
TextField
  textWidth : Number
[read-only] La anchura del texto, expresada en píxeles.
TextField
  thickness : Number
El grosor de los bordes de glifo en este campo de texto.
TextField
 Inheritedtransform : 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
 Inheritedvisible : Boolean
Indica si el objeto de visualización es visible.
DisplayObject
 Inheritedwidth : 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
 Inheritedx : Number
Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.
DisplayObject
 Inheritedy : Number
Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.
DisplayObject
Métodos públicos
 MétodoDefinido por
  
Crea una nueva instancia de TextField.
TextField
 Inherited
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
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
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
  
getLineLength(lineIndex:int):int
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
  
getLineOffset(lineIndex:int):int
Devuelve el índice de carácter del primer carácter de la línea especificada por el parámetro lineIndex.
TextField
  
getLineText(lineIndex:int):String
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
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
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
  
getTextFormat(beginIndex:int = -1, endIndex:int = -1):TextFormat
Devuelve un objeto TextFormat que contiene información de formato para el rango de texto especificado por los parámetros beginIndex y endIndex.
TextField
 Inherited
Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).
DisplayObject
 Inherited
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.
EventDispatcher
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el objeto de visualización obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
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
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).
DisplayObject
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
EventDispatcher
  
Reemplaza la selección actual por el contenido del parámetro del valor.
TextField
  
replaceText(beginIndex:int, endIndex:int, newText:String):void
Reemplaza el rango de caracteres especificados por los parámetros beginIndex y endIndex con el contenido del parámetro newText.
TextField
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
  
setSelection(beginIndex:int, endIndex:int):void
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
  
setTextFormat(format:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Aplica el formato de texto especificado por el parámetro format al texto especificado en un campo de texto.
TextField
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
 Inherited
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
Eventos
 Evento Resumen Definido por
 Inherited Se distribuye cuando Flash Player queda seleccionado por el sistema operativo y pasa a estar activo.EventDispatcher
 Inherited Se distribuye cuando un objeto de visualización se añade a la lista de visualización.DisplayObject
 Inherited Se distribuye cuando un objeto de visualización se añade a la lista de visualización del escenario, bien directamente o a través de un subárbol que contiene el objeto de visualización.DisplayObject
   Se distribuye tras modificar un valor del control.TextField
 Inherited Se distribuye cuando un usuario pulsa y suelta el botón principal del dispositivo de señalización sobre el mismo objeto InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando Flash Player deja de estar seleccionado por el sistema operativo y pasa a estar inactivo.EventDispatcher
 Inherited 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
 Inherited Se distribuye cuando la cabeza lectora entra en un nuevo fotograma.DisplayObject
 Inherited Se distribuye después de que un objeto de visualización quede seleccionado.InteractiveObject
 Inherited Se distribuye después de que un objeto de visualización deje de estar seleccionado.InteractiveObject
 Inherited Se distribuye cuando el usuario pulsa una tecla.InteractiveObject
 Inherited Se distribuye cuando el usuario intenta cambiar la selección empleando la navegación mediante teclado.InteractiveObject
 Inherited 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
 Inherited Se distribuye cuando el usuario pulsa el botón del dispositivo de señalización sobre una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando el usuario intenta cambiar la selección empleando un dispositivo de señalización.InteractiveObject
 Inherited Se distribuye cuando el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando el usuario pasa el dispositivo de señalización por encima de una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando el usuario suelta el botón del dispositivo de señalización sobre una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando se hace girar una rueda de ratón sobre una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización.DisplayObject
 Inherited 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
 Inherited Se distribuye cuando la lista de visualización se va a actualizar y mostrar.DisplayObject
 Inherited Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.InteractiveObject
 Inherited 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
 Inherited Se distribuye cuando cambia el valor del indicador tabChildren del objeto.InteractiveObject
 Inherited Se distribuye cuando cambia el indicador tabEnabled del objeto.InteractiveObject
 Inherited 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
Información sobre propiedades
alwaysShowSelectionpropiedad
alwaysShowSelection:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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

Véase también


Ejemplo

Compile y ejecute el siguiente archivo. Cuando ejecute el archivo, arrastre el ratón para seleccionar texto en cada uno de los dos campos de texto y observe la diferencia del resaltado de la selección cuando seleccione el texto de los dos campos de texto (cambiando la selección):

    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 = createTextField(0, 20, 200, 20);
            label1.text = "This text is selected.";
            label1.setSelection(0, 9);
            label1.alwaysShowSelection = true;

            var label2:TextField = createTextField(0, 50, 200, 20);
            label2.text = "Drag to select some of this text.";
        }

        private function createTextField(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;
        }
    }
}
antiAliasTypepropiedad 
antiAliasType:String  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: 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 cadenaDescripción
flash.text.AntiAliasType.NORMALAplica el suavizado de texto regular. Equivale al tipo de suavizado que utilizaba Flash Player en la versión 7 y anteriores.
flash.text.AntiAliasType.ADVANCEDAplica 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

Véase también

autoSizepropiedad 
autoSize:String  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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.

Véase también

backgroundpropiedad 
background:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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

Véase también

backgroundColorpropiedad 
backgroundColor:uint  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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

Véase también

borderpropiedad 
border:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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

Véase también

borderColorpropiedad 
borderColor:uint  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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

Véase también

bottomScrollVpropiedad 
bottomScrollV:int  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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

Véase también

caretIndexpropiedad 
caretIndex:int  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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

Véase también


Ejemplo

En este ejemplo, se crea una instancia de TextField y se llena con texto. Se asigna un controlador de eventos para que, cuando el usuario haga clic en el objeto TextField, se llame al método 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 = createTextField(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 createTextField(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;
        }
    }
}
condenseWhitepropiedad 
condenseWhite:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Un valor booleano que especifica si se deben eliminar 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 establece condenseWhite como true, debe utilizar 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

Véase también


Ejemplo

En el ejemplo siguiente, se muestra la diferencia entre definir la propiedad 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 = createTextField(0, 0, 200, 50);
            tf1.condenseWhite = false;
            tf1.htmlText = "keep    on\n\ttruckin'";

            var tf2:TextField = createTextField(0, 120, 200, 50);
            tf2.condenseWhite = true;
            tf2.htmlText = "keep    on\n\ttruckin'";
        }

        private function createTextField(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;
        }
    }
}
defaultTextFormatpropiedad 
defaultTextFormat:TextFormat  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica el formato aplicado al texto nuevo insertado, como el insertado con el método replaceSelectedText() o el introducido por un usuario.

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():TextFormat
    public function set defaultTextFormat(value:TextFormat):void

Emite
Error — Este método no puede utilizarse en un campo de texto con una hoja de estilos.

Véase también

displayAsPasswordpropiedad 
displayAsPassword:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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
embedFontspropiedad 
embedFonts:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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

Véase también

gridFitTypepropiedad 
gridFitType:String  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: 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 cadenaDescripción
flash.text.GridFitType.NONESin ajuste de cuadrícula. Las líneas horizontales y verticales de los glifos no se ajustan a la cuadrícula de píxeles. Es una buena opción para animación o tamaños de fuente grandes.
flash.text.GridFitType.PIXELEspecifica 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.SUBPIXELEspecifica 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