Referência do ActionScript® 3.0 para Adobe® Flash® Platform
Início  |  Ocultar listas de Pacotes e Classes |  Pacotes  |  Classes  |  Novidades  |  Índice  |  Apêndices  |  Por que inglês?
Filtros: AIR 30.0 e anterior, Flash Player 30.0 e anterior, Flash Lite 4
Flex 4.6 e anterior, Flash Pro CS6 e anterior
Ocultar filtros
flash.text 

TextField  - AS3

Pacotesx

Nível 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 de linguagem

Constantes globais
Funções globais
Operadores
Instruções, palavras-chave e diretivas
Tipos especiais

Apêndices

Novidades
Erros do compilador
Avisos do compilador
Erros de runtime
Migrando para o ActionScript 3
Conjuntos de caracteres suportados
Tags MXML apenas
Elementos XML de movimento
Marcas de texto cronometradas
Lista de elementos deprecados
Constantes de Implementação de Acessibilidade
Como Usar Exemplos do ActionScript
Aspectos jurídicos
Pacoteflash.text
Classepublic class TextField
HerançaTextField Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Subclasses FlexTextField

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

A classe TextField é utilizada para criar objetos de exibição para exibição de texto e entrada. No Inspetor de propriedades, você pode dar a um campo de texto um nome de ocorrência e utilizar os métodos e as propriedades da classe TextField para manipulá-lo com o ActionScript. Nomes de ocorrência de TextField são exibidos no Explorador de filmes e na caixa de diálogo Inserir demarcador de destino do painel Ações.

Para criar um campo de texto dinamicamente, utilize o construtor TextField().

Os métodos da classe TextField permitem definir, selecionar e manipular texto em um campo dinâmico ou de entrada de texto criado durante a criação ou em tempo de execução.

ActionScript fornece várias maneiras de formatar seu texto em tempo de execução. A classe TextFormat permite definir a formatação de caractere e parágrafo para objetos TextField. Você pode aplicar estilos CSS (Páginas de estilo em cascata) a campos de texto, utilizando a propriedade TextField.styleSheet e a classe StyleSheet. Você pode utilizar CSS para aplicar um estilo a marcas HTML embutidas, definir novas marcas de formatação ou aplicar estilos. Você pode atribuir texto formatado em HTML, que pode usar estilos CSS como opção, diretamente a um campo de texto. O texto HTML atribuído a um campo de texto pode conter mídia incorporada (clipes de vídeo, arquivos SWF, arquivos GIF, arquivos PNG e arquivos JPEG). O texto é disposto na mídia incorporada da mesma maneira que um navegador da Web dispõe o texto na mídia incorporada em um documento HTML.

O Flash Player oferece suporte a um subconjunto de marcas HTML que você pode utilizar para formatar texto. Consulte a lista de marcas HTML suportadas na descrição da propriedade htmlText.

Veja os exemplos

Elementos da API relacionados



Propriedades públicas
 PropriedadeDefinido por
 InheritedaccessibilityImplementation : AccessibilityImplementation
A implementação de acessibilidade atual (AccessibilityImplementation) para esta instância do InteractiveObject.
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
As opções de acessibilidade atuais para este objeto de exibição.
DisplayObject
 Inheritedalpha : Number
Indica o valor de transparência alfa do objeto especificado.
DisplayObject
  alwaysShowSelection : Boolean
Quando definida como true e o campo de texto não está em foco, o Flash Player realça a seleção no campo de texto em cinza.
TextField
  antiAliasType : String
O tipo de suavização de borda utilizado para esse campo de texto.
TextField
  autoSize : String
Controla o dimensionamento e o alinhamento automáticos de campos de texto.
TextField
  background : Boolean
Especifica se o campo de texto tem um preenchimento de plano de fundo.
TextField
  backgroundColor : uint
A cor do plano de fundo do campo de texto.
TextField
 InheritedblendMode : String
Um valor a partir da classe BlendMode que especifica o modo de mesclagem a ser usado.
DisplayObject
 InheritedblendShader : Shader
[somente gravação] Define um shader usado para mesclar o primeiro plano e o segundo plano.
DisplayObject
  border : Boolean
Especifica se o campo de texto tem uma borda.
TextField
  borderColor : uint
A cor da borda do campo de texto.
TextField
  bottomScrollV : int
[somente leitura] Um inteiro (índice com base 1) que indica a linha na extremidade inferior que está atualmente visível no campo de texto especificado.
TextField
 InheritedcacheAsBitmap : Boolean
Se definido como true, tempo de execução do Flash armazenará em cachê uma representação interna em bitmap do objeto de exibição.
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
Se não nulo, este objeto Matrix definirá como um objeto exibição será renderizado quando cacheAsBitmap for definido como verdadeiro.
DisplayObject
  caretIndex : int
[somente leitura] O índice da posição do ponto de inserção (circunflexo).
TextField
  condenseWhite : Boolean
Um valor booliano que especifica se o espaço em branco extra (espaços, quebras de linha, etc.) em um campo de texto com texto HTML deve ser removido.
TextField
 Inheritedconstructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.
Object
 InheritedcontextMenu : NativeMenu
Especifica o menu de contexto associado a este objeto.
InteractiveObject
  defaultTextFormat : flash.text:TextFormat
Especifica o formato aplicado ao texto recém-inserido, por exemplo, o texto inserido com o método replaceSelectedText() ou o texto digitado pelo usuário.
TextField
  displayAsPassword : Boolean
Especifica se o campo de texto é um campo de texto de senha.
TextField
 InheriteddoubleClickEnabled : Boolean
Especifica se o objeto recebe eventos doubleClick.
InteractiveObject
  embedFonts : Boolean
Especifica se a renderização será feita com o uso de contornos de fontes incorporadas.
TextField
 Inheritedfilters : Array
Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição.
DisplayObject
 InheritedfocusRect : Object
Especifica se este objeto exibe um retângulo de foco.
InteractiveObject
  gridFitType : String
O tipo de ajuste à grade utilizado para esse campo de texto.
TextField
 Inheritedheight : Number
Indica a altura do objeto de exibição, em pixels.
DisplayObject
  htmlText : String
Contém a representação HTML do conteúdo do campo de texto.
TextField
  length : int
[somente leitura] O número de caracteres em um campo de texto.
TextField
 InheritedloaderInfo : LoaderInfo
[somente leitura] Retorna um objeto LoaderInfo contendo informações sobre o carregamento do arquivo ao qual esse objeto de exibição pertence.
DisplayObject
 Inheritedmask : DisplayObject
O objeto de exibição de chamada é mascarado pelo objeto "mask" especificado.
DisplayObject
  maxChars : int
O número máximo de caracteres que o campo de texto pode conter, conforme digitado por um usuário.
TextField
  maxScrollH : int
[somente leitura] O valor máximo de scrollH.
TextField
  maxScrollV : int
[somente leitura] O valor máximo de scrollV.
TextField
 InheritedmetaData : Object
Obtém o objeto de metadados da instância DisplayObject se os metadados forem armazenados juntamente com a instância desse DisplayObject no arquivo SWF por uma marca PlaceObject4.
DisplayObject
 InheritedmouseEnabled : Boolean
Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários.
InteractiveObject
  mouseWheelEnabled : Boolean
Um valor booliano que indica se o Flash Player deverá rolar automaticamente os campos de texto de várias linhas quando o usuário clicar em um campo de texto e usar o botão de rolagem do mouse.
TextField
 InheritedmouseX : Number
[somente leitura] Indica a coordenada x da posição do dispositivo do mouse ou de entrada do usuário, em pixels.
DisplayObject
 InheritedmouseY : Number
[somente leitura] Indica a coordenada y da posição do dispositivo do mouse ou de entrada do usuário, em pixels.
DisplayObject
  multiline : Boolean
Indica se o campo é um campo de texto de várias linhas.
TextField
 Inheritedname : String
Indica o nome da ocorrência de DisplayObject.
DisplayObject
 InheritedneedsSoftKeyboard : Boolean
Especifica se um teclado virtual (teclado de software, na tela) deve ser exibido quando esta instância InteractiveObject recebe foco.
InteractiveObject
  numLines : int
[somente leitura] Define o número de linhas de texto em um campo de texto de várias linhas.
TextField
 InheritedopaqueBackground : Object
Especifica se o objeto de exibição é opaco com uma certa cor de plano de fundo.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[somente leitura] Indica o objeto DisplayObjectContainer que contém esse objeto de exibição.
DisplayObject
  restrict : String
Indica o conjunto de caracteres que um usuário pode digitar no campo de texto.
TextField
 Inheritedroot : DisplayObject
[somente leitura] Para um objeto de exibição em um arquivo SWF carregado, a propriedade "root" é o objeto de exibição na extremidade superior, na parte da estrutura em árvore da lista de exibição representada por esse arquivo SWF.
DisplayObject
 Inheritedrotation : Number
Indica o giro da ocorrência de DisplayObject, em graus, a partir da sua orientação original.
DisplayObject
 InheritedrotationX : Number
Indica a rotação do eixo x da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent.
DisplayObject
 InheritedrotationY : Number
Indica a rotação do eixo y da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent.
DisplayObject
 InheritedrotationZ : Number
Indica a rotação do eixo z da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent.
DisplayObject
 Inheritedscale9Grid : Rectangle
A grade de dimensionamento atual que está em vigor.
DisplayObject
 InheritedscaleX : Number
Indica a escala horizontal (porcentagem) do objeto aplicada a partir do ponto de registro.
DisplayObject
 InheritedscaleY : Number
Indica a escala vertical (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto.
DisplayObject
 InheritedscaleZ : Number
Indica a escala de profundidade (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto.
DisplayObject
  scrollH : int
A posição de rolagem horizontal atual.
TextField
 InheritedscrollRect : Rectangle
Os limites do retângulo de rolagem do objeto de exibição.
DisplayObject
  scrollV : int
A posição vertical do texto em um campo de texto.
TextField
  selectable : Boolean
Um valor booliano que indica se o campo de texto é selecionável.
TextField
  selectionBeginIndex : int
[somente leitura] O valor de índice de caractere com base em zero do primeiro caractere na seleção atual.
TextField
  selectionEndIndex : int
[somente leitura] O valor de índice de caractere com base em zero do último caractere na seleção atual.
TextField
  sharpness : Number
A nitidez das bordas de glifo neste campo de texto.
TextField
 Inherited    softKeyboard : String
Controla a aparência do teclado suave.
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
Define a área que deve permanecer na tela quando um teclado virtual for exibido (não disponível no iOS)
InteractiveObject
 Inheritedstage : Stage
[somente leitura] O Palco do objeto de exibição.
DisplayObject
  styleSheet : StyleSheet
Anexa uma folha de estilo ao campo de texto.
TextField
 InheritedtabEnabled : Boolean
Especifica se este objeto está na ordem de tabulação.
InteractiveObject
 InheritedtabIndex : int
Especifica a ordem de tabulação de objetos em um arquivo SWF.
InteractiveObject
  text : String
Uma string que é o texto atual no campo de texto.
TextField
  textColor : uint
A cor do texto em um campo de texto, em formato hexadecimal.
TextField
  textHeight : Number
[somente leitura] A altura do texto, em pixels.
TextField
  textInteractionMode : String
[somente leitura] A propriedade de modo de interação, cujo valor padrão é TextInteractionMode.NORMAL.
TextField
  textWidth : Number
[somente leitura] A largura do texto, em pixels.
TextField
  thickness : Number
A espessura das bordas de glifo neste campo de texto.
TextField
 Inheritedtransform : flash.geom:Transform
Um objeto com propriedades relacionadas aos limites de pixels, matriz e transformação de cores de um objeto de exibição.
DisplayObject
  type : String
O tipo do campo de texto.
TextField
  useRichTextClipboard : Boolean
Especifica se a formatação do texto será ou não copiada e colada junto com o texto.
TextField
 Inheritedvisible : Boolean
Se o objeto de exibição está ou não visível.
DisplayObject
 Inheritedwidth : Number
Indica a largura do objeto de exibição, em pixels.
DisplayObject
  wordWrap : Boolean
Um valor booliano que indica se o campo de texto tem quebra automática.
TextField
 Inheritedx : Number
Indica a coordenada x da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai.
DisplayObject
 Inheritedy : Number
Indica a coordenada y da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai.
DisplayObject
 Inheritedz : Number
Indica a posição da coordenada z ao longo do eixo z da ocorrência DisplayObject em relação ao contêiner 3D pai.
DisplayObject
Métodos públicos
 MétodoDefinido por
  
Cria uma nova ocorrência de TextField.
TextField
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.
EventDispatcher
  
Acrescenta a string especificada pelo parâmetro newText ao final do texto do campo de texto.
TextField
 Inherited
Envia um evento para o fluxo de eventos.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace.
DisplayObject
  
Retorna um retângulo que é a caixa delimitadora do caractere.
TextField
  
Retorna o valor de índice com base em zero do caractere no ponto especificado pelos parâmetros x e y.
TextField
  
Tendo sido fornecido um índice de caractere, retorna o índice do primeiro caractere no mesmo parágrafo.
TextField
  
Retorna uma referência DisplayObject para o id especificado, para uma imagem ou arquivo SWF que foi adicionado a um campo de texto formatado em HTML com o uso da marca <img>.
TextField
  
Retorna o valor de índice com base em zero da linha no ponto especificado pelos parâmetros x e y.
TextField
  
Retorna o valor de índice com base em zero da linha contendo o caractere especificado pelo parâmetro charIndex.
TextField
  
getLineLength(lineIndex:int):int
Retorna o número de caracteres em uma linha de texto específica.
TextField
  
Retorna informações de métrica de uma determinada linha de texto.
TextField
  
getLineOffset(lineIndex:int):int
Retorna o índice de caractere do primeiro caractere na linha que o parâmetro lineIndex especifica.
TextField
  
Retorna o texto da linha especificada pelo parâmetro lineIndex.
TextField
  
Tendo sido fornecido um índice de caractere, retorna o tamanho do parágrafo contendo o caractere específico.
TextField
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Retorna um retângulo que define o limite do objeto de exibição, com base no sistema de coordenadas definido pelo parâmetro espaçoCoordenadasDestino, excluindo quaisquer traçados em formas.
DisplayObject
  
getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Retorna um objeto TextFormat que contém informações de formatação do intervalo de texto especificado pelos parâmetros beginIndex e endIndex.
TextField
 Inherited
Converte o objeto de ponto a partir de coordenadas de Palco (globais) em coordenadas do objeto de exibição (locais).
DisplayObject
 Inherited
Converte um ponto bidimensional das coordenadas do Palco (globais) em coordenadas do objeto de exibição tridimensional (locais).
DisplayObject
 Inherited
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.
EventDispatcher
 Inherited
Indica se um objeto tem uma propriedade especificada definida.
Object
 Inherited
Avalia a caixa delimitadora do objeto de exibição para ver se ela sobrepõe ou faz interseção com a caixa delimitadora do objeto de exibição obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Avalia o objeto de exibição para ver se ele sobrepõe ou faz interseção com o ponto especificado pelos parâmetros x e y.
DisplayObject
  
isFontCompatible(fontName:String, fontStyle:String):Boolean
[estático] Retorna true se uma fonte incorporada estiver disponível com os parâmetros fontName e fontStyle especificados, em que Font.fontType é flash.text.FontType.EMBEDDED.
TextField
 Inherited
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.
Object
 Inherited
Converte um ponto tridimensional das coordenadas (locais) do objeto de exibição tridimensional em ponto bidimensional das coordenadas (globais) do Palco.
DisplayObject
 Inherited
Converte o objeto de ponto a partir das coordenadas do objeto de exibição (locais) em coordenadas do Palco (globais).
DisplayObject
 Inherited
Indica se a propriedade especificada existe e é enumerável.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Remove um ouvinte do objeto EventDispatcher.
EventDispatcher
  
Substitui a seleção atual pelo conteúdo do parâmetro value.
TextField
  
replaceText(beginIndex:int, endIndex:int, newText:String):void
Substitui o intervalo de caracteres especificado pelos parâmetros beginIndex e endIndex pelo conteúdo do parâmetro newText.
TextField
 Inherited
Ativa um teclado virtual.
InteractiveObject
 Inherited
Define a disponibilidade de uma propriedade dinâmica para operações de repetição.
Object
  
setSelection(beginIndex:int, endIndex:int):void
Define, conforme selecionado, o texto designado pelos valores de índice do primeiro e último caracteres, que são especificados com os parâmetros beginIndex e endIndex.
TextField
  
setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Aplica a formatação de texto determinada pelo parâmetro format ao texto especificado em um campo de texto.
TextField
 Inherited
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.
Object
 Inherited
Retorna a representação de string do objeto especificado.
Object
 Inherited
Retorna o valor primitivo do objeto especificado.
Object
 Inherited
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.
EventDispatcher
Eventos
 Evento Resumo Definido por
 Inherited[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo.EventDispatcher
 InheritedDespachado quando um objeto de exibição é adicionado à lista de exibição.DisplayObject
 InheritedDespachado quando um objeto de exibição é adicionado à lista de exibição no palco, seja diretamente ou através da adição de uma subárvore na qual esse objeto de exibição está contido.DisplayObject
  Despachado depois que um valor de controle é modificado, ao contrário do evento textInput, que é despachado antes de o valor ser modificado.TextField
 InheritedDespachado quando o usuário seleciona "Clear" (ou "Delete") no menu de contexto do texto.InteractiveObject
 InheritedDespachado quando um usuário pressiona e solta o botão principal do dispositivo apontador sobre o mesmo InteractiveObject.InteractiveObject
 Inherited
    contextMenu
Despachado quando uma ação do usuário seleciona o menu de contexto associado a esse objeto interativo em um aplicativo do AIR.InteractiveObject
 InheritedDespachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de copiar ou seleciona "Copy" no menu de contexto do texto.InteractiveObject
 InheritedDespachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de cortar ou seleciona "Cut" no menu de contexto do texto.InteractiveObject
 Inherited[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo.EventDispatcher
 InheritedDespachado quando um usuário pressiona e solta o botão principal de um dispositivo apontador duas vezes em rápida sucessão sobre o mesmo InteractiveObject quando o sinalizador doubleClickEnabled desse objeto está definido como "true".InteractiveObject
 Inherited[evento de transmissão] Despachado quando o indicador de reprodução está entrando em um novo quadro.DisplayObject
 Inherited[evento de transmissão] Despachado quando o indicador de reprodução está deixando o quadro atual.DisplayObject
 InheritedDespachado depois que um objeto de exibição ganha foco.InteractiveObject
 InheritedDespachado depois que um objeto de exibição perde o foco.InteractiveObject
 Inherited[evento de transmissão] Despachado depois que são executados os construtores dos objetos de exibição de quadro, mas antes dos scripts.DisplayObject
 InheritedEnviado quando um usuário cria um ponto de contato na borda da superfície de toque com uma instância InteractiveObject (como tocar na borda da superfície de toque no Siri Remote da Apple TV). Alguns dispositivos também podem interpretar esse contato como uma combinação de vários eventos de toque.InteractiveObject
 InheritedDespachado quando o usuário aperta dois pontos de contato na mesma instância InteractiveObject em um dispositivo ativado pelo toque (como pressionar e soltar dois dedos em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário move um ponto de contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como mover os dedos da esquerda para a direita em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário executa uma rotação em um ponto do contato com uma instância InteractiveObject (como tocar com dois dedos e rodá-los em cima de um objeto da tela em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário executa um gesto de arrastar em um ponto de contato com uma instância InteractiveObject (como tocar três dedos em uma tela e depois movê-los em paralelo sobre um objeto de exposição em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário cria um ponto do contato com uma instância InteractiveObject, depois toca com um dispositivo ativado pelo toque (como colocar vários dedos em um objeto da tela para abrir um menu e depois toca com um dedo para selecionar um item do menu em um celular ou tablet com tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário executa um zoom em um ponto do contato com uma instância InteractiveObject (como tocar dois dedos em uma tela e depois abrir os dedos por cima de um objeto de exposição em um celular ou tablet com uma tela de toque).InteractiveObject
 InheritedEste evento é despachado para qualquer aplicativo cliente que suporte a entrada incorporada com um IMEInteractiveObject
 InheritedDespachado quando o usuário pressiona uma tecla.InteractiveObject
 InheritedDespachado quando o usuário tenta alterar o foco usando a navegação pelo teclado.InteractiveObject
 InheritedDespachado quando o usuário solta uma tecla.InteractiveObject
  Despachado quando um usuário clica em um hiperlink em um campo de texto habilitado para HTML, em que o URL começa com "event:".TextField
 InheritedDespachado quando um usuário pressiona e libera o botão do meio do dispositivo apontador sobre o mesmo InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário pressiona o botão do meio do dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário tenta alterar o foco usando um dispositivo apontador.InteractiveObject
 InheritedDespachado quando um usuário move o dispositivo apontador enquanto ele está sobre InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando a roda do mouse rola sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado pelo iniciador de arrasto InteractiveObject quando o usuário libera o gesto de arrastar.InteractiveObject
 InheritedDespachado pelo InteractiveObject de destino quando um objeto arrastado é solto nele e a liberação tiver sido aceita com uma chamada para DragManager.acceptDragDrop().InteractiveObject
 InheritedDespachado por um InteractiveObject quando o gesto de arrasto entra no respectivo limite.InteractiveObject
 InheritedDespachado por um InteractiveObject quando o gesto de arrasto deixa o respectivo limite.InteractiveObject
 InheritedDespachado continuamente por um InteractiveObject enquanto o gesto de arrasto permanecer dentro do respectivo limite.InteractiveObject
 InheritedDespachado no início de uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag().InteractiveObject
 InheritedDespachado durante uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag().InteractiveObject
 InheritedDespachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de colar ou seleciona "Paste" no menu de contexto do texto.InteractiveObject
 InheritedDespachado quando o usuário abaixa um estilo ativo para além do limite de detecção de proximidade da tela.InteractiveObject
 Inherited
    proximityEnd
Despachado quando o usuário levanta um estilo ativo acima do limite de detecção de proximidade da tela.InteractiveObject
 InheritedDespachado quando o usuário move um estilo ativo sobre a tela enquanto permanece dentro do limite de detecção de proximidade.InteractiveObject
 Inherited
    proximityOut
Despachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela.InteractiveObject
 InheritedDespachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela.InteractiveObject
 InheritedDespachado quando o usuário move um estilo ativo deste InteractiveObject e algum de seus filhos enquanto permanece dentro do limite de detecção de proximidade da tela.InteractiveObject
 InheritedDespachado quando o usuário move um estilo ativo sobre este InteractiveObject do exterior da árvore do objeto de descendentes na lista de exibição (enquanto permanece dentro do limite de detecção de proximidade da tela).InteractiveObject
 InheritedEnviado quando um usuário solta o botão no dispositivo apontador depois que o usuário primeiro pressionou o botão sobre uma instância de InteractiveObject e moveu o dispositivo apontador de da instância para fora do InteractiveObject.InteractiveObject
 InheritedDespachado quando um objeto de exibição está prestes a ser removido da lista de exibição.DisplayObject
 InheritedDespachado quando um objeto de exibição está prestes a ser removido da lista de exibição, seja diretamente ou através da remoção de uma subárvore na qual esse objeto de exibição está contido.DisplayObject
 Inherited[evento de transmissão] Despachado quando a lista de exibição está prestes a ser atualizada e renderizada.DisplayObject
 InheritedDespachado quando um usuário pressiona e libera o botão direito do dispositivo apontador sobre o mesmo InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject.InteractiveObject
 InheritedDespachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject.InteractiveObject
  Despachado por um objeto TextField após a rolagem pelo usuário.TextField
 InheritedDespachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de selecionar tudo ou seleciona "Select All" no menu de contexto do texto.InteractiveObject
 InheritedDespachado imediatamente depois que o teclado virtual é elevado.InteractiveObject
 InheritedDespachado imediatamente antes de o teclado virtual ser elevado.InteractiveObject
 InheritedDespachado imediatamente depois que o teclado virtual é baixado.InteractiveObject
 InheritedDespachado quando o valor do sinalizador tabChildren do objeto é alterado.InteractiveObject
 InheritedDespachado quando o sinalizador tabEnabled do objeto é alterado.InteractiveObject
 InheritedDespachado quando o valor da propriedade tabIndex do objeto é alterado.InteractiveObject
  O Flash Player despacha o evento textInput quando um usuário digita um ou mais caracteres de texto.TextField
  O Flash Player emite o evento textInteractionModeChange quando o usuário altera o modo de interação de um campo de texto.TextField
 InheritedDespachado quando o usuário entra em contato pela primeira vez com um dispositivo ativado pelo toque (como tocar com um dedo um celular ou tablet com uma tela sensível toque).InteractiveObject
 InheritedDespachado quando o usuário remove o contato com um dispositivo ativado pelo toque (como retirar o dedo de um celular ou tablet com uma tela de toque).InteractiveObject
 InheritedDespachado quando o usuário toca o dispositivo, e é despachado continuamente até que o ponto contato seja removido.InteractiveObject
 InheritedDespachado quando o usuário move o ponto do contato longe da instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para outro em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário move o ponto do contato longe de uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para um ponto fora do objeto da tela em um celular ou tablet com uma tela sensível toque).InteractiveObject
 InheritedDespachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
 InheritedDespachado quando o usuário levanta o ponto do contato na mesma instância InteractiveObject em que o contato foi iniciado em um dispositivo ativado pelo toque (como pressionar e soltar com o dedo um ponto único em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).InteractiveObject
Detalhes da propriedade

alwaysShowSelection

propriedade
alwaysShowSelection:Boolean

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Quando definida como true e o campo de texto não está em foco, o Flash Player realça a seleção no campo de texto em cinza. Quando definida como false e o campo de texto não está em foco, o Flash Player não realça a seleção no campo de texto.

O valor padrão é false.



Implementação
    public function get alwaysShowSelection():Boolean
    public function set alwaysShowSelection(value:Boolean):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
Compile e execute o seguinte arquivo. Quando você executa o arquivo, arraste para selecionar o texto em cada um dos dois campos de texto e observe a diferença no realce da seleção quando você seleciona o texto nos dois campos de texto (alterando o foco):
    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

propriedade 
antiAliasType:String

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9

O tipo de suavização de borda utilizado para esse campo de texto. Utilize as constantes de flash.text.AntiAliasType para essa propriedade. Você poderá controlar essa definição apenas se a fonte estiver incorporada (com a propriedade embedFonts definida como true). A definição padrão é flash.text.AntiAliasType.NORMAL.

Para definir valores para essa propriedade, utilize os seguintes valores de string:

Valor de stringDescrição
flash.text.AntiAliasType.NORMALAplica a suavização de borda de texto regular. Este valor corresponde ao tipo de suavização de borda que o Flash Player 7 e versões anteriores usavam.
flash.text.AntiAliasType.ADVANCEDAplica a suavização de borda avançada, que torna o texto mais legível. (Esse recurso tornou-se disponível no Flash Player 8.) A suavização de borda avançada possibilita a renderização de alta qualidade das faces de fonte em tamanhos pequenos. É melhor utilizada com aplicativos que têm uma grande quantidade de texto pequeno. A suavização de borda avançada não é recomendada para fontes superiores a 48 pontos.



Implementação
    public function get antiAliasType():String
    public function set antiAliasType(value:String):void

Elementos da API relacionados

autoSize

propriedade 
autoSize:String

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Controla o dimensionamento e o alinhamento automáticos de campos de texto. Valores aceitáveis para as constantes TextFieldAutoSize: TextFieldAutoSize.NONE (padrão), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT e TextFieldAutoSize.CENTER.

Se autoSize for definido como TextFieldAutoSize.NONE (padrão), nenhum redimensionamento ocorrerá.

Se autoSize for definido como TextFieldAutoSize.LEFT, o texto será tratado como texto justificado à esquerda; ou seja, a margem esquerda do campo de texto permanecerá fixa e o redimensionamento de uma linha única do campo de texto ocorrerá na margem direita. Se o texto incluir uma quebra de linha (por exemplo, "\n" ou "\r"), a parte inferior também será redimensionada para caber na próxima linha de texto. Se wordWrap também estiver definido como true, apenas a parte inferior do campo de texto será redimensionada e o lado direito permanecerá fixo.

Se autoSize for definido como TextFieldAutoSize.RIGHT, o texto será tratado como texto justificado à direita; ou seja, a margem direita do campo de texto permanecerá fixa e o redimensionamento de uma linha única do campo de texto ocorrerá na margem esquerda. Se o texto incluir uma quebra de linha (por exemplo, "\n" ou "\r"), a parte inferior também será redimensionada para caber na próxima linha de texto. Se wordWrap também estiver definido como true, apenas a parte inferior do campo de texto será redimensionada e o lado esquerdo permanecerá fixo.

Se autoSize for definido como TextFieldAutoSize.CENTER, o texto será tratado como texto justificado no centro; ou seja, qualquer redimensionamento de uma linha única do campo de texto será igualmente distribuído nas margens direita e esquerda. Se o texto incluir uma quebra de linha (por exemplo, "\n" ou "\r"), a parte inferior também será redimensionada para caber na próxima linha de texto. Se wordWrap também estiver definido como true, apenas a parte inferior do campo de texto será redimensionada e os lados esquerdo e direito permanecerão fixos.



Implementação
    public function get autoSize():String
    public function set autoSize(value:String):void

Lança
ArgumentError — O autoSize especificado não é um membro de flash.text.TextFieldAutoSize.

Elementos da API relacionados

background

propriedade 
background:Boolean

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Especifica se o campo de texto tem um preenchimento de plano de fundo. Se true, o campo de texto terá um preenchimento de plano de fundo. Se false, o campo de texto não terá um preenchimento de plano de fundo. Utilize a propriedade backgroundColor para definir a cor do plano de fundo de um campo de texto.

O valor padrão é false.



Implementação
    public function get background():Boolean
    public function set background(value:Boolean):void

Elementos da API relacionados

backgroundColor

propriedade 
backgroundColor:uint

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

A cor do plano de fundo do campo de texto. O valor padrão é 0xFFFFFF (branco). Essa propriedade poderá ser recuperada ou definida, mesmo se, no momento, não houver um plano de fundo. Mas, a cor ficará visível apenas se o campo de texto tiver a propriedade background definida como true.



Implementação
    public function get backgroundColor():uint
    public function set backgroundColor(value:uint):void

Elementos da API relacionados

border

propriedade 
border:Boolean

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Especifica se o campo de texto tem uma borda. Se true, o campo de texto terá uma borda. Se false, o campo de texto não terá uma borda. Utilize a propriedade borderColor para definir a cor da borda.

O valor padrão é false.



Implementação
    public function get border():Boolean
    public function set border(value:Boolean):void

Elementos da API relacionados

borderColor

propriedade 
borderColor:uint

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

A cor da borda do campo de texto. O valor padrão é 0x000000 (preto). Essa propriedade poderá ser recuperada ou definida, mesmo se, no momento, não houver uma borda. Mas, a cor ficará visível apenas se o campo de texto tiver a propriedade border definida como true.



Implementação
    public function get borderColor():uint
    public function set borderColor(value:uint):void

Elementos da API relacionados

bottomScrollV

propriedade 
bottomScrollV:int  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Um inteiro (índice com base 1) que indica a linha na extremidade inferior que está atualmente visível no campo de texto especificado. Considere o campo de texto como uma janela em um bloco de texto. A propriedade scrollV é o índice com base 1 da linha visível mais alta na janela.

Todo o texto entre as linhas indicadas por scrollV e bottomScrollV está visível no momento no campo de texto.



Implementação
    public function get bottomScrollV():int

Elementos da API relacionados

caretIndex

propriedade 
caretIndex:int  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

O índice da posição do ponto de inserção (circunflexo). Se nenhum ponto de inserção for exibido, o valor será a posição em que ponto de inserção estaria se você restaurasse o foco para o campo (normalmente, onde o ponto de inserção estava ou 0 se o campo não teve foco).

Os índices de extensão da seleção têm base em zero (por exemplo, a primeira posição é 0, a segunda posição é 1 e assim por diante).



Implementação
    public function get caretIndex():int

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
Neste exemplo, uma ocorrência de TextField é criada e preenchida com texto. Um ouvinte de evento é atribuído para que quando o usuário clicar no TextField, o método printCursorPosition seja chamado. Nesse caso, os valores das propriedades caretIndex, selectionBeginIndex e selectionEndIndex são apresentados.

Execute esse exemplo e tente clicar no TextField para selecionar o texto. Em seguida, clique no campo sem selecionar o texto. Quando você clica no texto sem fazer uma seleção, a propriedade caretIndex indica onde ocorre o ponto de inserção e as propriedades selectionBeginIndex e selectionEndIndex se igualam ao valor da propriedade 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

propriedade 
condenseWhite:Boolean

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Um valor booliano que especifica se o espaço em branco extra (espaços, quebras de linha, etc.) em um campo de texto com texto HTML deve ser removido. O valor padrão é false. A propriedade condenseWhite afeta apenas o texto definido com a propriedade htmlText, não a propriedade text. Se você definir o texto com a propriedade text, condenseWhite será ignorado.

Se condenseWhite for definido como true, use os comandos HTML padrão, como <BR> e <P>, para colocar quebras de linha no campo de texto.

Defina a propriedade condenseWhite antes da propriedade htmlText.



Implementação
    public function get condenseWhite():Boolean
    public function set condenseWhite(value:Boolean):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O seguinte mostra a diferença entre a definição de condenseWhite como false e 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

propriedade 
defaultTextFormat:flash.text:TextFormat

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Especifica o formato aplicado ao texto recém-inserido, por exemplo, o texto inserido com o método replaceSelectedText() ou o texto digitado pelo usuário.

Observação: na seleção de caracteres que serão substituídos por setSelection() e replaceSelectedText(), o defaultTextFormat só será aplicado se o texto tiver sido selecionado até e inclusive o último caractere. Veja um exemplo:

     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");
     

Quando você acessa a propriedade defaultTextFormat, o objeto TextFormat retornado tem todas as sua propriedades definidas. Nenhuma propriedade é null.

Observação: não será possível definir essa propriedade se uma folha de estilo for aplicada ao campo de texto.



Implementação
    public function get defaultTextFormat():flash.text:TextFormat
    public function set defaultTextFormat(value:flash.text:TextFormat):void

Lança
Error — Este método não pode ser utilizado em um campo de texto com uma folha de estilo.

Elementos da API relacionados

displayAsPassword

propriedade 
displayAsPassword:Boolean

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Especifica se o campo de texto é um campo de texto de senha. Se o valor dessa propriedade for true, o campo de texto será tratado como um campo de texto de senha e ocultará os caracteres digitados utilizando asteriscos, em vez dos próprios caracteres. Se false, o campo de texto não será tratado como um campo de texto de senha. Quando o modo de senha for ativado, os comandos Recortar e Copiar e seus atalhos de teclado correspondentes não funcionarão. Esse mecanismo de segurança impede que um usuário inescrupuloso utilize os atalhos para descobrir uma senha em um computador desprotegido.

O valor padrão é false.



Implementação
    public function get displayAsPassword():Boolean
    public function set displayAsPassword(value:Boolean):void

embedFonts

propriedade 
embedFonts:Boolean

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Especifica se a renderização será feita com o uso de contornos de fontes incorporadas. Se false, o Flash Player renderizará o campo de texto utilizando fontes de dispositivo.

Se você definir a propriedade embedFonts como true para um campo de texto, será necessário especificar uma fonte para o texto utilizando a propriedade font de um objeto TextFormat aplicado ao campo de texto. Se a fonte especificada não estiver incorporada ao arquivo SWF, o texto não será exibido.

O valor padrão é false.



Implementação
    public function get embedFonts():Boolean
    public function set embedFonts(value:Boolean):void

Elementos da API relacionados

gridFitType

propriedade 
gridFitType:String

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9

O tipo de ajuste à grade utilizado para esse campo de texto. Essa propriedade será aplicada apenas se a propriedade flash.text.AntiAliasType do campo de texto for definida como flash.text.AntiAliasType.ADVANCED.

O tipo de ajuste à grade utilizado determina se o Flash Player força as linhas fortes horizontais e verticais para que caibam em uma grade de pixels ou subpixels, ou não.

Para a propriedade flash.text.GridFitType, você pode utilizar os seguintes valores de string:

Valor de stringDescrição
flash.text.GridFitType.NONENão especifica um ajuste à grade. As linhas horizontais e verticais nos glifos não são forçadas para a grade de pixels. A definição é recomendada para animação ou tamanhos de fonte grandes.
flash.text.GridFitType.PIXELEspecifica que linhas fortes horizontais e verticais são ajustadas à grade de pixels. Essa definição funciona apenas para campos de texto alinhados à esquerda. Para usá-la, a propriedade flash.dispaly.AntiAliasType do campo de texto deve ser definida como flash.text.AntiAliasType.ADVANCED. Em geral, essa definição fornece a melhor legibilidade para o texto alinhado à esquerda.
flash.text.GridFitType.SUBPIXELEspecifica que linhas fortes horizontais e verticais são ajustadas à grade de subpixels em um monitor LCD. Para utilizar essa definição, a propriedade flash.text.AntiAliasType do campo de texto deve ser definida como flash.text.AntiAliasType.ADVANCED. A definição flash.text.GridFitType.SUBPIXEL é geralmente apropriada para texto dinâmico alinhado à direita ou centralizado e, às vezes, é uma compensação útil para animação versus qualidade de texto.

O valor padrão é pixel.



Implementação
    public function get gridFitType():String
    public function set gridFitType(value:String):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir mostra três campos de texto com diferentes configurações para a propriedade gridFitType. Quando você usar esse exemplo, observe a diferença de legibilidade nas duas primeiras linhas. Também observe o uso ideal de GridFitType.PIXEL para texto alinhado à esquerda e GridFitType.SUBPIXEL para texto alinhado à direita.
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

propriedade 
htmlText:String

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Contém a representação HTML do conteúdo do campo de texto.

O Flash Player oferece suporte para marcas HTML:

Marca Descrição
Marca de âncora A marca <a> cria um link de hipertexto e oferece suporte aos seguintes atributos:
  • target: especifica o nome da janela de destino em que você carrega a página. As opções incluem _self, _blank, _parent e _top. A opção _self especifica o quadro atual na janela atual, _blank especifica uma nova janela, _parent especifica o pai do quadro atual e _top especifica o quadro de nível superior na janela atual.
  • href: especifica um URL ou um evento link do ActionScript. O URL pode ser absoluto ou relativo ao local do arquivo SWF que está carregando a página. Um exemplo de uma referência absoluta a um URL é http://www.adobe.com; um exemplo de uma referência relativa é /index.html. URLs absolutas devem ser iniciadas com http://; do contrário, o Flash Player ou o AIR as tratará como URLs relativas. Você pode utilizar o evento link para fazer com que o link execute uma função do ActionScript em um arquivo SWF, em vez de abrir um URL. Para especificar um evento link, utilize o esquema de evento em vez do esquema http em seu atributo href. Um exemplo é href="event:myText", em vez de href="http://myURL"; quando o usuário clica em um link de hipertexto que contém o esquema de evento, o campo de texto despacha um TextEvent link com sua propriedade text definida como "myText". Você pode então criar uma função do ActionScript que é executada sempre que o link TextEvent é despachado. Também é possível definir os estilos a:link, a:hover e a:active para marcas de âncora utilizando folhas de estilo.
Marca de negrito A marca <b> renderiza o texto como negrito. Uma face de tipo negrito deve estar disponível para a fonte utilizada.
Marca de quebra A marca <br> cria uma quebra de linha no campo de texto. Defina o campo de texto como um campo de texto de várias linhas para usar essa marca.
Marca de fonte A marca <font> especifica uma fonte ou uma lista de fontes para exibir o texto. A marca de fonte oferece suporte aos seguintes atributos:
  • color: apenas valores de cor hexadecimais (#FFFFFF) são suportados.
  • face: especifica o nome da fonte a ser utilizada. Como mostrado no seguinte exemplo, você pode especificar uma lista de nomes de fonte delimitados por vírgula, caso em que o Flash Player seleciona a primeira fonte disponível. Se a fonte especificada não estiver instalada no sistema do computador local ou não estiver incorporada no arquivo SWF, o Flash Player selecionará uma fonte substituta.
  • size: especifica o tamanho da fonte. Você pode utilizar tamanhos de pixel absolutos, como 16 ou 18, ou tamanhos de fonte relativos, como +2 ou -4.
Marca de imagem A marca <img> permite que você incorpore arquivos de imagem externa (JPEG, GIF, PNG), arquivos SWF e clipes de vídeo aos campos de texto. O texto flui automaticamente pelas imagens que você incorpora nos campos de texto. Defina o campo de texto como sendo de várias linhas para dispor o texto ao redor de uma imagem.

A marca <img> oferece suporte aos seguintes atributos:

  • src: especifica o URL para um arquivo de imagem ou SWF, ou o identificador de ligação para um símbolo de clipe de vídeo na biblioteca. Esse atributo é obrigatório; todos os outros atributos são opcionais. Arquivos externos (JPEG, GIF, PNG e SWF) não serão exibidos até que sejam completamente baixados.
  • width: a largura da imagem, do arquivo SWF ou do clipe de vídeo sendo inserido, em pixels.
  • height: a altura da imagem, do arquivo SWF ou do clipe de vídeo sendo inserido, em pixels.
  • align: especifica o alinhamento horizontal da imagem incorporada dentro do campo de texto. Os valores válidos são left e right. O valor padrão é left.
  • hspace: especifica a quantidade de espaço horizontal que envolve a imagem no qual nenhum texto é exibido. O valor padrão é 8.
  • vspace: especifica a quantidade de espaço vertical que envolve a imagem no qual nenhum texto é exibido. O valor padrão é 8.
  • id: especifica o nome da ocorrência de clipe de vídeo (criada pelo Flash Player) que contém o arquivo de imagem, o arquivo SWF ou o clipe de vídeo incorporado. Essa abordagem é usada para controlar o conteúdo incorporado com o ActionScript.
  • checkPolicyFile: especifica se o Flash Player verificará se há um arquivo de diretivas de URL no servidor que esteja associado ao domínio da imagem. Se existir um arquivo de diretivas, os arquivos SWF nos domínios listados no arquivo poderão acessar os dados da imagem carregada, por exemplo, chamando o método BitmapData.draw() com essa imagem como o parâmetro source. Para obter mais informações relacionadas à segurança, consulte o tópico do Centro dos desenvolvedores do Flash Player Security.

O Flash exibe a mídia incorporada em um campo de texto com o tamanho total. Para especificar as dimensões da mídia que você está incorporando, use os atributos height e width da marca <img>.

Em geral, uma imagem incorporada em um campo de texto é exibida na linha que segue a marca <img>. No entanto, quando a marca <img> é o primeiro caractere no campo de texto, a imagem é exibida na primeira linha do campo de texto.

Para o conteúdo do AIR na área de segurança do aplicativo, o AIR ignora tags img em conteúdo HTML nos objetos TextField ActionScript. Isso é para evitar possíveis ataques de phishing,

Marca de itálico A marca <i> exibe o texto selecionado em itálico. Uma face de tipo itálico deve estar disponível para a fonte utilizada.
Marca de item da lista A marca <li> coloca um marcador na frente do texto que ela envolve. Observação: Como o Flash Player e o AIR não reconhecem as marcas de lista ordenada e não ordenada (<ol> e <ul>), elas não modificam como a sua lista será renderizada. Todas as listas não estão ordenadas e todos os itens da lista utilizam marcadores.
Marca de parágrafo A marca <p> cria um novo parágrafo. O campo de texto deve ser definido como um campo de texto de várias linhas para usar essa marca. A marca <p> oferece suporte aos seguintes atributos:
  • align: especifica o alinhamento do texto dentro do parágrafo; os valores válidos são left, right, justify e center.
  • class: especifica uma classe de estilo CSS definida por um objeto flash.text.StyleSheet.
Marca span A marca <span> está disponível apenas para uso com estilos de texto CSS. Ela oferece suporte ao seguinte atributo:
  • class: especifica uma classe de estilo CSS definida por um objeto flash.text.StyleSheet.
Marca de formato de texto

A marca <textformat> permite utilizar um subconjunto de propriedades de formatação de parágrafo da classe TextFormat dentro de campos de texto, incluindo entrelinha, recuo, margens e paradas de tabulação. Você pode combinar as marcas <textformat> com as marcas HTML embutidas.

A marca <textformat> tem os seguintes atributos:

  • blockindent: especifica o recuo do bloco em pontos; corresponde ao TextFormat.blockIndent.
  • indent: especifica o recuo da margem esquerda para o primeiro caractere no parágrafo; corresponde ao TextFormat.indent. Números positivos e negativos são aceitáveis.
  • leading: especifica a quantidade de entrelinhas (espaço vertical); corresponde ao TextFormat.leading. Números positivos e negativos são aceitáveis.
  • leftmargin: especifica a margem esquerda do parágrafo em pontos; corresponde ao TextFormat.leftMargin.
  • rightmargin: especifica a margem direita do parágrafo em pontos; corresponde ao TextFormat.rightMargin.
  • tabstops: especifica paradas de tabulação personalizadas como uma matriz de inteiros não negativos; corresponde ao TextFormat.tabStops.
Marca de sublinhado A marca <u> sublinha o texto selecionado.

O Flash Player e o AIR oferecem suporte às seguintes entidades HTML:

Entidade Descrição
&lt; < (menor que)
&gt; > (maior que)
&amp; & (E comercial)
&quot; " (aspas duplas)
&apos; ' (apóstrofo, aspas simples)

O Flash e o AIR também oferecem suporte a códigos de caractere explícitos, como &#38; (E comercial ASCII) e &#x20AC; (Símbolo Unicode €).



Implementação
    public function get htmlText():String
    public function set htmlText(value:String):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O seguinte exemplo cria um TextField chamado tf1 e atribui uma string formatada em HTML a sua propriedade text. Quando sua propriedade htmlText é rastreada, a saída será a string formatada em HTML, com marcas adicionais (como <P> e <FONT>) automaticamente adicionadas pelo Flash Player. Quando o valor da propriedade text é rastreado, a string não formatada sem as marcas HTML é exibida.

Como comparação, as mesmas etapas são executadas em outro objeto TextField denominado tf2, além do que um objeto StyleSheet é atribuído à propriedade styleSheet de tf2 antes que sua propriedade htmlText seja definida. Nesse caso, quando a propriedade htmlText é rastreada, ela inclui apenas o texto HTML exato que foi originalmente atribuído à propriedade htmlText, mostrando que nenhuma outra marca foi adicionada pelo Flash Player.

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

propriedade 
length:int  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

O número de caracteres em um campo de texto. Uma tabulação (\t) é contada como um caractere.



Implementação
    public function get length():int

maxChars

propriedade 
maxChars:int

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

O número máximo de caracteres que o campo de texto pode conter, conforme digitado por um usuário. Um script pode inserir mais texto do que é permitido por maxChars; a propriedade maxChars indica apenas quanto texto um usuário pode digitar. Se o valor dessa propriedade for 0, um usuário poderá digitar uma quantidade ilimitada de texto.

O valor padrão é 0.



Implementação
    public function get maxChars():int
    public function set maxChars(value:int):void

maxScrollH

propriedade 
maxScrollH:int  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

O valor máximo de scrollH.



Implementação
    public function get maxScrollH():int

Elementos da API relacionados

maxScrollV

propriedade 
maxScrollV:int  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

O valor máximo de scrollV.



Implementação
    public function get maxScrollV():int

Elementos da API relacionados

mouseWheelEnabled

propriedade 
mouseWheelEnabled:Boolean

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9

Um valor booliano que indica se o Flash Player deverá rolar automaticamente os campos de texto de várias linhas quando o usuário clicar em um campo de texto e usar o botão de rolagem do mouse. Por padrão, esse valor é true. Essa propriedade será útil se você quiser impedir a rolagem de campos de texto pela roda do mouse ou implementar sua própria rolagem de campo de texto.



Implementação
    public function get mouseWheelEnabled():Boolean
    public function set mouseWheelEnabled(value:Boolean):void

multiline

propriedade 
multiline:Boolean

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Indica se o campo é um campo de texto de várias linhas. Se o valor for true, o campo de texto será de várias linhas; se o valor for false, o campo de texto será de uma única linha. Em um campo de tipo TextFieldType.INPUT, o valor de multiline determina se a tecla Enter criará uma nova linha (com o valor false a tecla Enter será ignorada). Se você colar texto em um TextField com multiline de valor false, as novas linhas serão removidas do texto.

O valor padrão é false.



Implementação
    public function get multiline():Boolean
    public function set multiline(value:Boolean):void

Elementos da API relacionados

numLines

propriedade 
numLines:int  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Define o número de linhas de texto em um campo de texto de várias linhas. Se a propriedade wordWrap for definida como true, o número de linhas aumentará quando houver quebra automática.



Implementação
    public function get numLines():int

Elementos da API relacionados

restrict

propriedade 
restrict:String

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Indica o conjunto de caracteres que um usuário pode digitar no campo de texto. Se o valor da propriedade restrict for null, você poderá digitar qualquer caractere. Se o valor da propriedade restrict for uma string vazia, você não poderá digitar um caractere. Se o valor da propriedade restrict for uma string de caracteres, você poderá digitar apenas os caracteres da string no campo de texto. A string é pesquisada da esquerda para a direita. É possível especificar um intervalo usando o caractere hífen (-). Somente a interação do usuário está restrita; um script pode colocar qualquer texto no campo de texto. Essa propriedade não é sincronizada com as opções de Incorporar fonte no Inspetor de propriedades.

Se a string começar com um circunflexo (^), todos os caracteres serão inicialmente aceitos e os caracteres seguintes na string serão excluídos do conjunto de caracteres aceitos. Se a string não começar com um circunflexo (^), nenhum caractere será inicialmente aceito e os caracteres seguintes na string serão incluídos no conjunto de caracteres aceitos.

O seguinte exemplo só permite que caracteres em maiúsculas, espaços e números sejam digitados em um campo de texto:

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

O seguinte exemplo inclui todos os caracteres, mas exclui letras minúsculas:

     my_txt.restrict = "^a-z";
     

Você pode utilizar uma barra invertida para inserir um ^ ou - textual. As sequências de barra invertida aceitas são \-, \^ ou \\. A barra invertida deve ser um caractere real na string, portanto, quando especificada no ActionScript, uma barra invertida dupla deve ser utilizada. Por exemplo, o seguinte código inclui apenas o traço (-) e o circunflexo (^):

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

O ^ pode ser usado em qualquer lugar da string para alternar entre a inclusão e a exclusão de caracteres. O seguinte código inclui apenas letras maiúsculas, mas exclui a letra maiúscula Q:

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

Você pode utilizar a sequência de escape \u para construir strings restrict. O seguinte código inclui apenas os caracteres de ASCII 32 (espaço) a ASCII 126 (til).

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

O valor padrão é null.



Implementação
    public function get restrict():String
    public function set restrict(value:String):void

scrollH

propriedade 
scrollH:int

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

A posição de rolagem horizontal atual. Se a propriedade scrollH for 0, o texto não será rolado na horizontal. O valor dessa propriedade é um número inteiro que representa a posição horizontal em pixels.

As unidades de rolagem horizontal são pixels, enquanto que as unidades de rolagem vertical são linhas. A rolagem horizontal é medida em pixels porque a maioria das fontes que você normalmente usa tem espaçamento proporcional; ou seja, os caracteres podem ter diferentes larguras. O Flash Player executa a rolagem vertical por linha porque os usuários normalmente querem ver uma linha completa de texto em vez de uma linha parcial. Mesmo se uma linha utilizar várias fontes, sua altura será ajustada para acomodar a fonte maior em uso.

Observação: a propriedade scrollH será baseada em zero, não em 1 como a propriedade de rolagem vertical scrollV.



Implementação
    public function get scrollH():int
    public function set scrollH(value:int):void

Elementos da API relacionados

scrollV

propriedade 
scrollV:int

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

A posição vertical do texto em um campo de texto. A propriedade scrollV é útil para direcionar os usuários para um parágrafo específico, em uma longa passagem, ou para criar campos de texto de rolagem.

As unidades de rolagem vertical são linhas, enquanto que as unidades de rolagem horizontal são pixels. Se a primeira linha exibida for a primeira linha no campo de texto, scrollV será definido como 1 (não 0). A rolagem horizontal é medida em pixels porque a maioria das fontes tem espaçamento proporcional; ou seja, os caracteres podem ter diferentes larguras. O Flash executa a rolagem vertical por linha porque os usuários normalmente querem ver uma linha completa de texto em vez de uma linha parcial. Mesmo se existirem várias fontes em uma linha, sua altura será ajustada para acomodar a fonte maior em uso.



Implementação
    public function get scrollV():int
    public function set scrollV(value:int):void

Elementos da API relacionados

selectable

propriedade 
selectable:Boolean

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Um valor booliano que indica se o campo de texto é selecionável. O valor true indica se o texto é selecionável. A propriedade selectable controla se um campo de texto é selecionável e não se ele é editável. Um campo de texto dinâmico poderá ser selecionável mesmo se ele não for editável. Se um campo de texto dinâmico não for selecionável, o usuário não poderá selecionar o texto nele contido.

Se selectable for definido como false, o texto no campo de texto não responderá aos comandos de seleção do mouse nem do teclado, e o texto não poderá ser copiado com o comando Copiar. Se selectable for definido como true, o texto no campo de texto poderá ser selecionado com o mouse ou o teclado e também poderá ser copiado com o comando Copiar. Você pode selecionar o texto dessa maneira, mesmo se o campo de texto for um campo de texto dinâmico e não de entrada.

O valor padrão é true.



Implementação
    public function get selectable():Boolean
    public function set selectable(value:Boolean):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
Os exemplos a seguir criam dois campos de texto dinâmicos: um campo de texto com a propriedade selecionável definida como true e o outro campo de texto com a propriedade selecionável definida como false. Quando você usar esse exemplo, tente selecionar o texto nesses campos com o mouse ou 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

propriedade 
selectionBeginIndex:int  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

O valor de índice de caractere com base em zero do primeiro caractere na seleção atual. Por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante. Se nenhum texto for selecionado, essa propriedade será o valor de caretIndex.



Implementação
    public function get selectionBeginIndex():int

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
Neste exemplo, uma ocorrência de TextField é criada e preenchida com texto. Um ouvinte de evento é atribuído para que quando o usuário clicar no TextField, o método printCursorPosition seja chamado. Nesse caso, os valores das propriedades caretIndex, selectionBeginIndex e selectionEndIndex são apresentados.

Execute esse exemplo e tente clicar no TextField para selecionar o texto. Em seguida, clique no campo sem selecionar o texto. Quando você clica no texto sem fazer uma seleção, a propriedade caretIndex indica onde ocorre o ponto de inserção e as propriedades selectionBeginIndex e selectionEndIndex se igualam ao valor da propriedade 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

propriedade 
selectionEndIndex:int  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

O valor de índice de caractere com base em zero do último caractere na seleção atual. Por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante. Se nenhum texto for selecionado, essa propriedade será o valor de caretIndex.



Implementação
    public function get selectionEndIndex():int

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
Neste exemplo, uma ocorrência de TextField é criada e preenchida com texto. Um ouvinte de evento é atribuído para que quando o usuário clicar no TextField, o método printCursorPosition seja chamado. Nesse caso, os valores das propriedades caretIndex, selectionBeginIndex e selectionEndIndex são apresentados.

Execute esse exemplo e tente clicar no TextField para selecionar o texto. Em seguida, clique no campo sem selecionar o texto. Quando você clica no texto sem fazer uma seleção, a propriedade caretIndex indica onde ocorre o ponto de inserção e as propriedades selectionBeginIndex e selectionEndIndex se igualam ao valor da propriedade 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

propriedade 
sharpness:Number

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9

A nitidez das bordas de glifo neste campo de texto. Essa propriedade será aplicada apenas se a propriedade flash.text.AntiAliasType do campo de texto for definida como flash.text.AntiAliasType.ADVANCED. O intervalo de sharpness é um número de -400 a 400. Se você tentar definir sharpness como um valor fora desse intervalo, o Flash definirá a propriedade para o valor mais próximo no intervalo (-400 ou 400).

O valor padrão é 0.



Implementação
    public function get sharpness():Number
    public function set sharpness(value:Number):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir mostra o efeito da alteração da propriedade de nitidez para um objeto TextField. Você deve incorporar a fonte e definir a propriedade 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

propriedade 
styleSheet:StyleSheet

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Anexa uma folha de estilo ao campo de texto. Para obter informações sobre como criar planilhas, consulte a classe StyleSheet e o Guia do Desenvolvedor do ActionScript 3.0.

Você pode alterar a folha de estilo associada a um campo de texto a qualquer momento. Se você alterar a folha de estilo em uso, o campo de texto será redesenhado com a nova folha de estilo. Você pode definir a folha de estilo como null ou undefined para removê-la. Se a folha de estilo em uso for removida, o campo de texto será redesenhado sem uma folha de estilo.

Observação: se a folha de estilo for removida, o conteúdo de TextField.text e TextField.htmlText será alterado para incorporar a formatação anteriormente aplicada pela folha de estilo. Para preservar o conteúdo de TextField.htmlText sem a formatação, salve o valor em uma variável antes de remover a folha de estilo.



Implementação
    public function get styleSheet():StyleSheet
    public function set styleSheet(value:StyleSheet):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir define um objeto StyleSheet simples e o atribui a um campo de texto com conteúdo HTML. Defina a propriedade stylesheet antes de configurar o conteúdo.
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

propriedade 
text:String

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Uma string que é o texto atual no campo de texto. As linhas são separadas pelo caractere de retorno de carro ('\r', ASCII 13). Essa propriedade contém texto não formatado no campo de texto, sem marcas HTML.

Para obter o texto em formato HTML, utilize a propriedade htmlText.

Nota: Se uma folha de estilos for aplicada ao conteúdo do campo de texto, o conteúdo da propriedade text será interpretado como HTML.



Implementação
    public function get text():String
    public function set text(value:String):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O seguinte exemplo cria um TextField chamado tf1 e atribui uma string formatada em HTML a sua propriedade text. Quando sua propriedade htmlText é rastreada, a saída será a string formatada em HTML, com marcas adicionais (como <P> e <FONT>) automaticamente adicionadas pelo Flash Player. Quando o valor da propriedade text é rastreado, a string não formatada sem as marcas HTML é exibida.

Como comparação, as mesmas etapas são executadas em outro objeto TextField denominado tf2, além do que um objeto StyleSheet é atribuído à propriedade styleSheet de tf2 antes que sua propriedade htmlText seja definida. Nesse caso, quando a propriedade htmlText é rastreada, ela inclui apenas o texto HTML exato que foi originalmente atribuído à propriedade htmlText, mostrando que nenhuma outra marca foi adicionada pelo Flash Player.

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

propriedade 
textColor:uint

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

A cor do texto em um campo de texto, em formato hexadecimal. O sistema de cores hexadecimais usa seis dígitos para representar os valores de cor. Cada dígito tem 16 valores ou caracteres possíveis. Os caracteres variam de 0 a 9 e de A a F. Por exemplo, o preto é 0x000000; o branco é 0xFFFFFF.

O valor padrão é 0 (0x000000).



Implementação
    public function get textColor():uint
    public function set textColor(value:uint):void

Exemplo  ( Como usar este exemplo )
O seguinte ActionScript cria um objeto TextField e altera sua propriedade textColor para vermelho (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

propriedade 
textHeight:Number  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

A altura do texto, em pixels.



Implementação
    public function get textHeight():Number

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O seguinte exemplo cria um objeto TextField e atribui texto a ela. As instruções trace exibem os valores das propriedades textWidth e textHeight. Para comparação, as propriedades width e height também são exibidas. (Observe que os valores que você vê para textHeight e textWidth podem variar dependendo da fonte utilizada em sua máquina).
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

propriedade 
textInteractionMode:String  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 11, Flash Lite 4

A propriedade de modo de interação, cujo valor padrão é TextInteractionMode.NORMAL. Nas plataformas móveis, o modo normal significa que o texto pode ser rolado, mas não selecionado. É possível alternar para o modo selecionável usando o menu de contexto incorporado no campo de texto. Na área de trabalho, o modo normal significa que o texto está tanto no modo rolável quanto no de seleção.



Implementação
    public function get textInteractionMode():String

textWidth

propriedade 
textWidth:Number  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

A largura do texto, em pixels.



Implementação
    public function get textWidth():Number

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O seguinte exemplo cria um objeto TextField e atribui texto a ela. As instruções trace exibem os valores das propriedades textWidth e textHeight. Para comparação, as propriedades width e height também são exibidas. (Observe que os valores que você vê para textHeight e textWidth podem variar dependendo da fonte utilizada em sua máquina).
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

propriedade 
thickness:Number

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9

A espessura das bordas de glifo neste campo de texto. Essa propriedade será aplicada apenas quando flash.text.AntiAliasType for definida como flash.text.AntiAliasType.ADVANCED.

O intervalo de thickness é um número de -200 a 200. Se você tentar definir thickness como um valor fora desse intervalo, a propriedade será definida como o valor mais próximo no intervalo (-200 ou 200).

O valor padrão é 0.



Implementação
    public function get thickness():Number
    public function set thickness(value:Number):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir mostra o efeito da alteração da propriedade de espessura para um objeto TextField. Você deve incorporar a fonte e definir a propriedade 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

propriedade 
type:String

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

O tipo do campo de texto. Uma das seguintes constantes de TextFieldType: TextFieldType.DYNAMIC, que especifica um campo de texto dinâmico, que um usuário não pode editar, ou TextFieldType.INPUT, que especifica um campo de texto de entrada, que um usuário pode editar.

O valor padrão é dynamic.



Implementação
    public function get type():String
    public function set type(value:String):void

Lança
ArgumentError — O type especificado não é um membro de flash.text.TextFieldType.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O seguinte exemplo cria dois campos de texto: tfDynamic e tfInput. O texto é digitado nos dois campos de texto. No entanto, tfDynamic tem sua propriedade type definida como TextFieldType.DYNAMIC e tfInput tem sua propriedade type definida como TextFieldType.INPUT, portanto, o usuário pode modificar o texto em tfInput, mas só pode exibir o texto em 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

propriedade 
useRichTextClipboard:Boolean

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9

Especifica se a formatação do texto será ou não copiada e colada junto com o texto. Quando definida como true, o Flash Player copiará e colará a formatação (como alinhamento, negrito e itálico) quando você copiar e colar entre os campos de texto. Os campos de texto de origem e de destino para o procedimento de cópia e colagem devem ter useRichTextClipboard definida como true. O valor padrão é false.



Implementação
    public function get useRichTextClipboard():Boolean
    public function set useRichTextClipboard(value:Boolean):void

Exemplo  ( Como usar este exemplo )
Esse exemplo cria um campo de texto de entrada (tf1) e dois campos de texto dinâmicos (tf2 e tf3). O código atribui cada campo de texto dinâmico a um objeto TextFormat (fonte Courier Bold). O campo de texto tf2 tem a propriedade useRichTextClipboard definida como false. O campo de texto tf3 tem a propriedade useRichTextClipboard definida como true. Quando você copia o texto do campo de texto tf2 e o cola no campo de texto tf1, o texto colado não inclui a formatação. Quando você copia texto do campo de texto tf3 (que tem o useRichTextClipboard definido como true) e o cola no campo de texto tf1, o texto colado inclui a formatação.
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

propriedade 
wordWrap:Boolean

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Um valor booliano que indica se o campo de texto tem quebra automática. Se o valor de wordWrap for true, o campo de texto terá uma quebra automática; se o valor for false, o campo de texto não terá uma quebra automática. O valor padrão é false.



Implementação
    public function get wordWrap():Boolean
    public function set wordWrap(value:Boolean):void

Exemplo  ( Como usar este exemplo )
Este exemplo demonstra a diferença entre a definição da propriedade wordWrap como true e como false. Duas ocorrências de TextField são criadas cujo conteúdo é muito grande para suas larguras. A propriedade wordWrap da primeira (denominada tfWrap) é definida como true; e definida como false para a segunda (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;
        }
    }
}
Detalhes do construtor

TextField

()Construtor
public function TextField()

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Cria uma nova ocorrência de TextField. Depois de criar a ocorrência de TextField, chame o método addChild() ou addChildAt() do objeto DisplayObjectContainer pai para adicionar a ocorrência de TextField à lista de exibição.

O tamanho padrão de um campo de texto é 100 x 100 pixels.


Exemplo  ( Como usar este exemplo )

O seguinte exemplo mostra como você pode criar dinamicamente uma entrada objeto de TextField em ActionScript 3.0 estabelecendo a propriedade de tipo de objeto de campo de texto na constante TextFieldType.INPUT. Exemplo fornecido 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);
Detalhes do método

appendText

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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Acrescenta a string especificada pelo parâmetro newText ao final do texto do campo de texto. Este método é mais eficiente do que uma atribuição de adição (+=) em uma propriedade text (como someTextField.text += moreText), particularmente para um campo de texto que contém uma quantidade significativa de conteúdo.

Parâmetros

newText:String — A string a ser acrescentada ao texto existente.


Exemplo  ( Como usar este exemplo )

O seguinte exemplo exibe a hora se não for final de semana ou o texto, "É final de semana", se for. Também conta o número de caracteres até certa posição e o número de linhas no campo de texto.

O campo de texto outputText é definido para ajustar automaticamente o texto e para redimensionar como um texto justificado à esquerda, utilizando a propriedade autoSize. A propriedade outputText.text escreve a primeira linha do conteúdo e o método appendText() acrescenta o restante do conteúdo. (Não é necessário iniciar com a propriedade text. O método appendText() também poderia ser utilizado para acrescentar texto do início.) A definição da propriedade text uma segunda vez sobrescreverá o texto original. Utilize o operador += para acrescentar conteúdo com a propriedade text.

A instrução if verifica se a data é Sábado (6) ou Domingo (0). Se não for, o método toLocaleTimeString() retorna a hora local, que é acrescentada ao conteúdo do campo de texto.

A propriedade length do campo de texto é utilizada para ler o número de caracteres antes de a função ser chamada e a propriedade numLines é utilizada para contar o número de linhas no campo de texto. Observe que as linhas vazias são contadas no número de linhas e os espaços vazios e as quebras de linha (\n) são contados ao determinar o tamanho do conteúdo.

  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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Retorna um retângulo que é a caixa delimitadora do caractere.

Parâmetros

charIndex:int — O valor de índice com base em zero do caractere (por exemplo, a primeira posição é 0, a segunda posição é 1 e assim por diante).

Retorna
Rectangle — Um retângulo com os valores mínimo e máximo x e y definindo a caixa delimitadora do caractere.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

No seguinte exemplo, o método getCharBoundaries() é utilizado para marcar (colocar um realce sobre) um caractere que é selecionado pelo usuário.

A classe define o objeto Forma spotlight que será utilizado para desenhar um retângulo em torno de cada caractere selecionado. Quando o usuário clica no campo de texto myTextField, o método clickHandler() é chamado.

No método clickHandler(), o método getCharIndexAtPoint() obtém o índice de caractere clicado com base nas coordenadas localX e localY do clique do mouse, que é relativo a Sprite contido. O método getCharIndexAtPoint() retornará -1 se o ponto (clique do mouse) não foi sobre um caractere. Uma vez que o campo de texto pode ser maior que o texto, o inteiro retornado (index) é marcado para garantir que o usuário clicou em um caractere. O inteiro index também é utilizado por getCharBoundaries() para obter um objeto Rectangle que contém o limite do caractere. O método clear() limpa qualquer objeto Forma spotlight anteriormente exibido. Um novo retângulo com o tamanho dos limites de largura e altura do caractere é produzido no local do caractere [deslocamento das coordenadas (10, 10)] utilizando as coordenadas x e y do retângulo frame retornado. Para colocar o realce sobre o caractere, o objeto Forma spotlight é preenchido com a cor amarela e a opacidade é definida como 35 por cento, de forma que o caractere possa ser visto. Observe que espaços também são considerados um caractere.

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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Retorna o valor de índice com base em zero do caractere no ponto especificado pelos parâmetros x e y.

Parâmetros

x:Number — A coordenada x do caractere.
 
y:Number — A coordenada y do caractere.

Retorna
int — O valor de índice com base em zero do caractere (por exemplo, a primeira posição é 0, a segunda posição é 1 e assim por diante). Retorna -1 se o ponto não estiver sobre um caractere.

Exemplo  ( Como usar este exemplo )

No seguinte exemplo, quando um usuário clica em um caractere, o caractere é repetido em outro campo de texto acima do texto.

O primeiro campo de texto contém o texto que o usuário irá selecionar. Para garantir que o texto seja clicado e não selecionado, a propriedade selectable é definida como false. Quando o usuário clica no campo de texto firstTextField, o método clickHandler() é chamado.

No método clickHandler(), o método getCharIndexAtPoint() retorna o índice de caractere com base nas coordenadas localX e localY do clique do mouse. Uma vez que o campo de texto pode ser maior que o texto, o inteiro retornado (index) é marcado para garantir que o usuário clicou em um caractere. (O método getCharIndexAtPoint() retornará -1 se o ponto (clique do mouse) não foi sobre um caractere.) As coordenadas do mouse são utilizadas para definir as coordenadas do novo campo de texto em que o caractere repetido será exibido. A cor do caractere no segundo campo de texto é definida como vermelho. Por fim, o texto do segundo campo é definido como o caractere selecionado, que é recuperado utilizando o método charAt(). Observe que utilizar a propriedade text em vez do método appendText() sobrescreverá o caractere no segundo campo de texto, em vez de acrescentá-lo.

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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Tendo sido fornecido um índice de caractere, retorna o índice do primeiro caractere no mesmo parágrafo.

Parâmetros

charIndex:int — O valor de índice com base em zero do caractere (por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante).

Retorna
int — O valor de índice com base em zero do primeiro caractere no mesmo parágrafo.

Lança
RangeError — O índice de caractere especificado está fora do intervalo.

Exemplo  ( Como usar este exemplo )

No seguinte exemplo, a formatação do parágrafo é aplicada ao conteúdo do campo de texto. Quando o usuário clica em um parágrafo, o texto do parágrafo é alinhado à direita e quando o usuário clica no parágrafo novamente, retorna ao formato original (padrão) (alinhamento à esquerda).

No construtor, o campo de texto myTextField é definido como texto com quebra automática. O método getTextFormat retorna o formato original do primeiro caractere do conteúdo do campo de texto, que é colocado no objeto TextFormat originalFormat. Um novo objeto TextFormat (newFormat) também é definido e sua propriedade align é atribuída a justificado à direita. Quando o usuário clica no campo de texto, o método clickHandler() é chamado.

No método clickHandler(), o método getCharIndexAtPoint() retorna o índice de caractere com base nas coordenadas localX e localY do clique do mouse. A primeira instrução if verifica se o usuário clicou em um caractere. Utilizando o inteiro clickIndex retornado pelo método getCharIndexAtPoint(), o método getFirstCharInParagraph() retorna o índice do primeiro caractere no parágrafo que o usuário clicou. O índice do último caractere no parágrafo é determinado pela adição do tamanho do parágrafo (utilizando o método getParagraphLength()) ao índice do primeiro caractere no parágrafo, menos o último caractere (\n). A segunda instrução if verifica o formato do primeiro caractere no parágrafo. Se seu valor de alinhamento for o mesmo que o do formato original (justificado à esquerda), o novo formato será aplicado a todos os caracteres no parágrafo. Do contrário, o formato do parágrafo será definido de volta ao formato original. Alinhamento, formatação para frente como recuo, marcador, parada de tabulação, margens à esquerda e à direita são formatos próprios para parágrafos. Observe que uma vez que a quebra automática ou quebra de linha é utilizada, a formatação somente será aplicada à primeira linha do parágrafo, se o argumento endIndex não for definido para o 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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Retorna uma referência DisplayObject para o id especificado, referente a um arquivo SWF ou de imagem que foi adicionado a um campo de texto formatado em HTML com o uso de uma marca <img>. A marca <img> está no seguinte formato:

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

Parâmetros

id:String — A id para correspondência (no atributo id da marca <img>).

Retorna
DisplayObject — O objeto de exibição relacionado ao arquivo de imagem ou SWF com o atributo id correspondente na marca <img> do campo de texto. Para a mídia carregada de uma fonte externa, esse objeto será um objeto Loader e, uma vez carregado, o objeto de mídia será o filho do objeto Loader. Para a mídia incorporada no arquivo SWF, esse será o objeto carregado. Se não houver uma marca <img> com o id correspondente, o método retornará null.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

No seguinte exemplo, quando o campo de texto é clicado, a imagem no campo tem sua opacidade definida como 25 por cento e gira 90 graus a partir de sua posição original. A imagem continuará girando com cada clique subsequente.

A imagem (image.jpg) é incluída via HTML. (Aqui, pressupõe-se que um arquivo de imagem esteja no mesmo diretório que o arquivo SWF.) Um atributo id precisa ser definido para a marca img para acessar a imagem utilizando o método getImageReference(). A propriedade htmlText é utilizada para incluir o conteúdo da string formatado em HTML. Quando o usuário clica no campo de texto myTextField, o método clickHandler() é chamado.

No método clickHandler(), o método getImageReference() retorna uma referência à imagem como um DisplayObject. Essa referência pode ser utilizada para manipular a imagem, como qualquer objeto DisplayObject. Aqui, as propriedades alpha (transparência) e rotation são definidas. A propriedade transform também pode ser utilizada para acessar a matriz, a transformação de cores e os limites de pixel do objeto de exibição. Observe também que flash.display.DisplayObject precisa ser importado.

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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Retorna o valor de índice com base em zero da linha no ponto especificado pelos parâmetros x e y.

Parâmetros

x:Number — A coordenada x da linha.
 
y:Number — A coordenada y da linha.

Retorna
int — O valor de índice com base em zero da linha (por exemplo, a primeira linha é 0, a segunda linha é 1 e assim por diante). Retorna -1 se o ponto não estiver sobre uma linha.

Exemplo  ( Como usar este exemplo )

No seguinte exemplo, quando um usuário seleciona uma linha no soneto de Shakespeare, ela é copiada (acrescentada) para um novo campo de texto.

No construtor, o campo de texto poem é definido como sem quebra (já que é um poema). A propriedade autoSize também é utilizada para definir o texto para ajustar-se automaticamente e para que seja redimensionado como um texto justificado à esquerda. O campo de texto poemCopy é colocado sob o campo de texto poem. Quando um usuário clica em alguma linha do poema, o método clickHandler() é chamado.

No método clickHandler(), o método getLineIndexAtPoint() retorna o índice de linha de onde o usuário clicou com base nas coordenadas localX e localY do clique do mouse. (Uma vez que o poema original se ajusta ao tamanho do campo de texto aqui, não é necessário verificar se há um erro Fora do intervalo (RangeError) acionado pelo método getCharIndexAtPoint().) O índice de linha é então utilizado para obter o conteúdo da linha como uma string com o método getLineText(), que é acrescentado ao conteúdo do campo de texto poemCopy. A cópia pode continuar sem interrupção, mas após um ponto, o texto ficará fora do intervalo do campo de texto poemCopy visível.

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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Retorna o valor de índice com base em zero da linha contendo o caractere especificado pelo parâmetro charIndex.

Parâmetros

charIndex:int — O valor de índice com base em zero do caractere (por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante).

Retorna
int — O valor de índice com base em zero da linha.

Lança
RangeError — O índice de caractere especificado está fora do intervalo.

Exemplo  ( Como usar este exemplo )

No seguinte exemplo, o método getLineIndexOfChar() retorna os números de linha do 100o. e 500o. caracteres no campo de texto.

O campo de texto myTextField é definido para quebra automática e redimensionamento como um texto justificado à esquerda. O método getLineIndexOfChar() retorna o índice de linha dos índices de caractere especificados (100 e 500). Essas informações são então acrescentadas após o parágrafo. Observe que uma vez começando com 0, o índice de linha (index) é aumentado em 1 para obter o número da linha. Além disso, se a exibição for redimensionada, o número da linha poderá mudar, mas as informações aqui permanecerão iguais, uma vez que o método só é chamado uma 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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Retorna o número de caracteres em uma linha de texto específica.

Parâmetros

lineIndex:int — O número da linha da qual você quer o tamanho.

Retorna
int — O número de caracteres na linha.

Lança
RangeError — O número da linha especificado está fora do intervalo.

Exemplo  ( Como usar este exemplo )

No seguinte exemplo, uma vez que o usuário seleciona uma linha, seu tamanho (número de caracteres) é exibido em um campo de texto separado.

Como uma ilustração, o campo de texto myTextField, que exibe o texto que será contado, é definido como INPUT, ou seja, os usuários podem realmente alterar as linhas ou adicionar linhas entre as linhas ou ao final. (Há uma linha vazia criada utilizando a quebra de linha (\n) ao final da última linha.) O campo de texto countLines, em que o resultado da contagem do tamanho da linha é exibido, é definido abaixo do campo de texto myTextField e seu texto não pode ser selecionado. Quando o usuário clica em uma linha no campo de texto myTextField, o método clickHandler() é chamado.

No método clickHandler(), o método getLineIndexAtPoint() retorna o índice de linha de onde o usuário clicou, utilizando as coordenadas localX e localY do clique do mouse. A instrução if verifica se o usuário clicou em um caractere. Em caso afirmativo, o método getLineLength(), utilizando o índice da linha, retorna o número de caracteres na linha. Observe que as linhas vazias entre as linhas incluem a segunda quebra de linha (\n) e têm uma contagem de 1 caractere, enquanto a linha após a última linha tem uma contagem 0. Espaços também contam como um caractere. Os usuários podem escrever uma nova linha ou alterar uma linha e obter sua contagem de caracteres ao clicar nela. Se a quebra automática for utilizada e a tela for redimensionada, o índice de linha poderá ser alterado.

 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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Retorna informações de métrica de uma determinada linha de texto.

Parâmetros

lineIndex:int — O número da linha da qual você quer informações de métrica.

Retorna
flash.text:TextLineMetrics — Um objeto TextLineMetrics.

Lança
RangeError — O número da linha especificado está fora do intervalo.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

O seguinte exemplo exibe alguns valores de métrica de linha para duas linhas de texto formatadas de maneira diferente.

O texto acrescentado tem duas linhas de Song of Myself por Walt Whitman. Um novo objeto TextFormat (newFormat) é utilizado para definir o formato da segunda linha. A primeira linha contém o formato padrão. O método getLineMetrics() retorna um objeto TextLineMetrics de uma linha específica. (O índice de linha começa com 0.) Utilizando os objetos TextLineMetrics metrics1 e metrics2 para as linhas um e dois, respectivamente, o valor de subida, descida, altura e espessura da linha são recuperados e exibidos. Os números resultantes são convertidos em string, mas não são arredondados. Observe que esse valor é para a linha e não para um caractere específico. Ele reflete o intervalo de caracteres de uma linha. Por exemplo, se uma linha tiver diferentes caracteres com diferentes formatos de altura, o caractere com a altura maior determinará o valor. Isso também significa que se um dos formatos do caractere for alterado, alguns dos valores de métrica também poderão ser alterados.

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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Retorna o índice de caractere do primeiro caractere na linha que o parâmetro lineIndex especifica.

Parâmetros

lineIndex:int — O valor de índice com base em zero da linha (por exemplo, a primeira linha é 0, a segunda linha é 1 e assim por diante).

Retorna
int — O valor de índice com base em zero do primeiro caractere na linha.

Lança
RangeError — O número da linha especificado está fora do intervalo.

Exemplo  ( Como usar este exemplo )

O seguinte exemplo verifica o primeiro caractere da linha 4, que mudará se a tela (e o campo de texto) for redimensionada.

O campo de texto myTextField é definido como quebra automática. O campo de texto countField exibirá o primeiro caractere da linha 4. Quando o usuário clica no campo de texto myTextField, o método clickHandler() é chamado.

No método clickHandler(), o método getLineOffset() retorna o índice do primeiro caractere no índice de linha 3, que é a quarta linha do texto. (A primeira linha tem um índice 0.) O método charAt() é utilizado para obter o caractere, utilizando o índice do primeiro caractere da quarta linha. O conteúdo do campo de texto countField é atualizado com essas informações, utilizando a propriedade text do campo de texto countField. Utilizar a propriedade countField.text significa que toda vez depois do clique, o conteúdo do campo de texto countField será sobrescrito. Se o usuário redimensionar a exibição, o conteúdo terá uma quebra automática e o primeiro caractere da linha 4 poderá mudar. Ao clicar novamente no campo myTextField, o conteúdo do campo de texto countField será atualizado com o novo primeiro caractere da quarta linha.

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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Retorna o texto da linha especificada pelo parâmetro lineIndex.

Parâmetros

lineIndex:int — O valor de índice com base em zero da linha (por exemplo, a primeira linha é 0, a segunda linha é 1 e assim por diante).

Retorna
String — A string de texto contida na linha especificada.

Lança
RangeError — O número da linha especificado está fora do intervalo.

Exemplo  ( Como usar este exemplo )

No seguinte exemplo, os números de linha de todas as ocorrências da palavra "love" utilizada no soneto de Shakespeare serão encontrados e exibidos.

O campo de texto poem é definido para ajustar automaticamente o texto e para redimensionar como um texto justificado à esquerda. A propriedade wordWrap é definida como false, assim, as linhas do poema não são quebradas. Isso não é um problema quando a propriedade autoSize é utilizada normalmente. O loop for é repetido pelas linhas do soneto, utilizando a propriedade numLines do campo de texto. O método getLineText() retorna o conteúdo da linha como uma string. (Observe que a propriedade numLines retorna o número de linhas, começando com a linha 1, enquanto para o método getLineText(), o número da linha começa com 0.) Utilizando o padrão de expressão regular (/love/i), a instrução if procura por qualquer substring da palavra, em maiúscula ou minúscula. Se o padrão for encontrado, o método search retornará o índice da primeira substring correspondente, do contrário, retornará -1 (se não houver correspondência). O número da linha em que "love" foi encontrado ((i + 1)) será então colocado na string lineResult. O método string converte o argumento de número ((i + 1)) em uma string, desde que exista um outro argumento que seja uma string (" "). O resultado da linha da pesquisa incluirá linhas com as palavras "loved" ou "Love's". Se a string "Love was found in lines:" foi acrescentada antes do loop for, a palavra "Love" nessa linha também terá sido incluída.

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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Tendo sido fornecido um índice de caractere, retorna o tamanho do parágrafo contendo o caractere específico. O tamanho é relativo ao primeiro caractere no parágrafo (conforme retornado por getFirstCharInParagraph()), não ao índice de caractere passado.

Parâmetros

charIndex:int — O valor de índice com base em zero do caractere (por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante).

Retorna
int — Retorna o número de caracteres no parágrafo.

Lança
RangeError — O índice de caractere especificado está fora do intervalo.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

No seguinte exemplo, quando um usuário seleciona um parágrafo, seu tamanho e o número de caracteres "s" nele contidos são exibidos em um campo de texto separado.

O campo de texto myTextField exibe os parágrafos que o usuário selecionará. Quando o usuário clica no campo de texto, o evento MouseEvent.CLICK é despachado e o método clickHandler() é chamado. O tamanho do parágrafo e o número de caracteres "s" serão exibidos no campo de texto countField, que é colocado abaixo do campo de texto myTextField.

No método clickHandler(), o método getCharIndexAtPoint() retorna o índice de caractere com base nas coordenadas localX e localY do clique do mouse. A primeira instrução if verifica se o usuário clicou em um caractere. O método getFirstCharInParagraph() usa esse índice para retornar o índice do primeiro caractere no mesmo parágrafo. O tamanho do parágrafo retornado pelo método getParagraphLength() é utilizado com o índice do primeiro caractere no parágrafo para determinar o índice do final do parágrafo. Um loop for é repetido pelo parágrafo, procurando pelo 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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Retorna um objeto TextFormat que contém informações de formatação do intervalo de texto especificado pelos parâmetros beginIndex e endIndex. Apenas as propriedades comuns a todo o texto especificado são definidas no objeto TextFormat resultante. Qualquer propriedade que seja mixed, o que significa que ela tem diferentes valores em diferentes pontos no texto, tem um valor null.

Se você não especificar valores para esses parâmetros, esse método será aplicado a todo o texto no campo de texto.

A seguinte tabela descreve três possíveis usos:

UsoDescrição
my_textField.getTextFormat()Retorna um objeto TextFormat contendo informações de formatação para todo o texto em um campo de texto. Apenas as propriedades comuns a todo o texto no campo de texto são definidas no objeto TextFormat resultante. Qualquer propriedade que seja mixed, o que significa que ela tem diferentes valores em diferentes pontos no texto, tem um valor null.
my_textField.getTextFormat(beginIndex:Number)Retorna um objeto TextFormat contendo uma cópia do formato de texto do caractere na posição beginIndex.
my_textField.getTextFormat(beginIndex:Number,endIndex:Number)Retorna um objeto TextFormat contendo informações de formatação para a extensão de texto de beginIndex a endIndex-1. Apenas as propriedades comuns a todo o texto no intervalo especificado são definidas no objeto TextFormat resultante. Qualquer propriedade mixed (ou seja, tem diferentes valores em diferentes pontos no intervalo) tem seu valor definido como null.

Parâmetros

beginIndex:int (default = -1) — Opcional; um inteiro que especifica o local inicial de um intervalo de texto dentro do campo de texto.
 
endIndex:int (default = -1) — Opcional; um inteiro que especifica a posição do primeiro caractere após a extensão de texto desejada. Conforme desejado, se você especificar os valores beginIndex e endIndex, o texto de beginIndex a endIndex-1 será lido.

Retorna
flash.text:TextFormat — O objeto TextFormat que representa as propriedades de formatação do texto especificado.

Lança
RangeError — O beginIndex ou endIndex especificado está fora do intervalo.

Elementos da API relacionados


Exemplo
Como usar este exemplo
Consulte o exemplo do método getFirstCharInParagraph() ou setTextFormat() quanto a ilustrações de como usar o método getTextFormat().

isFontCompatible

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

Versão da linguagem: ActionScript 3.0
Versões de runtime: Flash Player 10, AIR 1.5, Flash Lite 4

Retorna true se uma fonte incorporada estiver disponível com os parâmetros fontName e fontStyle especificados, em que Font.fontType é flash.text.FontType.EMBEDDED. A partir do Flash Player 10, dois tipos de fontes incorporadas podem aparecer em um arquivo SWF. As fontes incorporadas normais são usadas somente com objetos TextField. As fontes incorporadas CFF são usadas somente com as classes flash.text.engine. Os dois tipos são diferenciados pela propriedade fontType da classe Font, conforme retornados pela função enumerateFonts().

TextField não pode usar uma fonte de tipo EMBEDDED_CFF. Se embedFonts for definido como true e a única fonte disponível no tempo de execução com o nome e estilo especificados for de tipo EMBEDDED_CFF, o Flash Player não renderizará o texto, como se não houvesse nenhuma fonte incorporada com o nome e estilo especificados.

Se as fontes EMBEDDED e EMBEDDED_CFF estiverem disponíveis com o mesmo nome e estilo, a fonte EMBEDDED será selecionada e o texto será processado com a fonte EMBEDDED.

Parâmetros

fontName:String — O nome da fonte incorporada a ser verificada.
 
fontStyle:String — Especifica o estilo de fonte a ser verificado. Use flash.text.FontStyle

Retorna
Booleantrue se houver uma fonte compatível incorporada está disponível, caso contrário, será false.

Lança
ArgumentError — O fontStyle especificado não é membro de flash.text.FontStyle.

Elementos da API relacionados

replaceSelectedText

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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Substitui a seleção atual pelo conteúdo do parâmetro value. O texto é inserido na posição da seleção atual, utilizando o formato de caractere padrão e o formato de parágrafo padrão atuais. O texto não é tratado como HTML.

Você pode utilizar o método replaceSelectedText() para inserir e excluir texto sem romper a formatação de caractere e parágrafo do restante do texto.

Observação: Esse método não funcionará se uma folha de estilo for aplicada ao campo de texto.

Parâmetros

value:String — A string que substituirá o texto atualmente selecionado.


Lança
Error — Este método não pode ser utilizado em um campo de texto com uma folha de estilo.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

No seguinte exemplo, o usuário apaga parte do texto do primeiro campo de texto selecionando-a e substitui um texto selecionado no segundo campo de texto pela string "NEW TEXT".

Dois objetos TextField diferentes são criados e ouvintes de evento são adicionados para os eventos MouseEvent.MOUSE_UP. Mouse para cima ocorre quando o usuário solta o mouse, um evento que normalmente ocorre depois que uma seleção de texto é feita. Observe que a definição padrão de um campo de texto é para que seu texto seja selecionado.

No método mouseHandler1(), quando um usuário solta o mouse no campo de texto myTextField1, o texto é apagado e substituído por uma string vazia. Isso pode continuar até que todo o texto seja apagado. No método mouseHandler2(), quando um usuário seleciona parte do texto no campo de texto myTextField2, as propriedades selectionBeginIndex e selectionEndIndex são verificadas para ver se qualquer caractere foi selecionado. (As propriedades selectionBeginIndex e selectionEndIndex não terão o mesmo valor se parte do texto for selecionada.) O texto selecionado é então substituído pela string "NEW TEXT". Isso pode continuar até que todo o texto original do segundo campo de texto seja substituído pela string "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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Substitui o intervalo de caracteres especificado pelos parâmetros beginIndex e endIndex pelo conteúdo do parâmetro newText. Conforme desejado, o texto de beginIndex a endIndex-1 é substituído.

Observação: Esse método não funcionará se uma folha de estilo for aplicada ao campo de texto.

Parâmetros

beginIndex:int — O valor de índice com base em zero da posição inicial do intervalo de substituição.
 
endIndex:int — A posição do índice com base em zero do primeiro caractere após a extensão de texto desejada.
 
newText:String — O texto a ser utilizado para substituir o intervalo especificado de caracteres.


Lança
Error — Este método não pode ser utilizado em um campo de texto com uma folha de estilo.

Exemplo  ( Como usar este exemplo )

O seguinte exemplo usa o método replaceText() para excluir, substituir e inserir parte do texto em um campo de texto.

O campo de texto outputText é definido para ajustar automaticamente o texto e para redimensionar como um texto justificado à esquerda. Com a primeira chamada do método replaceText(), a primeira linha ("This is the wrong heading") é substituída por "THIS IS THE HEADING FOR EVERYONE". Com a segunda chamada do método, o texto "CORRECT" é inserido entre "THE" e "HEADING". Com a terceira chamada do método, as palavras "FOR EVERYONE" são excluídas. Observe que com cada chamada para o método appendText(), os índices inicial e final do texto atual são alterados. Aqui, apenas o texto final (após terem sido realizadas as alterações) será exibido.

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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Define, conforme selecionado, o texto designado pelos valores de índice do primeiro e último caracteres, que são especificados com os parâmetros beginIndex e endIndex. Se os dois valores de parâmetro forem iguais, este método definirá o ponto de inserção, como se você tivesse definido a propriedade caretIndex.

Parâmetros

beginIndex:int — O valor de índice com base em zero do primeiro caractere na seleção (por exemplo, o primeiro caractere é 0, o segundo caractere é 1 e assim por diante).
 
endIndex:int — O valor de índice com base em zero do último caractere na seleção.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

No seguinte exemplo, quando o usuário clica em qualquer lugar no campo de texto, um intervalo predefinido de texto será selecionado (realçando as palavras "TEXT IN ALL CAPS").

Dois ouvintes de evento para o campo de texto myTextField respondem aos cliques do mouse do usuário ou aos eventos de mouse para cima. Mouse para cima ocorrerá quando o usuário soltar o mouse, um evento que normalmente ocorre depois que uma seleção de texto é feita. Observe que a definição padrão de um campo de texto é para que seu texto seja selecionado. Quando parte do texto é clicada, o método clickHandler() é chamado. Quando parte do texto é selecionada e o mouse é liberado, o método mouseUpHandler() é chamado.

Nos métodos clickHandler() e mouseUpHandler(), o método setSelection() define apenas os caracteres entre os índices 54 e 70 (TEXT IN ALL CAPS) a ser selecionado.

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

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Aplica a formatação de texto determinada pelo parâmetro format ao texto especificado em um campo de texto. O valor de format deve ser um objeto TextFormat que especifica as alterações desejadas na formatação do texto. Apenas as propriedades que não são nulas de format são aplicadas ao campo de texto. Qualquer propriedade de format definida como null não é aplicada. Por padrão, todas as propriedades de um objeto TextFormat recém-criado são definidas como null.

Observação: Esse método não funcionará se uma folha de estilo for aplicada ao campo de texto.

O método setTextFormat() altera a formatação de texto aplicada a um intervalo de caracteres ou a todo o corpo do texto em um campo de texto. Para aplicar as propriedades de format a todo o texto no campo de texto, não especifique valores para beginIndex e endIndex. Para aplicar as propriedades de format a um intervalo de texto, especifique valores para os parâmetros beginIndex e endIndex. Você pode utilizar a propriedade length para determinar os valores de índice.

Os dois tipos de informações de formatação em um objeto TextFormat são formatação em nível de caractere e formatação em nível de parágrafo. Cada caractere em um campo de texto pode ter suas próprias definições de formatação de caractere, como nome de fonte, tamanho de fonte, negrito e itálico.

Para parágrafos, o primeiro caractere do parágrafo é examinado quanto às definições de formatação de todo o parágrafo. Exemplos de definições de formatação de parágrafo são margem à esquerda, margem à direita e recuo.

Qualquer texto inserido manualmente pelo usuário, ou substituído pelo método replaceSelectedText(), recebe a formatação padrão do campo de texto do novo texto e não a formatação especificada para o ponto de inserção de texto. Para definir a formatação padrão do novo texto, use defaultTextFormat.

Parâmetros

format:flash.text:TextFormat — Um objeto TextFormat que contém informações de formatação de caractere e parágrafo.
 
beginIndex:int (default = -1) — Opcional; um inteiro que especifica a posição do índice com base em zero especificando o primeiro caractere do intervalo de texto desejado.
 
endIndex:int (default = -1) — Opcional; um inteiro que especifica o primeiro caractere após a extensão de texto desejada. Conforme desejado, se você especificar os valores beginIndex e endIndex, o texto de beginIndex a endIndex-1 será atualizado.

UsoDescrição
my_textField.setTextFormat(textFormat:TextFormat)Aplica as propriedades de textFormat a todo o texto no campo de texto.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int)Aplica as propriedades de textFormat ao texto iniciando com a posição beginIndex.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int, endIndex:int)Aplica as propriedades do parâmetro textFormat à extensão de texto a partir da posição beginIndex até a posição endIndex-1.

Observe que qualquer texto inserido manualmente pelo usuário, ou substituído pelo método replaceSelectedText(), recebe a formatação padrão do campo de texto do novo texto e não a formatação especificada para o ponto de inserção de texto. Para definir uma formatação padrão do campo de texto para o novo texto, use a propriedade defaultTextFormat.


Lança
Error — Este método não pode ser utilizado em um campo de texto com uma folha de estilo.
 
RangeError — O beginIndex ou endIndex especificado está fora do intervalo.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

No seguinte exemplo, quando o texto é clicado, um intervalo definido de texto, "TEXT IN ALL CAPS", muda entre o formato de texto padrão e o novo formato.

Um ouvinte de evento para o campo de texto myTextField é adicionado para responder aos cliques do mouse ao chamar o método clickHandler(). No método clickHandler(), o método getTextFormat() retorna o formato atual de um caractere (índice 55) do intervalo de texto pretendido, que é então colocado no objeto TextFormat currentTextFormat. A instrução if verifica o formato do texto currentTextFormat para ver se o caractere no intervalo está utilizando o novo formato (ponto de fonte definido como 18). Se não estiver, o novo formato muda o tamanho para 18 pontos, a cor para vermelho, e aplica sublinhado e itálico ao intervalo de texto entre 54-70 (TEXT IN ALL CAPS). Se o caractere no intervalo estiver utilizando o novo formato, o formato do intervalo retornará ao formato padrão (original) do 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);
            }    
        }    
    }
}
Detalhe do evento

change

Evento
Tipo do objeto de evento: flash.events.Event
propriedade Event.type = flash.events.Event.CHANGE

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Despachado depois que um valor de controle é modificado, ao contrário do evento textInput, que é despachado antes de o valor ser modificado. Diferente da versão do Modelo de evento W3C DOM do evento change, que despacha o evento somente depois que o controle perde o foco, a versão ActionScript 3.0 do evento change é despachada toda vez que o controle é alterado. Por exemplo, se um usuário digitar texto em um campo de texto, um evento change será despachado depois de cada pressionamento de tecla.

A constante Event.CHANGE define o valor da propriedade type de um objeto de evento change.

Esse evento tem as seguintes propriedades:

PropriedadeValor
bubblestrue
cancelablefalse; não há comportamento padrão a ser cancelado.
currentTargetO objeto que está processando ativamente o objeto Event com um ouvinte de evento.
targetO objeto que tem seus respectivos valores modificados. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento.

Exemplo  ( Como usar este exemplo )

No seguinte exemplo, o texto digitado pelo usuário (entrada de usuário) é imediatamente copiado para (repetido em) outro campo de texto com um formato de texto diferente.

Dois campos de texto são criados, um para a entrada do usuário e o outro (headingTextField) para a cópia da entrada do usuário. Um objeto TextFormat também é criado e o formato de texto padrão é atribuído ao campo de texto headingTextField. Quando o conteúdo do campo de texto é alterado, o método changeHandler() é chamado, o qual atribui o texto do campo de texto inputTextField ao campo de texto headingTextField. (Se o método foi chamado para o evento TextEvent.TEXT_INPUT em vez do evento Event.CHANGE, o conteúdo da entrada do usuário será copiado apenas depois que o usuário inserir mais 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 do objeto de evento: flash.events.TextEvent
propriedade TextEvent.type = flash.events.TextEvent.LINK

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Despachado quando um usuário clica em um hiperlink em um campo de texto habilitado para HTML, em que o URL começa com "event:". O restante do URL depois de "event:" é colocado na propriedade de texto do evento LINK.

Observação: o comportamento padrão, adicionar texto ao campo de texto, ocorre apenas quando o Flash Player gera o evento, que, nesse caso, acontece quando um usuário tenta inserir texto. Você não pode colocar texto em um campo de texto enviando eventos textInput a ele.

Define o valor da propriedade type de um objeto de evento link.

Esse evento tem as seguintes propriedades:

PropriedadeValor
bubblestrue
cancelablefalse; não há comportamento padrão a ser cancelado.
currentTargetO objeto que está processando ativamente o objeto Event com um ouvinte de evento.
targetO campo de texto que contém o hiperlink que foi clicado. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento.
textO restante do URL depois de "event:"

Exemplo  ( Como usar este exemplo )

No exemplo a seguir, a função playMP3() é definida. Um objeto TextField denominado list é criado e preenchido com texto HTML. O texto "Track 1" e "Track 2" são links dentro do campo de texto. A função playMP3() é chamada quando o usuário clica nos links. O nome do arquivo MP3, que segue a string "event:" no atributo href da marca HTML, é passado para o método linkHandler() como a propriedade text do 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 do objeto de evento: flash.events.Event
propriedade Event.type = flash.events.Event.SCROLL

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Despachado por um objeto TextField após a rolagem pelo usuário.

A constante Event.SCROLL define o valor da propriedade type de um objeto de evento scroll.

Esse evento tem as seguintes propriedades:

PropriedadeValor
bubblesfalse
cancelablefalse; não há comportamento padrão a ser cancelado.
currentTargetO objeto que está processando ativamente o objeto Event com um ouvinte de evento.
targetO objeto TextField que foi rolado. A propriedade target nem sempre é o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento.

Exemplo  ( Como usar este exemplo )

O exemplo a seguir define dois objetos TextField. O primeiro objeto TextField tem dois manipuladores de evento associados. Quando você clica com o mouse dentro do primeiro campo de texto, o evento mouseDown é lançado e o manipulador mouseDownScroll associado é chamado. O manipulador mouseDownScroll() faz um campo rolar. Em seguida, o evento scroll é despachado e o manipulador scrollHandler() associado atualiza o segundo campo de texto para exibir a posição de rolagem atual.
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 do objeto de evento: flash.events.TextEvent
propriedade TextEvent.type = flash.events.TextEvent.TEXT_INPUT

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 9, Flash Lite 4

O Flash Player despacha o evento textInput quando um usuário insere um ou mais caracteres de texto. Vários métodos de entrada de texto podem gerar esse evento, incluindo teclados padrão, IMEs (Editores de método de entrada), sistemas de reconhecimento de voz ou fala e até mesmo o ato de colar texto sem formatação ou informações de estilo.

Define o valor da propriedade type de um objeto de evento textInput.

Observação: Este evento não é despachado para as teclas Excluir ou Backspace.

Esse evento tem as seguintes propriedades:

PropriedadeValor
bubblestrue
cancelabletrue; chama o método preventDefault() para cancelar o comportamento padrão.
currentTargetO objeto que está processando ativamente o objeto Event com um ouvinte de evento.
targetO campo de texto no qual os caracteres estão sendo inseridos. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento.
textO caractere ou a string de caracteres inserida pelo usuário.

Exemplo  ( Como usar este exemplo )

O exemplo a seguir define dois objetos TextField: o primeiro objeto TextField é um campo de texto de entrada e o segundo objeto TextField é um campo de texto dinâmico. A medida que você digita caracteres no primeiro campo de texto, o evento textInput é despachado, o manipulador textInputHandler() é chamado e os caracteres são exibidos no segundo campo de texto: Quando um bloco de texto é colado no campo de entrada, o manipulador de evento copia o bloco inteiro para o outro bloco.
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 do objeto de evento: flash.events.Event

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0, Flash Player 11, Flash Lite 4

O Flash Player despacha o evento textInteractionModeChange quando o usuário altera o modo de interação de um campo de texto. por exemplo, no Android é possível alternar do modo NORMAL para o modo SELECTION usando as opções do menu de contexto

TextFieldExample.as

O seguinte exemplo usa a classe TextFieldExample para exibir uma mensagem de texto. Isso é realizado com as seguintes etapas:
  1. Uma propriedade label do tipo TextField é criada.
  2. O construtor de classe chama a função configureLabel().
  3. O método configureLabel() cria primeiro um novo objeto TextField e o atribui à propriedade label. Em seguida, define seus parâmetros como a seguir:
    • Justifica à esquerda o campo de texto.
    • Ativa o preenchimento do plano de fundo.
    • Ativa a borda.
  4. O método configureLabel() cria a variável format e a atribui a uma nova ocorrência TextFormat com seus parâmetros definidos como a seguir:
    • Tipo de fonte = Verdana
    • Cor da fonte = solid red
    • Tamanho da fonte = 10
    • Fonte sublinhada = true
  5. A propriedade defaultTextFormat do campo de texto label é definida como format e a ocorrência label é adicionada à lista de exibição, que exibe inicialmente um campo de texto sem texto no palco.
  6. O construtor define o texto do campo de texto label como "Hello world and welcome to the show." chamando o 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 que inglês?
O conteúdo na Referência do ActionScript 3.0 aparece em inglês

Nem todas as partes da Referência do ActionScript 3.0 estão traduzidas em todos os idiomas. Quando um elemento de um idioma não está traduzido, ele é exibido em inglês. Por exemplo, a classe ga.controls.HelpBox não está traduzida em nenhum idioma. Por isso, na versão da referência em português do Brasil, a classe ga.controls.HelpBox é exibida em inglês.