TextArea

Paquete	fl.controls
Clase	public class TextArea
Herencia	TextArea UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
Implementa	IFocusManagerComponent

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

Elementos de API relacionados

TextInput

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		accessibilityImplementation : AccessibilityImplementation La implementación actual de accesibilidad (AccessibilityImplementation) para esta instancia de InteractiveObject.	InteractiveObject
		accessibilityProperties : AccessibilityProperties Las opciones de accesibilidad actuales para este objeto de visualización.	DisplayObject
		alpha : Number Indica el valor de transparencia alfa del objeto especificado.	DisplayObject
		alwaysShowSelection : Boolean Obtiene o define un valor booleano que indica si Flash Player resalta una selección en el campo de texto cuando éste no está seleccionado.	TextArea
		blendMode : String Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.	DisplayObject
		blendShader : Shader [solo escritura] Define un sombreado para utilizarlo en la mezcla del primer plano y del fondo.	DisplayObject
		buttonMode : Boolean Especifica el modo de botón de este elemento sprite.	Sprite
		cacheAsBitmap : Boolean Si se define como true, los motores de ejecución de Flash dejan en caché una representación interna de mapa de bits del objeto de visualización.	DisplayObject
		cacheAsBitmapMatrix : Matrix Si su valor no es null, este objeto Matrix define cómo un objeto de visualización se procesa cuando cacheAsBitmap se define como true.	DisplayObject
		condenseWhite : Boolean Obtiene o define un valor booleano que indica si se deben eliminar espacios en blanco adicionales de un componente TextArea con texto HTML.	TextArea
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		contextMenu : NativeMenu Especifica el menú contextual asociado a este objeto.	InteractiveObject
		displayAsPassword : Boolean Obtiene o define un valor booleano que indica si la instancia de componente TextArea es el campo de texto para una contraseña.	TextArea
		doubleClickEnabled : Boolean Especifica si este objeto recibe eventos doubleClick.	InteractiveObject
		dropTarget : DisplayObject [solo lectura] Especifica el objeto de visualización sobre el que se está arrastrando el elemento sprite o sobre el que se ha colocado el elemento sprite.	Sprite
		editable : Boolean Obtiene o define un valor booleano que indica si el usuario puede modificar el texto del componente.	TextArea
		enabled : Boolean [override] Obtiene o define un valor que indica si el componente puede aceptar la interacción del usuario.	TextArea
		filters : Array Conjunto indexado que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.	DisplayObject
		focusEnabled : Boolean Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él.	UIComponent
		focusManager : IFocusManager Obtiene o define la clase FocusManager que controla la selección de este componente y sus homólogos.	UIComponent
		focusRect : Object Especifica si este objeto muestra un rectángulo de selección.	InteractiveObject
		graphics : Graphics [solo lectura] Especifica el objeto Graphics que pertenece a este elemento sprite, donde pueden ejecutarse comandos de dibujo vectorial.	Sprite
		height : Number [override] Obtiene o define la altura del componente, expresada en píxeles.	UIComponent
		hitArea : Sprite Designa otro elemento sprite para que actúe como área activa de un elemento sprite.	Sprite
		horizontalScrollBar : UIScrollBar [solo lectura] 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 [solo lectura] Obtiene el recuento de caracteres que contiene el componente TextArea.	TextArea
		loaderInfo : LoaderInfo [solo lectura] Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización.	DisplayObject
		mask : DisplayObject El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado.	DisplayObject
		maxChars : int Obtiene o define el número máximo de caracteres que puede introducir un usuario en el campo de texto.	TextArea
		maxHorizontalScrollPosition : int [solo lectura] Obtiene el valor máximo de la propiedad horizontalScrollPosition.	TextArea
		maxVerticalScrollPosition : int [solo lectura] Obtiene el valor máximo de la propiedad verticalScrollPosition.	TextArea
		metaData : Object Obtiene el objeto de metadatos de la instancia de DisplayObject si los metadatos se almacenaron con la instancia de este objeto DisplayObject en el archivo SWF a través de una etiqueta PlaceObject4.	DisplayObject
		mouseChildren : Boolean Determina si los elementos secundarios del objeto están activados para acciones de ratón o de dispositivo de entrada de usuario.	DisplayObjectContainer
		mouseEnabled : Boolean Especifica si este objeto recibe la entrada del ratón, la entrada del usuario o mensajes.	InteractiveObject
		mouseFocusEnabled : Boolean Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él.	UIComponent
		mouseX : Number [solo lectura] Indica la coordenada x de la posición del ratón o del dispositivo de entrada del usuario, en píxeles.	DisplayObject
		mouseY : Number [solo lectura] Indica la coordenada y de la posición del ratón o del dispositivo de entrada del usuario, en píxeles.	DisplayObject
		name : String Indica el nombre de instancia de DisplayObject.	DisplayObject
		needsSoftKeyboard : Boolean Especifica si un teclado virtual (teclado en pantalla) se debe mostrar cuando esta instancia de InteractiveObject recibe la selección.	InteractiveObject
		numChildren : int [solo lectura] Devuelve el número de elementos secundarios de este objeto.	DisplayObjectContainer
		opaqueBackground : Object Especifica si el objeto de visualización es opaco con un determinado color de fondo.	DisplayObject
		parent : DisplayObjectContainer [solo lectura] Indica el objeto DisplayObjectContainer que contiene este objeto de visualización.	DisplayObject
		restrict : String Obtiene o define la cadena de caracteres que el campo de texto acepta del usuario.	TextArea
		root : DisplayObject [solo lectura] Para un objeto de visualización en un archivo SWF cargado, la propiedad root es el objeto de visualización de nivel más alto en la parte de la estructura de árbol de la lista de visualización representada por dicho archivo SWF.	DisplayObject
		rotation : Number Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original.	DisplayObject
		rotationX : Number Indica la rotación del eje x de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D.	DisplayObject
		rotationY : Number Indica la rotación del eje y de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D.	DisplayObject
		rotationZ : Number Indica la rotación del eje z de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D.	DisplayObject
		scale9Grid : Rectangle La cuadrícula de escala aplicada actualmente.	DisplayObject
		scaleX : Number [override] Multiplica la anchura actual del componente por un factor de escala.	UIComponent
		scaleY : Number [override] Multiplica la altura actual del componente por un factor de escala.	UIComponent
		scaleZ : Number Indica la escala de profundidad (porcentaje) de un objeto aplicada desde el punto de registro del objeto.	DisplayObject
		scrollRect : Rectangle Los límites del rectángulo de desplazamiento del objeto de visualización.	DisplayObject
		selectionBeginIndex : int [solo lectura] Obtiene la posición del índice del primer carácter seleccionado en una selección de uno o varios caracteres.	TextArea
		selectionEndIndex : int [solo lectura] Obtiene la posición del índice del último carácter seleccionado en una selección de uno o varios caracteres.	TextArea
		softKeyboard : String Controla la apariencia del teclado virtual.	InteractiveObject
		softKeyboardInputAreaOfInterest : Rectangle Define el área que debe permanecer en pantalla cuando se muestra un teclado virtual (no disponible en iOS).	InteractiveObject
		soundTransform : flash.media:SoundTransform Controla el sonido dentro de este elemento sprite.	Sprite
		stage : Stage [solo lectura] El escenario del objeto de visualización.	DisplayObject
		tabChildren : Boolean Determina si los elementos secundarios del objeto están habilitados para tabulación.	DisplayObjectContainer
		tabEnabled : Boolean Especifica si este objeto está en el orden de tabulación.	InteractiveObject
		tabIndex : int Especifica el orden de tabulación de los objetos de un archivo SWF.	InteractiveObject
		text : String Obtiene o define una cadena que incluye el texto que está actualmente en el componente TextInput.	TextArea
		textField : flash.text:TextField Referencia al campo de texto interno del componente TextArea.	TextArea
		textHeight : Number [solo lectura] Obtiene la altura del texto, expresada en píxeles.	TextArea
		textSnapshot : flash.text:TextSnapshot [solo lectura] Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.	DisplayObjectContainer
		textWidth : Number [solo lectura] Obtiene la anchura del texto, expresada en píxeles.	TextArea
		transform : flash.geom:Transform Objeto con propiedades pertenecientes a una matriz, transformación de color y límites de píxel de un objeto de visualización.	DisplayObject
		useHandCursor : Boolean Valor booleano que indica si debe aparecer la mano que señala (cursor de mano) cuando el puntero pasa por encima de un elemento sprite en el que la propiedad buttonMode se ha definido con el valor true.	Sprite
		verticalScrollBar : UIScrollBar [solo lectura] 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
		visible : Boolean [override] Obtiene o define un valor que indica si la instancia del componente actual es visible.	UIComponent
		width : Number [override] Obtiene o define la anchura del componente, expresada en píxeles.	UIComponent
		wordWrap : Boolean Obtiene o define un valor booleano que indica si el texto se ajusta al final de la línea.	TextArea
		x : Number [override] Obtiene o define la coordenada x que representa la posición del componente a lo largo del eje x en su contenedor principal.	UIComponent
		y : Number [override] Obtiene o define la coordenada y que representa la posición del componente a lo largo del eje y en su contenedor principal.	UIComponent
		z : Number Indica la posición de la coordenada z en el eje z de la instancia de DisplayObject relativa al contenedor principal 3D.	DisplayObject

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		TextArea() Crea una instancia de componente TextArea nueva.	TextArea
		addChild(child:DisplayObject):DisplayObject Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.	DisplayObjectContainer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.	EventDispatcher
		appendText(text:String):void Añade la cadena especificada después del último carácter que incluye el componente TextArea.	TextArea
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 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
		clearStyle(style:String):void Elimina una propiedad de estilo de esta instancia de componente.	UIComponent
		contains(child:DisplayObject):Boolean Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia.	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean Distribuye un evento en el flujo del evento.	EventDispatcher
		drawFocus(draw:Boolean):void [override] Muestra u oculta el indicador de selección en este componente.	TextArea
		drawNow():void Inicia de forma inmediata una operación de dibujo, sin invalidarlo todo como ocurre con invalidateNow.	UIComponent
		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
		getChildAt(index:int):DisplayObject Devuelve la instancia del objeto de visualización secundario que sale del índice especificado.	DisplayObjectContainer
		getChildByName(name:String):DisplayObject Devuelve el objeto de visualización secundario que sale con el nombre especificado.	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int Devuelve la posición de índice de una instancia secundaria de DisplayObject.	DisplayObjectContainer
		getFocus():InteractiveObject Recupera el objeto que está seleccionado actualmente.	UIComponent
		getLineMetrics(lineIndex:int):flash.text:TextLineMetrics Recupera información sobre una línea de texto específica.	TextArea
		getObjectsUnderPoint(point:Point):Array Devuelve un conjunto de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer.	DisplayObjectContainer
		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
		getStyle(style:String):Object Recupera una propiedad de estilo que se define en la cadena de búsqueda de estilo del componente.	UIComponent
		getStyleDefinition():Object [estática] Devuelve la asignación de estilos predeterminada del componente actual.	TextArea
		globalToLocal(point:Point):Point Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).	DisplayObject
		globalToLocal3D(point:Point):Vector3D Convierte un punto bidimensional de las coordenadas (globales) del escenario en coordenadas (locales) de un objeto tridimensional.	DisplayObject
		hasEventListener(type:String):Boolean Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		hitTestObject(obj:DisplayObject):Boolean Calcula el cuadro delimitador del objeto de visualización para ver si se solapa o corta con el cuadro delimitador del objeto de visualización obj.	DisplayObject
		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
		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
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		local3DToGlobal(point3d:Vector3D):Point Convierte un punto tridimensional de las coordenadas (locales) del objeto de visualización tridimensional en un punto bidimensional en las coordenadas (globales) del escenario.	DisplayObject
		localToGlobal(point:Point):Point Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).	DisplayObject
		mergeStyles(... list):Object [estática] Combina los estilos de varias clases en un objeto.	UIComponent
		move(x:Number, y:Number):void Mueve el componente a la posición especificada dentro de su elemento principal.	UIComponent
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		removeChild(child:DisplayObject):DisplayObject Elimina la instancia child de DisplayObject especificada de la lista de elementos secundarios de la instancia de DisplayObjectContainer.	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject Elimina una instancia de DisplayObject secundaria de la posición de índice especificada en la lista de elementos secundarios de DisplayObjectContainer.	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void Elimina todas las instancias child de DisplayObject especificadas de la lista de elementos secundarios de la instancia de DisplayObjectContainer.	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		requestSoftKeyboard():Boolean Muestra un teclado virtual.	InteractiveObject
		setChildIndex(child:DisplayObject, index:int):void Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización.	DisplayObjectContainer
		setFocus():void Selecciona este componente.	UIComponent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 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
		setSize(width:Number, height:Number):void Define el componente en la anchura y altura especificadas.	UIComponent
		setStyle(style:String, value:Object):void Define una propiedad de estilo en esta instancia de componente.	UIComponent
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Permite al usuario arrastrar el elemento sprite especificado.	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void Permite al usuario arrastrar el elemento sprite especificado en un dispositivo táctil.	Sprite
		stopAllMovieClips():void Se detiene gradualmente la ejecución de línea de tiempo de todos los objetos MovieClip con raíz en este objeto.	DisplayObjectContainer
		stopDrag():void Finaliza el método startDrag().	Sprite
		stopTouchDrag(touchPointID:int):void Finaliza el método startTouchDrag() para su uso con dispositivos táctiles.	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void Intercambia el orden z (de delante a atrás) de los dos objetos secundarios especificados.	DisplayObjectContainer
		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
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		validateNow():void Valida y actualiza las propiedades y el diseño de este objeto y lo vuelve a dibujar, si es necesario.	UIComponent
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object
		willTrigger(type:String):Boolean Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.	EventDispatcher

Métodos protegidos

Ocultar métodos protegidos heredados

Mostrar métodos protegidos heredados

	Método		Definido por
		getStyleValue(name:String):Object Devuelve el estilo especificado para un componente; tiene en cuenta todos los estilos definidos en el nivel global, en el nivel de componentes y en el nivel de instancias.	UIComponent

Eventos

Haga clic para obtener más información sobre los eventos

Ocultar eventos heredados

Mostrar eventos heredados

	Resumen	Definido por
activate	[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.	EventDispatcher
added	Se distribuye cuando un objeto de visualización se añade a la lista de visualización.	DisplayObject
addedToStage	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
change	Se distribuye cuando el texto del componente TextArea cambia por la interacción del usuario.	TextArea
clear	Se distribuye cuando el usuario selecciona 'Borrar' (o 'Eliminar') en el menú contextual.	InteractiveObject
click	Se distribuye cuando un usuario pulsa y suelta el botón principal del dispositivo de señalización sobre el mismo objeto InteractiveObject.	InteractiveObject
contextMenu	Se distribuye cuando un gesto de usuario activa el menú contextual asociado al objeto interactivo la aplicación de AIR.	InteractiveObject
copy	Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para copiar elementos, o bien cuando el usuario elige la opción 'Copiar' en el menú contextual.	InteractiveObject
cut	Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para cortar elementos, o bien cuando el usuario elige la opción 'Cortar' en el menú contextual.	InteractiveObject
deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher
doubleClick	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
enter	Se distribuye cuando el usuario presiona la tecla Intro mientras está en el componente.	TextArea
enterFrame	[evento de difusión] Se distribuye cuando la cabeza lectora entra en un nuevo fotograma.	DisplayObject
exitFrame	[evento de difusión] Se distribuye cuando la cabeza lectora sale del fotograma actual.	DisplayObject
focusIn	Se distribuye después de que un objeto de visualización quede seleccionado.	InteractiveObject
focusOut	Se distribuye después de que un objeto de visualización deje de estar seleccionado.	InteractiveObject
frameConstructed	[evento de difusión] Se distribuye una vez ejecutados los constructores de los objetos de visualización del fotograma, pero antes de que se ejecuten los scripts de fotograma.	DisplayObject
gestureDirectionalTap	Se distribuye cuando el usuario crea un punto de contacto a lo largo del borde de la superficie de toque con una instancia de InteractiveObject (por ejemplo, toque a lo largo del borde de la superficie de toque en el servidor de Siri para Apple TV). Algunos dispositivos también pueden interpretar este contacto como una combinación de varios eventos táctiles.	InteractiveObject
gestureLongPress	Se distribuye cuando el usuario presiona dos puntos de contacto en la misma instancia de InteractiveObject en un dispositivo táctil (como, por ejemplo, pulsar y soltar dos dedos sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
gesturePan	Se distribuye cuando el usuario mueve un punto de contacto sobre la instancia de InteractiveObject de un dispositivo táctil (como mover los dedos de izquierda a derecha sobre un objeto de visualización en un teléfono móvil o dispositivo con pantalla táctil).	InteractiveObject
gestureRotate	Se distribuye cuando el usuario realiza un gesto de zoom en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con dos dedos y girarlos sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
gestureSwipe	Se distribuye cuando el usuario realiza un gesto de barrido en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con tres dedos y, a continuación, moverlos en paralelo sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
gestureTap	Se distribuye cuando el usuario crea un punto de contacto con una instancia de InteractiveObject, seguidamente toca un dispositivo táctil (como colocar varios dedos sobre un objeto de visualización para abrir un menú y, a continuación, toca con un dedo para seleccionar un elemento de menú en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
gestureZoom	Se distribuye cuando el usuario realiza un gesto de zoom en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con dos dedos y, a continuación, separarlos rápidamente sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
hide	Se distribuye cuando la visibilidad del componente cambia de visible a invisible.	UIComponent
imeStartComposition	Este evento se distribuye a cualquier cliente app que admite entrada en línea con un IME	InteractiveObject
keyDown	Se distribuye cuando el usuario pulsa una tecla.	InteractiveObject
keyFocusChange	Se distribuye cuando el usuario intenta cambiar la selección empleando la navegación mediante teclado.	InteractiveObject
keyUp	Se distribuye cuando el usuario suelta una tecla.	InteractiveObject
middleClick	Se distribuye cuando un usuario pulsa y suelta el botón central del dispositivo de señalización sobre el mismo objeto InteractiveObject.	InteractiveObject
middleMouseDown	Se distribuye cuando el usuario pulsa el botón central del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
middleMouseUp	Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
mouseDown	Se distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
mouseFocusChange	Se distribuye cuando el usuario intenta cambiar la selección empleando un dispositivo de señalización.	InteractiveObject
mouseMove	Se distribuye cuando el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject.	InteractiveObject
mouseOut	Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.	InteractiveObject
mouseOver	Se distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject.	InteractiveObject
mouseUp	Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
mouseWheel	Se distribuye cuando se presiona la rueda del ratón sobre una instancia de InteractiveObject.	InteractiveObject
move	Se distribuye cuando se mueve el componente.	UIComponent
nativeDragComplete	Distribuido por el objeto InteractiveObject iniciador de arrastre cuando el usuario suelta el botón y finaliza el arrastre.	InteractiveObject
nativeDragDrop	Distribuido por el objeto InteractiveObject de destino cuando un objeto arrastrado se coloca sobre el objeto y la colocación se acepta con una llamada a DragManager.acceptDragDrop().	InteractiveObject
nativeDragEnter	Distribuido por un objeto InteractiveObject cuando la acción de arrastre entra en sus límites.	InteractiveObject
nativeDragExit	Distribuido por un objeto InteractiveObject cuando la acción de arrastre se sale de los límites.	InteractiveObject
nativeDragOver	Distribuido continuamente por un objeto InteractiveObject mientras la operación de arrastre se mantiene dentro de sus límites.	InteractiveObject
nativeDragStart	Distribuido al comienzo de una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag().	InteractiveObject
nativeDragUpdate	Distribuido durante una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag().	InteractiveObject
paste	Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para pegar elementos, o bien cuando el usuario elige la opción 'Pegar' en el menú contextual.	InteractiveObject
proximityBegin	Se distribuye cuando el usuario baja un lápiz stylus activo más allá del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityEnd	Se distribuye cuando el usuario levanta un lápiz stylus activo por encima del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityMove	Se distribuye cuando el usuario pasa un lápiz stylus activo por encima de la pantalla sin salir del umbral de detección de proximidad.	InteractiveObject
proximityOut	Se distribuye cuando el usuario quita un lápiz stylus activo de encima de este objeto InteractiveObject permaneciendo dentro del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityOver	Se distribuye cuando el usuario pasa un lápiz stylus activo directamente por encima de este objeto InteractiveObject permaneciendo dentro del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityRollOut	Se distribuye cuando el usuario quita un lápiz stylus activo de encima de este objeto InteractiveObject y sus elementos secundarios permaneciendo dentro del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityRollOver	Se distribuye cuando el usuario pasa un lápiz stylus activo por encima de este objeto InteractiveObject desde fuera del árbol de descendientes del objeto en la lista de visualización (permaneciendo dentro del umbral de detección de proximidad de la pantalla).	InteractiveObject
releaseOutside	Se distribuye cuando el usuario suelta el botón del dispositivo señalador por primera vez después de que el usuario presiona el botón sobre una instancia de InteractiveObject y, a continuación, mueve el dispositivo de señalización fuera de la instancia de InteractiveObject.	InteractiveObject
removed	Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización.	DisplayObject
removedFromStage	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
render	[evento de difusión] Se distribuye cuando la lista de visualización se va a actualizar y representar.	DisplayObject
resize	Se distribuye cuando se cambia el tamaño del componente.	UIComponent
rightClick	Se distribuye cuando un usuario pulsa y suelta el botón derecho del dispositivo de señalización sobre el mismo objeto InteractiveObject.	InteractiveObject
rightMouseDown	Se distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
rightMouseUp	Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
rollOut	Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.	InteractiveObject
rollOver	Se distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject.	InteractiveObject
scroll	Se distribuye cuando se recorre el contenido.	TextArea
selectAll	Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para seleccionar todos los elementos, o bien cuando el usuario elige la opción 'Seleccionar todo' en el menú contextual.	InteractiveObject
show	Se distribuye cuando la visibilidad del componente cambia de invisible a visible.	UIComponent
softKeyboardActivate	Se distribuye inmediatamente una vez mostrado el teclado en pantalla.	InteractiveObject
softKeyboardActivating	Se distribuye inmediatamente antes de que se muestre el teclado en pantalla.	InteractiveObject
softKeyboardDeactivate	Se distribuye inmediatamente una vez oculto el teclado en pantalla.	InteractiveObject
tabChildrenChange	Se distribuye cuando cambia el valor del indicador tabChildren del objeto.	InteractiveObject
tabEnabledChange	Se distribuye cuando cambia el indicador tabEnabled del objeto.	InteractiveObject
tabIndexChange	Se distribuye cuando cambia el valor de la propiedad tabIndex del objeto.	InteractiveObject
textInput	Se distribuye cuando el usuario escribe, borra o pega texto en el componente.	TextArea
touchBegin	Se distribuye cuando el usuario toca por primera vez un dispositivo táctil (por ejemplo, toca un teléfono móvil o dispositivo con pantalla táctil con un dedo).	InteractiveObject
touchEnd	Se distribuye cuando el usuario elimina el contacto con un dispositivo táctil (como levantar un dedo de un teléfono móvil o dispositivo con pantalla táctil).	InteractiveObject
touchMove	Se distribuye cuando el usuario toca el dispositivo y se distribuye constantemente hasta que desaparece el punto de contacto.	InteractiveObject
touchOut	Se distribuye cuando el usuario retira el punto de contacto de una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un objeto de visualización a otro en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
touchOver	Se distribuye cuando el usuario mueve el punto de contacto sobre una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un punto fuera de un objeto de visualización en un punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
touchRollOut	Se distribuye cuando el usuario retira el punto de contacto de una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un objeto de visualización a un punto fuera del objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
touchRollOver	Se distribuye cuando el usuario mueve el punto de contacto sobre una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un punto fuera de un objeto de visualización en un punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
touchTap	Se distribuye cuando el usuario levanta el punto de contacto en la misma instancia de InteractiveObject en la que se inició el contacto en un dispositivo táctil (como, por ejemplo, pulsar y soltar un dedo desde un único punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject

Estilos

Los estilos son comunes o están asociados a un tema específico. Si el estilo es común, se puede utilizar con cualquier tema. Si un estilo está asociado a un tema específico, solo se puede utilizar si la aplicación usa dicho tema.

Estilos comunes

Haga clic para obtener más información sobre los estilos

Ocultar estilos heredados

Mostrar estilos heredados

	Descripción	Definido por
disabledSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 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
disabledTextFormat	Tipo: flash.text.TextFormat Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El objeto TextFormat que se utilizará para representar la etiqueta del componente cuando el botón esté desactivado.	UIComponent
embedFonts	Tipo: Boolean Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 Indica si se utilizan contornos de fuentes incorporadas para representar el campo de texto. Si este valor es `true`, Flash Player representa el campo de texto utilizando contornos de fuentes incorporados. Si es `false`, Flash Player representa el campo de texto mediante fuentes del dispositivo. Si define la propiedad `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
focusRectPadding	Tipo: Number Formato: Length Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El relleno que separa los límites externos del componente de los bordes externos del indicador de selección, expresado en píxeles.	UIComponent
focusRectSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El aspecto que se utilizará para mostrar los indicadores de selección.	UIComponent
textFormat	Tipo: flash.text.TextFormat Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El objeto TextFormat que se utilizará para representar la etiqueta del componente.	UIComponent
textPadding	Tipo: Number Formato: Length Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El relleno que separa el borde del componente del texto, expresado en píxeles. El valor predeterminado es `3`.	TextArea
upSkin	Tipo: Class Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 La clase que proporciona el fondo para el componente TextArea. El valor predeterminado es `TextArea_upSkin`.	TextArea

Constantes públicas

Ocultar constantes públicas heredadas

Mostrar constantes públicas heredadas

	Constante		Definido por
		version : String = "3.0.3.1" Número de versión de los componentes.	UIComponent

Información sobre propiedades

alwaysShowSelection

propiedad

alwaysShowSelection:Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene o define un valor booleano que indica 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

Elementos de API relacionados

TextField.alwaysShowSelection

condenseWhite

propiedad

condenseWhite:Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene o define un valor booleano que indica si se deben eliminar espacios en blanco adicionales de un componente 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

Elementos de API relacionados

TextField.condenseWhite

Ejemplo ( Cómo utilizar este 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;
}

displayAsPassword

propiedad

displayAsPassword:Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene o define un valor booleano que indica si la instancia 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

editable

propiedad

editable:Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene o define un valor booleano que indica si el usuario puede modificar el 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

enabled

propiedad

enabled:Boolean[override]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

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

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

horizontalScrollBar

propiedad

horizontalScrollBar:UIScrollBar [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene una referencia a la barra de desplazamiento horizontal.

Implementación
public function get horizontalScrollBar():UIScrollBar

Elementos de API relacionados

verticalScrollBar

horizontalScrollPolicy

propiedad

horizontalScrollPolicy:String

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

ScrollPolicy.ON: la barra de desplazamiento horizontal siempre está activada.
ScrollPolicy.OFF: la barra de desplazamiento siempre está desactivada.
ScrollPolicy.AUTO: la barra de desplazamiento se activa cuando es necesario.

El valor predeterminado es ScrollPolicy.AUTO.

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

Elementos de API relacionados

verticalScrollPolicy
ScrollPolicy

Ejemplo ( Cómo utilizar este 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);

horizontalScrollPosition

propiedad

horizontalScrollPosition:Number

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene o define el 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

Elementos de API relacionados

verticalScrollPosition

htmlText

propiedad

htmlText:String

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

Elementos de API relacionados

text
TextField.htmlText

Ejemplo ( Cómo utilizar este 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);
}

imeMode

propiedad

imeMode:String

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

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

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

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

Elementos de API relacionados

flash.system.IMEConversionMode

length

propiedad

length:Number [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene el recuento de caracteres que contiene el componente TextArea.

El valor predeterminado es 0.

Implementación
public function get length():Number

Elementos de API relacionados

maxChars

propiedad

maxChars:int

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

El valor predeterminado es 0.

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

Elementos de API relacionados

length

Ejemplo ( Cómo utilizar este 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;
}

maxHorizontalScrollPosition

propiedad

maxHorizontalScrollPosition:int [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene el valor máximo de la propiedad horizontalScrollPosition.

El valor predeterminado es 0.

Implementación
public function get maxHorizontalScrollPosition():int

Elementos de API relacionados

horizontalScrollPosition
maxVerticalScrollPosition

maxVerticalScrollPosition

propiedad

maxVerticalScrollPosition:int [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene el valor máximo de la propiedad verticalScrollPosition.

El valor predeterminado es 1.

Implementación
public function get maxVerticalScrollPosition():int

Elementos de API relacionados

verticalScrollPosition
maxHorizontalScrollPosition

restrict

propiedad

restrict:String

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

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

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

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

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

El valor predeterminado es null.

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

Elementos de API relacionados

TextField.restrict

selectionBeginIndex

propiedad

selectionBeginIndex:int [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene 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

Elementos de API relacionados

selectionEndIndex

propiedad

selectionEndIndex:int [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

El valor predeterminado es 0.

Implementación
public function get selectionEndIndex():int

Elementos de API relacionados

selectionBeginIndex

text

propiedad

text:String

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

El valor predeterminado es "".

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

Elementos de API relacionados

htmlText

textField

propiedad

public var textField:flash.text:TextField

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Referencia al campo de texto interno del componente TextArea.

textHeight

propiedad

textHeight:Number [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

El valor predeterminado es 0.

Implementación
public function get textHeight():Number

Elementos de API relacionados

textWidth

Ejemplo ( Cómo utilizar este 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;
}

textWidth

propiedad

textWidth:Number [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

El valor predeterminado es 0.

Implementación
public function get textWidth():Number

Elementos de API relacionados

textHeight

Ejemplo ( Cómo utilizar este 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;
}

verticalScrollBar

propiedad

verticalScrollBar:UIScrollBar [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene una referencia a la barra de desplazamiento vertical.

Implementación
public function get verticalScrollBar():UIScrollBar

Elementos de API relacionados

horizontalScrollBar

Ejemplo ( Cómo utilizar este 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;
}

verticalScrollPolicy

propiedad

verticalScrollPolicy:String

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

ScrollPolicy.ON: la barra de desplazamiento siempre está activada.
ScrollPolicy.OFF: la barra de desplazamiento siempre está desactivada.
ScrollPolicy.AUTO: la barra de desplazamiento se activa cuando es necesario.

El valor predeterminado es ScrollPolicy.AUTO.

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

Elementos de API relacionados

horizontalScrollPolicy
ScrollPolicy

Ejemplo ( Cómo utilizar este 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);

verticalScrollPosition

propiedad

verticalScrollPosition:Number

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene o define el 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

Elementos de API relacionados

horizontalScrollPosition

Ejemplo ( Cómo utilizar este 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;
}

wordWrap

propiedad

wordWrap:Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Obtiene o define un valor booleano que indica si el 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

Elementos de API relacionados

TextField.wordWrap

Información sobre constructores

()

Información sobre

public function TextArea()

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Crea una instancia de componente 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 de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Añade la cadena especificada después del último carácter que incluye 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

override public function drawFocus(draw:Boolean):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

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

Parámetros

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

getLineMetrics

()

método

public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

Parámetros

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

Valor devuelto

flash.text:TextLineMetrics

getStyleDefinition

()

método

public static function getStyleDefinition():Object

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

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

Valor devuelto

Object — Objeto de estilos predeterminados.

Elementos de API relacionados

UIComponent.getStyle()
UIComponent.setStyle()
StyleManager

Ejemplo ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se crea un navegador de estilos para varias clases de componentes:

import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

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

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

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

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

setSelection

()

método

public function setSelection(setSelection:int, endIndex:int):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Establece el rango de una selección realizada en un área de texto que se ha seleccionado. El rango de selección comienza en el índice que se especifica mediante el parámetro start y termina en el índice indicado con el parámetro end. 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
propiedad Event.type = flash.events.Event.CHANGE

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Se distribuye cuando el texto del componente TextArea cambia por la interacción del usuario. Este evento no se distribuye si el código ActionScript cambia el componente.

La constante Event.CHANGE define el valor de la propiedad type de un objeto de evento change.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`true`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Objeto al que se ha modificado su valor. El objeto `target` no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad `currentTarget` para acceder al objeto de la lista de visualización que está procesando el evento actualmente.

enter

Evento

Tipo de objeto de evento: fl.events.ComponentEvent
propiedad ComponentEvent.type = fl.events.ComponentEvent.ENTER

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Error que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad `currentTarget` para acceder al objeto que detecta el evento.

scroll

Evento

Tipo de objeto de evento: fl.events.ScrollEvent
propiedad ScrollEvent.type = fl.events.ScrollEvent.SCROLL

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Se distribuye cuando se recorre el contenido.

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`delta`	`1`; valor que indica la cantidad de desplazamiento que se ha realizado.
`direction`	`vertical`; dirección de ScrollBar.
`position`	`0`; posición del deslizador Scrollbar después de que se haya movido.
`target`	Error que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad `currentTarget` para acceder al objeto que detecta el evento.

Ejemplo ( Cómo utilizar este 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
propiedad TextEvent.type = flash.events.TextEvent.TEXT_INPUT

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

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

Nota: este evento no se distribuye para las teclas Supr o Retroceso.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`true`
`cancelable`	`true`; llama al método `preventDefault()` para cancelar el comportamiento predeterminado.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Campo de texto en el que se introducen los caracteres. El destino no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad `currentTarget` para acceder al objeto de la lista de visualización que está procesando el evento actualmente.
`text`	Carácter o secuencia de caracteres introducidos por el usuario.

Ejemplos Cómo utilizar este ejemplo

TextAreaExample.as

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

Arrastre un componente TextArea al escenario y denomínelo ta1.
Arrastre un componente TextArea al escenario y denomínelo ta2.
Guarde este código como TextAreaExample.as en el mismo directorio que el archivo FLA.
Establece la clase DocumentClass del archivo FLA como TextAreaExample.

package
{
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.events.TextEvent;
    import flash.text.TextField;
    import fl.events.ComponentEvent;
    import fl.controls.TextArea;
    
    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());    
        }
    }
}

Avisos legales | Política de privacidad en línea

TextArea - AS3 Flash

Clases x

alwaysShowSelection

condenseWhite

displayAsPassword

editable

enabled

horizontalScrollBar

horizontalScrollPolicy

horizontalScrollPosition

htmlText

imeMode

length

maxChars

maxHorizontalScrollPosition

maxVerticalScrollPosition

restrict

selectionBeginIndex

selectionEndIndex

text

textField

textHeight

textWidth

verticalScrollBar

verticalScrollPolicy

verticalScrollPosition

wordWrap

TextArea

appendText

drawFocus

getLineMetrics

getStyleDefinition

setSelection

change

enter

scroll

textInput