Referencia de ActionScript® 3.0 para la plataforma de Adobe® Flash®
Inicio  |  Ocultar lista de paquetes y clases |  Paquetes  |  Clases  |  Novedades  |  Índice  |  Apéndices  |  ¿Por qué hay texto en inglés?
Filtros: AIR 30.0 y versiones anteriores, Flash Player 30.0 y versiones anteriores, Flash Lite 4
Flex 4.6 y versiones anteriores, Flash Pro CS6 y versiones anteriores
Ocultar filtros
flash.text 

TextField  - AS3

Paquetesx

Nivel superior
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Elementos del lenguaje

Constantes globales
Funciones globales
Operadores
Sentencias, palabras clave y directivas
Tipos especiales

Apéndices

Novedades
Errores del compilador
Advertencias del compilador
Errores en tiempo de ejecución
Migración a ActionScript 3
Conjuntos de caracteres admitidos
Solo etiquetas MXML
Elementos Motion XML
Etiquetas de texto temporizado
Lista de elementos desfasados
Constantes de implementación de accesibilidad
Cómo utilizar ejemplos de ActionScript
Avisos legales
Paqueteflash.text
Clasepublic class TextField
HerenciaTextField Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Subclases FlexTextField

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

Para crear un campo de texto dinámicamente, utilice el constructor TextField().

Los métodos de la clase TextField permiten establecer, seleccionar y manipular texto de un campo de texto dinámico o de entrada que se cree durante la edición o ejecución.

ActionScript ofrece diversas maneras de dar formato a los textos durante la ejecución. La clase TextFormat permite definir el formato de carácter y de párrafo para los objetos TextField. Se pueden aplicar estilos CSS (Cascading Style Sheets, Hojas de estilos en cascada) a los campos de texto. Para ello, utilice la propiedad TextField.styleSheet y la clase StyleSheet. Puede utilizar CSS para aplicar un estilo a las etiquetas HTML incorporadas, definir nuevas etiquetas de formato o aplicar estilos. Es posible asignar directamente texto con formato HTML, el cual utiliza de manera opcional estilos CSS, a un campo de texto. El texto HTML que asigna a un campo de texto puede contener elementos multimedia incorporados (clips de película, archivos SWF, GIF, PNG y JPEG). El texto se ajustará alrededor del elemento multimedia incorporado del mismo modo que los navegadores web lo hacen en un documento HTML.

Flash Player también admite un subconjunto de etiquetas HTML que puede utilizar para dar formato al texto. Consulte la lista de etiquetas HTML admitidas en la descripción de la propiedad htmlText.

Ver los ejemplos

Elementos de API relacionados



Propiedades públicas
 PropiedadDefinido por
 InheritedaccessibilityImplementation : AccessibilityImplementation
La implementación actual de accesibilidad (AccessibilityImplementation) para esta instancia de InteractiveObject.
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización.
DisplayObject
 Inheritedalpha : Number
Indica el valor de transparencia alfa del objeto especificado.
DisplayObject
  alwaysShowSelection : Boolean
Cuando se establece como true y el campo de texto no está seleccionado, Flash Player resalta la selección del campo de texto en color gris.
TextField
  antiAliasType : String
Tipo de suavizado que se utiliza en este campo de texto.
TextField
  autoSize : String
Controla la asignación de tamaño y alineación automáticas de los campos de texto.
TextField
  background : Boolean
Especifica si el campo de texto tiene relleno de fondo.
TextField
  backgroundColor : uint
Color del fondo del campo de texto.
TextField
 InheritedblendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.
DisplayObject
 InheritedblendShader : Shader
[solo escritura] Define un sombreado para utilizarlo en la mezcla del primer plano y del fondo.
DisplayObject
  border : Boolean
Especifica si el campo de texto tiene un borde.
TextField
  borderColor : uint
Color del borde del campo de texto.
TextField
  bottomScrollV : int
[solo lectura] Un entero (índice basado en uno) que indica la última línea visible en el campo de texto especificado.
TextField
 InheritedcacheAsBitmap : 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
 Inherited    cacheAsBitmapMatrix : Matrix
Si su valor no es null, este objeto Matrix define cómo un objeto de visualización se procesa cuando cacheAsBitmap se define como true.
DisplayObject
  caretIndex : int
[solo lectura] El índice de la posición del punto de inserción (intercalación).
TextField
  condenseWhite : Boolean
Un valor booleano que especifica si se eliminarán los espacios en blanco adicionales (espacios, saltos de línea, etc.) en el campo de texto con texto HTML.
TextField
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 InheritedcontextMenu : NativeMenu
Especifica el menú contextual asociado a este objeto.
InteractiveObject
  defaultTextFormat : flash.text:TextFormat
Especifica el formato aplicado al texto nuevo insertado, por ejemplo, texto introducido por un usuario o insertado mediante el método replaceSelectedText().
TextField
  displayAsPassword : Boolean
Especifica si el campo de texto es de contraseña.
TextField
 InheriteddoubleClickEnabled : Boolean
Especifica si este objeto recibe eventos doubleClick.
InteractiveObject
  embedFonts : Boolean
Especifica si representar utilizando contornos de fuentes incorporadas.
TextField
 Inheritedfilters : Array
Conjunto indexado que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.
DisplayObject
 InheritedfocusRect : Object
Especifica si este objeto muestra un rectángulo de selección.
InteractiveObject
  gridFitType : String
Tipo de ajuste de cuadrícula que se utiliza en este campo de texto.
TextField
 Inheritedheight : Number
Indica la altura del objeto de visualización, expresada en píxeles.
DisplayObject
  htmlText : String
Contiene la representación HTML del contenido del campo de texto.
TextField
  length : int
[solo lectura] El número de caracteres de un campo de texto.
TextField
 InheritedloaderInfo : 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
 Inheritedmask : DisplayObject
El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado.
DisplayObject
  maxChars : int
El número máximo de caracteres que puede incluir el campo de texto, tal y como los ha introducido el usuario.
TextField
  maxScrollH : int
[solo lectura] Valor máximo de scrollH.
TextField
  maxScrollV : int
[solo lectura] Valor máximo de scrollV.
TextField
 InheritedmetaData : 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
 InheritedmouseEnabled : Boolean
Especifica si este objeto recibe la entrada del ratón, la entrada del usuario o mensajes.
InteractiveObject
  mouseWheelEnabled : Boolean
Valor booleano que indica si Flash Player desplazará automáticamente campos de texto multilínea cuando el usuario haga clic en un campo de texto y gire la rueda del ratón.
TextField
 InheritedmouseX : 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
 InheritedmouseY : Number
[solo lectura] Indica la coordenada y de la posición del ratón o del dispositivo de entrada del usuario, en píxeles.
DisplayObject
  multiline : Boolean
Indica si el campo de texto es multilínea.
TextField
 Inheritedname : String
Indica el nombre de instancia de DisplayObject.
DisplayObject
 InheritedneedsSoftKeyboard : Boolean
Especifica si un teclado virtual (teclado en pantalla) se debe mostrar cuando esta instancia de InteractiveObject recibe la selección.
InteractiveObject
  numLines : int
[solo lectura] Define el número de líneas de texto de un campo de varias líneas.
TextField
 InheritedopaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[solo lectura] Indica el objeto DisplayObjectContainer que contiene este objeto de visualización.
DisplayObject
  restrict : String
Indica el conjunto de caracteres que los usuarios pueden introducir en el campo de texto.
TextField
 Inheritedroot : 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
 Inheritedrotation : Number
Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original.
DisplayObject
 InheritedrotationX : 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
 InheritedrotationY : 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
 InheritedrotationZ : 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
 Inheritedscale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente.
DisplayObject
 InheritedscaleX : Number
Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro.
DisplayObject
 InheritedscaleY : Number
Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto.
DisplayObject
 InheritedscaleZ : Number
Indica la escala de profundidad (porcentaje) de un objeto aplicada desde el punto de registro del objeto.
DisplayObject
  scrollH : int
La posición de desplazamiento horizontal actual.
TextField
 InheritedscrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización.
DisplayObject
  scrollV : int
La posición vertical del texto de un campo de texto.
TextField
  selectable : Boolean
Valor booleano que indica si el campo de texto puede seleccionarse.
TextField
  selectionBeginIndex : int
[solo lectura] El valor de índice basado en cero del primer carácter de la selección actual.
TextField
  selectionEndIndex : int
[solo lectura] El valor de índice basado en cero del último carácter de la selección actual.
TextField
  sharpness : Number
La nitidez de los bordes de glifo en este campo de texto.
TextField
 Inherited    softKeyboard : String
Controla la apariencia del teclado virtual.
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
Define el área que debe permanecer en pantalla cuando se muestra un teclado virtual (no disponible en iOS).
InteractiveObject
 Inheritedstage : Stage
[solo lectura] El escenario del objeto de visualización.
DisplayObject
  styleSheet : StyleSheet
Asocia una hoja de estilos al campo de texto.
TextField
 InheritedtabEnabled : Boolean
Especifica si este objeto está en el orden de tabulación.
InteractiveObject
 InheritedtabIndex : int
Especifica el orden de tabulación de los objetos de un archivo SWF.
InteractiveObject
  text : String
Una cadena que es el texto actual del campo de texto.
TextField
  textColor : uint
El color del texto de un campo de texto, expresado en formato hexadecimal.
TextField
  textHeight : Number
[solo lectura] La altura del texto, expresada en píxeles.
TextField
  textInteractionMode : String
[solo lectura] La propiedad del modo de interacción; el valor predeterminado es TextInteractionMode.NORMAL.
TextField
  textWidth : Number
[solo lectura] La anchura del texto, expresada en píxeles.
TextField
  thickness : Number
El grosor de los bordes de glifo en este campo de texto.
TextField
 Inheritedtransform : flash.geom:Transform
Objeto con propiedades pertenecientes a una matriz, transformación de color y límites de píxel de un objeto de visualización.
DisplayObject
  type : String
Tipo del campo de texto.
TextField
  useRichTextClipboard : Boolean
Especifica si se copia y se pega el formato del texto junto con el propio texto.
TextField
 Inheritedvisible : Boolean
Indica si el objeto de visualización es visible.
DisplayObject
 Inheritedwidth : Number
Indica la anchura del objeto de visualización, expresada en píxeles.
DisplayObject
  wordWrap : Boolean
Valor booleano que indica si el campo de texto tiene ajuste de texto.
TextField
 Inheritedx : Number
Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.
DisplayObject
 Inheritedy : Number
Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.
DisplayObject
 Inheritedz : 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
 MétodoDefinido por
  
Crea una nueva instancia de TextField.
TextField
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.
EventDispatcher
  
Añade la cadena especifica por el parámetro newText al final del texto del campo de texto.
TextField
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace.
DisplayObject
  
Devuelve un rectángulo como recuadro de delimitación del carácter.
TextField
  
Devuelve un valor de índice basado en cero del carácter en el punto especificado por los parámetros x e y.
TextField
  
Dado un índice del carácter, devuelve el índice del primer carácter del mismo párrafo.
TextField
  
Devuelve una referencia DisplayObject para el id dado, ya que se ha añadido una imagen o un archivo SWF a un campo de texto con formato HTML mediante la etiqueta <img>.
TextField
  
Devuelve un valor de índice basado en cero de la línea en el punto especificado por los parámetros x e y.
TextField
  
Devuelve un valor de índice basado en cero de la línea que contiene el carácter especificado por el parámetro
TextField
  
getLineLength(lineIndex:int):int
Devuelve el número de caracteres de una línea de texto específica.
TextField
  
Devuelve información de medidas sobre una línea de texto dada.
TextField
  
getLineOffset(lineIndex:int):int
Devuelve el índice de carácter del primer carácter de la línea especificada por el parámetro lineIndex.
TextField
  
Devuelve el texto de la línea especificada por el parámetro lineIndex.
TextField
  
Dado un índice de carácter, devuelve la longitud del párrafo que contiene dicho carácter.
TextField
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Devuelve un rectángulo que define el límite del objeto de visualización, basado en el sistema de coordenadas definido por el parámetro targetCoordinateSpace, excluyendo los trazos en las formas.
DisplayObject
  
getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Devuelve un objeto TextFormat que contiene información de formato para el rango de texto especificado por los parámetros beginIndex y endIndex.
TextField
 Inherited
Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).
DisplayObject
 Inherited
Convierte un punto bidimensional de las coordenadas (globales) del escenario en coordenadas (locales) de un objeto tridimensional.
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
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
 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
  
isFontCompatible(fontName:String, fontStyle:String):Boolean
[estática] Devuelve true si hay disponible una fuente incorporada con las propiedades fontName y fontStyle especificadas, donde Font.fontType sea flash.text.FontType.EMBEDDED.
TextField
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
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
 Inherited
Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).
DisplayObject
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
EventDispatcher
  
Reemplaza la selección actual por el contenido del parámetro del valor.
TextField
  
replaceText(beginIndex:int, endIndex:int, newText:String):void
Reemplaza el rango de caracteres especificados por los parámetros beginIndex y endIndex con el contenido del parámetro newText.
TextField
 Inherited
Muestra un teclado virtual.
InteractiveObject
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
  
setSelection(beginIndex:int, endIndex:int):void
Establece como seleccionado el texto designado por los valores de índice de los primeros y últimos caracteres, especificados por los parámetros beginIndex y endIndex.
TextField
  
setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Aplica el formato de texto especificado por el parámetro format al texto especificado en un campo de texto.
TextField
 Inherited
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
 Inherited
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.
EventDispatcher
Eventos
 Evento Resumen Definido por
 Inherited[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.EventDispatcher
 InheritedSe distribuye cuando un objeto de visualización se añade a la lista de visualización.DisplayObject
 InheritedSe distribuye cuando un objeto de visualización se añade a la lista de visualización del escenario, bien directamente o a través de un subárbol que contiene el objeto de visualización.DisplayObject
  Se emite tras modificar el valor de un control, a diferencia del evento textInput, que se emite antes de modificar el valor.TextField
 InheritedSe distribuye cuando el usuario selecciona 'Borrar' (o 'Eliminar') en el menú contextual.InteractiveObject
 InheritedSe distribuye cuando un usuario pulsa y suelta el botón principal del dispositivo de señalización sobre el mismo objeto InteractiveObject.InteractiveObject
 Inherited
    contextMenu
Se distribuye cuando un gesto de usuario activa el menú contextual asociado al objeto interactivo la aplicación de AIR.InteractiveObject
 InheritedSe 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
 InheritedSe 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
 Inherited[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.EventDispatcher
 InheritedSe distribuye cuando un usuario pulsa y suelta el botón principal de un dispositivo de señalización dos veces en una sucesión rápida sobre el mismo objeto InteractiveObject cuando el indicador doubleClickEnabled de dicho objeto se ha definido como true.InteractiveObject
 Inherited[evento de difusión] Se distribuye cuando la cabeza lectora entra en un nuevo fotograma.DisplayObject
 Inherited[evento de difusión] Se distribuye cuando la cabeza lectora sale del fotograma actual.DisplayObject
 InheritedSe distribuye después de que un objeto de visualización quede seleccionado.InteractiveObject
 InheritedSe distribuye después de que un objeto de visualización deje de estar seleccionado.InteractiveObject
 Inherited[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
 InheritedSe 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
 InheritedSe 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
 InheritedSe 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
 InheritedSe 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
 InheritedSe 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
 InheritedSe 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
 InheritedSe 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
 InheritedEste evento se distribuye a cualquier cliente app que admite entrada en línea con un IMEInteractiveObject
 InheritedSe distribuye cuando el usuario pulsa una tecla.InteractiveObject
 InheritedSe distribuye cuando el usuario intenta cambiar la selección empleando la navegación mediante teclado.InteractiveObject
 InheritedSe distribuye cuando el usuario suelta una tecla.InteractiveObject
  Se distribuye cuando un usuario hace clic en el hipervínculo de un campo de texto compatible con HTML, donde la URL empieza por "event:".TextField
 InheritedSe distribuye cuando un usuario pulsa y suelta el botón central del dispositivo de señalización sobre el mismo objeto InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario pulsa el botón central del dispositivo señalador sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario intenta cambiar la selección empleando un dispositivo de señalización.InteractiveObject
 InheritedSe distribuye cuando el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando se presiona la rueda del ratón sobre una instancia de InteractiveObject.InteractiveObject
 InheritedDistribuido por el objeto InteractiveObject iniciador de arrastre cuando el usuario suelta el botón y finaliza el arrastre.InteractiveObject
 InheritedDistribuido 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
 InheritedDistribuido por un objeto InteractiveObject cuando la acción de arrastre entra en sus límites.InteractiveObject
 InheritedDistribuido por un objeto InteractiveObject cuando la acción de arrastre se sale de los límites.InteractiveObject
 InheritedDistribuido continuamente por un objeto InteractiveObject mientras la operación de arrastre se mantiene dentro de sus límites.InteractiveObject
 InheritedDistribuido al comienzo de una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag().InteractiveObject
 InheritedDistribuido durante una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag().InteractiveObject
 InheritedSe 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
 InheritedSe distribuye cuando el usuario baja un lápiz stylus activo más allá del umbral de detección de proximidad de la pantalla.InteractiveObject
 Inherited
    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
 InheritedSe 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
 Inherited
    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
 InheritedSe 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
 InheritedSe 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
 InheritedSe 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
 InheritedSe 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
 InheritedSe distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización.DisplayObject
 InheritedSe 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[evento de difusión] Se distribuye cuando la lista de visualización se va a actualizar y representar.DisplayObject
 InheritedSe distribuye cuando un usuario pulsa y suelta el botón derecho del dispositivo de señalización sobre el mismo objeto InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.InteractiveObject
 InheritedSe distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject.InteractiveObject
  Distribuido por un objeto TextField después de que el usuario se desplace.TextField
 InheritedSe 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
 InheritedSe distribuye inmediatamente una vez mostrado el teclado en pantalla.InteractiveObject
 InheritedSe distribuye inmediatamente antes de que se muestre el teclado en pantalla.InteractiveObject
 InheritedSe distribuye inmediatamente una vez oculto el teclado en pantalla.InteractiveObject
 InheritedSe distribuye cuando cambia el valor del indicador tabChildren del objeto.InteractiveObject
 InheritedSe distribuye cuando cambia el indicador tabEnabled del objeto.InteractiveObject
 InheritedSe distribuye cuando cambia el valor de la propiedad tabIndex del objeto.InteractiveObject
  Flash Player distribuye el evento textInput cuando un usuario escribe uno o varios caracteres de texto.TextField
  Flash Player distribuye el evento textInteractionModeChange cuando el usuario cambia el modo de interacción de un campo de texto.TextField
 InheritedSe 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
 InheritedSe 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
 InheritedSe distribuye cuando el usuario toca el dispositivo y se distribuye constantemente hasta que desaparece el punto de contacto.InteractiveObject
 InheritedSe 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
 InheritedSe 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
 InheritedSe 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
 InheritedSe 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
 InheritedSe 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
Información sobre propiedades

alwaysShowSelection

propiedad
alwaysShowSelection:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Cuando se establece como true y el campo de texto no está seleccionado, Flash Player resalta la selección del campo de texto en color gris. Cuando se define como false y el campo de texto no está seleccionado, Flash Player no resalta la selección del campo de texto.

El valor predeterminado es false.



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

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
Compile y ejecute el siguiente archivo. Cuando ejecute el archivo, arrastre el ratón para seleccionar texto en cada uno de los dos campos de texto y observe la diferencia del resaltado de la selección cuando seleccione el texto de los dos campos de texto (cambiando la selección):
    package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldType;

    public class TextField_alwaysShowSelection extends Sprite {
        public function TextField_alwaysShowSelection() {
            var label1:TextField = createCustomTextField(0, 20, 200, 20);
            label1.text = "This text is selected.";
            label1.setSelection(0, 9);
            label1.alwaysShowSelection = true;

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

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x; result.y = y;
            result.width = width; result.height = height;
            addChild(result);
            return result;
        }
    }
}

antiAliasType

propiedad 
antiAliasType:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9

Tipo de suavizado que se utiliza en este campo de texto. Utilice constantes flash.text.AntiAliasType para esta propiedad. Sólo puede controlar este parámetro de configuración si la fuente está incorporada (con la propiedad embedFonts definida como true). El valor predeterminado es flash.text.AntiAliasType.NORMAL.

Para definir los valores de esta propiedad, utilice los siguientes valores de cadena:

Valor de la cadenaDescripción
flash.text.AntiAliasType.NORMALAplica el suavizado de texto regular. Este valor equivale al tipo de suavizado que utilizaba Flash Player en la versión 7 y anteriores.
flash.text.AntiAliasType.ADVANCEDAplica suavizado avanzado, que aumenta la legibilidad del texto. (Esta función pasó a estar disponible en Flash Player 8.) El suavizado avanzado proporciona máxima calidad de representación para las fuentes de tamaño pequeño. Ofrece mejores resultados con aplicaciones que presentan gran cantidad de texto pequeño. No se recomienda utilizarlo con fuentes de más de 48 puntos.



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

Elementos de API relacionados

autoSize

propiedad 
autoSize:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Controla la asignación de tamaño y alineación automáticas de los campos de texto. Los valores válidos para las constantes TextFieldAutoSize son: TextFieldAutoSize.NONE (predeterminado), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT y TextFieldAutoSize.CENTER.

Si autoSize se define como TextFieldAutoSize.NONE (predeterminado), no se produce cambio de tamaño.

Si autoSize se define como TextFieldAutoSize.LEFT, se considerará que el texto está justificado a la izquierda, lo que significa que el lado izquierdo del campo de texto permanecerá fijo y el cambio de tamaño de un campo de texto de una sola línea tendrá lugar en el lado derecho. Si el texto incluye un salto de línea (por ejemplo, "\n" o "\r"), también se cambiará el tamaño del lado inferior para dar cabida a la siguiente línea de texto. Si wordWrap también se ha definido como true, sólo se cambiará el tamaño del lado inferior del campo de texto, mientras que el lado derecho permanecerá fijo.

Si autoSize se define como TextFieldAutoSize.RIGHT, se considerará que el texto está justificado a la izquierda, lo que significa que el lado derecho del campo de texto permanecerá fijo y el cambio de tamaño de un campo de texto de una sola línea tendrá lugar en el lado izquierdo. Si el texto incluye un salto de línea (por ejemplo, "\n" o "\r"), también se cambiará el tamaño del lado inferior para dar cabida a la siguiente línea de texto. Si wordWrap también se ha definido como true, sólo se cambiará el tamaño del lado inferior del campo de texto, mientras que el lado izquierdo permanecerá fijo.

Si autoSize se define como TextFieldAutoSize.CENTER, se considerará que el texto está centrado, lo que significa que el cambio de tamaño de un campo de texto de una sola línea se distribuirá por igual entre los márgenes derecho e izquierdo. Si el texto incluye un salto de línea (por ejemplo, "\n" o "\r"), también se cambiará el tamaño del lado inferior para dar cabida a la siguiente línea de texto. Si wordWrap también se define como true, sólo se cambiará el tamaño del lado inferior del campo de texto, mientras que los lados izquierdo y derecho permanecerán fijos.



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

Emite
ArgumentError — La cadena autoSize especificada no es un miembro de flash.text.TextFieldAutoSize.

Elementos de API relacionados

background

propiedad 
background:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Especifica si el campo de texto tiene relleno de fondo. Si es true, el campo de texto tiene relleno de fondo. Si es false, el campo de texto no tiene relleno de fondo. Utilice la propiedad backgroundColor para establecer el color de fondo de un campo de texto.

El valor predeterminado es false.



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

Elementos de API relacionados

backgroundColor

propiedad 
backgroundColor:uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Color del fondo del campo de texto. El valor predeterminado es 0xFFFFFF (blanco). Esta propiedad puede recuperarse o establecerse aunque no haya actualmente ningún fondo, pero el color sólo estará visible si el campo de texto tiene la propiedad background definida como true.



Implementación
    public function get backgroundColor():uint
    public function set backgroundColor(value:uint):void

Elementos de API relacionados

border

propiedad 
border:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Especifica si el campo de texto tiene un borde. Si es true, especifica si el campo de texto tiene un borde. Si es false, el campo de texto no tiene borde. Utilice la propiedad borderColor para definir el color del borde.

El valor predeterminado es false.



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

Elementos de API relacionados

borderColor

propiedad 
borderColor:uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Color del borde del campo de texto. El valor predeterminado es 0x000000 (negro). Esta propiedad puede recuperarse o definirse aunque no haya actualmente ningún borde, pero el color sólo estará visible si el campo de texto tiene la propiedad border definida como true.



Implementación
    public function get borderColor():uint
    public function set borderColor(value:uint):void

Elementos de API relacionados

bottomScrollV

propiedad 
bottomScrollV:int  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Un entero (índice basado en uno) que indica la última línea visible en el campo de texto especificado. Considere el campo de texto como una ventana en un bloque de texto. La propiedad scrollV es el índice basado en uno de la primera línea visible en la ventana.

El texto existente entre las líneas indicado por scrollV y bottomScrollV está visible actualmente en el campo de texto.



Implementación
    public function get bottomScrollV():int

Elementos de API relacionados

caretIndex

propiedad 
caretIndex:int  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

El índice de la posición del punto de inserción (intercalación). Si no se muestra ningún punto de inserción, el valor es la posición en la que estaría el punto de inserción si se recuperase la selección en el campo (normalmente, la última posición del punto de inserción o un valor 0 si el campo no se ha seleccionado nunca).

Los índices de espacio de selección están basados en cero (por ejemplo, la primera posición es 0, la segunda es 1, etc.).



Implementación
    public function get caretIndex():int

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En este ejemplo, se crea una instancia de TextField y se llena con texto. Se asigna un controlador de eventos para que, cuando el usuario haga clic en el objeto TextField, se llame al método printCursorPosition. En ese caso, los valores de las propiedades caretIndex, selectionBeginIndex y selectionEndIndex se proporcionarán como resultado.

Ejecute este ejemplo e intente hacer clic en el objeto TextField para seleccionar texto. A continuación, haga clic en el campo sin seleccionar texto. Al hacer clic en el texto sin realizar la selección, la propiedad caretIndex indica la posición del punto de inserción y el valor de las propiedades selectionBeginIndex y selectionEndIndex es igual que el valor de la propiedad caretIndex.

package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.text.TextFieldType;

    public class TextField_caretIndex extends Sprite {
        public function TextField_caretIndex() {
            var tf:TextField = createCustomTextField(10, 10, 100, 100);
            tf.wordWrap = true;
            tf.type = TextFieldType.INPUT;
            tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text.";
            tf.addEventListener(MouseEvent.CLICK, printCursorPosition);
        }

        private function printCursorPosition(event:MouseEvent):void {
            var tf:TextField = TextField(event.target);
            trace("caretIndex:", tf.caretIndex);
            trace("selectionBeginIndex:", tf.selectionBeginIndex);
            trace("selectionEndIndex:", tf.selectionEndIndex);
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}

condenseWhite

propiedad 
condenseWhite:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Un valor booleano que especifica si se eliminarán los espacios en blanco adicionales (espacios, saltos de línea, etc.) en el campo de texto con texto HTML. El valor predeterminado es false. La propiedad condenseWhite sólo afecta al texto definido con la propiedad htmlText, no con la propiedad text. Si define texto con la propiedad text, condenseWhite se omitirá.

Si la propiedad condenseWhite se establece como true, utilice comandos HTML estándar, como <BR> y <P>, para incluir saltos de línea en el campo de texto.

Defina la propiedad condenseWhite antes de hacer lo propio con htmlText.



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

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se muestra la diferencia entre definir la propiedad condenseWhite como false o como true:
package {
    import flash.display.Sprite;
    import flash.text.TextField;

    public class TextField_condenseWhite extends Sprite {
        public function TextField_condenseWhite() {
            var tf1:TextField = createCustomTextField(0, 0, 200, 50);
            tf1.condenseWhite = false;
            tf1.htmlText = "keep    on\n\ttruckin'";
            
            var tf2:TextField = createCustomTextField(0, 120, 200, 50);
            tf2.condenseWhite = true;
            tf2.htmlText = "keep    on\n\ttruckin'";
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            result.border = true;
            addChild(result);
            return result;
        }
    }
}

defaultTextFormat

propiedad 
defaultTextFormat:flash.text:TextFormat

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

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

Nota: cuando se seleccionan caracteres para reemplazar con setSelection() y replaceSelectedText(), defaultTextFormat se aplica únicamente si el texto se ha seleccionado hasta el último carácter. A continuación, se muestra un ejemplo:

     var my_txt:TextField new TextField();
     my_txt.text = "Flash Macintosh version";
     var my_fmt:TextFormat = new TextFormat();
     my_fmt.color = 0xFF0000;
     my_txt.defaultTextFormat = my_fmt;
     my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied
     my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied
     my_txt.replaceSelectedText("Windows version");
     

Cuando se accede a la propiedad defaultTextFormat, el objeto TextFormat devuelto tiene todas sus propiedades definidas. Ninguna de las propiedades tiene el valor null.

Nota: no se puede establecer esta propiedad si se aplica una hoja de estilos al campo de texto.



Implementación
    public function get defaultTextFormat():flash.text:TextFormat
    public function set defaultTextFormat(value:flash.text:TextFormat):void

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

Elementos de API relacionados

displayAsPassword

propiedad 
displayAsPassword:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Especifica si el campo de texto es de contraseña. Si el valor de esta propiedad es true, el campo de texto se trata como una contraseña y oculta la entrada de caracteres empleando asteriscos en lugar de los caracteres reales. Si su valor es false, el campo de texto no se trata como una contraseña. Cuando está activado el modo de contraseña, los comandos Cortar y Copiar y sus correspondientes métodos abreviados de teclado no funcionan. Este mecanismo de seguridad impide que un usuario sin escrúpulos pueda utilizar los métodos abreviados para descubrir una contraseña en un equipo en el que no haya nadie presente.

El valor predeterminado es false.



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

embedFonts

propiedad 
embedFonts:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Especifica si representar utilizando contornos de fuentes incorporadas. Si es false, Flash Player representa el campo de texto empleando fuentes de dispositivo.

Si define la propiedad embedFonts como true para un campo de texto, debe especificar una fuente para ese texto mediante la propiedad font de un objeto TextFormat aplicado al campo de texto. Si la fuente especificada no está incorporada en el archivo SWF, el texto no se mostrará.

El valor predeterminado es false.



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

Elementos de API relacionados

gridFitType

propiedad 
gridFitType:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9

Tipo de ajuste de cuadrícula que se utiliza en este campo de texto. Esta propiedad sólo se aplica si la propiedad flash.text.AntiAliasType del campo de texto se define como flash.text.AntiAliasType.ADVANCED.

El tipo de ajuste de cuadrícula empleado determina si Flash Player hará que las líneas horizontales y verticales se ajusten a una cuadrícula de píxeles o de subpíxeles o si no realizará ningún ajuste.

Para la propiedad flash.text.GridFitType, puede utilizar los siguientes valores de cadena:

Valor de la cadenaDescripción
flash.text.GridFitType.NONESin ajuste de cuadrícula. Las líneas horizontales y verticales de los glifos no se ajustan a la cuadrícula de píxeles. Se recomienda utilizar este valor con animaciones o tamaños de fuente grandes.
flash.text.GridFitType.PIXELEspecifica que las líneas horizontales y verticales intensas se ajustan a la cuadrícula de píxeles. Este parámetro sólo funciona para campos de texto alineados a la izquierda. Para usar este parámetro de configuración, la propiedad flash.dispaly.AntiAliasType del campo de texto debe estar definida como flash.text.AntiAliasType.ADVANCED. En general, es la opción que más facilita la lectura de texto con alineación a la izquierda.
flash.text.GridFitType.SUBPIXELEspecifica que las líneas horizontales y verticales intensas se ajusten a la cuadrícula de subpíxeles en monitores LCD. Para usar este parámetro de configuración, la propiedad flash.text.AntiAliasType del campo de texto debe estar definida como flash.text.AntiAliasType.ADVANCED. La configuración de flash.text.GridFitType.SUBPIXEL suele ser una buena opción para texto dinámico con alineación central o alineación a la derecha y en ocasiones ofrece un buen equilibrio entre animación y calidad de texto.

El valor predeterminado es pixel.



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

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
El siguiente ejemplo muestra tres campos de texto con distintas configuraciones de la propiedad gridFitType. Cuando utilice este ejemplo, preste atención a la diferencia con la que pueden leerse las dos primeras líneas. Tenga en cuenta también el uso óptimo de GridFitType.PIXEL en el texto alineado a la izquierda y de GridFitType.SUBPIXEL en el texto alineado a la derecha.
package
{
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFormat;
    import flash.text.TextFieldAutoSize;
    import flash.text.AntiAliasType;
    import flash.text.GridFitType;

    public class gridFitTypeExample extends Sprite
    {
        public function gridFitTypeExample()
        {
    var format1:TextFormat = new TextFormat();
    format1.font="Arial";
    format1.size=12;

    var tf1:TextField = createCustomTextField(0,0,format1,"NONE",TextFieldAutoSize.LEFT,GridFitType.NONE);
    
    var tf2:TextField = createCustomTextField(0,30,format1,"PIXEL",TextFieldAutoSize.LEFT,GridFitType.PIXEL);

    var tf3:TextField = createCustomTextField(300,60,format1,"SUBPIXEL",TextFieldAutoSize.RIGHT,GridFitType.SUBPIXEL);

        }
        private function createCustomTextField(x:Number,y:Number,fm:TextFormat,tl:String,tfs:String,gft:String):TextField 
        {
            var result:TextField = new TextField();
            result.x=x;
            result.y=y;
            result.embedFonts=true;
            result.antiAliasType=AntiAliasType.ADVANCED;
            result.text="This text uses a gridFitType of " + tl;
            result.autoSize=tfs;
        result.gridFitType=gft;
            result.setTextFormat(fm);
            addChild(result);
            return result;
        }
    }
}

htmlText

propiedad 
htmlText:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Contiene la representación HTML del contenido del campo de texto.

Flash Player admite las siguientes etiquetas HTML:

Etiqueta Descripción
Etiqueta de anclaje La etiqueta <a> crea un vínculo de hipertexto y admite los atributos siguientes:
  • target: Especifica el nombre de la ventana de destino en la que se cargará la página. Entre las opciones posibles, se incluye _self, _blank, _parent y _top. La opción _self especifica el marco actual de la ventana actual, _blank especifica una ventana nueva, _parent especifica el nivel superior del marco actual y _top especifica el marco del nivel más alto de la ventana actual.
  • href: especifica una URL o un evento link de ActionScript. La URL puede ser absoluta o relativa a la ubicación del archivo SWF que está cargando la página. Un ejemplo de referencia absoluta a una URL es http://www.adobe.com; un ejemplo de referencia relativa es /index.html. Las URL absolutas deben llevar el prefijo http://, ya que, en caso contrario, Flash Player o AIR las considera URL relativas. Puede utilizar el evento link para hacer que el vínculo ejecute una función de ActionScript en un archivo SWF en lugar de abrir una URL. Para especificar un evento link, utilice el esquema de eventos en lugar del esquema http en su atributo href. Un ejemplo es href="event:myText" en lugar de href="http://myURL"; cuando el usuario hace clic en un vínculo de hipertexto que contiene el mismo esquema de eventos, el campo de texto distribuye un TextEvent link con su propiedad text definida como "myText". Puede crear una función de ActionScript que se ejecute cada vez que se distribuya el vínculo TextEvent. También puede definir los estilos a:link, a:hover y a:active de las etiquetas de anclaje mediante las hojas de estilos.
Etiqueta de negrita La etiqueta <b> muestra el texto en negrita. Debe haber un tipo de letra en negrita disponible para la fuente utilizada.
Etiqueta de salto de línea La etiqueta <br> crea un salto de línea en el campo de texto. Configure el campo de texto como multilínea para poder utilizar esta etiqueta.
Etiqueta de fuente La etiqueta <font> especifica una fuente o una lista de fuentes para mostrar el texto. La etiqueta de fuente admite los atributos siguientes:
  • color: sólo se admiten valores de color hexadecimales (#FFFFFF).
  • face: especifica el nombre de la fuente que se utiliza. Como se muestra en el siguiente ejemplo, puede especificar una lista de nombres de fuentes separados por comas, en cuyo caso Flash Player selecciona la primera fuente disponible. Si la fuente especificada no está instalada en el sistema local o no está incorporada al archivo SWF, Flash Player elegirá una fuente alternativa.
  • size: especifica el tamaño de la fuente. Se pueden utilizar tamaños en píxeles absolutos, como 16 ó 18, o bien, tamaños en puntos relativos, como +2 ó -4.
Etiqueta de imagen La etiqueta <img> permite incorporar archivos de imagen externos (JPEG, GIF, PNG), archivos SWF y clips de película en los campos de texto. El texto fluye automáticamente alrededor de las imágenes incorporadas en los campos de texto. Debe configurar el campo de texto como multilínea para que se ajuste el texto en torno a una imagen.

La etiqueta <img> admite los atributos siguientes:

  • src: especifica la URL de un archivo de imagen o SWF o el identificador de vínculo de un símbolo de clip de película de la biblioteca. Este atributo es necesario; todos los demás son opcionales. Los archivos externos (JPEG, GIF, PNG y SWF) no se muestran hasta que no se han descargado completamente.
  • width: anchura, en píxeles, de la imagen, el archivo SWF o el clip de película que se va a insertar.
  • height: altura, en píxeles, de la imagen, el archivo SWF o el clip de película que se va a insertar.
  • align: especifica la alineación horizontal de la imagen incorporada en el campo de texto. Los valores válidos son left y right. El valor predeterminado es left.
  • hspace: especifica la cantidad de espacio horizontal que rodea a la imagen sin que aparezca texto alguno. El valor predeterminado es 8.
  • vspace: especifica la cantidad de espacio vertical que rodea a la imagen sin que aparezca texto alguno. El valor predeterminado es 8.
  • id: especifica el nombre de la instancia de clip de película (creada por Flash Player) que contiene el archivo de imagen, SWF o el clip de película incorporado. Esta opción se utiliza para controlar el contenido incorporado con ActionScript.
  • checkPolicyFile: especifica que Flash Player buscará un archivo de política URL en el servidor asociado al dominio de la imagen. Si existe un archivo de política, los archivos SWF de los dominios del archivo podrán acceder a la imagen cargada, por ejemplo, llamando al método BitmapData.draw() con la imagen como parámetro source. Para obtener más información, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

Flash muestra los medios incorporados en un campo de texto con su tamaño completo. Para especificar las dimensiones de los medios que está incorporando, utilice los atributos height y width de la etiqueta <img>.

En general, las imágenes incorporadas a un campo de texto aparecen en la línea que sigue a la etiqueta <img>. Sin embargo, si la etiqueta <img> es el primer carácter de un campo de texto, la imagen aparece en la primera línea de éste.

En contenido de AIR del entorno limitado de seguridad de la aplicación, AIR omite las etiquetas img del contenido HTML en los objetos TextField de ActionScript. Esto se hace para evitar ataques de phishing.

Etiqueta de cursiva La etiqueta <i> muestra el texto encerrado en cursiva. Debe haber un tipo de letra en cursiva disponible para la fuente utilizada.
Etiqueta de elemento de lista La etiqueta <li> coloca un viñeta delante del texto incluido en la etiqueta. Nota: debido a que Flash Player y AIR no reconocen etiquetas de lista ordenadas y no ordenadas (<ol> y <ul>), no afectan al modo en que se muestra la lista. Todas las listas son no ordenadas y todos sus elementos utilizan viñetas.
Etiqueta de párrafo La etiqueta <p> crea un párrafo nuevo. El campo de texto se debe configurar como multilínea para poder utilizar esta etiqueta. La etiqueta <p> admite los siguientes atributos:
  • align: especifica la alineación del texto en el párrafo; los valores válidos son left, right, justify ycenter.
  • class: especifica una clase de estilos CSS definida por un objeto flash.text.StyleSheet.
Etiqueta de espacio La etiqueta <span> sólo está disponible para uso con los estilos de texto CSS. Admite el atributo siguiente:
  • class: especifica una clase de estilos CSS definida por un objeto flash.text.StyleSheet.
Etiqueta de formato de texto

La etiqueta <textformat> permite utilizar un subconjunto de las propiedades de formato de párrafo de la clase TextFormat en los campos de texto, incluidos el interlineado, la sangría, los márgenes y las tabulaciones. Puede combinar las etiquetas <textformat> con las etiquetas HTML incorporadas.

La etiqueta <textformat> tiene los atributos siguientes:

  • blockindent: especifica la sangría de bloque en puntos; corresponde a TextFormat.blockIndent.
  • indent: especifica la sangría desde el margen izquierdo hasta el primer carácter del párrafo; corresponde a TextFormat.indent. Acepta números positivos y negativos.
  • leading: especifica la cantidad de espacio vertical entre las líneas (interlineado); corresponde a TextFormat.leading. Acepta números positivos y negativos.
  • leftmargin: especifica el margen izquierdo del párrafo, expresado en puntos; corresponde a TextFormat.leftMargin.
  • rightmargin: especifica el margen izquierdo del párrafo, expresado en puntos; corresponde a TextFormat.rightMargin.
  • tabstops: especifica las tabulaciones personalizadas como un conjunto de enteros no negativos; corresponde a TextFormat.tabStops.
Etiqueta de subrayado La etiqueta <u> subraya el texto encerrado.

Flash Player y AIR admiten las siguientes entidades HTML:

Entidad Descripción
&lt; < (menor que)
&gt; > (mayor que)
&amp; & (ampersand)
&quot; " (comillas dobles)
&apos; ' (apóstrofe, comilla simple)

Flash Player y AIR también admiten códigos de caracteres explícitos, como &#38; (ampersand ASCII) y &#x20AC; (símbolo € Unicode).



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

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En el siguiente ejemplo, se crea un objeto TextField llamado tf1 y se asigna una cadena con formato HTML a su propiedad text. Si se realiza un seguimiento de la propiedad htmlText, el resultado es la cadena con formato HTML y con etiquetas adicionales (como <P> y <FONT>) añadidas automáticamente por Flash Player. Si se realiza un seguimiento del valor de la propiedad text, se muestra la cadena sin formato y sin etiquetas HTML.

Para realizar la comparación, se llevan a cabo los mismos pasos en otro objeto TextField llamado tf2 con una novedad: se asigna un objeto StyleSheet a la propiedad de tf2 styleSheet antes de definir la propiedad htmlText. En este caso, cuando se realice el seguimiento de la propiedad htmlText, sólo incluirá el texto HTML exacto asignado en un principio a la propiedad htmlText, demostrando así que Flash Player no ha añadido ninguna etiqueta.

package {
    import flash.display.Sprite;
    import flash.text.StyleSheet;
    import flash.text.TextField;

    public class TextField_text extends Sprite {
        public function TextField_text() {
            var tf1:TextField = createCustomTextField(10, 10, 400, 22);
            tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>";

            // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P>
            trace("htmlText: " + tf1.htmlText);
            // text: Lorem ipsum dolor sit amet.
            trace("text: " + tf1.text);
            
            var tf2:TextField = createCustomTextField(10, 50, 400, 22);
            tf2.styleSheet = new StyleSheet();
            tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>";
            // htmlText: <b>Lorem ipsum dolor sit amet.</b>
            trace("htmlText: " + tf2.htmlText);
            // text: Lorem ipsum dolor sit amet.
            trace("text: " + tf2.text);
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}

length

propiedad 
length:int  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

El número de caracteres de un campo de texto. El carácter de tabulador (\t) cuenta como un carácter.



Implementación
    public function get length():int

maxChars

propiedad 
maxChars:int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

El número máximo de caracteres que puede incluir el campo de texto, tal y como los ha introducido el usuario. Un script puede insertar más texto que maxChars; la propiedad maxChars sólo indica cuánto texto puede introducir el usuario. Si el valor de esta propiedad es 0, el usuario puede introducir una cantidad ilimitada de texto.

El valor predeterminado es 0.



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

maxScrollH

propiedad 
maxScrollH:int  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Valor máximo de scrollH.



Implementación
    public function get maxScrollH():int

Elementos de API relacionados

maxScrollV

propiedad 
maxScrollV:int  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Valor máximo de scrollV.



Implementación
    public function get maxScrollV():int

Elementos de API relacionados

mouseWheelEnabled

propiedad 
mouseWheelEnabled:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9

Valor booleano que indica si Flash Player desplazará automáticamente campos de texto multilínea cuando el usuario haga clic en un campo de texto y gire la rueda del ratón. De forma predeterminada, este valor es true. Esta propiedad resulta útil si desea impedir que la rueda del ratón pueda desplazar campos de texto o si desea implementar su propio desplazamiento de campo de texto.



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

multiline

propiedad 
multiline:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Indica si el campo de texto es multilínea. Si el valor es true, el campo de texto es multilínea; si el valor es false, se trata de un campo de texto de una sola línea. En un tipo de campo TextFieldType.INPUT, el valor multiline determina si la tecla Intro creará una nueva línea (si el valor es false, se ignorará la tecla Intro). Si pega texto en un objeto TextField cuyo valor multiline sea false, las nuevas líneas se eliminarán del texto.

El valor predeterminado es false.



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

Elementos de API relacionados

numLines

propiedad 
numLines:int  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Define el número de líneas de texto de un campo de varias líneas. Si la propiedad wordWrap se establece como true, el número de líneas aumenta al ajustarse el texto.



Implementación
    public function get numLines():int

Elementos de API relacionados

restrict

propiedad 
restrict:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Indica el conjunto de caracteres que los usuarios pueden introducir en el campo de texto. Si el valor de la propiedad restrict es null, puede introducir cualquier carácter. Si el valor de la propiedad restrict es una cadena vacía, no se puede introducir ningún carácter. Si el valor de la propiedad restrict es una cadena de caracteres, puede introducir caracteres solamente en la cadena del campo de texto. La cadena se examina de izquierda a derecha. Se puede especificar un rango utilizando el carácter de guión (-). Sólo se limita la interacción del usuario; los scripts pueden incluir cualquier texto en el campo de texto. Esta propiedad no se sincroniza con las opciones de incorporación de fuentes del inspector de propiedades.

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

En el ejemplo siguiente, sólo se permite que se introduzcan caracteres en mayúsculas, espacios y números en un campo de texto:

     my_txt.restrict = "A-Z 0-9";
     

En el ejemplo siguiente, se incluyen todos los caracteres, con excepción de las letras en mayúsculas:

     my_txt.restrict = "^a-z";
     

Puede utilizar una barra invertida para introducir un ^ o - literalmente. Las secuencias con barras invertidas aceptadas son \-, \^ o \\. La barra invertida debe ser un carácter real de la cadena, por lo que cuando se especifica en ActionScript, se debe utilizar una barra doble. Por ejemplo, el código siguiente incluye sólo el guión (-) y el símbolo de intercalación (^):

     my_txt.restrict = "\\-\\^";
     

El carácter ^ se puede utilizar en cualquier lugar de la cadena para incluir o excluir caracteres. El código siguiente incluye sólo letras en mayúsculas, pero excluye la letra Q en mayúscula:

     my_txt.restrict = "A-Z^Q";
     

Puede usar la secuencia de escape \u para construir cadenas restrict. El código siguiente incluye solamente los caracteres desde el ASCII 32 (espacio) al ASCII 126 (tilde).

     my_txt.restrict = "\u0020-\u007E";
     

El valor predeterminado es null.



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

scrollH

propiedad 
scrollH:int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

La posición de desplazamiento horizontal actual. Si la propiedad scrollH es 0, el texto no se desplazará horizontalmente. El valor de esta propiedad es un entero que representa la posición horizontal, expresada en píxeles.

Las unidades de desplazamiento horizontal son píxeles, mientras que las de desplazamiento vertical son líneas. El desplazamiento horizontal se mide en píxeles porque la mayoría de las fuentes que utiliza normalmente tienen espaciado proporcional, lo que significa que los caracteres tienen anchuras diferentes. Flash Player realiza el desplazamiento vertical por líneas, ya que el usuario normalmente desea ver una línea de texto completa y no sólo parte de ella. Aunque en una línea se utilicen varias fuentes, la altura de la línea se ajusta a la de la fuente más grande.

Nota: la propiedad scrollH está basada en cero (a diferencia de la propiedad de desplazamiento vertical scrollV, que está basada en uno).



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

Elementos de API relacionados

scrollV

propiedad 
scrollV:int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

La posición vertical del texto de un campo de texto. La propiedad scrollV es útil para dirigir a los usuarios a un párrafo específico en un pasaje largo o para crear campos de texto con desplazamiento.

Las unidades de desplazamiento vertical son líneas, mientras que las de desplazamiento horizontal son píxeles. Si la primera línea mostrada es la primera línea del campo de texto, scrollV se establece como 1 (no como 0). El desplazamiento horizontal se mide en píxeles porque la mayoría de las fuentes que utiliza tienen espaciado proporcional, lo que significa que los caracteres tienen anchuras diferentes. Flash realiza el desplazamiento vertical por líneas, ya que el usuario normalmente desea ver una línea de texto completa y no sólo parte de ella. Aunque en una línea se utilicen varias fuentes, la altura de la línea se ajusta a la de la fuente más grande.



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

Elementos de API relacionados

selectable

propiedad 
selectable:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Valor booleano que indica si el campo de texto puede seleccionarse. El valor true indica que el texto se puede seleccionar. La propiedad selectable controla si un campo de texto se puede seleccionar y no si un campo de texto es editable. Un campo dinámico puede seleccionarse aunque no sea editable. Si un campo de texto dinámico no es seleccionable, el usuario no puede seleccionar su texto.

Si selectable se define como false, el texto del campo de texto no responderá a los comandos de selección del ratón o el teclado y el texto no se podrá copiar con el comando Copiar. Si selectable se define como true, el texto del campo de texto se puede seleccionar con el ratón o el teclado y se puede copiar utilizando el comando Copiar. Puede seleccionar texto de esta forma aunque el campo de texto sea dinámico en lugar de un campo de entrada de texto.

El valor predeterminado es true.



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

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
El siguiente ejemplo crea dos campos de texto dinámicos : un campo de texto con la propiedad selectable establecida como true y el otro campo de texto con la propiedad selectable establecida como false. Cuando utilice este ejemplo, intente seleccionar el texto de estos campos con el ratón o con el teclado.
package
{
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class selectableExample extends Sprite
    {
        public function selectableExample()
        {
    var tf1:TextField = createCustomTextField(10, 10);
    tf1.text="This text can be selected";
    tf1.selectable=true;

    var tf2:TextField = createCustomTextField(10, 30);
    tf2.text="This text cannot be selected";
    tf2.selectable=false;
        }

        private function createCustomTextField(x:Number, y:Number):TextField 
       {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.autoSize=TextFieldAutoSize.LEFT;
            addChild(result);
            return result;
        }
    }
}

selectionBeginIndex

propiedad 
selectionBeginIndex:int  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

El valor de índice basado en cero del primer carácter de la selección actual. Por ejemplo, el primer carácter es 0, el segundo es 1, etc. Si no hay texto seleccionado, esta propiedad es el valor de caretIndex.



Implementación
    public function get selectionBeginIndex():int

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En este ejemplo, se crea una instancia de TextField y se llena con texto. Se asigna un controlador de eventos para que, cuando el usuario haga clic en el objeto TextField, se llame al método printCursorPosition. En ese caso, los valores de las propiedades caretIndex, selectionBeginIndex y selectionEndIndex se proporcionarán como resultado.

Ejecute este ejemplo e intente hacer clic en el objeto TextField para seleccionar texto. A continuación, haga clic en el campo sin seleccionar texto. Al hacer clic en el texto sin realizar la selección, la propiedad caretIndex indica la posición del punto de inserción y el valor de las propiedades selectionBeginIndex y selectionEndIndex es igual que el valor de la propiedad caretIndex.

package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.text.TextFieldType;

    public class TextField_caretIndex extends Sprite {
        public function TextField_caretIndex() {
            var tf:TextField = createCustomTextField(10, 10, 100, 100);
            tf.wordWrap = true;
            tf.type = TextFieldType.INPUT;
            tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text.";
            tf.addEventListener(MouseEvent.CLICK, printCursorPosition);
        }

        private function printCursorPosition(event:MouseEvent):void {
            var tf:TextField = TextField(event.target);
            trace("caretIndex:", tf.caretIndex);
            trace("selectionBeginIndex:", tf.selectionBeginIndex);
            trace("selectionEndIndex:", tf.selectionEndIndex);
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}

selectionEndIndex

propiedad 
selectionEndIndex:int  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

El valor de índice basado en cero del último carácter de la selección actual. Por ejemplo, el primer carácter es 0, el segundo es 1, etc. Si no hay texto seleccionado, esta propiedad es el valor de caretIndex.



Implementación
    public function get selectionEndIndex():int

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En este ejemplo, se crea una instancia de TextField y se llena con texto. Se asigna un controlador de eventos para que, cuando el usuario haga clic en el objeto TextField, se llame al método printCursorPosition. En ese caso, los valores de las propiedades caretIndex, selectionBeginIndex y selectionEndIndex se proporcionarán como resultado.

Ejecute este ejemplo e intente hacer clic en el objeto TextField para seleccionar texto. A continuación, haga clic en el campo sin seleccionar texto. Al hacer clic en el texto sin realizar la selección, la propiedad caretIndex indica la posición del punto de inserción y el valor de las propiedades selectionBeginIndex y selectionEndIndex es igual que el valor de la propiedad caretIndex.

package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.text.TextFieldType;

    public class TextField_caretIndex extends Sprite {
        public function TextField_caretIndex() {
            var tf:TextField = createCustomTextField(10, 10, 100, 100);
            tf.wordWrap = true;
            tf.type = TextFieldType.INPUT;
            tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text.";
            tf.addEventListener(MouseEvent.CLICK, printCursorPosition);
        }

        private function printCursorPosition(event:MouseEvent):void {
            var tf:TextField = TextField(event.target);
            trace("caretIndex:", tf.caretIndex);
            trace("selectionBeginIndex:", tf.selectionBeginIndex);
            trace("selectionEndIndex:", tf.selectionEndIndex);
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}

sharpness

propiedad 
sharpness:Number

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9

La nitidez de los bordes de glifo en este campo de texto. Esta propiedad sólo se aplica si la propiedad flash.text.AntiAliasType del campo de texto se define como flash.text.AntiAliasType.ADVANCED. El rango de sharpness es un número entre -400 y 400. Si intenta definir sharpness con un valor fuera del rango, Flash selecciona el valor más cercano en el rango (-400 o 400) para la propiedad.

El valor predeterminado es 0.



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

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
El siguiente ejemplo muestra el efecto que produce cambiar la propiedad sharpness en un objeto TextField. Es necesario incorporar la fuente y establecer la propiedad antiAliasType como ADVANCED.
package
{
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.text.AntiAliasType;
    import flash.text.GridFitType;
    import flash.text.TextFormat;

    public class sharpnessExample extends Sprite
    {
        public function sharpnessExample()
        {
    var format1:TextFormat = new TextFormat();
    format1.font="Arial";
    format1.size=24;
    var lTxt:String = "The quick brown fox";

    var tf1:TextField=createCustomTextField(0,lTxt,format1,-400);
    var tf2:TextField=createCustomTextField(30,lTxt,format1,0);
    var tf3:TextField=createCustomTextField(60,lTxt,format1,400);
        }

        private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldSharpness:Number):TextField 
       {
            var result:TextField = new TextField();
            result.y=y;
            result.text=fldTxt;
            result.embedFonts=true;
            result.autoSize=TextFieldAutoSize.LEFT;
            result.antiAliasType=AntiAliasType.ADVANCED;
            result.gridFitType=GridFitType.PIXEL;
            result.sharpness=fldSharpness;
            result..setTextFormat(format);
            addChild(result);
            return result;
        }
    }
}

styleSheet

propiedad 
styleSheet:StyleSheet

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Asocia una hoja de estilos al campo de texto. Para más información sobre la creación de hojas de estilos, consulte la clase StyleSheet y la Guía del desarrollador de ActionScript 3.0.

La hoja de estilos asociada a un campo de texto se puede cambiar en cualquier momento. Si se cambia la hoja de estilos en uso, el campo de texto vuelve a dibujarse utilizando la nueva hoja de estilos. Se puede definir la hoja de estilos como null o undefined para eliminarla. Si se elimina la hoja de estilos en uso, el campo de texto vuelve a dibujarse sin ninguna hoja de estilos.

Nota: si se elimina la hoja de estilos, cambia el contenido de TextField.text y TextField.htmlText para incorporar el formato aplicado anteriormente por la hoja de estilos. Para conservar el contenido original de TextField.htmlText sin el formato, guarde el valor en una variable antes de eliminar la hoja de estilos.



Implementación
    public function get styleSheet():StyleSheet
    public function set styleSheet(value:StyleSheet):void

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
El siguiente ejemplo define un objeto simple StyleSheet y lo asigna a un campo de texto con contenido HTML. Establezca la propiedad stylesheet antes de definir el contenido.
package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.StyleSheet;

    public class TextStylesheetExample extends Sprite {
        var myLabel:TextField = new TextField();
        var labelText:String = "Hello world.";
        var newStyle:StyleSheet = new StyleSheet();

        public function TextStylesheetExample()
       {
            var styleObj:Object = new Object();
            styleObj.fontWeight = "bold";
            styleObj.color = "#660066";
            newStyle.setStyle(".defStyle", styleObj);

            myLabel.styleSheet=newStyle;
            myLabel.htmlText=labelText;
            addChild(myLabel);
        }
    }
}

text

propiedad 
text:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Una cadena que es el texto actual del campo de texto. Las líneas se separan mediante el carácter de retorno de carro ('\r', ASCII 13). La propiedad contiene texto sin formato en el campo de texto, sin etiquetas HTML.

Para obtener el texto en formato HTML, utilice la propiedad htmlText.

Nota: si se aplica una hoja de estilos al campo de texto, el contenido de la propiedad text se interpreta como HTML.



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

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En el siguiente ejemplo, se crea un objeto TextField llamado tf1 y se asigna una cadena con formato HTML a su propiedad text. Si se realiza un seguimiento de la propiedad htmlText, el resultado es la cadena con formato HTML y con etiquetas adicionales (como <P> y <FONT>) añadidas automáticamente por Flash Player. Si se realiza un seguimiento del valor de la propiedad text, se muestra la cadena sin formato y sin etiquetas HTML.

Para realizar la comparación, se llevan a cabo los mismos pasos en otro objeto TextField llamado tf2 con una novedad: se asigna un objeto StyleSheet a la propiedad de tf2 styleSheet antes de definir la propiedad htmlText. En este caso, cuando se realice el seguimiento de la propiedad htmlText, sólo incluirá el texto HTML exacto asignado en un principio a la propiedad htmlText, demostrando así que Flash Player no ha añadido ninguna etiqueta.

package {
    import flash.display.Sprite;
    import flash.text.StyleSheet;
    import flash.text.TextField;

    public class TextField_text extends Sprite {
        public function TextField_text() {
            var tf1:TextField = createCustomTextField(10, 10, 400, 22);
            tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>";

            // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P>
            trace("htmlText: " + tf1.htmlText);
            // text: Lorem ipsum dolor sit amet.
            trace("text: " + tf1.text);
            
            var tf2:TextField = createCustomTextField(10, 50, 400, 22);
            tf2.styleSheet = new StyleSheet();
            tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>";
            // htmlText: <b>Lorem ipsum dolor sit amet.</b>
            trace("htmlText: " + tf2.htmlText);
            // text: Lorem ipsum dolor sit amet.
            trace("text: " + tf2.text);
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}

textColor

propiedad 
textColor:uint

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

El color del texto de un campo de texto, expresado en formato hexadecimal. El sistema de colores hexadecimal utiliza seis dígitos para representar los valores de color. Cada dígito tiene 16 valores o caracteres posibles. El rango de caracteres oscila entre 0 y 9, y entre A y F. Por ejemplo, el color negro es 0x000000; el color blanco es 0xFFFFFF.

El valor predeterminado es 0 (0x000000).



Implementación
    public function get textColor():uint
    public function set textColor(value:uint):void

Ejemplo  ( Cómo utilizar este ejemplo )
El siguiente código ActionScript crea un objeto TextField y cambia su propiedad textColor a rojo (0xFF0000).
package {
    import flash.display.Sprite;
    import flash.text.TextField;

    public class TextField_textColor extends Sprite {
        public function TextField_textColor() {
            var tf:TextField = createCustomTextField(10, 10, 100, 300);
            tf.text = "This will be red text";
            tf.textColor = 0xFF0000;            
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            addChild(result);
            return result;
        }
    }
}

textHeight

propiedad 
textHeight:Number  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

La altura del texto, expresada en píxeles.



Implementación
    public function get textHeight():Number

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea un objeto TextField y se le asigna texto. Las sentencias trace muestran los valores de las propiedades textWidth y textHeight. Por motivos de comparación, las propiedades width y height también se muestran. (Tenga en cuenta que los valores que ve para textHeight y textWidth pueden variar en función de la fuente utilizada en su equipo).
package {
    import flash.display.Sprite;
    import flash.text.TextField;

    public class TextField_textHeight extends Sprite {
        public function TextField_textHeight() {
            var tf:TextField = createCustomTextField(10, 10, 100, 150);
            tf.text = "Sample text";
            
            trace("textWidth: " + tf.textWidth); // textWidth: 55.75
            trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001
            trace("width: " + tf.width); // width: 100
            trace("height: " + tf.height); // height: 150
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            result.border = true;
            result.background = true;
            addChild(result);
            return result;
        }
    }
}

textInteractionMode

propiedad 
textInteractionMode:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 11, Flash Lite 4

La propiedad del modo de interacción; el valor predeterminado es TextInteractionMode.NORMAL. En plataformas móviles, el modo normal implica que el texto se puede desplazar pero no seleccionar. Se puede cambiar al modo seleccionable a través del menú contextual en el campo de texto. En el escritorio, el modo normal implica que el texto está se puede desplazar y seleccionar.



Implementación
    public function get textInteractionMode():String

textWidth

propiedad 
textWidth:Number  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

La anchura del texto, expresada en píxeles.



Implementación
    public function get textWidth():Number

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crea un objeto TextField y se le asigna texto. Las sentencias trace muestran los valores de las propiedades textWidth y textHeight. Por motivos de comparación, las propiedades width y height también se muestran. (Tenga en cuenta que los valores que ve para textHeight y textWidth pueden variar en función de la fuente utilizada en su equipo).
package {
    import flash.display.Sprite;
    import flash.text.TextField;

    public class TextField_textHeight extends Sprite {
        public function TextField_textHeight() {
            var tf:TextField = createCustomTextField(10, 10, 100, 150);
            tf.text = "Sample text";
            
            trace("textWidth: " + tf.textWidth); // textWidth: 55.75
            trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001
            trace("width: " + tf.width); // width: 100
            trace("height: " + tf.height); // height: 150
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            result.border = true;
            result.background = true;
            addChild(result);
            return result;
        }
    }
}

thickness

propiedad 
thickness:Number

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9

El grosor de los bordes de glifo en este campo de texto. Esta propiedad sólo se aplica cuando flash.text.AntiAliasType es flash.text.AntiAliasType.ADVANCED.

El rango de thickness es un número entre -200 y 200. Si intenta definir thickness con un valor fuera del rango, la propiedad se define como el valor más cercano en el rango (-200 ó 200).

El valor predeterminado es 0.



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

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
El siguiente ejemplo muestra el efecto que produce cambiar la propiedad thickness en un objeto TextField. Es necesario incorporar la fuente y establecer la propiedad antiAliasType como ADVANCED.
package
{
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.text.AntiAliasType;
    import flash.text.GridFitType;
    import flash.text.TextFormat;

    public class thicknessExample extends Sprite
    {
        public function thicknessExample()
        {
    var format1:TextFormat = new TextFormat();
    format1.font="Arial";
    format1.size=24;
    var lTxt:String = "The quick brown fox";

    var tf1:TextField=createCustomTextField(0,lTxt,format1,-200);
    var tf2:TextField=createCustomTextField(30,lTxt,format1,0);
    var tf3:TextField=createCustomTextField(60,lTxt,format1,200);
        }

        private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldThickness:Number):TextField 
       {
            var result:TextField = new TextField();
            result.y=y;
            result.text=fldTxt;
            result.embedFonts=true;
            result.autoSize=TextFieldAutoSize.LEFT;
            result.antiAliasType=AntiAliasType.ADVANCED;
            result.gridFitType=GridFitType.PIXEL;
            result.thickness=fldThickness;
            result.setTextFormat(format);
            addChild(result);
            return result;
        }
    }
}

type

propiedad 
type:String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Tipo del campo de texto. Puede ser una de las siguientes constantes TextFieldType: TextFieldType.DYNAMIC, que especifica un campo de texto dinámico que el usuario no puede editar, o bien TextFieldType.INPUT, que especifica un campo de introducción de texto que el usuario sí puede editar.

El valor predeterminado es dynamic.



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

Emite
ArgumentError — La cadena type especificada no es un miembro de flash.text.TextFieldType.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se crean dos campos de texto: tfDynamic y tfInput. El texto se introduce en los dos campos. No obstante, tfDynamic tiene su propiedad type definida como TextFieldType.DYNAMIC y tfInput tiene su propiedad type definida como TextFieldType.INPUT, por lo que el usuario puede modificar el texto en tfInput pero sólo podrá verlo en tfDynamic.
package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldType;

    public class TextField_type extends Sprite {
        public function TextField_type() {
            var tfDynamic:TextField = createCustomTextField(10, 10, 100, 20);
            tfDynamic.type = TextFieldType.DYNAMIC;
            tfDynamic.text = "hello";

            var tfInput:TextField = createCustomTextField(10, 45, 100, 20);
            tfInput.type = TextFieldType.INPUT;
            tfInput.text = "world";
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            result.background = true;
            result.border = true;
            addChild(result);
            return result;
        }
    }
}

useRichTextClipboard

propiedad 
useRichTextClipboard:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9

Especifica si se copia y se pega el formato del texto junto con el propio texto. Cuando se establece como true, Flash Player también copia y pega el formato (alineación, negrita y cursiva) al copiar y pegar entre dos campos de texto. Tanto el campo de texto de origen como el de destino en el procedimiento de copiar y pegar deben tener useRichTextClipboard definido como true. El valor predeterminado es false.



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

Ejemplo  ( Cómo utilizar este ejemplo )
Este ejemplo crea un campo de entrada de texto (tf1) y dos campos de texto dinámico (tf2 y tf3). El código asigna cada campo de texto dinámico a un objeto TextFormat (fuente Courier negrita). El campo de texto tf2 tiene la propiedad useRichTextClipboard establecida como false. El campo de texto tf3 tiene la propiedad useRichTextClipboard establecida como true. Cuando copia texto del campo de texto tf2 y lo pega en el campo de texto tf1, el texto pegado no conserva el formato. Cuando copia texto del campo de texto tf3 (que tiene la propiedad useRichTextClipboard establecida como true) y lo pega en el campo de texto tf1, el texto pegado sí conserva el formato.
package
{
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldType;
    import flash.text.TextFormat;

    public class useRichTextClipboard extends Sprite
    {
        public function useRichTextClipboard()
        {
    var format1:TextFormat = new TextFormat();
    format1.font="Courier";
    format1.bold=true;

    var tf1:TextField = createCustomTextField(10, 10, 200, 20);
    tf1.type=TextFieldType.INPUT;
    tf1.useRichTextClipboard=true;

    var tf2:TextField = createCustomTextField(220, 10, 200, 20);
    tf2.text="1.Text loses format";
    tf2.setTextFormat(format1);
    tf2.useRichTextClipboard=false;

    var tf3:TextField = createCustomTextField(220, 50, 200, 20);
    tf3.text="2.Text includes format";
    tf3.setTextFormat(format1);
    tf3.useRichTextClipboard=true;
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField 
       {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            result.background = true;
            result.border = true;
            addChild(result);
            return result;
        }
    }
}

wordWrap

propiedad 
wordWrap:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Valor booleano que indica si el campo de texto tiene ajuste de texto. Si el valor de wordWrap es true, el campo de texto tiene ajuste de texto; si el valor es false, el campo de texto no tiene ajuste de texto. El valor predeterminado es false.



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

Ejemplo  ( Cómo utilizar este ejemplo )
En el ejemplo siguiente, se muestra la diferencia entre definir la propiedad wordWrap como true o como false. Se crean dos instancias de TextField con contenido que supera sus anchuras. La propiedad wordWrap de la primera instancia (denominada tfWrap) se define como true; se define como false para la segunda instancia (tfNoWrap).
package {
    import flash.display.Sprite;
    import flash.text.TextField;

    public class TextField_wordWrap extends Sprite {
        public function TextField_wordWrap() {
            var tfWrap:TextField = createCustomTextField(10, 10, 100, 100);
            tfWrap.wordWrap = true;
            tfWrap.text = "(wordWrap = true):\nThis is very long text that will certainly extend beyond the width of this text field";

            var tfNoWrap:TextField = createCustomTextField(10, 150, 100, 100);
            tfNoWrap.wordWrap = false;
            tfNoWrap.text = "(wordWrap = false):\nThis is very long text that will certainly extend beyond the width of this text field";
        }

        private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.width = width;
            result.height = height;
            result.background = true;
            result.border = true;
            addChild(result);
            return result;
        }
    }
}
Información sobre constructores

TextField

()Información sobre
public function TextField()

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Crea una nueva instancia de TextField. Tras crear la instancia de TextField, llame al método addChild() o addChildAt() de la instancia DisplayObjectContainer principal para colocar la instancia de TextField en la lista de visualización.

El tamaño predeterminado para un campo de texto es de 100 x 100 píxeles.


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente se muestra cómo se puede crear dinámicamente un objeto TextField de entrada en ActionScript 3.0 estableciendo la propiedad type del objeto del campo de texto en la constante TextFieldType.INPUT. Ejemplo facilitado por ActionScriptExamples.com.
var theTextField:TextField = new TextField();
theTextField.type = TextFieldType.INPUT;
theTextField.border = true;
theTextField.x = 10;
theTextField.y = 10;
theTextField.multiline = true;
theTextField.wordWrap = true;
addChild(theTextField);
Información sobre métodos

appendText

()método
public function appendText(newText:String):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Añade la cadena especificada por el parámetro newText al final del texto del campo de texto. Este método es más eficaz que una asignación de suma (+=) en una propiedad text (por ejemplo, someTextField.text += moreText), especialmente para un campo de texto que incluye una importante cantidad de contenido.

Parámetros

newText:String — La cadena que se añade al texto existente.


Ejemplo  ( Cómo utilizar este ejemplo )

El siguiente ejemplo muestra la hora si no es fin de semana o el texto "It's the weekend" (Es fin de semana), si lo es. También realiza el recuento del número de caracteres hasta una determinada posición y el número de líneas del campo de texto.

El campo de texto outputText se define para que ajuste automáticamente el texto y cambie el tamaño a texto justificado a la izquierda mediante la propiedad autoSize. La propiedad outputText.text escribe la primera línea del contenido y el método appendText() añade el resto del contenido. (No es necesario comenzar por la propiedad text. El método appendText() también se podría utilizar para añadir texto desde el principio.) La definición de la propiedad text una segunda vez sobrescribirá el texto original. Utilice el operador += para añadir contenido con la propiedad text.

La sentencia ifcomprueba si la fecha es sábado (6) o domingo (0). Si no lo es, el método toLocaleTimeString() devuelve la hora local, que se añade al contenido del campo de texto.

La propiedad length del campo de texto se utiliza para leer el número de caracteres hasta justo antes de que se llame a la función y la propiedad numLines se utiliza para realizar el recuento del número de líneas en el campo de texto. Tenga en cuenta que las líneas vacías se cuentan en el número de líneas, mientras que los espacios vacíos y los saltos de línea (\n) se cuentan al determinar la longitud del contenido.

  package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
 
    public class TextField_appendTextExample extends Sprite {
         
        public function TextField_appendTextExample() {
            var outputText:TextField = new TextField();
            var today:Date = new Date();
                
            outputText.x = 10;
            outputText.y = 10;
            outputText.background = true;
            outputText.autoSize = TextFieldAutoSize.LEFT;
 
            outputText.text = "WHAT TIME IS IT?" + "\n\n";
 
            if((today.day == 0) || (today.day == 6)) {
                outputText.appendText("It's the weekend.");
                outputText.appendText("\n\n");
           
            } else {
                outputText.appendText("The time is: ");
                outputText.appendText(today.toLocaleTimeString() + ".\n\n");  
            }

            outputText.appendText("Number of characters including line breaks and spaces so far: ");
            outputText.appendText(outputText.length.toString() + "\n");
            outputText.appendText("Number of lines in the outputText: ");
            outputText.appendText(outputText.numLines.toString());   

            this.addChild(outputText);
        }
    }
}

getCharBoundaries

()método 
public function getCharBoundaries(charIndex:int):Rectangle

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve un rectángulo como recuadro de delimitación del carácter.

Parámetros

charIndex:int — El valor de índice basado en cero para el carácter (por ejemplo, la primera posición es 0, la segunda posición es 1, etc.).

Valor devuelto
Rectangle — Un rectángulo con valores máximos y mínimos x e y que definen el recuadro de delimitación del carácter.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el siguiente ejemplo, se utiliza el método getCharBoundaries() para marcar (destacar) un carácter seleccionado por el usuario.

La clase define el objeto Shape spotlight que se utilizará para dibujar un rectángulo alrededor de cada carácter seleccionado. Cuando el usuario hace clic en el campo de texto myTextField, se invoca el método clickHandler().

En el método clickHandler(), el método getCharIndexAtPoint() obtiene el índice del carácter seleccionado en función de las coordenadas localX y localY del clic del ratón, que es relativa a la clase Sprite que contiene. El método getCharIndexAtPoint() devuelve -1 si el punto (clic del mouse) no estaba sobre el carácter. Puesto que el campo de texto podría ser mayor que el texto, se comprueba el entero devuelto (index) para asegurarse de que el usuario ha hecho clic en un carácter. El entero index también lo utiliza getCharBoundaries() para obtener un objeto Rectangle que contiene el límite del carácter. El método clear() borra cualquier objeto Shape spotlight mostrado anteriormente. Se produce un nuevo rectángulo con el tamaño de los límites de altura y anchura del carácter en la ubicación del carácter (desplazamiento de las coordenadas (10, 10)) mediante las coordenadas x e y del rectángulo frame devuelto. Para marcar el carácter, se rellena el objeto Shape spotlight de color amarillo y se define la opacidad en el 35%, de modo que se pueda ver el carácter. Tenga en cuenta que los espacios también se consideran caracteres.

package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.geom.Rectangle;
    import flash.events.MouseEvent;
    import flash.text.TextFieldAutoSize;
    import flash.display.Shape;

    public class TextField_getCharBoundariesExample extends Sprite
    {
        private var myTextField:TextField = new TextField();    
        private var spotlight:Shape = new Shape();
        
        public function TextField_getCharBoundariesExample() {
            
            myTextField.x = 10;
            myTextField.y = 10; 
            myTextField.border = true;
            myTextField.selectable = false;
            myTextField.autoSize = TextFieldAutoSize.LEFT;
            
            myTextField.text = "Selected a character from this text by clicking on it."

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
            
            this.addChild(myTextField);    
            this.addChild(spotlight);
         }

        private function clickHandler (e:MouseEvent):void {
            var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY);
 
            if (index != -1) {
                 var frame:Rectangle = myTextField.getCharBoundaries(index);

                spotlight.graphics.clear();    
                spotlight.graphics.beginFill(0xFFFF00, .35);
                spotlight.graphics.drawRect((frame.x + 10), (frame.y + 10), frame.width, frame.height);            
                spotlight.graphics.endFill();
            }
        } 
    }
}

getCharIndexAtPoint

()método 
public function getCharIndexAtPoint(x:Number, y:Number):int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve un valor de índice basado en cero del carácter en el punto especificado por los parámetros x e y.

Parámetros

x:Number — La coordenada x del carácter.
 
y:Number — La coordenada y del carácter.

Valor devuelto
int — El valor de índice basado en cero para el carácter (por ejemplo, la primera posición es 0, la segunda es 1, etc.). Devuelve -1 si el punto no está sobre ningún carácter.

Ejemplo  ( Cómo utilizar este ejemplo )

En el siguiente ejemplo, cuando el usuario hace clic en un carácter, éste se duplica (eco) en otro campo de texto encima del texto.

El primer campo incluye el texto que va a seleccionar el usuario. Para asegurarse de que se hace clic en el texto pero no se selecciona, la propiedad selectable se define como false. Cuando el usuario hace clic en el campo de texto firstTextField, se invoca el método clickHandler().

En el método clickHandler(), el método getCharIndexAtPoint() devuelve el índice del carácter en función de las coordenadas localX y localY del clic del ratón. Puesto que el campo de texto podría ser mayor que el texto, se comprueba el entero devuelto (index) para asegurarse de que el usuario ha hecho clic en un carácter. (El método getCharIndexAtPoint() devuelve -1 si el punto (clic del mouse) no estaba sobre ningún carácter.) Las coordenadas del ratón se utilizan para definir las coordenadas del nuevo campo de texto en el que aparecerá el carácter duplicado (con eco). El color del carácter en el segundo campo de texto se define en rojo. Finalmente, el texto del segundo campo se define con el carácter seleccionado, que se recupera mediante el método charAt(). Tenga en cuenta que el uso de la propiedad text en lugar del método appendText() sobrescribirá el carácter del segundo campo de texto en lugar de añadirlo.

package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.geom.Rectangle;
    import flash.events.MouseEvent;
    import flash.text.TextFieldAutoSize;
    
    public class TextField_getCharIndexAtPointExample extends Sprite {
        private var firstTextField:TextField = new TextField();    
        private var secondTextField:TextField = new TextField();
        
        public function TextField_getCharIndexAtPointExample() {

            firstTextField.x = 100;
            firstTextField.y = 100; 
            firstTextField.width = 260;
            firstTextField.height = 20;
            firstTextField.border = true;
            firstTextField.background = true;
            firstTextField.selectable = false;
            
            firstTextField.text = "Selected a character from this text by clicking on it."

            firstTextField.addEventListener(MouseEvent.CLICK, clickHandler);

            this.addChild(firstTextField);    
            this.addChild(secondTextField);
         }

        private function clickHandler (e:MouseEvent):void {
            var index:int = firstTextField.getCharIndexAtPoint(e.localX, e.localY);

            if (index != -1) {
                secondTextField.x = mouseX;
                secondTextField.y =  70;
                secondTextField.border = true;
                secondTextField.selectable = false;
                secondTextField.background = true;
                secondTextField.textColor = 0xFF0000;
                secondTextField.autoSize = TextFieldAutoSize.LEFT;
                secondTextField.text = firstTextField.text.charAt(index);    
            }
        } 
    }
}

getFirstCharInParagraph

()método 
public function getFirstCharInParagraph(charIndex:int):int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Dado un índice del carácter, devuelve el índice del primer carácter del mismo párrafo.

Parámetros

charIndex:int — El valor de índice basado en cero para el carácter (por ejemplo, el primer carácter es 0, el segundo carácter es 1, etc.).

Valor devuelto
int — El valor de índice basado en cero del primer carácter del mismo párrafo.

Emite
RangeError — El índice del carácter especificado está fuera de rango.

Ejemplo  ( Cómo utilizar este ejemplo )

En el siguiente ejemplo, el formato del párrafo se aplica al contenido del campo de texto. Cuando el usuario haga clic en un párrafo, el texto se alineará a la derecha y cuando vuelva a hacer clic en el párrafo, se volverá al formato (alineación a la izquierda) original (predeterminado).

En el constructor, el campo de texto myTextField se define como ajuste de texto. El método getTextFormat devuelve el formato original del primer carácter del contenido del campo de texto, que se ubica en el objeto originalFormat TextFormat. También se define un nuevo objeto TextFormat (newFormat) y se asigna la propiedad align como justificada a la derecha. Cuando el usuario hace clic en el campo de texto, se invoca el método clickHandler().

En el método clickHandler(), el método getCharIndexAtPoint() devuelve el índice del carácter en función de las coordenadas localX y localY del clic del ratón. La primera sentencia if comprueba si el usuario ha hecho clic en el carácter. Con el entero clickIndex devuelto por el método getCharIndexAtPoint(), el método getFirstCharInParagraph() devuelve el índice del primer carácter del párrafo que el usuario ha seleccionado. El índice del último carácter del párrafo se determina mediante la incorporación de la longitud del párrafo (con el método getParagraphLength()) al índice del primer carácter del párrafo, menos el último carácter (\n). La segunda sentencia if comprueba el formato del primer carácter del párrafo. Si su valor de alineación es el mismo que el formato original (justificado a la izquierda), el nuevo formato se aplica a todos los caracteres del párrafo. De lo contrario, el formato del párrafo cambia al formato original. La alineación, junto con opciones de formato como la sangría, viñetas, tabulaciones, márgenes derecho e izquierdo, son formatos específicos de párrafos. Tenga en cuenta que una vez que se utiliza el ajuste de texto o el salto de línea, el formato sólo se aplicará a la primera línea del párrafo si el argumento endIndex no está definido para el método setTextFormat().

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.events.MouseEvent;
    import flash.text.TextFormat;
    import flash.text.TextFormatAlign;

    public class TextField_getFirstCharInParagraphExample extends Sprite
    {
        private var myTextField:TextField = new TextField();
        private var originalFormat:TextFormat = new TextFormat();
        private var newFormat:TextFormat = new TextFormat(); 
        
        public function TextField_getFirstCharInParagraphExample() {
            myTextField.x = 10;
            myTextField.y = 10; 
            myTextField.border = true;
            myTextField.wordWrap = true;
            myTextField.width = 300;
            myTextField.height = 300; 
            myTextField.background = true;
             
            myTextField.appendText("The TextField class is used to create display objects for "
                        + "text display and input. All dynamic and input text fields in a SWF file " 
                        + "are instances of the TextField class. You can use the TextField class "
                        + "to perform low-level text rendering. However, in Flex, you typically use "
                        + "the Label, Text, TextArea, and TextInput controls to process text. "  
                        + "You can give a text field an instance name in the Property inspector "
                        + "and use the methods and properties of the TextField class to manipulate it with ActionScript. "
                        + "TextField instance names are displayed in the Movie Explorer and in the Insert "
                        + "Target Path dialog box in the Actions panel.\n\n"  
                        + "To create a text field dynamically, use the TextField constructor.\n\n"
                        + "The methods of the TextField class let you set, select, and manipulate "  
                        + "text in a dynamic or input text field that you create during authoring or at runtime.\n\n");

            originalFormat = myTextField.getTextFormat(0);

            newFormat.align = TextFormatAlign.RIGHT;

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
  
            this.addChild(myTextField);
        }

        private function clickHandler(e:MouseEvent):void {
            var clickIndex:int = myTextField.getCharIndexAtPoint(e.localX, e.localY);
                  
            if(clickIndex != -1) {
                var paragraphFirstIndex:int = myTextField.getFirstCharInParagraph(clickIndex);
                var paragraphEndIndex:int = paragraphFirstIndex + ((myTextField.getParagraphLength(clickIndex) - 1));
            
                if (myTextField.getTextFormat(paragraphFirstIndex).align == originalFormat.align) {
                     myTextField.setTextFormat(newFormat, paragraphFirstIndex, paragraphEndIndex);
                }else {
                     myTextField.setTextFormat(originalFormat, paragraphFirstIndex, paragraphEndIndex);
                }
            } 
        }
    }
}
 

getImageReference

()método 
public function getImageReference(id:String):DisplayObject

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve una referencia DisplayObject para el id dado, ya que se ha añadido una imagen o un archivo SWF a un campo de texto con formato HTML mediante la etiqueta <img>. La etiqueta <img> tiene el siguiente formato:

   <img src = 'filename.jpg' id = 'instanceName' >

Parámetros

id:String — El id que debe coincidir (en el atributo id de la etiqueta <img>).

Valor devuelto
DisplayObject — El objeto de visualización correspondiente a la imagen o al archivo SWF con el atributo coincidente id en la etiqueta <img> del campo de texto. En medios cargados desde un origen externo, este objeto es un objeto Loader y, una vez cargado, el objeto de medios se convierte en un elemento secundario del objeto Loader. En el caso de medios incorporados al archivo SWF, se trata del objeto cargado. Si no hay ninguna etiqueta <img> con el id coincidente, el método devuelve null.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, cuando se hace clic en el campo de texto, la imagen del campo se establece en una opacidad del 25% y gira 90º desde su rotación original. La imagen continuará girando con cada clic subsiguiente.

La imagen (image.jpg) se incluye a través de HTML. (En este caso, se asume que un archivo de imagen está en el mismo directorio que el archivo SWF.) Un atributo id necesita definirse para la etiqueta img a fin de tener acceso a la imagen utilizando el método getImageReference(). La propiedad htmlText se utiliza para incluir contenido de cadenas con formato HTML. Cuando el usuario hace clic en el campo de texto myTextField, se invoca el método clickHandler().

En el método clickHandler(), el método getImageReference() devuelve una referencia a la imagen como DisplayObject. Esta referencia se puede utilizar para manipular la imagen, como cualquier otro objeto DisplayObject. En este caso, se establecen las propiedades alpha (transparencia) yrotation. También se puede utilizar la propiedad transform para acceder a los límites de píxel, transformación de color y matriz del objeto de visualización. Tenga también en cuenta que flash.display.DisplayObject debe importarse.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.events.Event;
    import flash.events.MouseEvent;
    import flash.display.DisplayObject;
    
    import flash.text.TextFieldAutoSize;
    
    public class TextField_getImageReferenceExample extends Sprite
    {
        private var myTextField:TextField = new TextField();
        
        public function TextField_getImageReferenceExample()
        {
            var myText1:String = "<p>Here is an image we want to mainpulate: <img src='image.jpg' id='testimage'></p>";

            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.width = 250;
            myTextField.height = 250;
            myTextField.background = true;
            myTextField.border = true;
            myTextField.border = true;
            myTextField.multiline = true;

            myTextField.htmlText = myText1;
            
            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
            
            this.addChild(myTextField);
        }
 
        private function clickHandler(e:MouseEvent):void {
            var imageRef:DisplayObject = myTextField.getImageReference("testimage");
 
            imageRef.rotation += 90;
            imageRef.x = 125;
            imageRef.y = 125;
            imageRef.alpha = 0.25;      
        }
    }
}

getLineIndexAtPoint

()método 
public function getLineIndexAtPoint(x:Number, y:Number):int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve un valor de índice basado en cero de la línea en el punto especificado por los parámetros x e y.

Parámetros

x:Number — La coordenada x de la línea.
 
y:Number — La coordenada y de la línea.

Valor devuelto
int — El valor de índice basado en cero para la línea (por ejemplo, la primera línea es 0, la segunda es 1, etc.). Devuelve -1 si el punto no está sobre ninguna línea.

Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, cuando el usuario selecciona una línea del soneto de Shakespeare, ésta se copia (añade) a un nuevo campo de texto.

En el constructor, el campo de texto poem se establece de modo que no se ajuste en líneas continuas (ya que se trata de un poema). También se utiliza la propiedad autoSize para especificar que el texto se ajuste automáticamente y cambie el tamaño a texto ajustado a la izquierda. El campo de texto poemCopy se coloca debajo del campo poem. Cuando el usuario hace clic en una línea del poema, se invoca el método clickHandler().

En el método clickHandler(), el método getLineIndexAtPoint() devuelve el índice de línea en el que el usuario ha hecho clic según las coordenadas localX y localY del clic del ratón. (Puesto que aquí el poema original se ajusta al tamaño del campo de texto, no es necesario comprobar los errores de fuera del rango (RangeError) emitidos por el método getCharIndexAtPoint().) A continuación, se utiliza el índice de línea para obtener el contenido de la línea como cadena con el método getLineText(), que se añade después al contenido del campo de texto poemCopy. La acción de copia puede repetirse continuamente pero llegado a un punto, el texto estará fuera del rango de visibilidad del campo de texto poemCopy.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.events.MouseEvent;
    import flash.text.TextFormat;
    import flash.text.TextFieldAutoSize;

    public class TextField_getLineIndexAtPointExample extends Sprite {
        private var poem:TextField = new TextField();
        private var poemCopy:TextField = new TextField();
        
        public function TextField_getLineIndexAtPointExample() {
            poem.border = true;
            poem.autoSize = TextFieldAutoSize.LEFT;
            poem.x = 10;
            poem.wordWrap = false;

            poemCopy.height = 250;
            poemCopy.width = 270;
            poemCopy.y = 230;
            poemCopy.x = 10;
            poemCopy.background = true;
            poemCopy.border = true;
            poemCopy.wordWrap = false;
            
            poem.appendText("Let me not to the marriage of true minds\n"
                              + "Admit impediments. love is not love\n"
                              + "Which alters when it alteration finds\n"
                              + "Or bends with the remover to remove:\n"
                              + "O no! it is an ever-fixed mark\n" 
                              + "That looks on tempests and is never shaken;\n"
                              + "It is the star to every wandering bark,\n"
                              + "Whose worth's unknown, although his height be taken.\n"
                              + "Love's not Time's fool, though rosy lips and cheeks\n"
                              + "Within his bending sickle's compass come:\n"
                              + "Love alters not with his brief hours and weeks,\n"
                              + "But bears it out even to the edge of doom.\n"
                              + "If this be error and upon me proved,\n"
                              + "I never writ, nor no man ever loved.");

           poem.addEventListener(MouseEvent.CLICK, clickHandler); 

           this.addChild(poem); 
           this.addChild(poemCopy);
        }
    
        private function clickHandler(e:MouseEvent):void {
                var index:int = poem.getLineIndexAtPoint(e.localX, e.localY);
                var s:String;

                s = poem.getLineText(index);
                poemCopy.appendText(s + "\n");
        }
    }
}

getLineIndexOfChar

()método 
public function getLineIndexOfChar(charIndex:int):int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve un valor de índice basado en cero de la línea que contiene el carácter especificado por el parámetro charIndex.

Parámetros

charIndex:int — El valor de índice basado en cero para el carácter (por ejemplo, el primer carácter es 0, el segundo carácter es 1, etc.).

Valor devuelto
int — El valor de índice basado en cero de la línea.

Emite
RangeError — El índice del carácter especificado está fuera de rango.

Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, el método getLineIndexOfChar() devuelve los números de línea para los caracteres 100 y 500 del campo de texto.

El campo de texto myTextField está definido para ajustarse y cambiar el tamaño como texto justificado a la izquierda. El método getLineIndexOfChar() devuelve el índice de línea para los índices de caracteres especificados (100 y 500). Esta información se añade después del párrafo. Tenga en cuenta que puesto que el índice de línea comienza por 0, el índice (index) aumenta en 1 para obtener el número de línea. Asimismo, si modifica el tamaño de la visualización, el número de líneas puede cambiar pero la información permanecerá igual, ya que el método sólo se invoca una vez.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class TextField_getLineIndexOfCharExample extends Sprite 
    {
        public function TextField_getLineIndexOfCharExample()
        {
            var myTextField:TextField = new TextField();
            
            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.width = 200;
            myTextField.background = true;  
            myTextField.border = true;
            myTextField.wordWrap = true;
            myTextField.autoSize = TextFieldAutoSize.LEFT;

            myTextField.appendText("The TextField class is used to create display objects for "
                + "text display and input. All dynamic and input text fields in a SWF file" 
                + "are instances of the TextField class. You can use the TextField class "
                + "to perform low-level text rendering. However, in Flex, you typically use "
                + "the Label, Text, TextArea, and TextInput controls to process text. "  
                + "You can give a text field an instance name in the Property inspector "
                + "and use the methods and properties of the TextField class to manipulate it with ActionScript. "
                + "TextField instance names are displayed in the Movie Explorer and in the Insert "
                + "Target Path dialog box in the Actions panel.\n\n");

            var index:int = myTextField.getLineIndexOfChar(100);
            myTextField.appendText("100th character is in line: " +  (index + 1) + "\n");
            index = myTextField.getLineIndexOfChar(500);
            myTextField.appendText("500th character is in line: " + (index + 1));

            this.addChild(myTextField);
        }
    }
}

getLineLength

()método 
public function getLineLength(lineIndex:int):int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve el número de caracteres de una línea de texto específica.

Parámetros

lineIndex:int — El número de línea para el que se desea obtener la longitud.

Valor devuelto
int — Número de caracteres de la línea.

Emite
RangeError — El número de línea especificado está fuera de rango.

Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, una vez que el usuario selecciona una línea, la longitud de ésta (número de caracteres) se muestra en un campo de texto independiente.

Como ilustración, el campo de texto myTextField, que muestra el texto que se contará, está definido como INPUT, lo que indica que los usuarios pueden realmente cambiar las líneas, o bien añadir líneas entre las líneas o al final. (Hay una línea vacía creada utilizando el salto de línea (\n) al final de la última línea.) El campo de texto countLines, donde se muestra el resultado de contar la longitud de la línea, está establecido debajo de myTextField y su texto no es seleccionable. Cuando el usuario hace clic en una línea del campo de texto myTextField, se invoca el método clickHandler().

En el método clickHandler(), el método getLineIndexAtPoint() devuelve el índice de línea en el que el usuario ha hecho clic utilizando las coordenadas localX y localY del clic del ratón. La sentencia if comprueba si el usuario ha hecho clic en un carácter. Si es así, el método getLineLength(), mediante el índice de la línea, devuelve el número de caracteres de la línea. Tenga en cuenta que las líneas vacías entre las líneas incluyen el segundo salto de línea (\n) y tienen un recuento de 1 carácter, mientras que la líneas después de la última línea tienen un recuento de 0. Los espacios también cuentan como un carácter. Los usuarios pueden escribir una nueva línea o cambiar una y obtener el número de caracteres de la línea haciendo clic en ella. Si se utiliza el ajuste de texto y se cambia el tamaño de la pantalla, el índice de línea podría modificarse

 package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldType;
    import flash.events.Event;
    import flash.events.MouseEvent;

    public class TextField_getLineLengthExample extends Sprite {
        private var myTextField:TextField = new TextField();
        private var countLines:TextField = new TextField();  

        public function TextField_getLineLengthExample() {
            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.width = 350;
            myTextField.height = 150;
            myTextField.background = true;
            myTextField.border = true;
            myTextField.type = TextFieldType.INPUT;
            
            myTextField.appendText("Click on the lines to count its number of characters:\n\n");
            myTextField.appendText("This is a short line.\n");
            myTextField.appendText("This is a longer line than the last line.\n\n");
            myTextField.appendText("This one is even longer than the one before. It has two sentences.\n");

            this.addChild(myTextField);

            countLines.border = true;
            countLines.x = 10;
            countLines.y = 180;
            countLines.height = 30;
            countLines.width = 200;
            countLines.background = true;
            countLines.selectable = false;

           this.addChild(countLines);    

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
        }

        private function clickHandler(e:MouseEvent):void {
            var index:int = myTextField.getLineIndexAtPoint(e.localX, e.localY);
        
            if (index != -1) {
            var lenght:int = myTextField.getLineLength(index);

            countLines.text = "Number of characters in the line is: " + lenght.toString();
            }
        }
    }
}

getLineMetrics

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

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve información de medidas sobre una línea de texto dada.

Parámetros

lineIndex:int — El número de línea para el que se desea obtener la información de medidas.

Valor devuelto
flash.text:TextLineMetrics — Un objeto TextLineMetrics.

Emite
RangeError — El número de línea especificado está fuera de rango.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

El ejemplo siguiente muestra algunos valores de métrica de línea para dos líneas de texto con diferente formato.

El texto añadido consta de dos líneas de Song of Myself de Walt Whitman. Se utiliza un nuevo objeto TextFormat (newFormat) para establecer el formato de la segunda línea. La primera línea mantiene el formato predefinido. El método getLineMetrics() devuelve un objeto TextLineMetrics para una línea específica. (El índice de línea empieza por 0.) Al utilizar los objetos TextLineMetrics metrics1 y metrics2 para la línea uno y dos, respectivamente, se recuperan y muestran los valores ascendente, descendente, de altura y de peso de la línea. Los números resultantes se convierten en cadena pero no se redondean. Tenga en cuenta que este valor es para la línea y no es un carácter específico. Refleja el rango de caracteres de la línea. Por ejemplo, si una línea tiene diferentes caracteres con distintos formatos de altura, el carácter con mayor altura determinará el valor. Esto significa también que si se modifica uno de los formatos del carácter, también podrían cambiar algunos de los valores de métrica.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextLineMetrics;
    import flash.text.TextFieldAutoSize;
    import flash.text.AntiAliasType;
    import flash.text.TextFormat;
 
    public class TextField_getLineMetricsExample extends Sprite {

        public function TextField_getLineMetricsExample() {
            var myTextField:TextField = new TextField();
            var newFormat:TextFormat = new TextFormat(); 

            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.background = true;
            myTextField.wordWrap = false;
            myTextField.autoSize = TextFieldAutoSize.LEFT;
            
            myTextField.appendText("A child said What is the grass? fetching it to me with full hands;\n");
            myTextField.appendText("How could I answer the child? I do not know what it is any more than he.\n\n");

            newFormat.size = 14;
            newFormat.font = "Arial";
            newFormat.italic = true;
            myTextField.setTextFormat(newFormat, 67, 139);
               
            var metrics1:TextLineMetrics = myTextField.getLineMetrics(0);
             
            myTextField.appendText("Metrics ascent for the line 1 is: " + metrics1.ascent.toString() + "\n");
            myTextField.appendText("Metrics descent is: " + metrics1.descent.toString() + "\n");
            myTextField.appendText("Metrics height is: " + metrics1.height.toString() + "\n"); 
            myTextField.appendText("Metrics width is: " + metrics1.width.toString() + "\n\n");

            var metrics2:TextLineMetrics = myTextField.getLineMetrics(1);
             
            myTextField.appendText("Metrics ascent for the line 2 is: " + metrics2.ascent.toString() + "\n");
            myTextField.appendText("Metrics descent is: " + metrics2.descent.toString() + "\n");
            myTextField.appendText("Metrics height is: " + metrics2.height.toString() + "\n"); 
            myTextField.appendText("Metrics width is: " + metrics2.width.toString() + "\n");

            addChild(myTextField);
        }
    }
}

getLineOffset

()método 
public function getLineOffset(lineIndex:int):int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve el índice de carácter del primer carácter de la línea especificada por el parámetro lineIndex.

Parámetros

lineIndex:int — El valor de índice basado en cero para la línea (por ejemplo, la primera línea es 0, la segunda es 1, etc.).

Valor devuelto
int — El valor de índice basado en cero del primer carácter de la línea.

Emite
RangeError — El número de línea especificado está fuera de rango.

Ejemplo  ( Cómo utilizar este ejemplo )

El ejemplo siguiente comprueba el primer carácter de la línea 4, que cambiará si la pantalla (y el campo de texto) cambia de tamaño.

El campo de texto myTextField está establecido en ajuste de texto. El campo de texto countField mostrará el primer carácter de la línea 4. Cuando el usuario hace clic en el campo de texto myTextField, se invoca el método clickHandler().

En el método clickHandler(), el método getLineOffset() devuelve el índice del primer carácter en el índice de línea 3, que es la cuarta línea del texto. (La primera línea tiene un índice de 0.) El método charAt() se utiliza para obtener el carácter utilizando el índice del primer carácter de la cuarta línea. El contenido del campo de texto countField se actualiza con esta información mediante la propiedad text del campo de texto countField. El uso de la propiedad countField.text implica que cada vez que se haga clic, se sobrescribirá el contenido del campo de texto countField. Si el usuario cambia el tamaño de la pantalla, se ajustará el contenido y podría cambiar el primer carácter de la línea 4. Si hace clic de nuevo en el campo myTextField, se actualiza el campo de texto countField con el primer carácter nuevo para la cuarta línea.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.events.MouseEvent;

    public class TextField_getLineOffsetExample extends Sprite {
        private var myTextField:TextField = new TextField();
        private var countField:TextField = new TextField();
        
        public function TextField_getLineOffsetExample() {
            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.width = 150;
            myTextField.height = 300;
            myTextField.background = true;
            myTextField.border = true;
            myTextField.wordWrap = true;

            countField.height = 20;
            countField.width = 200;
            countField.x = 10;
            countField.y = 320;
            countField.selectable = false;
            
            myTextField.appendText("The TextField class is used to create display objects for "
                        + "text display and input. All dynamic and input text fields in a SWF file " 
                        + "are instances of the TextField class. You can use the TextField class "
                        + "to perform low-level text rendering. However, in Flex, you typically use "
                        + "the Label, Text, TextArea, and TextInput controls to process text. "  
                        + "You can give a text field an instance name in the Property inspector "
                        + "and use the methods and properties of the TextField class to manipulate it with ActionScript.");

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
        
            this.addChild(myTextField);
            this.addChild(countField);
        }
    
            private function clickHandler(e:MouseEvent):void {
                var c:String;
                var index:int;
                
                index = myTextField.getLineOffset(3);
                c = myTextField.text.charAt(index);
                countField.text = "The first character of line 4 is: " + c;
            }
    }
}

getLineText

()método 
public function getLineText(lineIndex:int):String

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve el texto de la línea especificada por el parámetro lineIndex.

Parámetros

lineIndex:int — El valor de índice basado en cero para la línea (por ejemplo, la primera línea es 0, la segunda es 1, etc.).

Valor devuelto
String — La cadena de texto contenida en la línea especificada.

Emite
RangeError — El número de línea especificado está fuera de rango.

Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, se buscan y se muestran los números de línea de todas las instancias de la palabra "love" utilizadas en el soneto de Shakespeare.

El campo de texto poem se establece para que se ajuste automáticamente y cambie el tamaño como texto justificado a la izquierda. La propiedad wordWrap se establece como false, para que las líneas del poema no se ajusten, aunque normalmente cuando se utiliza la propiedad autoSize no debería ser un problema. El bucle for itera por las líneas del soneto mediante la propiedad numLines del campo de texto. El método getLineText() devuelve el contenido de la línea como cadena. (Tenga en cuenta que la propiedad numLines devuelve el número de líneas empezando por la línea 1, mientras que para el método getLineText() el número de línea empieza por 0.) Con el patrón de expresión normal (/love/i), la sentencia if busca cualquier subcadena de la palabra en mayúscula o minúscula. Si se encuentra el patrón, el método search devuelve el índice de la primera subcadena coincidente; de lo contrario, devuelve -1 (si no hay coincidencias). El número de líneas donde se encontró la palabra "love" ((i + 1)) se coloca después en la cadena lineResult. El método de cadena convierte el argumento de número ((i + 1)) en una cadena con la longitud de otro argumento que sea cadena (" "). El resultado de líneas de la búsqueda incluirá las líneas con las palabras "loved" o "Love's". Si se añadió la cadena "Love was found in lines:" antes del bucle for, la palabra "Love" de esta línea también se habría incluido.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.utils.Timer;
    import flash.events.TimerEvent;
 
    public class TextField_getLineTextExample extends Sprite {
           
        public function TextField_getLineTextExample() {
           var poem:TextField = new TextField();
           var lineResult:String = ""; 
           var pattern:RegExp = /love/i;

            poem.x = 10;
            poem.y = 10;
            poem.background = true;
            poem.wordWrap = false;
            poem.autoSize = TextFieldAutoSize.LEFT;
            
            poem.text = "Let me not to the marriage of true minds\n"
                              + "Admit impediments. love is not love\n"
                              + "Which alters when it alteration finds\n"
                              + "Or bends with the remover to remove:\n"
                              + "O no! it is an ever-fixed mark\n" 
                              + "That looks on tempests and is never shaken;\n"
                              + "It is the star to every wandering bark,\n"
                              + "Whose worth's unknown, although his height be taken.\n"
                              + "Love's not Time's fool, though rosy lips and cheeks\n"
                              + "Within his bending sickle's compass come:\n"
                              + "Love alters not with his brief hours and weeks,\n"
                              + "But bears it out even to the edge of doom.\n"
                              + "If this be error and upon me proved,\n"
                              + "I never writ, nor no man ever loved.\n\n";

            for (var i:int = 0; i < poem.numLines; i++) {

                var s:String = poem.getLineText(i);
                        
                if(s.search(pattern) != -1) {
                    lineResult += (i + 1) + " ";
                }
            }

            poem.appendText("Love was found in lines: " + lineResult);
             
            this.addChild(poem);                      
        }
    }
}

getParagraphLength

()método 
public function getParagraphLength(charIndex:int):int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Dado un índice de carácter, devuelve la longitud del párrafo que contiene dicho carácter. La longitud se mide con respecto al primer carácter del párrafo (tal como la devuelve getFirstCharInParagraph()), no con respecto al índice de carácter.

Parámetros

charIndex:int — El valor de índice basado en cero para el carácter (por ejemplo, el primer carácter es 0, el segundo carácter es 1, etc.).

Valor devuelto
int — Devuelve el número de caracteres del párrafo.

Emite
RangeError — El índice del carácter especificado está fuera de rango.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, cuando un usuario selecciona un párrafo, la longitud y el número de caracteres "s" del párrafo se muestran en un campo de texto independiente.

El campo de texto myTextField muestra los párrafos que seleccionará el usuario. Cuando el usuario hace clic en el campo de texto, se distribuye el evento MouseEvent.CLICK y se realiza una llamada al método clickHandler(). La longitud del párrafo y el número de caracteres "s" aparecerán en el campo de texto countField, que se ubica debajo del campo de texto myTextField.

En el método clickHandler(), el método getCharIndexAtPoint() devuelve el índice del carácter en función de las coordenadas localX y localY del clic del ratón. La primera sentencia if comprueba si el usuario ha hecho clic en el carácter. El método getFirstCharInParagraph() utiliza este índice para devolver el índice del primer carácter del mismo párrafo. La longitud de párrafo devuelta por el método getParagraphLength() se utiliza con índice del primer carácter del párrafo para determinar el índice del final. Un bucle for itera por el párrafo en busca del número de caracteres "s".

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.events.MouseEvent;

    public class TextField_getParagraphLengthExample extends Sprite {
        private var myTextField:TextField = new TextField();
        private var countField:TextField = new TextField();

        public function TextField_getParagraphLengthExample() {
            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.background = true;
            myTextField.border = true;
            myTextField.wordWrap = true;
            myTextField.width = 300;
            myTextField.height = 280;
            
            myTextField.appendText("The TextField class is used to create display objects for "
                        + "text display and input. All dynamic and input text fields in a SWF file" 
                        + "are instances of the TextField class. You can use the TextField class "
                        + "to perform low-level text rendering. However, in Flex, you typically use "
                        + "the Label, Text, TextArea, and TextInput controls to process text. "  
                        + "You can give a text field an instance name in the Property inspector "
                        + "and use the methods and properties of the TextField class to manipulate it with ActionScript. "
                        + "TextField instance names are displayed in the Movie Explorer and in the Insert "
                        + "Target Path dialog box in the Actions panel.\n\n"  
                        + "To create a text field dynamically, use the TextField() constructor.\n\n"
                        + "The methods of the TextField class let you set, select, and manipulate "  
                        + "text in a dynamic or input text field that you create during authoring or at runtime.");

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
            
            countField.x = 10;
            countField.y = 300;
            countField.height = 50;
            countField.width = 250;
            countField.background = true;
            countField.selectable = false;

            this.addChild(myTextField);
            this.addChild(countField);
        }

        private function clickHandler(e:MouseEvent):void {
            var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY);
            
            if(index != -1) {
                var beginParag:int = myTextField.getFirstCharInParagraph(index);
                var paragLength:int = myTextField.getParagraphLength(index);
                var endParag:int = beginParag + paragLength;
                var sCount:uint = 0;

                for (var i:int = beginParag; i <= endParag; i++) {
                    if ((myTextField.text.charAt(i) == "s") || (myTextField.text.charAt(i) == "S")) {
                        sCount++; 
                    }

                countField.text = "Paragraph length is: " + paragLength.toString() + "\n" 
                        + "Number of 's' characters in the paragraph: " + sCount.toString();
                }
            }
        }
    }
}

getTextFormat

()método 
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve un objeto TextFormat que contiene información de formato para el rango de texto especificado por los parámetros beginIndex y endIndex. En el objeto TextFormat resultante, sólo se establecen las propiedades que son comunes a todo el texto del campo de texto. Todas las propiedades que sean mixtas, es decir, que tengan valores diferentes en distintos puntos del texto, tendrán el valor null.

Si no se especifican valores para estos parámetros, el método se aplicará a todo el texto del campo de texto.

La tabla siguiente describe tres posibles usos:

UsoDescripción
my_textField.getTextFormat()Devuelve un objeto TextFormat que contiene información de formato para todo el texto de un campo de texto. En el objeto TextFormat resultante, sólo se establecen las propiedades que son comunes a todo el texto del campo de texto. Todas las propiedades que sean mixtas, es decir, que tengan valores diferentes en distintos puntos del texto, tendrán el valor null.
my_textField.getTextFormat(beginIndex:Number)Devuelve un objeto TextFormat que contiene una copia del formato del texto del carácter en la posición de beginIndex.
my_textField.getTextFormat(beginIndex:Number,endIndex:Number)Devuelve un objeto TextFormat que contiene información de formato para el texto comprendido entre beginIndex y endIndex-1. En el objeto TextFormat resultante, sólo se establecen las propiedades que son comunes a todo el texto del rango especificado. Todas las propiedades que sean mixtas (es decir, que tengan valores diferentes en distintos puntos del rango), estarán configuradas con el valor null.

Parámetros

beginIndex:int (default = -1) — Opcional; un entero que especifica la ubicación inicial de un rango de texto en el campo de texto.
 
endIndex:int (default = -1) — Opcional; un entero que especifica la posición del primer carácter después de un fragmento de texto. Según su diseño, si se especifican los valores beginIndex y endIndex, se lee el texto desde beginIndex hasta endIndex-1.

Valor devuelto
flash.text:TextFormat — El objeto TextFormat que representa las propiedades de formato del texto especificado.

Emite
RangeError — Los elementos beginIndex o endIndex especificados están fuera de rango.

Elementos de API relacionados


Ejemplo
Cómo utilizar este ejemplo
Consulte el ejemplo de los métodos getFirstCharInParagraph() o setTextFormat() para ver ilustraciones sobre cómo utilizar el método getTextFormat().

isFontCompatible

()método 
public static function isFontCompatible(fontName:String, fontStyle:String):Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5, Flash Lite 4

Devuelve true si hay disponible una fuente incorporada con las propiedades fontName y fontStyle especificadas, donde Font.fontType sea flash.text.FontType.EMBEDDED. A partir de Flash Player 10, pueden aparecer dos tipos de fuentes incorporadas en un archivo SWF. Las fuentes incorporadas normales sólo se utilizan con objetos TextField. Las fuentes incorporadas CFF sólo se utilizan con las clases flash.text.engine. Los dos tipos se diferencian por la propiedad fontType de la clase Font, tal y como la devuelve la función enumerateFonts().

TextField no puede utilizar un tipo de fuente EMBEDDED_CFF. Si embedFonts se establece como true y la única fuente disponible en tiempo de ejecución con el nombre y el estilo especificados es del tipo EMBEDDED_CFF, Flash Player no podrá presentar el texto, como si no hubiera disponible ninguna fuente incorporada con ese nombre y ese estilo.

Si existen tanto EMBEDDED como EMBEDDED_CFF con el mismo nombre y estilo, se seleccionará la fuente EMBEDDED y se presentará el texto con la fuente EMBEDDED.

Parámetros

fontName:String — Nombre de la fuente incorporada que se va a comprobar.
 
fontStyle:String — Especifica el estilo de fuente que se va a comprobar. Utilice flash.text.FontStyle

Valor devuelto
Booleantrue si hay una fuente incorporada compatible. De lo contrario, se denomina false.

Emite
ArgumentError — La propiedad fontStyle especificada no es un miembro de flash.text.FontStyle.

Elementos de API relacionados

replaceSelectedText

()método 
public function replaceSelectedText(value:String):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Reemplaza la selección actual por el contenido del parámetro value. El texto se inserta en la posición de la selección actual empleando el formato de carácter predeterminado y el formato de párrafo predeterminado actuales. El texto no se crea como HTML.

Puede utilizar el método replaceSelectedText() para insertar y eliminar texto sin modificar el formato de carácter y de párrafo del resto del texto.

Nota: este método no funcionará si se aplica una hoja de estilos al campo de texto.

Parámetros

value:String — La cadena que reemplazará el texto seleccionado actualmente.


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

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, el usuario borra parte de texto del primer campo de texto seleccionándolo y sustituye un texto seleccionado en el segundo campo por la cadena "NEW TEXT".

Se crean dos objetos TextField diferentes y se añaden detectores de eventos para los eventos MouseEvent.MOUSE_UP. El evento Mouse up tiene lugar cuando el usuario suelta el ratón y normalmente sucede después de realizar la selección de un texto. Tenga en cuenta que el parámetro predeterminado del campo de texto es para que se seleccione su texto.

En el método mouseHandler1(), cuando un usuario suelta el ratón en el campo de texto myTextField1, el texto se borra sustituyéndolo por una cadena vacía. Esto puede continuar hasta que se borra todo el texto. En el método mouseHandler2(), cuando un usuario selecciona parte del texto en el campo myTextField2, se activan las propiedades selectionBeginIndex y selectionEndIndex para comprobar si se ha seleccionado algún carácter. (Las propiedades selectionBeginIndex y selectionEndIndex no tienen el mismo valor si se ha seleccionado parte del texto.) El texto seleccionado se sustituye a continuación por la cadena "NEW TEXT". Esto puede continuar hasta que todo el texto original del segundo campo de texto se sustituya por la cadena "NEW TEXT".

package {
    import flash.display.Sprite;
    import flash.text.TextField;    
    import flash.events.MouseEvent;

    public class TextField_replaceSelectedTextExample extends Sprite {
        private var myTextField1:TextField = new TextField();
        private var myTextField2:TextField = new TextField();
        
        public function TextField_replaceSelectedTextExample() {
            myTextField1.x = 10;
            myTextField1.width = 300;
            myTextField1.height = 50; 
            myTextField1.background = true; 
            myTextField1.border = true;
            myTextField1.text = "Select the text you want to remove from the line.";
            
            myTextField2.x = 10;
            myTextField2.y = 60;
            myTextField2.width = 300;
            myTextField2.height = 50;
            myTextField2.background = true;
            myTextField2.border = true;
            myTextField2.text = "Select the text you want to replace with NEW TEXT.";
            
            myTextField1.addEventListener(MouseEvent.MOUSE_UP, mouseHandler1);
            myTextField2.addEventListener(MouseEvent.MOUSE_UP, mouseHandler2);
            
            this.addChild(myTextField1);
            this.addChild(myTextField2);
        }
        
        private function mouseHandler1(e:MouseEvent):void {
            myTextField1.replaceSelectedText("");
        }

        private function mouseHandler2(e:MouseEvent):void {
            if(myTextField2.selectionBeginIndex != myTextField2.selectionEndIndex) {
                myTextField2.replaceSelectedText("NEW TEXT");    
            }
        }
    }
}

replaceText

()método 
public function replaceText(beginIndex:int, endIndex:int, newText:String):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Reemplaza el rango de caracteres especificados por los parámetros beginIndex y endIndex con el contenido del parámetro newText. Según su diseño, se sustituye el texto de beginIndex a endIndex-1.

Nota: este método no funcionará si se aplica una hoja de estilos al campo de texto.

Parámetros

beginIndex:int — El valor de índice basado en cero para la posición inicial del rango de sustitución.
 
endIndex:int — La posición del índice basado en cero del primer carácter después de un fragmento de texto.
 
newText:String — El texto que va a reemplazar al rango de caracteres especificado.


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

Ejemplo  ( Cómo utilizar este ejemplo )

El ejemplo siguiente utiliza el método replaceText() para eliminar, sustituir e insertar parte de texto en un campo de texto.

El campo de texto outputText se establece para que se ajuste automáticamente y cambie el tamaño como texto justificado a la izquierda. Con la primera llamada al método replaceText(), la primera línea ("This is the wrong heading") se sustituye por "THIS IS THE HEADING FOR EVERYONE". Con la segunda llamada al método, se inserta el texto "CORRECT" entre "THE" y "HEADING". Con la tercera llamada al método, se eliminan las palabras "FOR EVERYONE". Tenga en cuenta que con cada llamada al método appendText(), se modifican el índice del principio y del final del texto. En este caso, sólo se mostrará el texto final (después de aplicados los cambios).

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    
    public class TextField_replaceTextExample extends Sprite {

        public function TextField_replaceTextExample() {
            var outputText:TextField = new TextField();

            outputText.x = 10;
            outputText.y = 10;
            outputText.background = true;
            outputText.autoSize = TextFieldAutoSize.LEFT;
            
            outputText.appendText("This is the wrong heading");
            outputText.appendText("\n\n"); 
            outputText.appendText("This is the body of the text.");

            outputText.replaceText(0, 25, "THIS IS THE HEADING FOR EVERYONE");

            outputText.replaceText(12, 12, "CORRECT ");
            
            outputText.replaceText(27, 40, "");
            
           this.addChild(outputText);
         }
    }
}

setSelection

()método 
public function setSelection(beginIndex:int, endIndex:int):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Define como seleccionado el texto designado por los valores de índice de los primeros y últimos caracteres, especificados por los parámetros beginIndex y endIndex. Si los dos valores de parámetro coinciden, este método definirá un punto de inserción, del mismo modo que al establecer la propiedad caretIndex.

Parámetros

beginIndex:int — El valor de índice basado en cero del primer carácter de la selección (por ejemplo, el primer carácter es 0, el segundo carácter es 1, etc.).
 
endIndex:int — El valor de índice basado en cero del último carácter de la selección.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, cuando el usuario hace clic en cualquier parte del campo de texto, se seleccionará un rango de texto predefinido (con las palabras "TEXT IN ALL CAPS" resaltadas).

Dos detectores de eventos para el campo de texto myTextField responden a los clics del ratón o a los eventos de ratón soltado del usuario. El evento Mouse up tendrá lugar cuando el usuario suelte el ratón y normalmente sucede después de realizar la selección de un texto. Tenga en cuenta que el parámetro predeterminado del campo de texto es para que se seleccione su texto. Cuando se hace clic en una parte del texto, se invoca el método clickHandler(). Cuando se selecciona texto y se suelta el ratón, se invoca el método mouseUpHandler().

Tanto en los métodos clickHandler() como mouseUpHandler(), el método setSelection() establece que se seleccionen sólo los caracteres entre los índices 54 y 70 (TEXT IN ALL CAPS).

package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    
    public class TextField_setSelectionExample extends Sprite
    {
        private var myTextField:TextField = new TextField();

        public function TextField_setSelectionExample() {
            myTextField.autoSize = TextFieldAutoSize.LEFT;
            myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS is selected.";

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
            myTextField.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);

            this.addChild(myTextField);
        }

        private function clickHandler(event:MouseEvent):void {
            myTextField.setSelection(54, 70);
        }

        private function mouseUpHandler(event:MouseEvent):void {
            myTextField.setSelection(54, 70);
        }

    }
}

setTextFormat

()método 
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Aplica el formato de texto especificado por el parámetro format al texto especificado en un campo de texto. El valor de format debe ser un objeto TextFormat que especifique los cambios de formato deseados del texto. Sólo se aplican al campo de texto las propiedades de format que no tengan valor null. No se aplicará ninguna propiedad de format definida como null. De manera predeterminada, todas las propiedades del objeto TextFormat de nueva creación están configuradas con el valor null.

Nota: este método no funcionará si se aplica una hoja de estilos al campo de texto.

El método setTextFormat() cambia el formato de texto aplicado a un rango de caracteres o a todo el cuerpo del texto de un campo de texto. Para aplicar las propiedades del formato a todo el texto del campo de texto, no especifique valores para beginIndex y endIndex. Para aplicar las propiedades del formato a un rango de texto, especifique valores para los parámetros beginIndex y endIndex. Se puede utilizar la propiedad length para determinar los valores de índice.

Los dos tipos de información de formato en un objeto TextFormat son el formato de nivel de carácter y el formato de nivel de párrafo. Cada carácter de un campo de texto puede tener su propia configuración de formato de carácter, como nombre de fuente, tamaño de fuente, negrita y cursiva.

En el caso de los párrafos, se examina el primer carácter del párrafo en busca de la configuración de formato de párrafo para el párrafo completo. Margen izquierdo, margen derecho y sangría son ejemplos de configuración de formato de párrafo.

El texto insertado manualmente por el usuario o sustituido mediante el método replaceSelectedText() recibe el formato predeterminado de campo de texto para texto nuevo, no el formato especificado para el punto de inserción del texto. Para definir el formato predeterminado para texto nuevo, utilice defaultTextFormat.

Parámetros

format:flash.text:TextFormat — Un objeto TextFormat que contiene información de formato de carácter y de párrafo.
 
beginIndex:int (default = -1) — Opcional; entero que indica la posición de índice basada en cero especificando el primer carácter del rango de texto deseado.
 
endIndex:int (default = -1) — Opcional; entero que especifica el primer carácter después de un fragmento de texto. Según el diseño, si se especifican los valores beginIndex y endIndex, se actualiza el texto desde beginIndex hasta endIndex-1.

UsoDescripción
my_textField.setTextFormat(textFormat:TextFormat)Aplica las propiedades de textFormat a todo el texto del campo de texto.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int)Aplica las propiedades de textFormat al texto que comienza en la posición beginIndex.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int, endIndex:int)Aplica al fragmento de texto las propiedades del parámetro textFormat desde la posición beginIndex hasta endIndex-1.

Tenga en cuenta que el texto insertado manualmente por el usuario o sustituido mediante el método replaceSelectedText() recibe el formato predeterminado de campo de texto para texto nuevo, no el formato especificado para el punto de inserción del texto. Para definir el formato de texto predeterminado de un campo de texto, utilice la propiedad defaultTextFormat.


Emite
Error — Este método no puede utilizarse en un campo de texto con una hoja de estilos.
 
RangeError — Los elementos beginIndex o endIndex especificados están fuera de rango.

Elementos de API relacionados


Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, cuando se hace clic en el texto, un rango de texto definido, "TEXT IN ALL CAPS", cambia de formato entre el texto predeterminado y el nuevo formato.

Se añade un detector de eventos al campo de texto myTextField para que responda a los clics del ratón mediante la invocación del método clickHandler(). En el método clickHandler(), el método getTextFormat() devuelve el formato actual del carácter (índice 55) del rango del texto deseado, que se ubica a continuación en el objeto TextFormat currentTextFormat. La sentencia if comprueba el formato de texto currentTextFormat para ver si se el carácter del rango utiliza el nuevo formato (el punto de fuente se establece en 18). Si no es así, el nuevo formato cambia el tamaño a 18 puntos, el color a rojo y aplica el subrayado y la cursiva al rango de texto entre 54-70 (TEXT IN ALL CAPS). Si el carácter del rango está utilizando el nuevo formato, el formato del rango se establece de nuevo con el formato predeterminado (original) del campo de texto.

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFormat;  
    import flash.text.TextFieldAutoSize;  
    import flash.events.MouseEvent;

    public class TextField_setTextFormatExample extends Sprite {
        private var myTextField:TextField = new TextField();
        private var newFormat:TextFormat = new TextFormat();
        
        public function TextField_setTextFormatExample() {
            myTextField.autoSize = TextFieldAutoSize.LEFT;
            myTextField.selectable = false;
            myTextField.background = true;
            myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS changes format.";

            myTextField.addEventListener(MouseEvent.CLICK, clickHandler);

            newFormat.color = 0xFF0000;
            newFormat.size = 18;
            newFormat.underline = true;
            newFormat.italic = true;
                
            this.addChild(myTextField);
        }

        private function clickHandler(event:MouseEvent):void {
            var currentTextFormat:TextFormat = myTextField.getTextFormat(55);
            
            if(currentTextFormat.size != 18) {
                myTextField.setTextFormat(newFormat, 54, 70);
            }
            else {
                myTextField.setTextFormat(myTextField.defaultTextFormat);
            }    
        }    
    }
}
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
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Se emite tras modificar el valor de un control, a diferencia del evento textInput, que se emite antes de modificar el valor. Al contrario de lo que ocurre con la versión del modelo de evento W3C DOM del evento change, que se distribuye solamente cuando el control ya no está seleccionado, en ActionScript 3.0, la versión del evento change se distribuye siempre que cambia el control. Por ejemplo, si un usuario escribe texto en un campo de texto, se distribuirá un evento change cada vez que pulse una tecla.

La constante Event.CHANGE 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.
currentTargetObjeto 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.

Ejemplo  ( Cómo utilizar este ejemplo )

En el ejemplo siguiente, el texto introducido por el usuario (entrada del usuario) se copia inmediatamente (con eco) en otro campo de texto con un formato distinto.

Se crean dos campos de texto, uno para la entrada del usuario y el otro (headingTextField) para la copia de la entrada. También se crea un objeto TextFormat y se asigna al formato de texto predeterminado al campo de texto headingTextField. Cuando se modifica el contenido del campo de texto, se invoca el método changeHandler(), que asigna el texto del campo inputTextField al campo headingTextField. (Si se llamó al método para el evento TextEvent.TEXT_INPUT en lugar del evento Event.CHANGE, sólo se copiará el contenido de la entrada del usuario después de que éste haya introducido más texto.)

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldType;
    import flash.text.TextFormat;
    import flash.text.TextFormatAlign;
    import flash.events.Event;
    
    import flash.events.TextEvent;

    public class TextField_Event_changeExample extends Sprite {
        private var inputTextField:TextField = new TextField(); 
        private var headingTextField:TextField = new TextField(); 
        private var newFormat:TextFormat = new TextFormat();
         
        public function TextField_Event_changeExample() {
            headingTextField.x = 10;
            headingTextField.y = 10;
            headingTextField.height = 30;
            headingTextField.width = 400;
            headingTextField.background = true;
            headingTextField.backgroundColor = 0xF5F5DC;
            headingTextField.selectable = false;
 
            inputTextField.x = 10;
            inputTextField.y = 70;
            inputTextField.height = 20;
            inputTextField.width = 230;
            inputTextField.background = true;
            inputTextField.border = true;
            inputTextField.maxChars = 40;
            inputTextField.wordWrap = true;
            inputTextField.type = TextFieldType.INPUT;

            inputTextField.addEventListener(Event.CHANGE, changeHandler);

            newFormat.bold = true;
            newFormat.size = 18;
            newFormat.color = 0xFF0000;
            newFormat.align = TextFormatAlign.CENTER;

            headingTextField.defaultTextFormat = newFormat;

            this.addChild(inputTextField);
            this.addChild(headingTextField);
        }

        private function changeHandler(e:Event):void {
            headingTextField.text = inputTextField.text;
        }
    }
}

link

Evento  
Tipo de objeto de evento: flash.events.TextEvent
propiedad TextEvent.type = flash.events.TextEvent.LINK

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Se distribuye cuando un usuario hace clic en el hipervínculo de un campo de texto compatible con HTML, donde la URL empieza por "event:". El resto de la URL después de "event:" se coloca en la propiedad de texto del evento LINK.

Nota: el comportamiento predeterminado (añadir el texto al campo de texto) sólo se produce cuando Flash Player genera el evento (en este caso, ocurrirá cuando el usuario intente introducir texto). No se puede colocar texto en un campo de texto enviando eventos textInput.

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

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblestrue
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetEl campo de texto que contiene el hipervínculo en el que se ha hecho clic. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente.
textEl resto de la URL después de "event:"

Ejemplo  ( Cómo utilizar este ejemplo )

En el siguiente ejemplo, se define la función playMP3(). Se crea un objeto TextField denominado list y se llena con texto HTML. El texto "Track 1" y "Track 2" son vínculos dentro del campo de texto. Se llama a la función playMP3() cuando el usuario hace clic en el vínculo. El nombre del archivo MP3, que sigue a la cadena "event:" en el atributo href de la etiqueta HTML, se pasa al método linkHandler() como la propiedad text del objeto de evento link.
package {
    import flash.display.Sprite;
    import flash.errors.IOError;
    import flash.events.IOErrorEvent;
    import flash.events.TextEvent;
    import flash.media.Sound;
    import flash.media.SoundChannel;
    import flash.net.URLRequest;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class TextField_event_link extends Sprite
    {
        private var myMP3:Sound;
        public function TextField_event_link() {
            myMP3 = new Sound();
            var list:TextField = new TextField();
            list.autoSize = TextFieldAutoSize.LEFT;
            list.multiline = true;
            list.htmlText = "<a href=\"event:track1.mp3\">Track 1</a><br>";
            list.htmlText += "<a href=\"event:track2.mp3\">Track 2</a><br>";
            addEventListener(TextEvent.LINK, linkHandler);
            addChild(list);
        }
        
        private function playMP3(mp3:String):void {
            try {    
                myMP3.load(new URLRequest(mp3));
                myMP3.play();
            }
            catch(err:Error) {
                trace(err.message);
            }
            myMP3.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
        }
        
        private function linkHandler(linkEvent:TextEvent):void {
            playMP3(linkEvent.text);
        }
        
        private function errorHandler(errorEvent:IOErrorEvent):void {
            trace(errorEvent.text);
        }
    }
}

scroll

Evento  
Tipo de objeto de evento: flash.events.Event
propiedad Event.type = flash.events.Event.SCROLL

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Distribuido por un objeto TextField después de que el usuario se desplace.

La constante Event.SCROLL 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.
targetEl objeto TextField que se desplaza. La propiedad target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente.

Ejemplo  ( Cómo utilizar este ejemplo )

El ejemplo siguiente define dos objetos TextField. El primer objeto TextField tiene asociados dos controladores de eventos. Al hacer clic con el ratón dentro del primer campo de texto, se distribuye el evento mouseDown y se llama al controlador mouseDownScroll asociado. El controlador mouseDownScroll() hace que el desplazamiento en el campo sea posible. Seguidamente, se distribuye el evento scroll y el controlador scrollHandler() asociado actualiza el segundo campo de texto para mostrar la posición de desplazamiento actual.
package
{
    import flash.display.Sprite;
    import flash.text.*;
    import flash.events.Event;
    import flash.events.TextEvent;
    import flash.events.MouseEvent;

    public class TextScrollExample extends Sprite
    {
        private var myTextBox1:TextField = new TextField();
        private var myTextBox2:TextField = new TextField();
        private var myText:String = "Hello world and welcome to the show. It's really nice to meet you. Take your coat off and stay a while. OK, show is over. Hope you had fun. You can go home now. Don't forget to tip your waiter. There are mints in the bowl by the door. Thank you. Please come again.";

        public function TextScrollExample()
        {
            myTextBox1.text = myText;
            myTextBox1.width = 200;
            myTextBox1.height = 50;
            myTextBox1.multiline = true;
            myTextBox1.wordWrap = true;
            myTextBox1.background = true;
            myTextBox1.border = true;
            
            myTextBox2.x=220;
            myTextBox2.text="scrolled to line: " + myTextBox1.scrollV;

            addChild(myTextBox1);
            addChild(myTextBox2);
            myTextBox1.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownScroll);
            myTextBox1.addEventListener(Event.SCROLL, scrollHandler);
        }

        public function mouseDownScroll(event:MouseEvent):void
        {
            myTextBox1.scrollV++;
        }
        public function scrollHandler(event:Event):void
        {
           myTextBox2.text="scrolled to line: " + myTextBox1.scrollV;
        }
    }
}

textInput

Evento  
Tipo de objeto de evento: flash.events.TextEvent
propiedad TextEvent.type = flash.events.TextEvent.TEXT_INPUT

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Flash Player distribuye el evento textInput cuando un usuario escribe uno o varios caracteres de texto. Existen diferentes métodos de introducción de texto que pueden generar este evento: teclados estándar, editores de método de entrada (IME), sistemas de reconocimiento de voz e, incluso, la acción de pegar texto sin formato o información de estilos.

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:

PropiedadValor
bubblestrue
cancelabletrue; llama al método preventDefault() para cancelar el comportamiento predeterminado.
currentTargetObjeto 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.

Ejemplo  ( Cómo utilizar este ejemplo )

El ejemplo siguiente define dos objetos TextField: el primer objeto TextField es un campo de entrada de texto y el segundo objeto TextField es un campo de texto dinámico. A medida que introduce caracteres en el primer campo de texto, se distribuye el evento textInput, se llama al controlador textInputHandler() y los caracteres se visualizan en el segundo campo de texto. Al pegar un bloque de texto en el campo de entrada, el controlador de eventos copia todo el bloque en el otro campo.
package
{
    import flash.display.Sprite;
    import flash.text.*;
    import flash.events.Event;
    import flash.events.TextEvent;
    import flash.events.MouseEvent;

    public class TextInputExample extends Sprite
    {
        private var myTextBox1:TextField = new TextField();
        private var myTextBox2:TextField = new TextField();

        public function TextInputExample()
        {
            myTextBox1.type = TextFieldType.INPUT;
            myTextBox1.width = 200;
            myTextBox1.height = 20;
            myTextBox1.background = true;
            myTextBox1.border = true;
            
            myTextBox2.x=220;

            addChild(myTextBox1);
            addChild(myTextBox2);
            myTextBox1.addEventListener(TextEvent.TEXT_INPUT,textInputHandler);
        }

        public function textInputHandler(event:TextEvent):void
        {
           myTextBox2.text=event.text;
        }
    }
}

textInteractionModeChange

Evento  
Tipo de objeto de evento: flash.events.Event

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 11, Flash Lite 4

Flash Player distribuye el evento textInteractionModeChange cuando el usuario cambia el modo de interacción de un campo de texto. Por ejemplo, en Android, se puede cambiar entre el modo NORMAL y el modo SELECTION utilizando las opciones de menú contextual

TextFieldExample.as

En el ejemplo siguiente, se utiliza la clase TextFieldExample para mostrar un mensaje de texto. Esto se consigue con los pasos siguientes:
  1. Se crea una propiedad label de tipo TextField.
  2. El constructor de la clase llama a la función configureLabel().
  3. El método configureLabel() crea primero un nuevo objeto TextField y lo asigna a la propiedad label; seguidamente, define sus parámetros del modo siguiente:
    • Justifica a la izquierda el campo de texto.
    • Habilita el relleno de fondo.
    • Habilita el borde.
  4. El método configureLabel() crea la variable format y la asigna a una nueva instancia de TextFormat con los parámetros definidos del siguiente modo:
    • Tipo de fuente = Verdana
    • Color de fuente = continuo rojo
    • Tamaño de fuente = 10
    • Subrayado de fuente = true
  5. La propiedad defaultTextFormat del campo de texto label se define como format y la instancia label se añade a la lista de visualización, que muestra inicialmente un campo de texto sin texto en el escenario.
  6. El constructor establece el texto del campo de texto label en "Hello world and welcome to the show". mediante una llamada al método setLabel().
package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.text.TextFormat;


    public class TextFieldExample extends Sprite {
        private var label:TextField;
        private var labelText:String = "Hello world and welcome to the show.";

        public function TextFieldExample() {
            configureLabel();
            setLabel(labelText);
        }

        public function setLabel(str:String):void {
            label.text = str;
        }

        private function configureLabel():void {
            label = new TextField();
            label.autoSize = TextFieldAutoSize.LEFT;
            label.background = true;
            label.border = true;

            var format:TextFormat = new TextFormat();
            format.font = "Verdana";
            format.color = 0xFF0000;
            format.size = 10;
            format.underline = true;

            label.defaultTextFormat = format;
            addChild(label);
        }
    }
}




[ X ]¿Por qué hay texto en inglés?
Cierto contenido de la Referencia de ActionScript 3.0 se muestra en inglés

No todo el contenido de la Referencia de ActionScript 3.0 se traduce a todos los idiomas. Si un elemento del lenguaje no se traduce, aparecerá en inglés. Por ejemplo, la clase ga.controls.HelpBox no está traducida en ningún idioma. Por lo tanto, en la versión en español de la referencia, la clase ga.controls.HelpBox aparecerá en inglés.