Paquetefl.controls
Clasepublic class TextArea
HerenciaTextArea Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Implementa IFocusManagerComponent

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

El componente TextArea es un campo de texto de varias líneas con un borde y barras de desplazamiento opcionales. TextArea admite la funcionalidad de representación HTML de Adobe Flash Player.

Ver los ejemplos

Véase también

TextInput


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
Obtiene o define un valor booleano que indica si Flash Player resalta una selección en el campo de texto cuando éste no está seleccionado.
TextArea
 InheritedblendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.
DisplayObject
 InheritedbuttonMode : Boolean
Especifica el modo de botón de este elemento sprite.
Sprite
 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
  condenseWhite : Boolean
Obtiene o define un valor booleano que indica si se deben eliminar espacios en blanco adicionales de un componente TextArea con texto HTML.
TextArea
 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
  displayAsPassword : Boolean
Obtiene o define un valor booleano que indica si la instancia de componente TextArea es el campo de texto para una contraseña.
TextArea
 InheriteddoubleClickEnabled : Boolean
Especifica si este objeto recibe eventos doubleClick.
InteractiveObject
 InheriteddropTarget : DisplayObject
[read-only] Especifica el objeto de visualización sobre el que se está arrastrando el elemento sprite o sobre el que se ha colocado el elemento sprite.
Sprite
  editable : Boolean
Obtiene o define un valor booleano que indica si el usuario puede modificar el texto del componente.
TextArea
  enabled : Boolean
Obtiene o define un valor que indica si el componente puede aceptar la interacción del usuario.
TextArea
 Inheritedfilters : Array
Matriz indexada que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.
DisplayObject
 InheritedfocusEnabled : Boolean
Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él.
UIComponent
 InheritedfocusManager : IFocusManager
Obtiene o define la clase FocusManager que controla la selección de este componente y sus homólogos.
UIComponent
 InheritedfocusRect : Object
Especifica si este objeto muestra un rectángulo de selección.
InteractiveObject
 Inheritedgraphics : Graphics
[read-only] Especifica el objeto Graphics que pertenece a este elemento sprite, donde pueden ejecutarse comandos de dibujo vectorial.
Sprite
 Inheritedheight : Number
Obtiene o define la altura del componente, expresada en píxeles.
UIComponent
 InheritedhitArea : Sprite
Designa otro elemento sprite para que actúe como área activa de un elemento sprite.
Sprite
  horizontalScrollBar : UIScrollBar
[read-only] Obtiene una referencia a la barra de desplazamiento horizontal.
TextArea
  horizontalScrollPolicy : String
Obtiene o define la política de desplazamiento de la barra de desplazamiento horizontal.
TextArea
  horizontalScrollPosition : Number
Obtiene o define el cambio de posición del deslizador de la barra de desplazamiento, en píxeles, una vez que el usuario se desplaza por el campo de texto horizontalmente.
TextArea
  htmlText : String
Obtiene o define la representación HTML de la cadena que incluye el campo de texto.
TextArea
  imeMode : String
Obtiene o define el modo del editor de método de entrada (IME).
TextArea
  length : Number
[read-only] Obtiene el recuento de caracteres que contiene el componente TextArea.
TextArea
 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
Obtiene o define el número máximo de caracteres que puede introducir un usuario en el campo de texto.
TextArea
  maxHorizontalScrollPosition : int
[read-only] Obtiene el valor máximo de la propiedad horizontalScrollPosition.
TextArea
  maxVerticalScrollPosition : int
[read-only] Obtiene el valor máximo de la propiedad verticalScrollPosition.
TextArea
 InheritedmouseChildren : Boolean
Determina si los elementos secundarios del objeto están habilitados para ratón.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Especifica si este objeto recibe mensajes de ratón.
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él.
UIComponent
 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
 Inheritedname : String
Indica el nombre de instancia de DisplayObject.
DisplayObject
 InheritednumChildren : int
[read-only] Devuelve el número de elementos secundarios de este objeto.
DisplayObjectContainer
 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
Obtiene o define la cadena de caracteres que el campo de texto acepta del usuario.
TextArea
 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
Multiplica la anchura actual del componente por un factor de escala.
UIComponent
 InheritedscaleY : Number
Multiplica la altura actual del componente por un factor de escala.
UIComponent
 InheritedscrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización.
DisplayObject
  selectionBeginIndex : int
[read-only] Obtiene la posición del índice del primer carácter seleccionado en una selección de uno o varios caracteres.
TextArea
  selectionEndIndex : int
[read-only] Obtiene la posición del índice del último carácter seleccionado en una selección de uno o varios caracteres.
TextArea
 InheritedsoundTransform : SoundTransform
Controla el sonido dentro de este elemento sprite.
Sprite
 Inheritedstage : Stage
[read-only] El escenario del objeto de visualización.
DisplayObject
 InheritedtabChildren : Boolean
Determina si los elementos secundarios del objeto están habilitados para tabulación.
DisplayObjectContainer
 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
Obtiene o define una cadena que incluye el texto que está actualmente en el componente TextInput.
TextArea
  textField : TextField
Referencia al campo de texto interno del componente TextArea.
TextArea
  textHeight : Number
[read-only] Obtiene la altura del texto, expresada en píxeles.
TextArea
 InheritedtextSnapshot : TextSnapshot
[read-only] Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.
DisplayObjectContainer
  textWidth : Number
[read-only] Obtiene la anchura del texto, expresada en píxeles.
TextArea
 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
 InheriteduseHandCursor : Boolean
Valor booleano que indica si debe aparecer la mano que señala (cursor de mano) cuando el ratón pasa por encima de un elemento sprite en el que la propiedad buttonMode se ha definido con el valor true.
Sprite
 Inheritedversion : String = "3.0.0.15"
Número de versión de los componentes.
UIComponent
  verticalScrollBar : UIScrollBar
[read-only] Obtiene una referencia a la barra de desplazamiento vertical.
TextArea
  verticalScrollPolicy : String
Obtiene o define la política de desplazamiento de la barra de desplazamiento vertical.
TextArea
  verticalScrollPosition : Number
Obtiene o define el cambio de posición del deslizador de la barra de desplazamiento, en píxeles, una vez que el usuario se desplaza por el campo de texto verticalmente.
TextArea
 Inheritedvisible : Boolean
Obtiene o define un valor que indica si la instancia del componente actual es visible.
UIComponent
 Inheritedwidth : Number
Obtiene o define la anchura del componente, expresada en píxeles.
UIComponent
  wordWrap : Boolean
Obtiene o define un valor booleano que indica si el texto se ajusta al final de la línea.
TextArea
 Inheritedx : Number
Obtiene o define la coordenada x que representa la posición del componente a lo largo del eje x en su contenedor principal.
UIComponent
 Inheritedy : Number
Obtiene o define la coordenada y que representa la posición del componente a lo largo del eje y en su contenedor principal.
UIComponent
Métodos públicos
 MétodoDefinido por
  
Crea una instancia de componente TextArea nueva.
TextArea
 Inherited
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 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 especificada después del último carácter que incluye el componente TextArea.
TextArea
 Inherited
Indica si las restricciones de seguridad provocarían la omisión de objetos de visualización de la lista devuelta al llamar al método DisplayObjectContainer.getObjectsUnderPoint() con el punto point especificado.
DisplayObjectContainer
 Inherited
Elimina una propiedad de estilo de esta instancia de componente.
UIComponent
 Inherited
Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia.
DisplayObjectContainer
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
  
Muestra u oculta el indicador de selección en este componente.
TextArea
 Inherited
Inicia de forma inmediata una operación de dibujo, sin invalidarlo todo como ocurre con invalidateNow.
UIComponent
 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
 Inherited
Devuelve la instancia del objeto de visualización secundario que sale del índice especificado.
DisplayObjectContainer
 Inherited
Devuelve el objeto de visualización secundario que sale con el nombre especificado.
DisplayObjectContainer
 Inherited
Devuelve la posición de índice de una instancia secundaria de DisplayObject.
DisplayObjectContainer
 Inherited
Recupera el objeto que está seleccionado actualmente.
UIComponent
  
Recupera información sobre una línea de texto específica.
TextArea
 Inherited
Devuelve una matriz de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 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
 Inherited
Recupera una propiedad de estilo que se define en la cadena de búsqueda de estilo del componente.
UIComponent
  
[static] Devuelve la asignación de estilos predeterminada del componente actual.
TextArea
 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
invalidate(property:String, callLater:Boolean = true):void
Marca una propiedad como no válida y vuelve a dibujar el componente en el siguiente fotograma a menos que se especifique lo contrario.
UIComponent
 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
[static] Combina los estilos de varias clases en un objeto.
UIComponent
 Inherited
Mueve el componente a la posición especificada dentro de su elemento principal.
UIComponent
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Elimina la instancia child de DisplayObject especificada de la lista de elementos secundarios de la instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Elimina una instancia de DisplayObject secundaria de la posición de índice especificada en la lista de elementos secundarios de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
EventDispatcher
 Inherited
Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización.
DisplayObjectContainer
 Inherited
Selecciona este componente.
UIComponent
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
  
setSelection(setSelection:int, endIndex:int):void
Establece el rango de una selección realizada en un área de texto que se ha seleccionado.
TextArea
 Inherited
setSize(width:Number, height:Number):void
Define el componente en la anchura y altura especificadas.
UIComponent
 Inherited
setStyle(style:String, value:Object):void
Define una propiedad de estilo en esta instancia de componente.
UIComponent
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Permite al usuario arrastrar el elemento sprite especificado.
Sprite
 Inherited
Finaliza el método startDrag().
Sprite
 Inherited
Intercambia el orden z (de delante a atrás) de los dos objetos secundarios especificados.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Intercambia el orden z (de delante a atrás) de los objetos secundarios situados en las posiciones de índice especificadas en la lista de elementos secundarios.
DisplayObjectContainer
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Valida y actualiza las propiedades y el diseño de este objeto y lo vuelve a dibujar, si es necesario.
UIComponent
 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 cuando cambia el texto del componente TextArea.TextArea
 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
   Se distribuye cuando el usuario presiona la tecla Intro mientras está en el componente.TextArea
 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 la visibilidad del componente cambia de visible a invisible.UIComponent
 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
 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 se mueve el componente.UIComponent
 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 se cambia el tamaño del componente.UIComponent
 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
   Se distribuye cuando se recorre el contenido.TextArea
 Inherited Se distribuye cuando la visibilidad del componente cambia de invisible a visible.UIComponent
 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
   Se distribuye cuando el usuario escribe, borra o pega texto en el componente.TextArea
Estilos
 Estilo Descripción Definido por
  
disabledSkin
Tipo: Class
La clase que proporciona el fondo para el componente TextArea cuando su propiedad enabled está definida como false. El valor predeterminado es TextArea_disabledSkin.
TextArea
 Inherited Tipo: flash.text.TextFormat
El objeto TextFormat que se utilizará para representar la etiqueta del componente cuando el botón esté desactivado.
UIComponent
  
embedFonts
Tipo: Boolean
Indica si se utilizan contornos de fuentes incorporadas para representar el campo de texto. Si este valor es true, Flash Player representa el campo de texto utilizando contornos de fuentes incorporados. Si es false, Flash Player representa el campo de texto mediante fuentes del dispositivo.

Si define la propiedad 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.
TextArea
 Inherited Tipo: Number   Formato: Length
El relleno que separa los límites externos del componente de los bordes externos del indicador de selección, expresado en píxeles.
UIComponent
 Inherited Tipo: Class
El aspecto que se utilizará para mostrar los indicadores de selección.
UIComponent
 Inherited Tipo: flash.text.TextFormat
El objeto TextFormat que se utilizará para representar la etiqueta del componente.
UIComponent
  
textPadding
Tipo: Number   Formato: Length
El relleno que separa el borde del componente del texto, expresado en píxeles. El valor predeterminado es 3.
TextArea
  
upSkin
Tipo: Class
La clase que proporciona el fondo para el componente TextArea. El valor predeterminado es TextArea_upSkin.
TextArea
Información sobre propiedades
alwaysShowSelectionpropiedad
alwaysShowSelection:Boolean  [read-write]

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

Obtiene o define un valor booleano que indica si Flash Player resalta una selección en el campo de texto cuando éste no está seleccionado. Si este valor se establece en true y el campo de texto no está seleccionado, Flash Player resalta la selección en color gris. Si este valor se establece en false y el campo de texto no está seleccionado, Flash Player no resalta la selección.

El valor predeterminado es false.


Implementación
    public function get alwaysShowSelection():Boolean
    public function set alwaysShowSelection(value:Boolean):void

Véase también

condenseWhitepropiedad 
condenseWhite:Boolean  [read-write]

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

Obtiene o define un valor booleano que indica si se deben eliminar espacios en blanco adicionales de un componente TextArea con texto HTML. Entre los ejemplos de espacios en blanco adicionales del componente se incluyen espacios y saltos de línea. true indica que se eliminan los espacios en blanco adicionales; false determina lo contrario.

Esta propiedad sólo afecta al texto definido con la propiedad htmlText; no afecta al texto que se establece con la propiedad text. Si utiliza la propiedad text para definir texto, condenseWhite se omitirá.

Si establece la propiedad condenseWhite como true, debe utilizar comandos HTML estándar, como <br> y <p>, para incluir saltos de línea en el campo de texto.

El valor predeterminado es false.


Implementación
    public function get condenseWhite():Boolean
    public function set condenseWhite(value:Boolean):void

Véase también


Ejemplo

En el ejemplo siguiente, se utiliza un componente CheckBox para activar una propiedad condenseWhite del componente TextArea:

import fl.controls.CheckBox;
import fl.controls.ScrollPolicy;
import fl.controls.TextArea;

var str:String;

var plainTextArea:TextArea = new TextArea();
plainTextArea.verticalScrollPolicy = ScrollPolicy.ON;
plainTextArea.setSize(260, 360);
plainTextArea.move(10, 10);
addChild(plainTextArea);

var htmlTextArea:TextArea = new TextArea();
htmlTextArea.verticalScrollPolicy = ScrollPolicy.ON;
htmlTextArea.condenseWhite = true;
htmlTextArea.setSize(260, 360);
htmlTextArea.move(280, 10);
addChild(htmlTextArea);

var condenseCheckBox:CheckBox = new CheckBox();
condenseCheckBox.textField.autoSize = TextFieldAutoSize.LEFT;
condenseCheckBox.label = "condenseWhite:";
condenseCheckBox.selected = htmlTextArea.condenseWhite;
condenseCheckBox.move(htmlTextArea.x, htmlTextArea.y + htmlTextArea.height);
condenseCheckBox.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(condenseCheckBox);

var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/lorem.html"));

function completeHandler(event:Event):void {
    str = event.target.data as String;
    plainTextArea.text = str;
    htmlTextArea.htmlText = str;
}

function clickHandler(event:MouseEvent):void {
    var sel:Boolean = event.currentTarget.selected;
    htmlTextArea.condenseWhite = sel;
    htmlTextArea.htmlText = str;
}
displayAsPasswordpropiedad 
displayAsPassword:Boolean  [read-write]

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

Obtiene o define un valor booleano que indica si la instancia de componente TextArea es el campo de texto para una contraseña. El valor true determina que la instancia actual se ha creado para que incluya una contraseña; false especifica lo contrario.

Si el valor de esta propiedad es true, los caracteres que introduce el usuario en el área de texto no se podrán ver. Aparecerá un asterisco en lugar de cada carácter que introduzca el usuario. Asimismo, se desactivan los comandos Cortar y Copiar y sus correspondientes métodos abreviados de teclado para evitar la obtención de una contraseña en un equipo en el que no haya nadie presente.

El valor predeterminado es false.


Implementación
    public function get displayAsPassword():Boolean
    public function set displayAsPassword(value:Boolean):void
editablepropiedad 
editable:Boolean  [read-write]

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

Obtiene o define un valor booleano que indica si el usuario puede modificar el texto del componente. El valor true indica que el usuario puede modificar el texto que incluye el componente; false determina lo contrario.

El valor predeterminado es true.


Implementación
    public function get editable():Boolean
    public function set editable(value:Boolean):void
enabledpropiedad 
enabled:Boolean  [read-write]

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

Obtiene o define un valor que indica si el componente puede aceptar la interacción del usuario. Un valor true indica que el componente puede aceptar la interacción del usuario; un valor false indica que no puede aceptarla.

Si la propiedad enabled se define como false, el color del contenedor aparece atenuado y la entrada del usuario está bloqueada (con la excepción de los componentes Label y ProgressBar).


Implementación
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
horizontalScrollBarpropiedad 
horizontalScrollBar:UIScrollBar  [read-only]

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

Obtiene una referencia a la barra de desplazamiento horizontal.


Implementación
    public function get horizontalScrollBar():UIScrollBar

Véase también

horizontalScrollPolicypropiedad 
horizontalScrollPolicy:String  [read-write]

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

Obtiene o define la política de desplazamiento de la barra de desplazamiento horizontal. Puede tratarse de cualquiera de los valores siguientes:

El valor predeterminado es ScrollPolicy.AUTO.


Implementación
    public function get horizontalScrollPolicy():String
    public function set horizontalScrollPolicy(value:String):void

Véase también


Ejemplo

En el ejemplo siguiente, se crea una instancia de componente TextArea y se define la propiedad horizontalScrollPolicy en ScrollPolicy.ON, de modo que la barra de desplazamiento horizontal siempre esté visible, independientemente de la cantidad de contenido en el área de texto:

import fl.controls.TextArea;
import fl.controls.ScrollPolicy;

var myTextArea:TextArea = new TextArea();
myTextArea.wordWrap = false;
myTextArea.horizontalScrollPolicy = ScrollPolicy.ON;
myTextArea.text = "The quick brown fox jumped over the lazy dog.";
myTextArea.setSize(320, 120);
myTextArea.move(10, 10);
addChild(myTextArea);
horizontalScrollPositionpropiedad 
horizontalScrollPosition:Number  [read-write]

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

Obtiene o define el cambio de posición del deslizador de la barra de desplazamiento, en píxeles, una vez que el usuario se desplaza por el campo de texto horizontalmente. Si este valor es 0, el campo de texto no se ha desplazado horizontalmente.

El valor predeterminado es 0.


Implementación
    public function get horizontalScrollPosition():Number
    public function set horizontalScrollPosition(value:Number):void

Véase también

htmlTextpropiedad 
htmlText:String  [read-write]

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

Obtiene o define la representación HTML de la cadena que incluye el campo de texto.

El valor predeterminado es "".


Implementación
    public function get htmlText():String
    public function set htmlText(value:String):void

Véase también


Ejemplo

En el ejemplo siguiente, se crea una instancia de componente TextArea y se utilizan varias etiquetas HTML para asignar el estilo al texto:

import fl.controls.TextArea;

var myText:String = "";
myText += "<p>You can use the <b> tag to create <b>bold</b> text.</p>";
myText += "<p>You can use the <i> tag to create <i>italic</i> text.</p>";
myText += "<p>You can use the <u> tag to create <u>underlined</a> text.</p>";
myText += "<p>You can use the <a> tag to create <a href='http://www.adobe.com'>links to other sites</a>.</p>";
myText += "<p>You can use the <br> tag to create<br>new lines of text<br>whenever you want.</p>";
myText += "<p>You can use the <font> tag to specificy different font <font color='#FF0000'>colors</font>, <font size='16'>sizes</font>, or <font face='Times New Roman'>faces</font>.</p>";
myText += "<p>You can use the <img> tag to load images or SWF files:<br><img src='http://www.helpexamples.com/flash/images/logo.png'>.</p>";

var myTextArea:TextArea = new TextArea();
myTextArea.htmlText = myText;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
addChild(myTextArea);

En el ejemplo siguiente, se crea una instancia de componente TextArea y varios vínculos mediante una etiqueta de anclaje HTML:

import fl.controls.TextArea;

var str:String = "<p>Check out the following links:</p>";
str += "<li><a href=\"event:flash\"><u>Flash</u></a></li>";
str += "<li><a href=\"event:flex\"><u>Flex</u></a></li>";
str += "<li><a href=\"event:devnet\"><u>Developer Center</u></a></li>";

var myTextArea:TextArea = new TextArea();
myTextArea.htmlText += str;
myTextArea.setSize(320, 120);
myTextArea.move(10, 10);
myTextArea.addEventListener(TextEvent.LINK, linkHandler);
addChild(myTextArea);

function linkHandler(event:TextEvent):void {
    var url:String = "http://www.adobe.com/go/" + event.text;
    var urlReq:URLRequest = new URLRequest(url);
    navigateToURL(urlReq);
}
imeModepropiedad 
imeMode:String  [read-write]

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

Obtiene o define el modo del editor de método de entrada (IME). IME posibilita que el usuario utilice un teclado occidental estándar (QWERTY) para introducir caracteres de los idiomas japonés, chino y coreano.

Flash establece IME en el modo especificado cuando se selecciona el componente y restaura su valor original cuando el componente ya no está seleccionado.

La clase flash.system.IMEConversionMode define las constantes para los valores válidos de esta propiedad. Defina esta propiedad como null para evitar el uso de IME con el componente.


Implementación
    public function get imeMode():String
    public function set imeMode(value:String):void

Véase también

lengthpropiedad 
length:Number  [read-only]

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

Obtiene el recuento de caracteres que contiene el componente TextArea.

El valor predeterminado es 0.


Implementación
    public function get length():Number

Véase también

maxCharspropiedad 
maxChars:int  [read-write]

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

Obtiene o define el número máximo de caracteres que puede introducir un usuario en el campo de texto.

El valor predeterminado es 0.


Implementación
    public function get maxChars():int
    public function set maxChars(value:int):void

Véase también


Ejemplo

En el ejemplo siguiente, se crea una instancia de componente TextArea y se define la propiedad maxChars para limitar la cantidad de texto que se puede introducir en el área de texto:

import fl.controls.Label;
import fl.controls.TextArea;

var myTextArea:TextArea = new TextArea();
myTextArea.maxChars = 500;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(TextEvent.TEXT_INPUT, textInputHandler);
addChild(myTextArea);

var charCountLabel:Label = new Label();
charCountLabel.autoSize = TextFieldAutoSize.LEFT;
charCountLabel.move(myTextArea.x, myTextArea.y + myTextArea.height);
addChild(charCountLabel);

charCountLabel.text = myTextArea.length + " of " + myTextArea.maxChars;

function textInputHandler(event:TextEvent):void {
    updateCount();
}

function updateCount():void {
    charCountLabel.text = myTextArea.length + " of " + myTextArea.maxChars;
}
maxHorizontalScrollPositionpropiedad 
maxHorizontalScrollPosition:int  [read-only]

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

Obtiene el valor máximo de la propiedad horizontalScrollPosition.

El valor predeterminado es 0.


Implementación
    public function get maxHorizontalScrollPosition():int

Véase también

maxVerticalScrollPositionpropiedad 
maxVerticalScrollPosition:int  [read-only]

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

Obtiene el valor máximo de la propiedad verticalScrollPosition.

El valor predeterminado es 1.


Implementación
    public function get maxVerticalScrollPosition():int

Véase también

restrictpropiedad 
restrict:String  [read-write]

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

Obtiene o define la cadena de caracteres que el campo de texto acepta del usuario.

Tenga en cuenta que los caracteres que no se incluyen en esta cadena se aceptan en el campo de texto si se introducen mediante programación.

Los caracteres de la cadena se leen de izquierda a derecha. Se puede especificar un rango de caracteres utilizando el carácter de guión (-).

Si el valor de esta propiedad es null, el campo de texto acepta todos los caracteres. Si esta propiedad se define como una cadena vacía (""), el campo de texto no aceptará caracteres.

Si la cadena empieza por un carácter de intercalación (^), en un principio se aceptan todos los caracteres; los caracteres posteriores de la cadena se excluyen del conjunto de caracteres aceptados. Si la cadena no empieza por un carácter de intercalación (^), inicialmente no se acepta ningún carácter; los caracteres posteriores de la cadena se incluyen en el conjunto de caracteres aceptados.

El valor predeterminado es null.


Implementación
    public function get restrict():String
    public function set restrict(value:String):void

Véase también

selectionBeginIndexpropiedad 
selectionBeginIndex:int  [read-only]

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

Obtiene la posición del índice del primer carácter seleccionado en una selección de uno o varios caracteres.

La posición de índice de un carácter seleccionado se basa en cero y se calcula a partir del primer carácter que aparece en el área de texto. Si no hay selección, este valor se establece en la posición del carácter de intercalación.

El valor predeterminado es 0.


Implementación
    public function get selectionBeginIndex():int

Véase también

selectionEndIndexpropiedad 
selectionEndIndex:int  [read-only]

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

Obtiene la posición del índice del último carácter seleccionado en una selección de uno o varios caracteres.

La posición de índice de un carácter seleccionado se basa en cero y se calcula a partir del primer carácter que aparece en el área de texto. Si no hay selección, este valor se establece en la posición del carácter de intercalación.

El valor predeterminado es 0.


Implementación
    public function get selectionEndIndex():int

Véase también

textpropiedad 
text:String  [read-write]

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

Obtiene o define una cadena que incluye el texto que está actualmente en el componente TextInput. Esta propiedad contiene texto sin formato y no dispone de etiquetas HTML. Para recuperar este texto en formato HTML, utilice la propiedad htmlText.

El valor predeterminado es "".


Implementación
    public function get text():String
    public function set text(value:String):void

Véase también

textFieldpropiedad 
public var textField:TextField

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

Referencia al campo de texto interno del componente TextArea.

textHeightpropiedad 
textHeight:Number  [read-only]

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

Obtiene la altura del texto, expresada en píxeles.

El valor predeterminado es 0.


Implementación
    public function get textHeight():Number

Véase también


Ejemplo

En el ejemplo siguiente, se crea una instancia de componente TextArea y se muestran las propiedades textWidth y textHeight cuando se distribuye el evento change:

import fl.controls.Label;
import fl.controls.TextArea;

var myTextArea:TextArea = new TextArea()
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextArea);

var widthLabel:Label = new Label();
widthLabel.autoSize = TextFieldAutoSize.LEFT;
widthLabel.text = "textWidth: " + myTextArea.textWidth;
widthLabel.move(340, 10);
addChild(widthLabel);

var heightLabel:Label = new Label();
heightLabel.autoSize = TextFieldAutoSize.LEFT;
heightLabel.text = "textHeight: " + myTextArea.textHeight;
heightLabel.move(340, 30);
addChild(heightLabel);

function changeHandler(event:Event):void {
    widthLabel.text = "textWidth: " + myTextArea.textWidth;
    heightLabel.text = "textHeight: " + myTextArea.textHeight;
}
textWidthpropiedad 
textWidth:Number  [read-only]

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

Obtiene la anchura del texto, expresada en píxeles.

El valor predeterminado es 0.


Implementación
    public function get textWidth():Number

Véase también


Ejemplo

En el ejemplo siguiente, se crea una instancia de componente TextArea y se muestran las propiedades textWidth y textHeight cuando se distribuye el evento change:

import fl.controls.Label;
import fl.controls.TextArea;

var myTextArea:TextArea = new TextArea()
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextArea);

var widthLabel:Label = new Label();
widthLabel.autoSize = TextFieldAutoSize.LEFT;
widthLabel.text = "textWidth: " + myTextArea.textWidth;
widthLabel.move(340, 10);
addChild(widthLabel);

var heightLabel:Label = new Label();
heightLabel.autoSize = TextFieldAutoSize.LEFT;
heightLabel.text = "textHeight: " + myTextArea.textHeight;
heightLabel.move(340, 30);
addChild(heightLabel);

function changeHandler(event:Event):void {
    widthLabel.text = "textWidth: " + myTextArea.textWidth;
    heightLabel.text = "textHeight: " + myTextArea.textHeight;
}
verticalScrollBarpropiedad 
verticalScrollBar:UIScrollBar  [read-only]

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

Obtiene una referencia a la barra de desplazamiento vertical.


Implementación
    public function get verticalScrollBar():UIScrollBar

Véase también


Ejemplo

En el ejemplo siguiente, se crea una instancia de componente TextArea y se define la propiedad pageSize de la barra de desplazamiento vertical del componente:

import fl.controls.TextArea;
import fl.events.ScrollEvent;

var myTextArea:TextArea = new TextArea();
myTextArea.setSize(160, 120);
myTextArea.move(10, 10);
myTextArea.verticalScrollBar.pageSize = 1;
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea);

var myURLLoader:URLLoader = new URLLoader();
myURLLoader.addEventListener(Event.COMPLETE, completeHandler);
myURLLoader.load(new URLRequest("http://www.helpexamples.com/flash/lorem.txt"));

function scrollHandler(event:ScrollEvent):void {
    trace("scroll: " + myTextArea.verticalScrollPosition + " of " + myTextArea.maxVerticalScrollPosition);
}

function completeHandler(event:Event):void {
    var txt:String = URLLoader(event.currentTarget).data as String;
    myTextArea.text = txt;
}
verticalScrollPolicypropiedad 
verticalScrollPolicy:String  [read-write]

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

Obtiene o define la política de desplazamiento de la barra de desplazamiento vertical. Puede tratarse de cualquiera de los valores siguientes:

El valor predeterminado es ScrollPolicy.AUTO.


Implementación
    public function get verticalScrollPolicy():String
    public function set verticalScrollPolicy(value:String):void

Véase también


Ejemplo

En el ejemplo siguiente, se crea una instancia de componente TextArea y se define la propiedad verticalScrollPolicy en ScrollPolicy.ON, de modo que la barra de desplazamiento vertical siempre esté visible, independientemente de la cantidad de contenido en el área de texto:

import fl.controls.TextArea;
import fl.controls.ScrollPolicy;

var myTextArea:TextArea = new TextArea();
myTextArea.verticalScrollPolicy = ScrollPolicy.ON;
myTextArea.text = "The quick brown fox jumped over the lazy dog.";
myTextArea.setSize(160, 120);
myTextArea.move(10, 10);
addChild(myTextArea);
verticalScrollPositionpropiedad 
verticalScrollPosition:Number  [read-write]

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

Obtiene o define el cambio de posición del deslizador de la barra de desplazamiento, en píxeles, una vez que el usuario se desplaza por el campo de texto verticalmente. Si este valor es 1, el campo de texto no se ha desplazado verticalmente.

El valor predeterminado es 1.


Implementación
    public function get verticalScrollPosition():Number
    public function set verticalScrollPosition(value:Number):void

Véase también


Ejemplo

En el ejemplo siguiente, se utiliza un componente Slider para desplazar el contenido de un componente TextArea:

import fl.controls.ScrollPolicy;
import fl.controls.Slider;
import fl.controls.SliderDirection
import fl.controls.TextArea;
import fl.events.ScrollEvent;
import fl.events.SliderEvent;

var myTextArea:TextArea = new TextArea();
myTextArea.horizontalScrollPolicy = ScrollPolicy.OFF;
myTextArea.verticalScrollPolicy = ScrollPolicy.OFF;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea)

var mySlider:Slider = new Slider();
mySlider.liveDragging = true;
mySlider.snapInterval = 1;
mySlider.tickInterval = 1;
mySlider.width = myTextArea.width;
mySlider.move(myTextArea.x, myTextArea.y + myTextArea.height + 10);

var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/text/lorem.txt"));

function completeHandler(event:Event):void {
    var txt:String = event.target.data as String;
    myTextArea.text = txt;
    myTextArea.drawNow();

    mySlider.minimum = myTextArea.verticalScrollPosition;
    mySlider.maximum = myTextArea.maxVerticalScrollPosition;
    mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
    addChild(mySlider);
}

function scrollHandler(event:ScrollEvent):void {
    trace("scrolled:");
    mySlider.value = event.position;
}

function changeHandler(event:SliderEvent):void {
    trace("changed:");
    myTextArea.verticalScrollPosition = event.value;
}
wordWrappropiedad 
wordWrap:Boolean  [read-write]

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

Obtiene o define un valor booleano que indica si el texto se ajusta al final de la línea. El valor true determina el ajuste del texto; false indica lo contrario.

El valor predeterminado es true.


Implementación
    public function get wordWrap():Boolean
    public function set wordWrap(value:Boolean):void

Véase también

Información sobre constructores
TextArea()constructor
public function TextArea()

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

Crea una instancia de componente TextArea nueva.

Información sobre métodos
appendText()método
public function appendText(text:String):void

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

Añade la cadena especificada después del último carácter que incluye el componente TextArea. Este método resulta más eficaz que concatenar dos cadenas utilizando una asignación de suma en una propiedad de texto; por ejemplo, myTextArea.text += moreText. Este método es especialmente útil cuando el componente TextArea incluye una cantidad importante de contenido.

Parámetros

text:String — Cadena que se va a añadir al texto existente.

drawFocus()método 
public override function drawFocus(focused:Boolean):void

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

Muestra u oculta el indicador de selección en este componente.

La clase UIComponent implementa este método mediante la creación y posición de una instancia de la clase que se especifica mediante el estilo focusSkin.

Parámetros

focused:Boolean — Indica si se muestra o se oculta el indicador de selección. Si este valor es true, se mostrará el indicador de selección; si el valor es false, quedará oculto.

getLineMetrics()método 
public function getLineMetrics(lineIndex:int):TextLineMetrics

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

Recupera información sobre una línea de texto específica.

Parámetros

lineIndex:int — Número de línea para el que se va a recuperar información.

Valor devuelto
TextLineMetrics
getStyleDefinition()método 
public static function getStyleDefinition():Object

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

Devuelve la asignación de estilos predeterminada del componente actual. La asignación de estilos contiene el tipo adecuado para el componente, en función del estilo que ese componente utilice. Por ejemplo, el estilo disabledTextFormat contiene un valor null o un objeto TextFormat. Puede utilizar estos estilos y llamar a setStyle() en el componente actual. El código siguiente sustituye el estilo predeterminado disabledTextFormat en el componente especificado:

componentInstance.setStyle("disabledTextFormat", new TextFormat());

Valor devuelto
Object — Objeto de estilos predeterminados.

Véase también


Ejemplo

En el ejemplo siguiente, se crea un navegador de estilos para varias clases de componentes:
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}
setSelection()método 
public function setSelection(setSelection:int, endIndex:int):void

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

Establece el rango de una selección realizada en un área de texto que se ha seleccionado. El rango de selección comienza en el índice que se especifica mediante el parámetro start y termina en el índice indicado con el parámetro end. El texto seleccionado se considera como una cadena de caracteres basada en cero en la que el primer carácter seleccionado se sitúa en el índice 0, el segundo carácter en el índice 1 y así sucesivamente.

Este método no surte efecto si el campo de texto no se ha seleccionado.

Parámetros

setSelection:int — La ubicación del índice del primer carácter de la selección.
 
endIndex:int — La posición del índice del último carácter de la selección.

Información sobre eventos
change Evento
Tipo de objeto de evento: flash.events.Event
Event.type property = flash.events.Event.CHANGE

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

Se distribuye cuando cambia el texto del componente TextArea.

Define el valor de la propiedad type de un objeto de evento change.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblestrue
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetObjeto al que se ha modificado su valor. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente.
enter Evento  
Tipo de objeto de evento: fl.events.ComponentEvent
ComponentEvent.type property = fl.events.ComponentEvent.ENTER

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

Se distribuye cuando el usuario presiona la tecla Intro mientras está en el componente.

Define el valor de la propiedad type para un objeto de evento enter.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.
scroll Evento  
Tipo de objeto de evento: fl.events.ScrollEvent
ScrollEvent.type property = fl.events.ScrollEvent.SCROLL

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

Se distribuye cuando se recorre el contenido.

Define el valor de la propiedad type de un objeto de evento scroll.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
delta1; valor que indica la cantidad de desplazamiento que se ha realizado.
directionvertical; dirección de ScrollBar.
position0; posición del deslizador Scrollbar después de que se haya movido.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.

Ejemplo

En el ejemplo siguiente, se carga texto en un componente TextArea y se realiza el seguimiento de la dirección de desplazamiento, la posición de desplazamiento y la posición de desplazamiento máxima cuando el usuario se desplaza por el componente TextArea:

import fl.controls.ScrollBarDirection;
import fl.controls.TextArea;
import fl.events.ScrollEvent;

var myTextArea:TextArea = new TextArea();
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea);

var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/text/lorem.txt"));

function completeHandler(event:Event):void {
    var txt:String = event.target.data as String;
    myTextArea.text = txt;
}

function scrollHandler(event:ScrollEvent):void {
    var myTA:TextArea = event.currentTarget as TextArea;
    var pos:Number = event.position;
    var maxPos:Number;

    if (event.direction == ScrollBarDirection.VERTICAL) {
        maxPos = myTA.maxVerticalScrollPosition;
    } else {
        maxPos = myTA.maxHorizontalScrollPosition;
    }
    trace("scroll: " + event.direction + " (" + pos.toFixed(2) + " of " + maxPos + ")");
}
textInput Evento  
Tipo de objeto de evento: flash.events.TextEvent
TextEvent.type property = flash.events.TextEvent.TEXT_INPUT

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

Se distribuye cuando el usuario escribe, borra o pega texto en el componente.

Define el valor de la propiedad type de un objeto de evento textInput.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblestrue
cancelabletrue; llama al método preventDefault() para cancelar el comportamiento predeterminado.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetCampo 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.
textCarácter o secuencia de caracteres introducidos por el usuario.
Ejemplos Cómo utilizar los ejemplos
TextAreaExample.as

En este ejemplo se muestra cómo detectar los eventos de una instancia de la clase TextArea..

Para realizar el ejemplo, siga estos pasos:

  1. Arrastre un componente TextArea al escenario y denomínelo ta1.
  2. Arrastre un componente TextArea al escenario y denomínelo ta2.
  3. Guarde este código como TextAreaExample.as en el mismo directorio que el archivo FLA.
  4. Defina la clase Document como TextAreaExample en el archivo FLA.
package
{
    import fl.controls.TextArea;
    import fl.events.ComponentEvent;
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.events.TextEvent;
    import flash.text.TextField;

    public class TextAreaExample extends Sprite
    {
        private var testString:String         = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Vivamus quis nisl vel tortor nonummy vulputate. Quisque sit amet eros sed purus euismod tempor. Morbi tempor. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos. Curabitur diam. Suspendisse at purus in ipsum volutpat viverra. Nulla pellentesque libero id libero. Proin pretium suscipit lectus. Donec in sapien vel nulla egestas semper. Mauris massa. In aliquet sem ac libero. In eget orci. Sed feugiat. Vestibulum vel felis in lectus imperdiet scelerisque. Vestibulum vestibulum neque at est. Etiam purus quam, laoreet quis, accumsan sed, porttitor ut, erat. Proin volutpat. In facilisis dolor gravida felis. Curabitur nisi lacus, euismod non, pharetra et, mollis a, tellus. Donec lectus orci, viverra at, luctus ac, sodales id, quam. Phasellus faucibus lacus ut est. Curabitur id diam eu massa bibendum lobortis. Vivamus quis elit. Donec mi justo, dictum vitae, cursus sit amet, lacinia consectetuer, d ut, vulputate sed, molestie et, arcu. Nullam mi.';
        private var testStringHTML:String     = 'This is <font color="#FF0000">HTML text</font> in a <b>TextArea control</b>. Use the <u>htmlText property</u> of the <font color="#008800">TextArea control</font> to include basic HTML markup in your text.';

        public function TextAreaExample() {
            ta1.text = testString;
            ta2.htmlText = testStringHTML;
            configureListeners(ta1);
            configureListeners(ta2);
        }
        private function configureListeners(ta:TextArea):void {
            ta.addEventListener(TextEvent.TEXT_INPUT,announceEvent);
            ta.addEventListener(Event.CHANGE,announceEvent);
            ta.addEventListener(ComponentEvent.ENTER,announceEvent);
            ta.addEventListener(Event.SCROLL,announceEvent);
        }
        private function announceEvent(e:Event):void {
            trace(e.toString());
        }
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/fl/controls/TextArea.html