| Paquete | flash.text |
| Clase | public class TextField |
| Herencia | TextField InteractiveObject DisplayObject EventDispatcher Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
Véase también
| Propiedad | Definido por | ||
|---|---|---|---|
![]() | 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 | |
| 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 | ||
![]() | cacheAsBitmap : 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 | ||
![]() | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
| Object | |
![]() | contextMenu : 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 | ||
![]() | doubleClickEnabled : Boolean
Especifica si este objeto recibe eventos doubleClick.
| InteractiveObject | |
| embedFonts : Boolean
Especifica si representar utilizando contornos de fuentes incorporadas.
| TextField | ||
![]() | filters : Array
Matriz indexada 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
[read-only]
El número de caracteres de un campo de texto.
| TextField | ||
![]() | loaderInfo : 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 | |
![]() | 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
[read-only]
Valor máximo de scrollH.
| TextField | ||
| maxScrollV : int
[read-only]
Valor máximo de scrollV.
| TextField | ||
![]() | mouseEnabled : 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 | ||
![]() | mouseX : Number
[read-only]
Indica la coordenada x de la posición del ratón en píxeles.
| DisplayObject | |
![]() | mouseY : 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 | ||
![]() | name : 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 | ||
![]() | opaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo.
| DisplayObject | |
![]() | parent : DisplayObjectContainer
[read-only]
Indica el objeto DisplayObjectContainer que contiene este objeto de visualización.
| DisplayObject | |
![]() | prototype : 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 | ||
![]() | root : 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 | |
![]() | rotation : Number
Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original.
| 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 | |
| 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
[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 | ||
![]() | stage : Stage
[read-only]
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
[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 | ||
![]() | transform : 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 | |
| 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 | |
![]() |
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 | |
![]() |
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 | |
![]() |
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 | |
![]() |
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
| Object | |
![]() |
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 | ||
![]() |
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 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 | ||
|---|---|---|---|---|
![]() | Se distribuye cuando Flash Player queda seleccionado por el sistema operativo y pasa a estar activo. | EventDispatcher | ||
![]() | Se distribuye cuando un objeto de visualización se añade a la lista de visualización. | DisplayObject | ||
![]() | Se distribuye cuando un objeto de visualización se añade a la lista de visualización del escenario, bien directamente o a través de un subárbol que contiene el objeto de visualización. | DisplayObject | ||
| Se distribuye tras modificar un valor del control. | TextField | |||
![]() | 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 Flash Player deja de estar seleccionado por el sistema operativo y pasa a estar inactivo. | EventDispatcher | ||
![]() | Se distribuye cuando un usuario pulsa y suelta el botón principal de un dispositivo de señalización dos veces en una sucesión rápida sobre el mismo objeto InteractiveObject cuando el indicador doubleClickEnabled de dicho objeto se ha definido como true. | InteractiveObject | ||
![]() | Se distribuye cuando la cabeza lectora entra en un nuevo fotograma. | 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 | ||
![]() | 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 el usuario pulsa el botón del dispositivo de señalización sobre una instancia de InteractiveObject en la ventana de Flash Player. | 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 pasa el dispositivo de señalización por encima de una instancia de InteractiveObject en la ventana de Flash Player. | InteractiveObject | ||
![]() | 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 | ||
![]() | Se distribuye cuando se hace girar una rueda de ratón sobre una instancia de InteractiveObject en la ventana de Flash Player. | 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 | ||
![]() | Se distribuye cuando la lista de visualización se va a actualizar y mostrar. | DisplayObject | ||
![]() | 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 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 | |||
| alwaysShowSelection | propiedad |
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.
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
Véase tambié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;
}
}
}| antiAliasType | propiedad |
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 cadena | Descripción |
|---|---|
flash.text.AntiAliasType.NORMAL | Aplica el suavizado de texto regular. 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. |
public function get antiAliasType():String
public function set antiAliasType(value:String):void
Véase también
| autoSize | propiedad |
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.
public function get autoSize():String
public function set autoSize(value:String):void
ArgumentError — La cadena autoSize especificada no es un miembro de flash.text.TextFieldAutoSize.
|
Véase también
| background | propiedad |
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.
public function get background():Boolean
public function set background(value:Boolean):void
Véase también
| backgroundColor | propiedad |
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.
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
Véase también
| border | propiedad |
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.
public function get border():Boolean
public function set border(value:Boolean):void
Véase también
| borderColor | propiedad |
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.
public function get borderColor():uint
public function set borderColor(value:uint):void
Véase también
| bottomScrollV | propiedad |
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.
public function get bottomScrollV():int
Véase también
| caretIndex | propiedad |
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.).
public function get caretIndex():int
Véase también
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;
}
}
}| condenseWhite | propiedad |
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.
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
Véase también
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;
}
}
}| defaultTextFormat | propiedad |
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.
public function get defaultTextFormat():TextFormat
public function set defaultTextFormat(value:TextFormat):void
Error — Este método no puede utilizarse en un campo de texto con una hoja de estilos.
|
Véase también
| displayAsPassword | propiedad |
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.
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
| embedFonts | propiedad |
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.
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
Véase también
| gridFitType | propiedad |
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 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. Es una buena opción para animación 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 |