Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: AIR 30.0 e versioni precedenti, Flash Player 30.0 e versioni precedenti, Flash Lite 4
Flex 4.6 e versioni precedenti, Flash Pro CS6 e versioni precedenti
Nascondi filtri
flash.text 

TextField  - AS3

Pacchettix

Primo livello
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

Elementi del linguaggio

Costanti globali
Funzioni globali
Operatori
Istruzioni, parole chiave e direttive
Tipi speciali

Appendici

Novità
Errori del compilatore
Avvisi del compilatore
Errori runtime
Migrazione a ActionScript 3
Set di caratteri supportati
Tag solo di MXML
Elementi XML di Motion
Tag Timed Text
Elenco degli elementi obsoleti
Costanti di implementazione dell’accessibilità
Utilizzare gli esempi ActionScript
Note legali
Pacchettoflash.text
Classepublic class TextField
EreditarietàTextField Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Sottoclassi FlexTextField

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

La classe TextField viene utilizzata per creare oggetti di visualizzazione per la visualizzazione e l'immissione di testo. È possibile assegnare un nome di istanza a un campo di testo nella finestra di ispezione Proprietà e utilizzare i metodi e le proprietà della classe TextField per manipolarlo con ActionScript. I nomi di istanza TextField sono visualizzati in Esplora filmato e nella finestra di dialogo Inserisci percorso target del pannello Azioni.

Per creare un campo di testo in modo dinamico, utilizzate la funzione di costruzione TextField().

I metodi della classe TextField consentono di impostare, selezionare e gestire il testo in un campo di testo dinamico o di input creato in fase di runtime o di creazione.

ActionScript fornisce svariati modi per formattare il testo in fase di runtime. La classe TextFormat consente di impostare la formattazione dei caratteri e dei paragrafi per gli oggetti TextField. È possibile applicare stili CSS (Cascading Style Sheets) ai campi di testo utilizzando la proprietà TextField.styleSheet e la classe StyleSheet. Gli stili CSS possono essere utilizzati per specificare lo stile dei tag HTML incorporati, definire nuovi tag di formattazione o applicare stili. Potete assegnare testo in formato HTML, che utilizza eventualmente gli stili CSS, direttamente a un campo di testo. Il testo HTML assegnato a un campo di testo può includere contenuti multimediali incorporati, ad esempio clip filmato e file SWF, GIF, PNG e JPEG. Il testo viene disposto intorno all'oggetto multimediale incorporato nello stesso modo in cui in un browser il testo si dispone intorno a oggetti multimediali incorporati in un documento HTML.

Flash Player supporta inoltre un sottoinsieme di tag HTML utilizzabili per formattare il testo. Per un elenco dei tag HTML supportati, vedete la descrizione della proprietà htmlText.

Vedere gli esempi

Altri esempi

Altre informazioni

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
 InheritedaccessibilityImplementation : AccessibilityImplementation
L'implementazione di accessibilità corrente (AccessibilityImplementation) di questa istanza InteractiveObject.
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
Le opzioni di accessibilità correnti di questo oggetto di visualizzazione.
DisplayObject
 Inheritedalpha : Number
Indica il valore della trasparenza alfa dell'oggetto specificato.
DisplayObject
  alwaysShowSelection : Boolean
Quando è impostata su true e il campo di testo non è attivo, Flash Player evidenzia la selezione nel campo di testo in grigio.
TextField
  antiAliasType : String
Il tipo di antialiasing utilizzato per questo campo di testo.
TextField
  autoSize : String
Controlla il dimensionamento e l'allineamento automatici dei campi di testo.
TextField
  background : Boolean
Specifica se il campo di testo ha un riempimento di sfondo.
TextField
  backgroundColor : uint
Il colore di sfondo del campo di testo.
TextField
 InheritedblendMode : String
Un valore della classe BlendMode che specifica il metodo di fusione da utilizzare.
DisplayObject
 InheritedblendShader : Shader
[sola scrittura] Imposta uno shader utilizzato per la fusione dei colori di primo piano e sfondo.
DisplayObject
  border : Boolean
Specifica se il campo di testo ha un bordo.
TextField
  borderColor : uint
Il colore del bordo del campo di testo.
TextField
  bottomScrollV : int
[sola lettura] Un numero intero (indice a base uno) che indica l'ultima riga in basso attualmente visibile nel campo di testo specificato.
TextField
 InheritedcacheAsBitmap : Boolean
Se è impostata su true, nella cache dei runtime Flash viene memorizzata una rappresentazione bitmap interna dell'oggetto di visualizzazione.
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
Se il valore è diverso da null, questo oggetto Matrix definisce il modo in cui viene eseguito il rendering di un oggetto di visualizzazione quando cacheAsBitmap è impostato su true.
DisplayObject
  caretIndex : int
[sola lettura] L'indice della posizione del punto di registrazione (accento circonflesso).
TextField
  condenseWhite : Boolean
Un valore booleano che specifica se viene rimosso lo spazio vuoto supplementare (spazi, interruzioni di riga, e così via) di un campo di testo HTML.
TextField
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
 InheritedcontextMenu : NativeMenu
Specifica il menu di scelta rapida associato all'oggetto.
InteractiveObject
  defaultTextFormat : flash.text:TextFormat
Specifica il formato applicato al testo appena immesso, ad esempio al testo digitato da un utente o quello immesso mediante il metodo replaceSelectedText().
TextField
  displayAsPassword : Boolean
Specifica se il campo di testo è protetto da password.
TextField
 InheriteddoubleClickEnabled : Boolean
Specifica se l'oggetto riceve gli eventi doubleClick.
InteractiveObject
  embedFonts : Boolean
Specifica se deve essere eseguito il rendering del campo di testo mediante i profili di carattere incorporati.
TextField
 Inheritedfilters : Array
Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione.
DisplayObject
 InheritedfocusRect : Object
Specifica se l'oggetto visualizza un rettangolo di attivazione.
InteractiveObject
  gridFitType : String
Il tipo di adattamento alla griglia utilizzato per questo campo di testo.
TextField
 Inheritedheight : Number
Indica l'altezza dell'oggetto di visualizzazione espressa in pixel.
DisplayObject
  htmlText : String
Contiene la rappresentazione HTML dei contenuti dei campi di testo.
TextField
  length : int
[sola lettura] Il numero di caratteri presenti in un campo di testo.
TextField
 InheritedloaderInfo : LoaderInfo
[sola lettura] Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene.
DisplayObject
 Inheritedmask : DisplayObject
L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato.
DisplayObject
  maxChars : int
Il numero massimo di caratteri immessi da un utente, che il campo di testo può contenere.
TextField
  maxScrollH : int
[sola lettura] Il valore massimo di scrollH.
TextField
  maxScrollV : int
[sola lettura] Il valore massimo di scrollV.
TextField
 InheritedmetaData : Object
Ottiene l’oggetto di metadati dell’istanza DisplayObject se i metadati sono stati memorizzati insieme all’istanza di questo DisplayObject nel file SWF mediante un tag PlaceObject4.
DisplayObject
 InheritedmouseEnabled : Boolean
Specifica se questo oggetto riceve messaggi del mouse o di altri dispositivi di input dell'utente.
InteractiveObject
  mouseWheelEnabled : Boolean
Un valore booleano che indica se Flash Player scorre automaticamente i campi di testo multiriga quando l'utente fa clic su un campo di testo e utilizza la rotella del mouse.
TextField
 InheritedmouseX : Number
[sola lettura] Indica la coordinata x del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel.
DisplayObject
 InheritedmouseY : Number
[sola lettura] Indica la coordinata y del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel.
DisplayObject
  multiline : Boolean
Indica se il campo è un campo di testo multiriga.
TextField
 Inheritedname : String
Indica il nome dell'istanza dell'oggetto DisplayObject.
DisplayObject
 InheritedneedsSoftKeyboard : Boolean
Specifica se deve essere visualizzata una tastiera virtuale (una tastiera software a video) quando questa istanza InteractiveObject riceve lo stato di attivazione.
InteractiveObject
  numLines : int
[sola lettura] Definisce il numero delle righe di testo in un campo di testo multiriga.
TextField
 InheritedopaqueBackground : Object
Specifica se l'oggetto di visualizzazione è opaco con un determinato colore di sfondo.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[sola lettura] Indica l'oggetto DisplayObjectContainer che contiene questo oggetto di visualizzazione.
DisplayObject
  restrict : String
Indica il set di caratteri che l'utente può immettere in un campo di testo.
TextField
 Inheritedroot : DisplayObject
[sola lettura] Nel caso di un oggetto di visualizzazione all'interno di un file SWF caricato, la proprietà principale è l'oggetto di visualizzazione più in alto nella porzione della struttura dell'elenco di visualizzazione rappresentata da quel file SWF.
DisplayObject
 Inheritedrotation : Number
Indica la rotazione dell'istanza DisplayObject, espressa in gradi, rispetto alla posizione originale.
DisplayObject
 InheritedrotationX : Number
Indica la rotazione dell'asse x dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D.
DisplayObject
 InheritedrotationY : Number
Indica la rotazione dell'asse y dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D.
DisplayObject
 InheritedrotationZ : Number
Indica la rotazione dell'asse z dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D.
DisplayObject
 Inheritedscale9Grid : Rectangle
La griglia di modifica in scala attualmente attiva.
DisplayObject
 InheritedscaleX : Number
Indica la scala orizzontale (percentuale) dell'oggetto applicata dal punto di registrazione.
DisplayObject
 InheritedscaleY : Number
Indica la scala verticale (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto.
DisplayObject
 InheritedscaleZ : Number
Indica la scala di profondità (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto.
DisplayObject
  scrollH : int
La posizione di scorrimento orizzontale corrente.
TextField
 InheritedscrollRect : Rectangle
I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione.
DisplayObject
  scrollV : int
La posizione verticale del testo in un campo.
TextField
  selectable : Boolean
Un valore booleano che indica se il campo di testo è selezionabile.
TextField
  selectionBeginIndex : int
[sola lettura] Il valore dell'indice a base zero del primo carattere nella selezione corrente.
TextField
  selectionEndIndex : int
[sola lettura] Il valore dell'indice a base zero dell'ultimo carattere nella selezione corrente.
TextField
  sharpness : Number
La precisione dei bordi del glifo in questo campo di testo.
TextField
 Inherited    softKeyboard : String
Controlla l'aspetto della tastiera software.
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
Definisce l’area che deve rimanere visibile sullo schermo quando è visualizzata una tastiera virtuale (non disponibile in iOS).
InteractiveObject
 Inheritedstage : Stage
[sola lettura] Lo stage dell'oggetto di visualizzazione.
DisplayObject
  styleSheet : StyleSheet
Associa un foglio di stile al campo di testo.
TextField
 InheritedtabEnabled : Boolean
Specifica se questo oggetto è incluso nell'ordine di tabulazione.
InteractiveObject
 InheritedtabIndex : int
Specifica l'ordine di tabulazione degli oggetti in un file SWF.
InteractiveObject
  text : String
Una stringa che rappresenta il testo corrente nel campo di testo.
TextField
  textColor : uint
Il colore del testo nel campo di testo, in formato esadecimale.
TextField
  textHeight : Number
[sola lettura] L'altezza del testo espressa in pixel.
TextField
  textInteractionMode : String
[sola lettura] La proprietà modalità di interazione. Il valore predefinito è TextInteractionMode.NORMAL.
TextField
  textWidth : Number
[sola lettura] La larghezza del testo espressa in pixel.
TextField
  thickness : Number
Lo spessore dei bordi del glifo in questo campo di testo.
TextField
 Inheritedtransform : flash.geom:Transform
Un oggetto con proprietà relative alla matrice, alla trasformazione del colore e ai limiti di pixel di un oggetto di visualizzazione.
DisplayObject
  type : String
Il tipo di campo di testo.
TextField
  useRichTextClipboard : Boolean
Specifica se copiare e incollare la formattazione assieme al testo.
TextField
 Inheritedvisible : Boolean
Determina se l'oggetto di visualizzazione è visibile o meno.
DisplayObject
 Inheritedwidth : Number
Indica la larghezza dell'oggetto di visualizzazione espressa in pixel.
DisplayObject
  wordWrap : Boolean
Un valore booleano che indica se per il campo di testo è abilitato il ritorno a capo automatico.
TextField
 Inheritedx : Number
Indica la coordinata x dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale.
DisplayObject
 Inheritedy : Number
Indica la coordinata y dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale.
DisplayObject
 Inheritedz : Number
Indica la posizione della coordinata z lungo l'asse z dell'istanza DisplayObject relativa al contenitore principale 3D.
DisplayObject
Metodi pubblici
 MetodoDefinito da
  
Crea una nuova istanza TextField.
TextField
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.
EventDispatcher
  
Aggiunge la stringa specificata dal parametro nuovoTesto alla fine del testo del relativo campo.
TextField
 Inherited
Invia un evento nel flusso di eventi.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace.
DisplayObject
  
Restituisce un rettangolo che rappresenta il riquadro di delimitazione del carattere.
TextField
  
Restituisce il valore dell'indice a base zero del carattere nel punto specificato dai parametri x e y.
TextField
  
Dato un indice di carattere, restituisce l'indice del primo carattere nello stesso paragrafo.
TextField
  
Restituisce un riferimento DisplayObject per l'id dato, relativo a un'immagine o a un file SWF che è stato aggiunto a un campo di testo con formattazione HTML mediante un tag <img>.
TextField
  
Restituisce il valore dell'indice a base zero della riga nel punto specificato dai parametri x e y.
TextField
  
Restituisce il valore dell'indice a base zero della riga contenente il carattere specificato dal parametro charIndex.
TextField
  
getLineLength(lineIndex:int):int
Restituisce il numero di caratteri presenti in una riga di testo specifica.
TextField
  
Restituisce informazioni sulla metrica relative a una data riga di testo.
TextField
  
getLineOffset(lineIndex:int):int
Restituisce l'indice di carattere del primo carattere nella riga specificata dal parametro lineIndex.
TextField
  
Restituisce il testo della riga specificata dal parametro lineIndex.
TextField
  
Dato un indice di carattere, restituisce la lunghezza del paragrafo contenente il carattere dato.
TextField
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Restituisce un rettangolo che definisce i bordi dell'oggetto di visualizzazione in base al sistema di coordinate definito dal parametro targetCoordinateSpace, esclusi gli eventuali tratti presenti sulle forme.
DisplayObject
  
getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Restituisce un oggetto TextFormat che contiene le informazioni di formattazione per tutto il testo compreso tra i parametri indiceIniziale e indiceFinale.
TextField
 Inherited
Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto Point.
DisplayObject
 Inherited
Converte un punto bidimensionale dalle coordinate dello stage (globali) in quelle (locali) di un oggetto di visualizzazione tridimensionale.
DisplayObject
 Inherited
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.
EventDispatcher
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Valuta il riquadro di delimitazione dell'oggetto di visualizzazione per verificare se si sovrappone o si interseca con il riquadro di delimitazione dell'oggetto di visualizzazione obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con il punto specificato dai parametri x e y.
DisplayObject
  
isFontCompatible(fontName:String, fontStyle:String):Boolean
[statico] Restituisce true se è disponibile un carattere incorporato con i valori fontName e fontStyle specificati, dove Font.fontType è flash.text.FontType.EMBEDDED.
TextField
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Converte un punto tridimensionale delle coordinate (locali) dell'oggetto di visualizzazione tridimensionale in un punto bidimensionale nelle coordinate dello stage (globali).
DisplayObject
 Inherited
Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point.
DisplayObject
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Rimuove un listener dall'oggetto EventDispatcher.
EventDispatcher
  
Sostituisce la selezione corrente con il contenuto del parametro value.
TextField
  
replaceText(beginIndex:int, endIndex:int, newText:String):void
Sostituisce un intervallo di caratteri, specificato dai parametri indiceIniziale e indiceFinale, con il contenuto del parametro nuovoTesto.
TextField
 Inherited
Alza una tastiera virtuale.
InteractiveObject
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
  
setSelection(beginIndex:int, endIndex:int):void
Imposta come selezionato il testo designato dai valori di indice del primo e ultimo carattere, specificati dai parametri indiceIniziale e indiceFinale.
TextField
  
setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Applica la formattazione indicata dal parametro format al testo specificato nel campo di testo.
TextField
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
 Inherited
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.
EventDispatcher
Eventi
 Evento Riepilogo Definito da
 Inherited[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.EventDispatcher
 InheritedInviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione.DisplayObject
 InheritedInviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione sullo stage, sia direttamente o mediante l'aggiunta di una sottostruttura ad albero che contiene l'oggetto di visualizzazione.DisplayObject
  Inviato dopo la modifica del valore di un controllo, a differenza dell'evento textInput che viene inviato prima della modifica del valore.TextField
 InheritedInviato quando l'utente sceglie "Cancella" (o "Elimina") dal menu di scelta rapida per il testo.InteractiveObject
 InheritedInviato quando l'utente preme e rilascia il pulsante principale del dispositivo di puntamento sopra lo stesso InteractiveObject.InteractiveObject
 Inherited
    contextMenu
Inviato quando un'azione dell'utente causa la visualizzazione del menu di scelta rapida associato a questo oggetto interattivo in un'applicazione AIR.InteractiveObject
 InheritedInviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di tagliare oppure sceglie "Taglia" dal menu di scelta rapida per il testo.InteractiveObject
 InheritedInviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di tagliare oppure sceglie "Taglia" dal menu di scelta rapida testuale.InteractiveObject
 Inherited[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.EventDispatcher
 InheritedInviato quando l'utente preme e rilascia il pulsante principale di un dispositivo di puntamento due volte in rapida successione sopra la stessa istanza InteractiveObject quando il flag doubleClickEnabled dell'oggetto è impostato su true.InteractiveObject
 Inherited[evento di trasmissione] Inviato quando l'indicatore di riproduzione sta entrando in un nuovo fotogramma.DisplayObject
 Inherited[evento di trasmissione] Inviato quando l'indicatore di riproduzione sta per uscire dal fotogramma corrente.DisplayObject
 InheritedInviato dopo che un oggetto di visualizzazione ha ricevuto lo stato di attivazione.InteractiveObject
 InheritedInviato dopo che un oggetto di visualizzazione ha perso lo stato di attivazione.InteractiveObject
 Inherited[evento di trasmissione] Inviato dopo l'esecuzione delle funzioni di costruzione degli oggetti di visualizzazione dei fotogrammi, ma prima dell'esecuzione degli script di fotogramma.DisplayObject
 InheritedInviato quanto l’utente crea un punto di contatto lungo il bordo della superficie di contatto con un’istanza di InteractiveObject (ad esempio toccando bordo della superficie di contatto in Siri Remote per Apple TV). Alcuni dispositivi possono inoltre interpretare questo contatto come una combinazione di più eventi touch.InteractiveObject
 InheritedInviato quanto l'utente preme due punti di contatto sulla stessa istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, preme e rilascia due dita su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).InteractiveObject
 InheritedInviato quanto l'utente sposta un punto di contatto sull'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, sposta un dito da sinistra a destra su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).InteractiveObject
 InheritedInviato quanto l'utente esegue un'operazione di rotazione in corrispondenza di un punto di contatto con un'istanza InteractiveObject (ad esempio, tocca lo schermo con due dita e le ruota su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).InteractiveObject
 InheritedInviato quanto l'utente esegue un'operazione di tocco in corrispondenza di un punto di contatto con un'istanza InteractiveObject (ad esempio, tocca lo schermo con tre dita e quindi le sposta parallelamente su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).InteractiveObject
 InheritedInviato quanto l'utente crea un punto di contatto con un'istanza InteractiveObject, quindi tocca un dispositivo abilitato per il tocco (ad esempio, posiziona più dita su un oggetto di visualizzazione per aprire un menu e quindi tocca con un dito per selezionare una voce di menu su un cellulare o su un Tablet PC con touch screen).InteractiveObject
 InheritedInviato quanto l'utente esegue un'operazione di zoom in corrispondenza di un punto di contatto con un'istanza InteractiveObject (ad esempio, tocca lo schermo con due dita e allontana velocemente le dita su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).InteractiveObject
 InheritedQuesto evento viene inviato a qualsiasi applicazione client che supporti input in linea con un IME.InteractiveObject
 InheritedInviato quando l'utente preme un tasto.InteractiveObject
 InheritedInviato quando l'utente tenta di cambiare l'elemento attivo utilizzando la tastiera.InteractiveObject
 InheritedInviato quando l'utente rilascia un tasto.InteractiveObject
  Inviato quando un utente fa clic su un collegamento ipertestuale in un campo di testo abilitato per HTML, dove l'URL inizia con "event:".TextField
 InheritedInviato quando l'utente preme e rilascia il pulsante centrale del dispositivo di puntamento sopra lo stesso InteractiveObject.InteractiveObject
 InheritedInviato quando un utente preme il pulsante centrale del dispositivo di puntamento su un'istanza InteractiveObject.InteractiveObject
 InheritedInviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.InteractiveObject
 InheritedInviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.InteractiveObject
 InheritedInviato quando l'utente tenta di cambiare l'elemento attivo utilizzando un dispositivo di puntamento.InteractiveObject
 InheritedInviato quando l'utente sposta il dispositivo di puntamento mentre si trova sopra un'istanza InteractiveObject.InteractiveObject
 InheritedInviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject.InteractiveObject
 InheritedInviato quando l'utente sposta un dispositivo di puntamento sopra un'istanza InteractiveObject.InteractiveObject
 InheritedInviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.InteractiveObject
 InheritedInviato quando si fa ruotare la rotella del mouse su un'istanza InteractiveObject.InteractiveObject
 InheritedInviato dall'iniziatore del trascinamento InteractiveObject quando l'utente rilascia il trascinamento.InteractiveObject
 InheritedInviato dall'InteractiveObject di destinazione quando un oggetto trascinato viene rilasciato su di esso e il rilascio è stato accettato con una chiamata a DragManager.acceptDragDrop().InteractiveObject
 InheritedInviato da un InteractiveObject quando un trascinamento entra nei suoi limiti.InteractiveObject
 InheritedInviato da un InteractiveObject quando un trascinamento esce dai propri limiti.InteractiveObject
 InheritedInviato continuamente da un InteractiveObject mentre un'azione di trascinamento rimane all'interno dei suoi limiti.InteractiveObject
 InheritedInviato all'inizio di un'operazione di trascinamento dall'InteractiveObject che è specificato come iniziatore del trascinamento nella chiamata a DragManager.doDrag().InteractiveObject
 InheritedInviato durante un'operazione di trascinamento dall'InteractiveObject che è specificato come iniziatore del trascinamento nella chiamata a DragManager.doDrag().InteractiveObject
 InheritedInviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di incollare oppure sceglie "Incolla" dal menu di scelta rapida testuale.InteractiveObject
 InheritedInviato quando l'utente abbassa uno stilo attivo oltre la soglia di rilevamento della prossimità dello schermo.InteractiveObject
 Inherited
    proximityEnd
Inviato quando l'utente solleva uno stilo attivo sopra la soglia di rilevamento della prossimità dello schermo.InteractiveObject
 InheritedInviato quando l'utente sposta uno stilo attivo sullo schermo rimanendo entro la soglia di rilevamento della prossimità.InteractiveObject
 Inherited
    proximityOut
Inviato quando l'utente allontana uno stilo attivo da questo InteractiveObject rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo.InteractiveObject
 InheritedInviato quando l'utente sposta uno stilo attivo direttamente sopra questo InteractiveObject rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo.InteractiveObject
 InheritedInviato quando l'utente allontana uno stilo attivo da questo InteractiveObject o da qualsiasi suo elemento secondario rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo.InteractiveObject
 InheritedInviato quando l'utente sposta uno stilo attivo sopra questo InteractiveObject dall'esterno della struttura di discendenti dell'oggetto nell'elenco di visualizzazione (rimanendo entro la soglia di rilevamento della prossimità dello schermo).InteractiveObject
 InheritedInviato quando un utente rilascia il pulsante del dispositivo di puntamento dopo averlo premuto sopra un’istanza InteractiveObject e aver quindi spostato il dispositivo di puntamento fuori dell’istanza stessa.InteractiveObject
 InheritedInviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione.DisplayObject
 InheritedInviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione sullo stage, sia direttamente o mediante la rimozione di una sottostruttura ad albero che contiene l'oggetto di visualizzazione.DisplayObject
 Inherited[evento di trasmissione] Inviato quando stanno per essere eseguiti l'aggiornamento e il rendering dell'elenco di visualizzazione.DisplayObject
 InheritedInviato quando l'utente preme e rilascia il pulsante destro del dispositivo di puntamento sopra lo stesso InteractiveObject.InteractiveObject
 InheritedInviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.InteractiveObject
 InheritedInviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.InteractiveObject
 InheritedInviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject.InteractiveObject
 InheritedInviato quando l'utente sposta un dispositivo di puntamento sopra un'istanza InteractiveObject.InteractiveObject
  Inviato da un oggetto TextField dopo che l'utente ha eseguito lo scorrimento.TextField
 InheritedInviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di selezionare tutto oppure sceglie "Seleziona tutto" dal menu di scelta rapida testuale.InteractiveObject
 InheritedInviato immediatamente dopo la visualizzazione della tastiera software.InteractiveObject
 InheritedInviato immediatamente prima della visualizzazione della tastiera software.InteractiveObject
 InheritedInviato immediatamente dopo la chiusura della tastiera software.InteractiveObject
 InheritedInviato quando cambia il valore del flag tabChildren dell'oggetto.InteractiveObject
 InheritedInviato quando cambia il flag tabEnabled dell'oggetto.InteractiveObject
 InheritedInviato quando cambia il valore della proprietà tabIndex dell'oggetto.InteractiveObject
  Flash Player invia l'evento textInput quando un utente immette uno o più caratteri di testo.TextField
  Flash Player invia l'evento textInteractionModeChange quando un utente cambia la modalità di interazione di un campo di testo.TextField
 InheritedInviato quanto l'utente stabilisce per la prima volta un contatto con un dispositivo abilitato per il tocco (ad esempio, tocca con un dito un cellulare o un Tablet PC con touch screen).InteractiveObject
 InheritedInviato quanto l'utente rimuove il contatto con un dispositivo abilitato per il tocco (ad esempio, solleva un dito da un cellulare o un Tablet PC con touch screen).InteractiveObject
 InheritedInviato quando l'utente tocca il dispositivo, e viene inviato in modo continuativo finché il punto di contatto non viene rimosso.InteractiveObject
 InheritedInviato quanto l'utente sposta il punto di contatto lontano da un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un oggetto di visualizzazione a un altro disponibile su un cellulare o su un Tablet PC con touch screen).InteractiveObject
 InheritedInviato quanto l'utente sposta il punto di contatto su un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un punto esterno a un oggetto di visualizzazione a un punto su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).InteractiveObject
 InheritedInviato quanto l'utente sposta il punto di contatto lontano da un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un oggetto di visualizzazione a un punto esterno a un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).InteractiveObject
 InheritedInviato quanto l'utente sposta il punto di contatto su un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un punto esterno a un oggetto di visualizzazione a un punto su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).InteractiveObject
 InheritedInviato quanto l'utente solleva il punto di contatto sulla stessa istanza InteractiveObject in corrispondenza della quale è stato iniziato il contatto su un dispositivo abilitato per il tocco (ad esempio, preme e rilascia un dito da un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen).InteractiveObject
Descrizione delle proprietà

alwaysShowSelection

proprietà
alwaysShowSelection:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Quando è impostata su true e il campo di testo non è attivo, Flash Player evidenzia la selezione nel campo di testo in grigio. Quando è impostata su false e il campo di testo non è attivo, Flash Player non evidenzia la selezione nel campo di testo.

Il valore predefinito è false.



Implementazione
    public function get alwaysShowSelection():Boolean
    public function set alwaysShowSelection(value:Boolean):void

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Compilate ed eseguite il file seguente. Quando eseguite il file, trascinate per selezionare il testo in ognuno dei due campi di testo e notate la differenza nell'evidenziazione quando selezionate il testo nei due campi di testo (cambiamento di attivazione):
    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

proprietà 
antiAliasType:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9

Il tipo di antialiasing utilizzato per questo campo di testo. Utilizzate le costanti flash.text.AntiAliasType per questa proprietà. È possibile controllare questa impostazione solo se il carattere è incorporato (con la proprietà embedFonts impostata su true). L'impostazione predefinita è flash.text.AntiAliasType.NORMAL.

Per impostare i valori di questa proprietà, utilizzate i seguenti valori stringa:

Valore stringaDescrizione
flash.text.AntiAliasType.NORMALApplica l'antialiasing di testo normale. Questo valore corrisponde al tipo di antialiasing utilizzato da Flash Player versione 7 e precedenti.
flash.text.AntiAliasType.ADVANCEDApplica l'antialiasing avanzato, che consente di migliorare la leggibilità del testo (funzione aggiunta in Flash Player 8). L'antialiasing avanzato consente di migliorare la leggibilità del testo e di eseguire il rendering dei caratteri con una qualità molto alta anche quando sono di piccole dimensioni. Trova il suo utilizzo ottimale nelle applicazioni con molto testo di piccole dimensioni. L'antialiasing avanzato non è consigliato per i caratteri superiori a 48 punti.



Implementazione
    public function get antiAliasType():String
    public function set antiAliasType(value:String):void

Elementi API correlati

autoSize

proprietà 
autoSize:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Controlla il dimensionamento e l'allineamento automatici dei campi di testo. I valori accettabili per le costanti TextFieldAutoSize sono: TextFieldAutoSize.NONE (predefinito), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT e TextFieldAutoSize.CENTER.

Se autoSize è impostata su TextFieldAutoSize.NONE (il valore predefinito), non viene effettuato alcun ridimensionamento.

Se autoSize è impostata su TextFieldAutoSize.LEFT, il testo viene considerato giustificato a sinistra, pertanto il margine sinistro del campo di testo rimane fisso e l'eventuale ridimensionamento di una riga singola del campo viene effettuato sul margine destro. Se il testo contiene un'interruzione di riga (ad esempio "\n" o "\r"), anche il lato inferiore viene ridimensionato in modo da rientrare nella riga di testo successiva. Se anche wordWrap viene impostata su true, solo il lato inferiore del campo di testo viene ridimensionato mentre il lato destro rimane fisso.

Se autoSize è impostata su TextFieldAutoSize.RIGHT, il testo viene considerato giustificato a destra, pertanto il margine destro del campo di testo rimane fisso e l'eventuale ridimensionamento di una riga singola del campo viene effettuato sul margine sinistro. Se il testo contiene un'interruzione di riga (ad esempio "\n" or "\r"), anche il lato inferiore viene ridimensionato in modo da rientrare nella riga di testo successiva. Se anche wordWrap viene impostata su true, solo il lato inferiore del campo di testo viene ridimensionato mentre il lato sinistro rimane fisso.

Se autoSize è impostata su TextFieldAutoSize.CENTER, il testo viene considerato giustificato al centro, pertanto l'eventuale ridimensionamento di una riga singola del campo di testo viene distribuito equamente sui margini destro e sinistro. Se il testo contiene un'interruzione di riga (ad esempio "\n" o "\r"), anche il lato inferiore viene ridimensionato in modo da rientrare nella riga di testo successiva. Se anche wordWrap viene impostata su true, solo il lato inferiore del campo di testo viene ridimensionato mentre i lati sinistro e destro rimangono fissi.



Implementazione
    public function get autoSize():String
    public function set autoSize(value:String):void

Genera
ArgumentError — Il valore di autoSize specificato non è un membro di flash.text.TextFieldAutoSize.

Elementi API correlati

background

proprietà 
background:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Specifica se il campo di testo ha un riempimento di sfondo. Se true, il campo di testo ha un riempimento di sfondo. Se false, il campo di testo non ha un riempimento di sfondo. Utilizzate la proprietà backgroundColor per impostare il colore di sfondo di un campo di testo.

Il valore predefinito è false.



Implementazione
    public function get background():Boolean
    public function set background(value:Boolean):void

Elementi API correlati

backgroundColor

proprietà 
backgroundColor:uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Il colore di sfondo del campo di testo. Il valore predefinito è 0xFFFFFF (bianco). Questa proprietà può essere recuperata o impostata, anche se non è presente uno sfondo e il colore è visibile solo se il campo di testo ha la proprietà background impostata su true.



Implementazione
    public function get backgroundColor():uint
    public function set backgroundColor(value:uint):void

Elementi API correlati

border

proprietà 
border:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Specifica se il campo di testo ha un bordo. Se true, il campo di testo presenta un bordo. Se false, il campo di testo è privo di bordo. Utilizzate la proprietà borderColor per impostare il colore del bordo.

Il valore predefinito è false.



Implementazione
    public function get border():Boolean
    public function set border(value:Boolean):void

Elementi API correlati

borderColor

proprietà 
borderColor:uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Il colore del bordo del campo di testo. Il valore predefinito è 0x000000 (nero). Questa proprietà può essere recuperata o impostata, anche se non è presente un bordo e il colore è visibile solo se il campo di testo ha la proprietà border impostata su true.



Implementazione
    public function get borderColor():uint
    public function set borderColor(value:uint):void

Elementi API correlati

bottomScrollV

proprietà 
bottomScrollV:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Un numero intero (indice a base uno) che indica l'ultima riga in basso attualmente visibile nel campo di testo specificato. Il campo di testo può essere considerato come una finestra sopra un blocco di testo. La proprietà scrollV è l'indice a base 1 della prima riga visibile in alto nella finestra.

Tutto il testo compreso tra le righe indicate da scrollV e bottomScrollV è visibile nel campo di testo.



Implementazione
    public function get bottomScrollV():int

Elementi API correlati

caretIndex

proprietà 
caretIndex:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

L'indice della posizione del punto di registrazione (accento circonflesso). Se non viene visualizzato alcun punto di registrazione, il valore è rappresentato dalla posizione in cui il punto di registrazione si troverebbe se fosse ripristinata l'attivazione del campo (solitamente, l'ultima posizione in cui si trovava il punto di registrazione, oppure 0 se il campo non è attivato).

Gli indici delle estensioni di selezione sono a base zero (ad esempio, la prima posizione è 0, la seconda è 1 e così via).



Implementazione
    public function get caretIndex():int

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
In questo esempio, viene creata un'istanza TextField che viene poi compilata con del testo. Viene assegnato un listener di eventi in modo che quando l'utente fa clic su TextField, viene chiamato il metodo printCursorPosition. In quel caso, vengono generati i valori delle proprietà caretIndex, selectionBeginIndex e selectionEndIndex.

Eseguite questo esempio e provate a fare clic all'interno di TextField per selezionare del testo. Quindi, fate clic nel campo senza selezionare il testo. Quando fate clic nel testo senza effettuare una selezione, la proprietà caretIndex indica dove si trova il punto di registrazione, e le proprietà selectionBeginIndex e selectionEndIndex equivalgono al valore della proprietà 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

proprietà 
condenseWhite:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Un valore booleano che specifica se viene rimosso lo spazio vuoto supplementare (spazi, interruzioni di riga, e così via) di un campo di testo HTML. Il valore predefinito è false. La proprietà condenseWhite ha effetto solo sul testo impostato con la proprietà htmlText, non con la proprietà text. Se il testo viene impostato con la proprietà text, condenseWhite viene ignorato.

Se condenseWhite è impostato su true, utilizzate comandi HTML standard quali <BR> e <P> per inserire le interruzioni di riga nel campo di testo.

Impostate la proprietà condenseWhite prima della proprietà htmlText.



Implementazione
    public function get condenseWhite():Boolean
    public function set condenseWhite(value:Boolean):void

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
L'esempio seguente mostra la differenza tra l'impostazione di condenseWhite su false e su 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

proprietà 
defaultTextFormat:flash.text:TextFormat

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Specifica il formato applicato al testo appena immesso, ad esempio al testo digitato da un utente o quello immesso mediante il metodo replaceSelectedText().

Nota: quando si selezionano i caratteri da sostituire con setSelection() e replaceSelectedText(), defaultTextFormat si applica solo se il testo è stato selezionato fino all'ultimo carattere incluso. Di seguito viene fornito un esempio:

     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 si accede alla proprietà defaultTextFormat, l'oggetto TextFormat restituito ha tutte le proprietà definite. Nessuna proprietà è null.

Nota: questa proprietà non può essere impostata se al campo di testo è applicato un foglio di stile.



Implementazione
    public function get defaultTextFormat():flash.text:TextFormat
    public function set defaultTextFormat(value:flash.text:TextFormat):void

Genera
Error — Questo metodo non può essere utilizzato in un campo di testo con un foglio di stile.

Elementi API correlati

displayAsPassword

proprietà 
displayAsPassword:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Specifica se il campo di testo è protetto da password. Se il valore di questa proprietà è true, il campo di testo è considerato come se fosse protetto da password e nasconde i caratteri immessi visualizzando degli asterischi invece che i caratteri veri e propri. Se invece è false, il campo di testo non è considerato come protetto da password. Quando è abilitata la modalità di protezione mediante password, i comandi Taglia e Copia e i rispettivi tasti di scelta rapida non funzionano. Questo meccanismo di sicurezza impedisce a un eventuale utente malintenzionato di utilizzare i tasti di scelta rapida per scoprire la password di un computer non sorvegliato.

Il valore predefinito è false.



Implementazione
    public function get displayAsPassword():Boolean
    public function set displayAsPassword(value:Boolean):void

embedFonts

proprietà 
embedFonts:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Specifica se deve essere eseguito il rendering del campo di testo mediante i profili di carattere incorporati. Se è impostato su false, Flash Player esegue il rendering del campo di testo utilizzando i caratteri dispositivo.

Se si imposta la proprietà embedFonts su true per un campo di testo, è necessario specificare un carattere per il testo mediante la proprietà font di un oggetto TextFormat applicato al campo di testo. Se il carattere specificato non è incorporato nel file SWF, il testo non viene visualizzato.

Il valore predefinito è false.



Implementazione
    public function get embedFonts():Boolean
    public function set embedFonts(value:Boolean):void

Elementi API correlati

gridFitType

proprietà 
gridFitType:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9

Il tipo di adattamento alla griglia utilizzato per questo campo di testo. Questa proprietà si applica solo se la proprietà flash.text.AntiAliasType del campo di testo è impostata su flash.text.AntiAliasType.ADVANCED.

Il tipo di adattamento alla griglia utilizzato determina se Flash Player forza l'adattamento delle righe orizzontali e verticali spesse a una griglia di pixel o sottopixel.

Per impostare i valori per la proprietà flash.text.GridFitType, utilizzate i valori stringa seguenti:

Valore stringaDescrizione
flash.text.GridFitType.NONESpecifica nessun adattamento alla griglia. Le linee orizzontali e verticali dei glifi non vengono forzate alla griglia di pixel. Si tratta di un'impostazione consigliata per le animazioni o i caratteri con dimensioni elevate.
flash.text.GridFitType.PIXELSpecifica che le linee orizzontali e verticali spesse vengono adattate alla griglia di pixel. Questa impostazione funziona solo per i campi di testo allineati a sinistra. Per usare questa impostazione, la proprietà flash.display.AntiAliasType del campo di testo deve essere impostata su flash.text.AntiAliasType.ADVANCED. Di solito, fornisce il livello migliore di leggibilità per il testo allineato a sinistra.
flash.text.GridFitType.SUBPIXELSpecifica che le linee orizzontali e verticali spesse vengono adattate alla griglia di sottopixel su un monitor LCD. Per usare questa impostazione, la proprietà flash.text.AntiAliasType del campo di testo deve essere impostata su flash.text.AntiAliasType.ADVANCED. L'impostazione flash.text.GridFitType.SUBPIXEL è spesso indicata per il testo dinamico allineato a destra o al centro, e talvolta rappresenta un utile compromesso in termini di qualità tra l'animazione e il testo.

Il valore predefinito è pixel.



Implementazione
    public function get gridFitType():String
    public function set gridFitType(value:String):void

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente vengono mostrati tre campi di testo per diverse impostazioni della proprietà gridFitType. Quando usate questo esempio, osservate la differenza di leggibilità per le prime due righe. Potete inoltre notare l'ottimo uso di GridFitType.PIXEL per il testo allineato a sinistra e GridFitType.SUBPIXEL per il testo allineato a destra.
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

proprietà 
htmlText:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Contiene la rappresentazione HTML dei contenuti dei campi di testo.

Flash Player supporta i tag HTML seguenti:

Tag Descrizione
Tag di ancoraggio Il tag <a> crea un collegamento ipertestuale e supporta i seguenti attributi:
  • target: Specifica il nome della finestra di destinazione in cui viene caricata la pagina. Le opzioni disponibili sono _self, _blank, _parent e _top. L'opzione _self specifica il frame corrente nella finestra corrente, _blank indica una nuova finestra, _parent specifica l'elemento principale del frame corrente, mentre _top indica il frame di primo livello nella finestra corrente.
  • href: specifica un URL o un evento link ActionScript. L'URL può essere sia assoluto che relativo alla posizione del file SWF che sta caricando la pagina. Un esempio di riferimento assoluto a un URL è http://www.adobe.com, mentre /index.html è un riferimento relativo. Gli URL assoluti devono essere preceduti dal prefisso http://, altrimenti Flash Player o AIR li considera come URL relativi. Per fare in modo che il collegamento esegua una funzione ActionScript in un file SWF è possibile utilizzare l'evento link, anziché aprire un URL. Per specificare un evento link è necessario utilizzare all'interno dell'attributo href lo schema dell'evento piuttosto che lo schema http. Utilizzate per esempio href="event:myText" invece di href="http://myURL"; quando l'utente fa clic su un collegamento ipertestuale contenente lo schema dell'evento, il campo di testo invia un TextEvent link la cui proprietà text è impostata su "myText". È possibile creare una funzione ActionScript che vada in esecuzione ogniqualvolta viene inviato il TextEvent link. Per i tag di ancoraggio è possibile anche definire gli stili a:link, a:hover e a:active utilizzando i fogli di stile.
Tag del grassetto Il tag <b> rende il testo in grassetto. Il tipo di carattere usato per visualizzare il testo deve essere disponibile in stile grassetto.
Tag per l'interruzione di riga Il tag <br> crea un'interruzione di riga nel campo di testo. Per poter utilizzare questo tag, il campo di testo deve essere multiriga.
Tag del carattere Il tag <font> specifica un tipo di carattere o un elenco di tipi di carattere per la visualizzazione del testo. Il tag del carattere supporta gli attributi seguenti:
  • color: sono supportati solo i valori colore esadecimali (#FFFFFF).
  • face: specifica il nome del carattere da utilizzare. Come illustrato nell'esempio seguente, è possibile anche specificare un elenco di nomi di carattere separati da virgola. In tal caso Flash Player sceglie il primo carattere disponibile. Se il carattere specificato non è installato nel computer locale o non è incorporato nel file SWF, Flash Player sceglie un altro carattere.
  • size: specifica le dimensioni del carattere. Si possono usare dimensioni di pixel assolute, come 16 o 18, o dimensioni di punti relative, come +2 o -4.
Tag per le immagini Il tag <img> consente di incorporare file di immagine (JPEG, GIF, PNG), file SWF e clip filmato esterni in campi di testo. Al testo viene applicato automaticamente un flusso intorno alle immagini incorporate nei campi di testo. Per poter disporre il testo intorno a un'immagine, il campo di testo deve essere multiriga.

Il tag <img> supporta i seguenti attributi:

  • src: specifica l'URL di un file di immagine o SWF oppure l'identificatore di concatenamento di un simbolo della libreria relativo a un clip filmato. Questo è l'unico attributo obbligatorio, tutti gli altri sono facoltativi. La visualizzazione dei file esterni (JPEG, GIF, PNG e SWF) avviene solo dopo lo scaricamento completo dei file.
  • width: la larghezza dell'immagine, del file SWF o del clip filmato inserito, in pixel.
  • height: l'altezza dell'immagine, del file SWF o del clip filmato inserito, in pixel.
  • align: specifica l'allineamento orizzontale dell'immagine incorporata nel campo di testo. I valori accettati sono left e right. Il valore predefinito è left.
  • hspace: specifica la quantità di spazio orizzontale intorno all'immagine in cui non viene visualizzato testo. Il valore predefinito è 8.
  • vspace: specifica la quantità di spazio verticale intorno all'immagine in cui non viene visualizzato testo. Il valore predefinito è 8.
  • id: specifica il nome dell'istanza relativa a un clip filmato, creata da Flash Player, che contiene il file di immagine o SWF o il clip filmato incorporato. Questo approccio viene utilizzato per controllare il contenuto incorporato con ActionScript.
  • checkPolicyFile: indica che Flash Player verifica la presenza di un file di criteri degli URL sul server associato al dominio dell'immagine. Se viene trovato un file di criteri, i file SWF nei domini elencati nel file possono accedere ai dati dell'immagine caricata, ad esempio mediante una chiamata al metodo BitmapData.draw() con questa immagine come parametro source. Per ulteriori informazioni sulla sicurezza, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player .

Flash visualizza il contenuto multimediale incorporato in un campo di testo alle dimensioni reali. Per specificare le dimensioni dei contenuti multimediali incorporati, utilizzate gli attributi <img> tag height e width.

In genere, un'immagine incorporata in un campo di testo compare nella riga dopo il tag <img>. Tuttavia, quando il tag <img> è il primo carattere del campo di testo, l'immagine è visualizzata nella prima riga del campo di testo.

Per i contenuti AIR presenti nella funzione di sicurezza sandbox dell'applicazione, AIR ignora i tag img nel contenuto HTML degli oggetti TextField di ActionScript. Lo scopo è quello di prevenire possibili attacchi di phishing.

Tag del corsivo Il tag <i> visualizza in corsivo il testo a cui viene applicato. Il tipo di carattere usato per visualizzare il testo deve essere disponibile in stile corsivo.
Tag per le voci di elenco Il tag <li> inserisce un punto elenco davanti al testo cui esso viene applicato. Nota: poiché Flash Player e AIR non riconoscono i tag delle voci di elenco ordinate e non ordinate (<ol> e <ul>), non modificano la modalità di rendering dell'elenco. Tutti gli elenchi sono non ordinati e tutte le voci di elenco utilizzano i punti elenco.
Tag del paragrafo Il tag <p> crea un nuovo paragrafo. Per poter utilizzare questo tag, il campo di testo deve essere multiriga. Il tag <p> supporta i seguenti attributi:
  • align: specifica l'allineamento del testo del paragrafo; i valori validi sono left, right, justify e center.
  • class: Specifica una classe di stile CSS definita da un oggetto flash.text.StyleSheet.
Tag SPAN Il tag <span> può essere usato solo con stili di testo CSS. Questo tag supporta i seguenti attributi:
  • class: Specifica una classe di stile CSS definita da un oggetto flash.text.StyleSheet.
Tag TEXTFORMAT

Il tag <textformat> permette di utilizzare nei campi di testo un sottoinsieme delle proprietà di formattazione dei paragrafi appartenente alla classe TextFormat (ad esempio, interlinea, rientro, margini e spazi di tabulazione). È possibile combinare i tag <textformat> con i tag HTML incorporati.

Il tag <textformat> supporta i seguenti attributi:

  • blockindent: specifica il rientro del blocco di testo in punti; corrisponde a TextFormat.blockIndent.
  • indent: specifica il rientro dal margine sinistro del primo carattere del paragrafo; corrisponde a TextFormat.indent. Sono accettati numeri sia positivi che negativi.
  • leading: specifica l'interlinea (spazio verticale) tra le righe; corrisponde a TextFormat.leading. Sono accettati numeri sia positivi che negativi.
  • leftmargin: indica il margine sinistro del paragrafo, espresso in punti. Corrisponde a TextFormat.leftMargin.
  • rightmargin: indica il margine destro del paragrafo, espresso in punti. Corrisponde a TextFormat.rightMargin.
  • tabstops: specifica gli spazi di tabulazione personalizzati sotto forma di un array di numeri interi non negativi. Corrisponde a TextFormat.tabStops.
Tag di sottolineatura Il tag <u> sottolinea il testo cui esso è applicato.

Flash Player e AIR supportano le seguenti entità HTML:

Entità Descrizione
&lt; < (minore di)
&gt; > (maggiore di)
& & (e commerciale)
&quot; " (virgolette doppie)
&apos; ' (apostrofo, virgolette singole)

Flash e AIR supportano inoltre codici di caratteri espliciti, quali &#38; (e commerciale ASCII) e &#x20AC; (simbolo € Unicode).



Implementazione
    public function get htmlText():String
    public function set htmlText(value:String):void

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente viene creato un campo di testo (TextField) denominato tf1 e viene assegnata una stringa di testo in formato HTML alla proprietà text del campo creato. Quando viene tracciata la proprietà htmlText del campo, l'output è la stringa in formato HTML e Flash Player aggiunge automaticamente dei tag aggiuntivi, quali <P> e <FONT>. Quando viene tracciato il valore della proprietà text, viene visualizzata la stringa non formattata e priva dei tag HTML.

Per fare un confronto, le stesse operazioni vengono eseguite su un altro oggetto TextField denominato tf2, con l'aggiunta di un oggetto StyleSheet che viene assegnato alla proprietà styleSheet di tf2 prima che venga impostata la sua proprietà htmlText. In quel caso, quando la proprietà htmlText viene tracciata, include solo il testo HTML esatto che era stato originariamente assegnato alla proprietà htmlText, a prova del fatto che Flash Player non ha aggiunto altri tag

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

proprietà 
length:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Il numero di caratteri presenti in un campo di testo. Il carattere di tabulazione (\t) viene contato come un carattere.



Implementazione
    public function get length():int

maxChars

proprietà 
maxChars:int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Il numero massimo di caratteri immessi da un utente, che il campo di testo può contenere. Uno script può inserire testi di lunghezza maggiore di quella consentita dalla proprietà maxChars, che indica solo la lunghezza massima del testo che può essere immesso da un utente. Se il valore di questa proprietà è 0, non vi sono limitazioni al testo che l'utente può immettere.

Il valore predefinito è 0.



Implementazione
    public function get maxChars():int
    public function set maxChars(value:int):void

maxScrollH

proprietà 
maxScrollH:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Il valore massimo di scrollH.



Implementazione
    public function get maxScrollH():int

Elementi API correlati

maxScrollV

proprietà 
maxScrollV:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Il valore massimo di scrollV.



Implementazione
    public function get maxScrollV():int

Elementi API correlati

mouseWheelEnabled

proprietà 
mouseWheelEnabled:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9

Un valore booleano che indica se Flash Player scorre automaticamente i campi di testo multiriga quando l'utente fa clic su un campo di testo e utilizza la rotella del mouse. Per impostazione predefinita, questo valore corrisponde a true. Questa proprietà è utile se desiderate impedire che la rotella del mouse effettui lo scorrimento dei campi di testo o se si desidera implementare uno scorrimento personalizzato per i campi di testo.



Implementazione
    public function get mouseWheelEnabled():Boolean
    public function set mouseWheelEnabled(value:Boolean):void

multiline

proprietà 
multiline:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Indica se il campo è un campo di testo multiriga. Se questo valore è true, il campo di testo è composto da più righe; se è false, il campo di testo è costituito da una sola riga di testo. In un campo di tipo TextFieldType.INPUT, il valore multiline determina se il tasto Invio crea una nuova riga (con una valore false, il tasto Invio viene ignorato). Se si incolla del testo in TextField con un valore multiline impostato su false, i caratteri newline vengono rimossi dal testo.

Il valore predefinito è false.



Implementazione
    public function get multiline():Boolean
    public function set multiline(value:Boolean):void

Elementi API correlati

numLines

proprietà 
numLines:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Definisce il numero delle righe di testo in un campo di testo multiriga. Se la proprietà wordWrap è impostata su true, il numero di righe aumenta quando il testo va a capo.



Implementazione
    public function get numLines():int

Elementi API correlati

restrict

proprietà 
restrict:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Indica il set di caratteri che l'utente può immettere in un campo di testo. Se il valore della proprietà restrict è null, è possibile immettere qualsiasi carattere. Se il valore della proprietà restrict è una stringa vuota, non è possibile immettere alcun carattere. Se il valore della proprietà restrict è una stringa di caratteri, è possibile immettere nel campo di testo soltanto i caratteri presenti nella stringa. La scansione della stringa viene eseguita da sinistra a destra. È possibile specificare un intervallo di caratteri utilizzando un carattere trattino (-). Soltanto le interazioni dell'utente sono limitate; uno script può invece immettere qualsiasi testo nel campo di testo. Tale proprietà non è sincronizzabile con le opzioni carattere Incorpora della finestra di ispezione Proprietà.

Se la stringa comincia con il simbolo ^, vengono accettati tutti i caratteri a eccezione di quelli che seguono questo valore nella stringa. Se la stringa non comincia con (^), non viene accettato alcun carattere ad eccezione di quelli indicati nella stringa.

Nell'esempio seguente è consentita l'immissione solo di caratteri in lettere maiuscole, spazi e numeri in un campo di testo:

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

Nell'esempio seguente sono inclusi tutti i caratteri, eccetto le lettere minuscole:

     my_txt.restrict = "^a-z";
     

È possibile utilizzare una barra rovesciata per immettere ^ o - così come è scritto. Le sequenze di barre rovesciate che vengono accettate sono \-, \^ o \\. La barra rovesciata deve essere un carattere effettivo nella stringa, quindi quando viene utilizzata nel codice ActionScript, è necessario specificare una doppia barra rovesciata. Ad esempio, il codice seguente include solo il trattino (-) e l'accento circonflesso (^):

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

Il carattere ^ può essere utilizzato in qualsiasi punto della stringa per passare alternativamente dall'inclusione all'esclusione di caratteri. Nell'esempio seguente sono inclusi solo i caratteri in lettere maiuscole, esclusa la lettera maiuscola Q:

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

È possibile utilizzare la sequenza di escape \u per creare stringhe restrict. Il codice seguente include solo i caratteri da ASCII 32 (spazio) ad ASCII 126 (tilde).

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

Il valore predefinito è null.



Implementazione
    public function get restrict():String
    public function set restrict(value:String):void

scrollH

proprietà 
scrollH:int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

La posizione di scorrimento orizzontale corrente. Se la proprietà scrollH è impostata su 0, non è possibile scorrere in orizzontale il testo. Il valore di questa proprietà è un numero intero che rappresenta la posizione orizzontale in pixel.

Le unità dello scorrimento orizzontale sono i pixel, mentre quelle dello scorrimento verticale sono le righe. Lo scorrimento orizzontale viene misurato in pixel poiché la maggior parte dei caratteri più diffusi ha una spaziatura proporzionale, ovvero i singoli caratteri possono avere larghezze diverse. Flash effettua lo scorrimento verticale in base alle righe per consentire agli utenti di visualizzare una riga di testo integralmente. Anche se in una riga sono presenti caratteri diversi, l'altezza della riga viene adattata al carattere più grande.

Nota: la proprietà scrollH è a base zero e non a base 1 come la proprietà dello scorrimento verticale scrollV.



Implementazione
    public function get scrollH():int
    public function set scrollH(value:int):void

Elementi API correlati

scrollV

proprietà 
scrollV:int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

La posizione verticale del testo in un campo. La proprietà scrollV è utile per indirizzare gli utenti verso un paragrafo specifico all'interno di un brano lungo o per creare campi di testo a scorrimento.

Le unità dello scorrimento verticale sono le righe, mentre quelle dello scorrimento orizzontale sono i pixel. Se la prima riga visualizzata è la prima riga del campo di testo, scrollV è impostato su 1 (non su 0). Lo scorrimento orizzontale viene misurato in pixel poiché la maggior parte dei caratteri ha una spaziatura proporzionale, ovvero i singoli caratteri possono avere larghezze diverse. Flash effettua lo scorrimento verticale in base alle righe per consentire agli utenti di visualizzare una riga di testo integralmente. Anche se in una riga sono presenti caratteri diversi, l'altezza della riga viene adattata al carattere più grande.



Implementazione
    public function get scrollV():int
    public function set scrollV(value:int):void

Elementi API correlati

selectable

proprietà 
selectable:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Un valore booleano che indica se il campo di testo è selezionabile. Il valore true indica che il testo è selezionabile. La proprietà selectable controlla se un campo di testo è selezionabile, non se è modificabile. Ad esempio, un campo di testo dinamico può essere selezionabile anche se non è modificabile. Se un campo di testo dinamico non è selezionabile, non è possibile selezionarne il testo.

Se selectable è impostata su false, il testo del campo di testo non risponde ai comandi di selezione del mouse o della tastiera e il testo non può essere copiato mediante il comando Copia. Se selectable è impostata su true, il testo del campo di testo può essere selezionato mediante il mouse o la tastiera e copiato mediante il comando Copia. In tal modo potete selezionare il testo anche se il campo di testo è dinamico e non di input.

Il valore predefinito è true.



Implementazione
    public function get selectable():Boolean
    public function set selectable(value:Boolean):void

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente vengono creati due campi di testo dinamici: uno con la proprietà selectable impostata su true e l'altro con la proprietà selectable impostata su false. Quando usate questo esempio, provate a selezionare il testo in questi campi con il mouse o la tastiera.
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

proprietà 
selectionBeginIndex:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Il valore dell'indice a base zero del primo carattere nella selezione corrente. (Ad esempio, il primo carattere è 0, il secondo è 1, e così via.) Questa proprietà è il valore di caretIndex se nessuna parte di testo viene selezionata.



Implementazione
    public function get selectionBeginIndex():int

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
In questo esempio, viene creata un'istanza TextField che viene poi compilata con del testo. Viene assegnato un listener di eventi in modo che quando l'utente fa clic su TextField, viene chiamato il metodo printCursorPosition. In quel caso, vengono generati i valori delle proprietà caretIndex, selectionBeginIndex e selectionEndIndex.

Eseguite questo esempio e provate a fare clic all'interno di TextField per selezionare del testo. Quindi, fate clic nel campo senza selezionare il testo. Quando fate clic nel testo senza effettuare una selezione, la proprietà caretIndex indica dove si trova il punto di registrazione, e le proprietà selectionBeginIndex e selectionEndIndex equivalgono al valore della proprietà 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

proprietà 
selectionEndIndex:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Il valore dell'indice a base zero dell'ultimo carattere nella selezione corrente. (Ad esempio, il primo carattere è 0, il secondo è 1, e così via.) Questa proprietà è il valore di caretIndex se nessuna parte di testo viene selezionata.



Implementazione
    public function get selectionEndIndex():int

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
In questo esempio, viene creata un'istanza TextField che viene poi compilata con del testo. Viene assegnato un listener di eventi in modo che quando l'utente fa clic su TextField, viene chiamato il metodo printCursorPosition. In quel caso, vengono generati i valori delle proprietà caretIndex, selectionBeginIndex e selectionEndIndex.

Eseguite questo esempio e provate a fare clic all'interno di TextField per selezionare del testo. Quindi, fate clic nel campo senza selezionare il testo. Quando fate clic nel testo senza effettuare una selezione, la proprietà caretIndex indica dove si trova il punto di registrazione, e le proprietà selectionBeginIndex e selectionEndIndex equivalgono al valore della proprietà 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

proprietà 
sharpness:Number

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9

La precisione dei bordi del glifo in questo campo di testo. Questa proprietà si applica solo se la proprietà flash.text.AntiAliasType del campo di testo è impostata su flash.text.AntiAliasType.ADVANCED. L'intervallo valido per sharpness è un numero compreso tra -400 e 400. Se tentate di impostare sharpness su un valore non compreso nell'intervallo, Flash utilizza il valore più vicino presente nell'intervallo (-400 o 400).

Il valore predefinito è 0.



Implementazione
    public function get sharpness():Number
    public function set sharpness(value:Number):void

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente viene mostrato l'effetto della modifica della proprietà sharpness per un oggetto TextField. Dovete incorporare il carattere e impostare la proprietà antiAliasType su 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

proprietà 
styleSheet:StyleSheet

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Associa un foglio di stile al campo di testo. Per informazioni sulla creazione di fogli di stile, vedete la classe StyleSheet e la Guida per gli sviluppatori di ActionScript 3.0.

Il foglio di stile associato a un campo di testo può essere modificato in qualsiasi momento. Se il foglio di stile in uso viene modificato, il campo di testo viene ridisegnato utilizzando il nuovo foglio di stile. Per rimuovere il foglio di stile, impostatelo su null o undefined. Se il foglio di stile in uso viene rimosso, il campo di testo viene ridisegnato senza foglio di stile.

Nota: se il foglio di stile viene rimosso, il contenuto di TextField.text e TextField.htmlText cambia in modo da incorporare la formattazione precedentemente applicata al foglio di stile. Per conservare il contenuto TextField.htmlText originale senza la formattazione, salvate il valore in una variabile prima di rimuovere il foglio di stile.



Implementazione
    public function get styleSheet():StyleSheet
    public function set styleSheet(value:StyleSheet):void

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente viene definito un semplice oggetto StyleSheet, che viene assegnato a un campo di testo con contenuto HTML. Impostate la proprietà stylesheet prima di impostare il contenuto.
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

proprietà 
text:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Una stringa che rappresenta il testo corrente nel campo di testo. Le righe sono separate dal carattere di ritorno a capo ('\r', ASCII 13). Questa proprietà contiene testo non formattato nel campo di testo, senza tag HTML.

Per ottenere il testo in formato HTML, utilizzate la proprietà htmlText.

Nota: se viene applicato un foglio di stile al campo di testo, il contenuto della proprietà text sarà interpretato come HTML.



Implementazione
    public function get text():String
    public function set text(value:String):void

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente viene creato un campo di testo (TextField) denominato tf1 e viene assegnata una stringa di testo in formato HTML alla proprietà text del campo creato. Quando viene tracciata la proprietà htmlText del campo, l'output è la stringa in formato HTML e Flash Player aggiunge automaticamente dei tag aggiuntivi, quali <P> e <FONT>. Quando viene tracciato il valore della proprietà text, viene visualizzata la stringa non formattata e priva dei tag HTML.

Per fare un confronto, le stesse operazioni vengono eseguite su un altro oggetto TextField denominato tf2, con l'aggiunta di un oggetto StyleSheet che viene assegnato alla proprietà styleSheet di tf2 prima che venga impostata la sua proprietà htmlText. In quel caso, quando la proprietà htmlText viene tracciata, include solo il testo HTML esatto che era stato originariamente assegnato alla proprietà htmlText, a prova del fatto che Flash Player non ha aggiunto altri tag

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

proprietà 
textColor:uint

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Il colore del testo nel campo di testo, in formato esadecimale. Il sistema dei colori esadecimali utilizza sei cifre per rappresentare i valori dei colori. Ogni cifra ha sedici possibili valori o caratteri. I caratteri vanno da 0 a 9 e da A a F. Il nero, ad esempio, è rappresentato da 0x000000; il bianco da 0xFFFFFF.

Il valore predefinito è 0 (0x000000).



Implementazione
    public function get textColor():uint
    public function set textColor(value:uint):void

Esempio  ( Come utilizzare questo esempio )
Il codice ActionScript seguente crea un oggetto TextField e ne cambia la proprietà textColor in red (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

proprietà 
textHeight:Number  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

L'altezza del testo espressa in pixel.



Implementazione
    public function get textHeight():Number

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente viene creato un oggetto TextField a cui viene assegnato del testo. Le istruzioni trace visualizzano i valori delle proprietà textWidth e textHeight. Per consentire un confronto, sono visualizzate anche le proprietà width e height. Potete notare che i valori di textHeight e textWidth possono variare a seconda del carattere utilizzato nel computer.
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

proprietà 
textInteractionMode:String  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 11, Flash Lite 4

La proprietà modalità di interazione. Il valore predefinito è TextInteractionMode.NORMAL. Sulle piattaforme mobili, la modalità normale implica la possibilità di far scorrere il testo ma non di selezionarlo. È possibile passare alla modalità selezionabile tramite il menu contestuale incorporato nel campo di testo. Sul desktop, la modalità normale implica la possibilità sia di far scorrere il testo che di selezionarlo.



Implementazione
    public function get textInteractionMode():String

textWidth

proprietà 
textWidth:Number  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

La larghezza del testo espressa in pixel.



Implementazione
    public function get textWidth():Number

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente viene creato un oggetto TextField a cui viene assegnato del testo. Le istruzioni trace visualizzano i valori delle proprietà textWidth e textHeight. Per consentire un confronto, sono visualizzate anche le proprietà width e height. Potete notare che i valori di textHeight e textWidth possono variare a seconda del carattere utilizzato nel computer.
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

proprietà 
thickness:Number

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9

Lo spessore dei bordi del glifo in questo campo di testo. Questa proprietà funziona solo quando flash.text.AntiAliasType è impostato su flash.text.AntiAliasType.ADVANCED.

L'intervallo valido per thickness è un numero compreso tra -200 e 200. Se tentate di impostare thickness su un valore non compreso nell'intervallo, la proprietà viene impostata sul valore più vicino presente nell'intervallo (-200 o 200).

Il valore predefinito è 0.



Implementazione
    public function get thickness():Number
    public function set thickness(value:Number):void

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente viene mostrato l'effetto della modifica della proprietà thickness per un oggetto TextField. Dovete incorporare il carattere e impostare la proprietà antiAliasType su 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

proprietà 
type:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Il tipo di campo di testo. Una delle due costanti TextFieldType seguenti: TextFieldType.DYNAMIC, che indica un campo di testo dinamico non modificabile dall'utente, o TextFieldType.INPUT, che specifica un campo di testo di input modificabile dall'utente.

Il valore predefinito è dynamic.



Implementazione
    public function get type():String
    public function set type(value:String):void

Genera
ArgumentError — Il tipo (type) specificato non è un membro di flash.text.TextFieldType.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )
Nell'esempio seguente vengono creati due campi di testo: tfDynamic e tfInput. In entrambi viene immesso del testo. Tuttavia, tfDynamic ha la proprietà type impostata su TextFieldType.DYNAMIC, mentre tfInput ha la proprietà type impostata su TextFieldType.INPUT, quindi l'utente può modificare il testo in tfInput ma può solo visualizzare il testo in 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

proprietà 
useRichTextClipboard:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9

Specifica se copiare e incollare la formattazione assieme al testo. Quando è impostata su true, Flash Player copia e incolla da un campo di testo all'altro anche la formattazione (allineamento, grassetto e corsivo). I campi di testo di origine e di destinazione dell'operazione di copia e incolla devono avere la proprietà useRichTextClipboard impostata su true. Il valore predefinito è false.



Implementazione
    public function get useRichTextClipboard():Boolean
    public function set useRichTextClipboard(value:Boolean):void

Esempio  ( Come utilizzare questo esempio )
In questo esempio viene creato un campo di testo di input (tf1) e due campi di testo dinamici (tf2 e tf3). Il codice assegna a ogni campo di testo dinamico un oggetto TextFormat (carattere Courier grassetto). Per il campo di testo tf2 la proprietà useRichTextClipboard è impostata su false. Per il campo di testo tf3 la proprietà useRichTextClipboard è impostata su true. Quando copiate il testo dal campo di testo tf2 e lo incollate nel campo di testo tf1, il testo incollato non include la formattazione. Quando copiate il testo dal campo di testo tf3 (la cui proprietà useRichTextClipboard è impostata su true) e lo incollate nel campo di testo tf1, il testo incollato include la formattazione.
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

proprietà 
wordWrap:Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Un valore booleano che indica se per il campo di testo è abilitato il ritorno a capo automatico. Se il valore di wordWrap è true, il campo di testo ha il ritorno a capo; se è false, il campo di testo non ha il ritorno a capo. Il valore predefinito è false.



Implementazione
    public function get wordWrap():Boolean
    public function set wordWrap(value:Boolean):void

Esempio  ( Come utilizzare questo esempio )
Questo esempio mostra la differenza tra l'impostazione della proprietà wordWrap su true oppure su false. Vengono create due istanze TextField con contenuti troppo estesi per la loro larghezza. La proprietà wordWrap della prima istanza (denominata tfWrap) viene impostata su true, mentre viene impostata su false per la seconda istanza (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;
        }
    }
}
Descrizione della funzione di costruzione

TextField

()Funzione di costruzione
public function TextField()

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Crea una nuova istanza TextField. Dopo che è stata creata l'istanza TextField, chiamare il metodo addChild() o il metodo addChildAt() dell'oggetto DisplayObjectContainer principale per aggiungere l'istanza TextField all'elenco di visualizzazione.

Le dimensioni predefinite di un campo di testo sono di 100 x 100 pixel.


Esempio  ( Come utilizzare questo esempio )

L'esempio seguente mostra come potete creare dinamicamente un oggetto TextField di input in ActionScript 3.0 impostando la proprietà del tipo di oggetto campo di testo sulla costante TextFieldType.INPUT. Esempio fornito da 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);
Descrizione dei metodi

appendText

()metodo
public function appendText(newText:String):void

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Aggiunge la stringa specificata dal parametro newText alla fine del testo del relativo campo. Questo metodo è più efficiente rispetto a un'assegnazione addizione (+=) applicata a una proprietà text (ad esempio someTextField.text += moreText), in particolare nel caso di un campo di testo con una quantità di contenuto significativa.

Parametri

newText:String — La stringa da aggiungere al testo esistente.


Esempio  ( Come utilizzare questo esempio )

Il seguente esempio visualizza l'ora nel caso in cui non sia né sabato né domenica, il testo "It's the weekend," se è sabato o domenica. Inoltre effettua il conteggio del numero di caratteri fino a una certa posizione e il numero di linee nel campo di testo.

Il campo di testo outputText viene impostato automaticamente in modo da ridimensionarsi a seconda del testo e di effettuare l'allineamento a sinistra tramite la proprietà autoSize. La proprietà outputText.text scrive la prima linea del contenuto e il metodo appendText() allega la restante parte del contenuto (non è necessario cominciare con la proprietà text; il metodo appendText() può essere utilizzato anche per allegare testo dall'esterno). Se impostate la proprietà text una seconda volta il testo originale verrà sovrascritto. Utilizzate l'operatore += per allegare del contenuto assieme alla proprietà text.

La dichiarazione if controlla se la data odierna è sabato (6) o domenica (0). In caso contrario il metodo toLocaleTimeString() restituisce l'ora locale che viene allegata al contenuto del campo di testo.

La proprietà length del campo di testo viene utilizzata per leggere il numero di caratteri fino al momento in cui la funzione viene chiamata mentre la proprietà numLines viene utilizzata per contare il numero di linee nel campo di testo. Notate che il numero di linee comprende anche le linee vuote e che la lunghezza del contenuto comprende anche i caratteri corrispondenti agli spazi vuoti e alle interruzioni di linea (\n).

  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

()metodo 
public function getCharBoundaries(charIndex:int):Rectangle

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce un rettangolo che rappresenta il riquadro di delimitazione del carattere.

Parametri

charIndex:int — Gli indici a base zero del carattere (ad esempio, la prima posizione è 0, la seconda è 1, e così via).

Restituisce
Rectangle — Un rettangolo con i valori x e y massimi e minimi che definiscono il riquadro di delimitazione del carattere.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio il metodo getCharBoundaries() viene utilizzato per evidenziare un carattere selezionato dall'utente.

La classe definisce l'oggetto spotlight Shape che verrà utilizzato per tracciare un rettangolo attorno ad ognuno dei caratteri selezionati. Quando l'utente fa clic sul campo di testo myTextField viene richiamato il metodo clickHandler().

All'interno del metodo clickHandler() il metodo getCharIndexAtPoint() ottiene l'indice del carattere tramite le coordinate localX e localY del clic del mouse corrispondenti allo Sprite contenitore. Il metodo getCharIndexAtPoint() restituisce -1 se il punto (clic del mouse ) non corrisponde ad alcun carattere. Poiché il campo di testo potrebbe essere più ampio del testo, viene effettuato un controllo sul numero intero restituito (index) così da essere sicuri che l'utente abbia fatto clic su un carattere. Il numero intero index viene utilizzato anche da getCharBoundaries() per ottenere un oggetto Rectangle da sistemare sui limiti esterni del carattere. Il metodo clear() cancella tutti gli oggetti spotlight Shape precedentemente visualizzati. Nella posizione in cui si trova il carattere (coordinate del punto di partenza (10, 10)) viene prodotto un nuovo rettangolo le cui dimensioni corrispondono alla larghezza e all'altezza del carattere utilizzando le coordinate x e y del rettangolo frame restituito. L'oggetto spotlight viene riempito di colore giallo per evidenziare il carattere; viene anche impostato il valore dell'opacità al 35% così da rendere il carattere visibile. Notate che anche gli spazi vengono considerati caratteri.

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

()metodo 
public function getCharIndexAtPoint(x:Number, y:Number):int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce il valore dell'indice a base zero del carattere nel punto specificato dai parametri x e y.

Parametri

x:Number — La coordinata x del carattere.
 
y:Number — La coordinata y del carattere.

Restituisce
int — Gli indici a base zero del carattere (ad esempio, la prima posizione è 0, la seconda è 1, e così via). Restituisce -1 se il punto non si trova sopra ad alcun carattere.

Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio quando un utente fa clic su un carattere, questo viene copiato in un altro campo di testo situato al di sopra del testo.

Il primo campo di testo contiene il testo che l'utente deve selezionare. Per far sì che sul testo venga fatto clic ma non effettuata la selezione, la proprietà selectable viene impostata su false. Quando l'utente fa clic sul campo di testo firstTextField viene richiamato il metodo clickHandler().

All'interno del metodo clickHandler() il metodo getCharIndexAtPoint() ottiene l'indice del carattere tramite le coordinate localX e localY del clic del mouse. Poiché il campo di testo potrebbe essere più ampio del testo, viene effettuato un controllo sul numero intero restituito (index) così da essere sicuri che l'utente abbia fatto clic su un carattere (il metodo getCharIndexAtPoint() restituisce -1 se il punto (clic del mouse ) non corrisponde ad alcun carattere). Le coordinate del mouse vengono utilizzate per impostare le coordinate del nuovo campo di testo nel punto in cui il carattere copiato dovrà apparire. Il colore del carattere nel secondo campo di testo viene impostato su rosso. Infine viene impostato il testo nel secondo campo in modo da corrispondere al carattere selezionato che viene recuperato per mezzo del metodo charAt(). Notate che utilizzando la proprietà text al posto del metodo appendText() il carattere recuperato andrà a sostituire il testo presente nel secondo campo di testo invece di aggiungersi allo stesso.

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

()metodo 
public function getFirstCharInParagraph(charIndex:int):int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Dato un indice di carattere, restituisce l'indice del primo carattere nello stesso paragrafo.

Parametri

charIndex:int — Gli indici a base zero del carattere (ad esempio, il primo carattere è 0, il secondo è 1, e così via).

Restituisce
int — Il valore dell'indice a base zero del primo carattere nello stesso paragrafo.

Genera
RangeError — L'indice del carattere specificato non rientra nell'intervallo.

Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio la formattazione del paragrafo viene applicata al contenuto del campo di testo. Quando l'utente fa clic su un paragrafo, il testo del paragrafo verrà allineato a destra e quando l'utente fa clic sul paragrafo una seconda volta, il paragrafo riprenderà il suo formato originale (allineamento a sinistra come impostazione predefinita).

Nella funzione di costruzione, il campo di testo myTextField viene impostato per l'a capo automatico. Il metodo getTextFormat restituisce il formato originale del primo carattere del contenuto del campo di testo situato nell'oggetto TextFormat originalFormat. Viene definito inoltre un nuovo oggetto TextFormat (newFormat) la cui proprietà align viene impostata sull'allineamento a destra. Quando l'utente fa clic sul campo di testo, viene richiamato il metodo clickHandler().

All'interno del metodo clickHandler() il metodo getCharIndexAtPoint() ottiene l'indice del carattere tramite le coordinate localX e localY del clic del mouse. La prima dichiarazione if controlla se l'utente ha fatto clic su un carattere. Utilizzando il numero intero clickIndex restituito dal metodo getCharIndexAtPoint(), il metodo getFirstCharInParagraph() restituisce l'indice del primo carattere nel paragrafo su cui l'utente ha fatto clic. L'indice dell'ultimo carattere nel paragrafo viene determinato aggiungendo la lunghezza del paragrafo (tramite il metodo getParagraphLength()) all'indice del primo carattere nel paragrafo, meno l'ultimo carattere (corrispondente a \n). La seconda dichiarazione if controlla il formato del primo carattere nel paragrafo. Se il valore del suo allineamento corrisponde al formato originale (allineamento a sinistra), il nuovo formato viene applicato a tutti i caratteri del paragrafo. In caso contrario il formato del paragrafo viene riportato al suo stato originario. L'allineamento, insieme al rientro di prima riga, al punto di elenco, alla tabulazione, ai margini destro e sinistro sono formati propri dei paragrafi. Notate che quando si utilizza l'a capo automatico o l'interruzione di linea, la formattazione verrà applicata solo alla prima linea del paragrafo a meno che l'argomento endIndex del metodo setTextFormat() non sia stato definito.

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

()metodo 
public function getImageReference(id:String):DisplayObject

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce un riferimento DisplayObject per l'id dato, relativo a un'immagine o a un file SWF che è stato aggiunto a un campo di testo con formattazione HTML mediante un tag <img>. Il tag <img> è nel seguente formato:

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

Parametri

id:String — L'id a cui far corrispondere l'attributo id del tag <img>.

Restituisce
DisplayObject — L'oggetto di visualizzazione corrispondente all'immagine o al file SWF con l'attributo corrispondente id nel tag <img> del campo di testo. Per il contenuto multimediale caricato da una fonte esterna, questo oggetto è un oggetto Loader e, una volta caricato, l'oggetto multimediale è un elemento secondario di quell'oggetto Loader. Per i contenuti multimediali incorporati nel file SWF, è l'oggetto caricato. Se non esiste un tag <img> con id corrispondente, il metodo restituisce null.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio, quando si fa clic sul campo di testo, viene modificata l'immagine nel campo portando l'opacità al 25% e ruotandola di 90 gradi rispetto alla posizione originale. L'immagine continuerà a ruotare a ogni clic successivo.

L'immagine (image.jpg) è viene allegata tramite HTML. Si presume che nella stessa directory del file SWF si trovi un file immagine. È necessario definire un attributo id per il tag img in modo da poter accedere all'immagine attraverso il metodo getImageReference(). Per includere il contenuto di stringhe formattate in HTML si utilizza la proprietà htmlText. Quando l'utente fa clic sul campo di testo myTextField viene richiamato il metodo clickHandler().

All'interno del metodo clickHandler(), il metodo getImageReference() restituisce un riferimento all'immagine come DisplayObject. Tale riferimento può essere utilizzato per manipolare l'immagine come qualsiasi altro oggetto DisplayObject. In questo caso vengono impostate le proprietà alpha (per l'opacità) e rotation (per la rotazione). Per accedere alla matrice dell'oggetto visualizzato, trasformate il colore e i contorni dei pixel, si può utilizzare la proprietà transform. Notate anche che è necessario importare flash.display.DisplayObject.

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

()metodo 
public function getLineIndexAtPoint(x:Number, y:Number):int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce il valore dell'indice a base zero della riga nel punto specificato dai parametri x e y.

Parametri

x:Number — La coordinata x della riga.
 
y:Number — La coordinata y della riga.

Restituisce
int — Gli indici a base zero della riga (ad esempio, la prima riga è 0, la seconda è 1, e così via). Restituisce -1 se il punto non si trova sopra alcuna riga.

Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio quando un utente seleziona una linea dal sonetto di Shakespeare, questa viene copiata (allegata) in un nuovo campo di testo.

Nella funzione di costruzione, per il campo di testo poem viene scelta l'impostazione senza a capo automatico (perché si tratta di una poesia). Viene utilizzata anche la proprietà autoSize per impostare il testo in modo che si sistemi automaticamente e si disponga con allineamento a sinistra. Il campo di testo poemCopy viene situato al di sotto del campo di testo poem. Quando un utente fa clic su una linea della poesia, viene richiamato il metodo clickHandler().

All'interno del metodo clickHandler() il metodo getLineIndexAtPoint() restituisce l'indice della linea sulla quale l'utente ha fatto clic tramite le coordinate localX e localY del clic del mouse (poiché in questo caso la poesia originale rientra nelle dimensioni del campo di testo, non è necessario il controllo per un errore di intervallo (RangeError) effettuato dal metodo getCharIndexAtPoint()). L'indice della linea viene quindi utilizzato per ottenere il contenuto della linea in formato stringa tramite il metodo getLineText(); tale contenuto viene successivamente allegato al contenuto del campo di testo poemCopy. L'operazione di copiatura può così essere effettuata indefinitamente, ma da un certo punto in poi il testo finirà al di fuori dell'area visibile del campo di testo poemCopy.

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

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

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

           poem.addEventListener(MouseEvent.CLICK, clickHandler); 

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

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

getLineIndexOfChar

()metodo 
public function getLineIndexOfChar(charIndex:int):int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce il valore dell'indice a base zero della riga contenente il carattere specificato dal parametro charIndex.

Parametri

charIndex:int — Gli indici a base zero del carattere (ad esempio, il primo carattere è 0, il secondo è 1, e così via).

Restituisce
int — Il valore dell'indice a base zero della riga.

Genera
RangeError — L'indice del carattere specificato non rientra nell'intervallo.

Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio il metodo getLineIndexOfChar() restituisce i numeri di linea dei caratteri numero 100 e 500 del campo di testo.

Il campo di testo myTextField viene definito in modo da andare a capo automaticamente ed essere allineato a sinistra. Il metodo getLineIndexOfChar() restituisce l'indice della linea per gli indici dei caratteri specificati (100 and 500). Questa informazioni viene quindi allegata di seguito al paragrafo. Notate che poiché l'indice di linea comincia con 0, l'indice (index) viene incrementato di 1 per ottenere il numero di linea. Inoltre se il display viene ridimensionato il numero di linea potrebbe cambiare; in questo caso tuttavia l'informazione rimarrà invariato perché il metodo viene richiamato una sola volta.

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

()metodo 
public function getLineLength(lineIndex:int):int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce il numero di caratteri presenti in una riga di testo specifica.

Parametri

lineIndex:int — Il numero della riga per cui è richiesta la lunghezza.

Restituisce
int — Il numero di caratteri presenti nella riga.

Genera
RangeError — Il numero di riga specificato non rientra nell'intervallo.

Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio, quando l'utente seleziona una linea, la sua lunghezza (cioè il numero di caratteri) verrà visualizzata in un campo di testo separato.

Come dimostrazione il campo di testo myTextField che visualizza il testo che deve essere contato, viene impostato su INPUT in modo che l'utente possa modificare le linee esistenti o aggiungervene di nuove. C'è una linea vuota creata utilizzando l'interruzione di linea (\n) alla fine dell'ultima linea. Il campo di testo countLines, nel quale viene visualizzato il risultato del conteggio della linea, è inserito al di sotto del campo di testo myTextField e il testo in esso contenuto non è selezionabile. Quando l'utente fa clic su una linea all'interno del campo di testo myTextField viene richiamato il metodo clickHandler().

All'interno del metodo clickHandler() il metodo getLineIndexAtPoint() restituisce l'indice della linea sulla quale l'utente ha fatto clic tramite le coordinate localX e localY del clic del mouse. La prima dichiarazione if controlla se l'utente ha fatto clic su un carattere. In caso affermativo il metodo getLineLength() che utilizza l'indice della linea, restituisce il numero di caratteri della linea. Notate che le linee vuote comprendono la seconda interruzione di linea (\n) e il conteggio dei loro caratteri è uguale a 1, mentre la linea successiva all'ultima ha un conteggio di 0. Anche gli spazi vengono contati come un carattere. Gli utenti possono scrivere una nuova linea o modificarne una esistente e ottenere il conteggio dei caratteri facendo clic su di essa. Se si utilizza l'a capo automatico e la schermata viene ridimensionata, l'indice della linea potrebbe cambiare.

 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

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce informazioni sulla metrica relative a una data riga di testo.

Parametri

lineIndex:int — Il numero della riga per cui sono richieste le informazioni sulla metrica.

Restituisce
flash.text:TextLineMetrics — Un oggetto TextLineMetrics.

Genera
RangeError — Il numero di riga specificato non rientra nell'intervallo.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )

Il seguente esempio visualizza alcuni valori metrici per due linee di testo formattate in modo diverso.

Il testo allegato è formato da due righe tratte da Song of Myself di Walt Whitman. Viene utilizzato un nuovo oggetto TextFormat (newFormat) per impostare il formato della seconda linea. Il formato della prima linea è quello predefinito. Il metodo getLineMetrics() restituisce un oggetto TextLineMetrics per una determinata linea. L'indice di linea comincia da 0. Utilizzando gli oggetti metrics1 e metrics2 rispettivamente per le righe 1 e 2, vengono recuperati i valori relativi ad ascendente, discendente, altezza, e spessore della linea. I risultati vengono convertiti in stringhe, ma non arrotondati. Notate che questo valore è relativo alla linea e non a uno specifico carattere. Riflette l'intervallo di caratteri per una linea. Per esempio, se una linea ha dei caratteri con altezze diverse, il valore verrà determinato dal carattere con l'altezza maggiore. Questo significa anche che se viene modificato il formato di uno dei caratteri, anche alcuni valori metrici potrebbero cambiare.

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

()metodo 
public function getLineOffset(lineIndex:int):int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce l'indice di carattere del primo carattere nella riga specificata dal parametro lineIndex.

Parametri

lineIndex:int — Gli indici a base zero della riga (ad esempio, la prima riga è 0, la seconda è 1, e così via).

Restituisce
int — Il valore dell'indice a base zero del primo carattere nella riga.

Genera
RangeError — Il numero di riga specificato non rientra nell'intervallo.

Esempio  ( Come utilizzare questo esempio )

Il seguente esempio effettua un controllo sul primo carattere della linea 4 e lo modifica se la schermata (e quindi il campo di testo) viene ridimensionata.

Il campo di testo myTextField è impostato sull'a capo automatico. Il campo di testo countField visualizzerà il primo carattere della linea 4. Quando l'utente fa clic sul campo di testo myTextField viene richiamato il metodo clickHandler().

All'interno del metodo clickHandler(), il metodo getLineOffset() restituisce l'indice del primo carattere dell'indice della linea 3 corrispondente alla quarta linea del testo (l'indice della prima linea è 0). Per ottenere il carattere tramite l'indice del primo carattere viene utilizzato il metodo charAt(). Il contenuto del campo di testo countField viene aggiornato con questa informazione tramite la proprietà text del campo di testo countField. L'uso della proprietà countField.text implica che a ogni clic il contenuto del campo di testo countField verrà sovrascritto. Nel caso in cui l'utente ridimensioni il display, al contenuto verrà applicato l'a capo automatico e pertanto il primo carattere della linea 4 potrebbe essere diverso. Facendo nuovamente clic sul campo myTextField, il contenuto del campo di testo countField viene aggiornato con il nuovo primo carattere della quarta linea.

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

()metodo 
public function getLineText(lineIndex:int):String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce il testo della riga specificata dal parametro lineIndex.

Parametri

lineIndex:int — Gli indici a base zero della riga (ad esempio, la prima riga è 0, la seconda è 1, e così via).

Restituisce
String — La stringa di testo contenuta nella riga specificata.

Genera
RangeError — Il numero di riga specificato non rientra nell'intervallo.

Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio vengono recuperati i numeri delle linee in cui ricorre la parola "love" all'interno del sonetto di Shakespeare.

Il campo di testo poem viene impostato automaticamente in modo da ridimensionarsi a seconda del testo e di effettuare l'allineamento a sinistra. La proprietà wordWrap viene impostata su false in modo che le linee della poesia non vadano a capo automaticamente, anche se, quando si usa la proprietà autoSize, questo non dovrebbe costituire un problema. Il ciclo for scorre le linee del sonetto utilizzando la proprietà numLines del campo di testo. Il metodo getLineText() restituisce il contenuto della linea come stringa. Notate che la proprietà numLines restituisce il numero di linee a partire da 1, mentre nel caso del metodo getLineText() la numerazione comincia da 0. Utilizzando l'espressione regolare (/love/i), la dichiarazione if ricerca la parola in lettere minuscole o maiuscole all'interno di ogni sottostringa. Se il pattern viene recuperato il metodo search restituisce l'indice della sottostringa corrispondente; in caso contrario (se, quindi, non viene trovata alcuna corrispondenza) restituisce -1. Il numero corrispondente alla linea nel quale è stata trovata l'espressione "love" ((i + 1)) viene quindi situato nella stringa lineResult. Il metodo string converte l'argomento numerico ((i + 1)) in una stringa fintantoché esiste un altro argomento che sia una stringa (" "). I risultati della ricerca comprenderanno le linee in cui sono presenti le parole "loved" o "Love's". Se la stringa "Love was found in lines:" è stata aggiunta prima del ciclo for anche la parola "Love" presente in questa linea verrà compresa.

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

()metodo 
public function getParagraphLength(charIndex:int):int

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Dato un indice di carattere, restituisce la lunghezza del paragrafo contenente il carattere dato. La lunghezza è relativa al primo carattere del paragrafo (secondo quanto restituito da getFirstCharInParagraph()) e non all'indice di carattere passato.

Parametri

charIndex:int — Gli indici a base zero del carattere (ad esempio, il primo carattere è 0, il secondo è 1, e così via).

Restituisce
int — Restituisce il numero dei caratteri nel paragrafo.

Genera
RangeError — L'indice del carattere specificato non rientra nell'intervallo.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio quando un utente seleziona un paragrafo, verranno visualizzati in un campo di testo a parte sia la lunghezza del paragrafo che il numero dei caratteri "s" all'interno del paragrafo stesso.

Il campo di testo myTextField visualizza i paragrafi selezionati dall'utente. Quando l'utente fa clic sul campo di testo, viene inviato l'evento MouseEvent.CLICK e viene chiamato il metodo clickHandler(). La lunghezza del paragrafo e il numero dei caratteri "s" appariranno nel campo di testo countField situato al di sotto del campo di testo myTextField.

All'interno del metodo clickHandler() il metodo getCharIndexAtPoint() ottiene l'indice del carattere tramite le coordinate localX e localY del clic del mouse. La prima dichiarazione if controlla se l'utente ha fatto clic su un carattere. Il metodo getFirstCharInParagraph() utilizza questo indice per restituire l'indice del primo carattere dello stesso paragrafo. La lunghezza del paragrafo restituita dal metodo getParagraphLength() viene utilizzata con l'indice del primo carattere del paragrafo per determinare l'indice relativo alla fine del paragrafo. Un ciclo for scorre il paragrafo alla ricerca dei caratteri "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

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce un oggetto TextFormat che contiene le informazioni di formattazione per tutto il testo compreso tra i parametri beginIndex e endIndex. Solo le proprietà comuni a tutto il testo specificato vengono impostate nell'oggetto TextFormat risultante. Qualunque proprietà mista (ovvero dotata di valori diversi in diversi punti del testo) ha un valore null.

Se non vengono specificati i valori di questi parametri, questo metodo viene applicato a tutto il testo presente nel campo di testo.

Nella tabella seguente sono descritti tre possibili utilizzi:

UsoDescrizione
my_textField.getTextFormat()Restituisce un oggetto TextFormat che contiene le informazioni di formattazione per tutto il testo presente nel campo di testo. Solo le proprietà comuni a tutto il testo vengono impostate nell'oggetto TextFormat risultante. Qualunque proprietà mista (ovvero dotata di valori diversi in diversi punti del testo) ha un valore null.
my_textField.getTextFormat(beginIndex:Number)Restituisce un oggetto TextFormat che contiene una copia del formato di testo del carattere nella posizione beginIndex.
my_textField.getTextFormat(beginIndex:Number,endIndex:Number)restituisce un oggetto TextFormat che contiene le informazioni di formattazione per tutto il testo compreso tra beginIndex ed endIndex. Solo le proprietà comuni a tutto il testo nell'intervallo specificato vengono impostate nell'oggetto TextFormat risultante. Qualunque proprietà mista (ovvero dotata di valori diversi in diversi punti dell'intervallo) ha un valore null.

Parametri

beginIndex:int (default = -1) — Opzionale; un numero intero che specifica la posizione iniziale di un intervallo di testo all'interno del campo di testo.
 
endIndex:int (default = -1) — Opzionale; un numero intero che specifica la posizione del primo carattere successivo alla porzione di testo desiderata. Come indicato, se vengono specificati i valoribeginIndex e endIndex, viene letto tutto il testo compreso tra beginIndex e endIndex-1.

Restituisce
flash.text:TextFormat — L'oggetto TextFormat che rappresenta le proprietà di formattazione del testo specificato.

Genera
RangeError — Il valore beginIndex o endIndex specificato non rientra nell'intervallo.

Elementi API correlati


Esempio
Come utilizzare questo esempio
Per capire come utilizzare il metodo getTextFormat(), fate riferimento all'esempio relativo al metodo getFirstCharInParagraph() o setTextFormat().

isFontCompatible

()metodo 
public static function isFontCompatible(fontName:String, fontStyle:String):Boolean

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5, Flash Lite 4

Restituisce true se è disponibile un carattere incorporato con i valori fontName e fontStyle specificati, dove Font.fontType è flash.text.FontType.EMBEDDED. A partire da Flash Player 10, in un file SWF possono essere presenti due tipi di caratteri incorporati. I caratteri incorporati normali vengono utilizzati solo con oggetti TextField. I caratteri incorporati CFF vengono utilizzati solo con le classi flash.text.engine. I due tipi si distinguono in base alla proprietà fontType della classe Fontrestituita dalla funzione enumerateFonts().

TextField non può utilizzare un carattere di tipo EMBEDDED_CFF. Se embedFonts è impostato su true e il solo carattere disponibile in fase di runtime con il nome e lo stile specificati è di tipo EMBEDDED_CFF, Flash Player non esegue il rendering del testo, come se non fosse disponibile alcun carattere incorporato con il nome e lo stile specificati.

Se i caratteri EMBEDDED e EMBEDDED_CFF sono entrambi disponibili con lo stesso nome e lo stesso stile, viene selezionato il carattere EMBEDDED e il rendering del testo viene eseguito con il carattere EMBEDDED.

Parametri

fontName:String — Il nome del carattere incorporato da verificare.
 
fontStyle:String — Specifica lo stile del carattere da verificare. Utilizzate flash.text.FontStyle

Restituisce
Booleantrue se è disponibile un carattere incorporato compatibile, altrimenti false.

Genera
ArgumentError — Il valore fontStyle specificato non è un membro di flash.text.FontStyle.

Elementi API correlati

replaceSelectedText

()metodo 
public function replaceSelectedText(value:String):void

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Sostituisce la selezione corrente con il contenuto del parametro value. Il testo viene inserito nella posizione della selezione corrente, utilizzando il formato predefinito corrente per il carattere e il paragrafo. La stringa di testo non viene considerata come HTML.

È possibile utilizzare il metodo replaceSelectedText() per inserire ed eliminare il testo senza interrompere la formattazione del carattere e del paragrafo per il resto del testo.

Nota: questo metodo non funziona se al campo di testo è applicato un foglio di stile.

Parametri

value:String — La stringa con cui sostituire il testo selezionato.


Genera
Error — Questo metodo non può essere utilizzato in un campo di testo con un foglio di stile.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio l'utente, tramite la selezione, cancella una parte di testo dal primo campo di testo e sostituisce una porzione selezionata di testo nel secondo campo di testo con il contenuto della stringa "NEW TEXT".

Vengono creati due diversi oggetti TextField e vengono aggiunti dei listener di evento per gli eventi MouseEvent.MOUSE_UP. L'evento mouse up si verifica quando l'utente rilascia il mouse; questo succede solitamente dopo aver effettuato una selezione di testo. Notate che l'impostazione predefinita per un campo di testo prevede che il testo in esso contenuto possa essere selezionato.

Il metodo mouseHandler1() prevede che quando un utente rilascia il mouse all'interno del campo di testo myTextField1, il testo venga sostituito con una stringa vuota e quindi cancellato. Questa operazione può essere ripetuta finché tutto il testo non venga cancellato. Il metodo mouseHandler2() prevede che quando un utente seleziona una parte del testo contenuto nel campo di testo myTextField2, venga effettuato un controllo sulle proprietà selectionBeginIndex e selectionEndIndex per verificare che sia effettivamente stata una selezione. Nel caso in cui sia stato selezionato del testo, infatti le proprietà selectionBeginIndex e selectionEndIndex avranno valori diversi. Il testo selezionato viene quindi sostituito con la stringa "NEW TEXT". Questa operazione può essere ripetuta finché il testo originale del secondo campo di testo non venga sostituito con la stringa "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

()metodo 
public function replaceText(beginIndex:int, endIndex:int, newText:String):void

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Sostituisce un intervallo di caratteri, specificato dai parametri beginIndex e endIndex, con il contenuto del parametro newText. Come indicato, il testo compreso tra beginIndex e endIndex-1 viene sostituito.

Nota: questo metodo non funziona se al campo di testo è applicato un foglio di stile.

Parametri

beginIndex:int — L'indice a base zero del punto iniziale dell'intervallo da sostituire.
 
endIndex:int — Il valore dell'indice con base zero del primo carattere situato dopo la porzione di testo richiesta.
 
newText:String — Il testo da utilizzare per la sostituzione dell'intervallo di caratteri specificato.


Genera
Error — Questo metodo non può essere utilizzato in un campo di testo con un foglio di stile.

Esempio  ( Come utilizzare questo esempio )

Il seguente esempio utilizza il metodo replaceText() per cancellare, sostituire e inserire del testo in un campo di testo.

Il campo di testo outputText viene impostato automaticamente in modo da ridimensionarsi a seconda del testo e di effettuare l'allineamento a sinistra. Con la prima chiamata del metodo replaceText() la prima linea ("This is the wrong heading") viene sostituita con il testo "THIS IS THE HEADING FOR EVERYONE". Con la seconda chiamata del metodo viene inserito il testo "CORRECT" tra "THE" e "HEADING". Con la terza chiamata del metodo viene cancellato il testo "FOR EVERYONE". Notate che a ogni chiamata del metodo appendText() gli indici attuali di inizio e di fine del testo vengono modificati. In questo caso verrà visualizzato come soltanto il testo finale (dopo, cioè, che tutte le modifiche sono state apportate).

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

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Imposta come selezionato il testo designato dai valori di indice del primo e ultimo carattere, specificati dai parametri beginIndex e endIndex. Se i valori dei due parametri sono uguali, questo metodo imposta il punto di inserimento, come se si impostasse la proprietà caretIndex.

Parametri

beginIndex:int — Il valore dell'indice a base zero del primo carattere nella selezione (ad esempio, il primo carattere è 0, il secondo è 1, e così via).
 
endIndex:int — Il valore dell'indice a base zero dell'ultimo carattere nella selezione.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio quando l'utente fa clic in qualsiasi punto del campo di testo, verrà selezionato un intervallo di testo predefinito (evidenziato le parole "TEXT IN ALL CAPS").

Due listener di evento relativi al campo di testo myTextField rispondono agli eventi clic del mouse e mouse up dell'utente. L'evento mouse up si verifica quando l'utente rilascia il mouse; questo succede solitamente dopo aver effettuato una selezione di testo. Notate che l'impostazione predefinita per un campo di testo prevede che il testo in esso contenuto possa essere selezionato. Quando viene fatto clic su una porzione di testo, viene chiamato il metodo clickHandler(). Quando si seleziona una porzione di testo e il mouse viene rilasciato, invece, viene richiamato il metodo mouseUpHandler().

Sia nel metodo clickHandler() che in quello mouseUpHandler(), il metodo setSelection() fa in modo che vengano selezionati solo i caratteri compresi tra le posizioni 54 e 70 (corrispondenti alla stringa "TEXT IN ALL CAPS").

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

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

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

            this.addChild(myTextField);
        }

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

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

    }
}

setTextFormat

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

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Applica la formattazione indicata dal parametro format al testo specificato nel campo di testo. Il valore di format deve essere un oggetto TextFormat che specifica le modifiche di formattazione del testo richieste. Solo le proprietà di format con valori diversi da null vengono applicate al campo di testo. Qualunque proprietà di format impostata su null non viene applicata. Per impostazione predefinita, tutte le proprietà di un oggetto TextFormat appena creato sono impostate su null.

Nota: questo metodo non funziona se al campo di testo è applicato un foglio di stile.

Il metodo setTextFormat() modifica la formattazione del testo applicata a gruppi di caratteri o all'intero testo presente in un campo di testo. Per applicare le proprietà di format a tutto il testo presente nel campo di testo, non indicate i valori relativi a beginIndex e endIndex. Per applicare le proprietà del formato a un intervallo di testo, specificate i valori relativi ai parametri beginIndex e endIndex. Potete utilizzare la proprietà length per determinare i valori di indice.

In un oggetto TextFormat sono presenti due tipi di informazioni sulla formattazione, le informazioni a livello di carattere e quelle a livello di paragrafo. Ogni carattere presente in un campo di testo può avere delle impostazioni di formattazione proprie, quali il nome del carattere, la dimensione, il grassetto e il corsivo.

Per i paragrafi, il primo carattere del paragrafo viene esaminato alla ricerca delle impostazioni di formattazione dell'intero paragrafo. Margine sinistro, margine destro e rientro sono esempi di impostazioni della formattazione del paragrafo.

Qualunque testo inserito manualmente dall'utente, o sostituito dal metodo replaceSelectedText(), riceve la formattazione predefinita del campo di testo per il nuovo testo e non la formattazione specificata nel punto di inserimento del testo. Per impostare la formattazione predefinita per il nuovo testo, potete usare defaultTextFormat.

Parametri

format:flash.text:TextFormat — Un oggetto TextFormat che contiene le informazioni relative alla formattazione del carattere e del paragrafo.
 
beginIndex:int (default = -1) — Opzionale; un numero intero che specifica il valore dell'indice con base zero del primo carattere dell'intervallo di testo richiesto.
 
endIndex:int (default = -1) — Opzionale; un numero intero che specifica il primo carattere successivo alla porzione di testo desiderata. Come indicato, se vengono specificati i valoribeginIndex e endIndex, viene aggiornato tutto il testo compreso tra beginIndex e endIndex-1.

UsoDescrizione
my_textField.setTextFormat(textFormat:TextFormat)Applica le proprietà di textFormat a tutto il testo presente nel campo di testo.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int)Applica le proprietà di textFormat al testo che inizia dalla posizione beginIndex.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int, endIndex:int)Applica le proprietà del parametro textFormat a tutto il testo compreso tra la posizione beginIndex e la posizione endIndex.

Notate che qualunque testo inserito manualmente dall'utente, o sostituito dal metodo replaceSelectedText(), riceve la formattazione predefinita del campo di testo per il nuovo testo e non la formattazione specificata nel punto di inserimento del testo. Per impostare la formattazione predefinita del campo di testo per il nuovo testo, usate la proprietà defaultTextFormat.


Genera
Error — Questo metodo non può essere utilizzato in un campo di testo con un foglio di stile.
 
RangeError — Il valore beginIndex o endIndex specificato non rientra nell'intervallo.

Elementi API correlati


Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio quando viene fatto clic su un intervallo definito di testo la porzione di testo "TEXT IN ALL CAPS" passa dal formato di testo predefinito a un nuovo formato.

Per il campo di testo myTextField viene aggiunto un listener di evento in risposta ai clic del mouse chiamando il metodo clickHandler(). All'interno del metodo clickHandler(), il metodo getTextFormat() restituisce il formato attuale di un carattere (indice 55) compreso nell'intervallo di testo desiderato, il quale viene situato nell'oggetto TextFormat currentTextFormat. La dichiarazione if effettua un controllo sul formato di testo currentTextFormat per verificare se il carattere nell'intervallo sta utilizzando un nuovo formato (la dimensione del carattere è impostata su 18 punti). In caso contrario il nuovo formato modificherà l'intervallo di testo compreso tra le posizioni 54 e 70 (corrispondente alla stringa "TEXT IN ALL CAPS") portando la dimensione del carattere a 18 punti, cambiando il colore in rosso e applicando gli effetti di sottolineatura e corsivo. Se, invece, il carattere nell'intervallo sta già utilizzando il nuovo formato, questo verrà riportato al formato predefinito (originale) del campo di testo.

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);
            }    
        }    
    }
}
Descrizione degli eventi

change

Evento
Tipo di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.CHANGE

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Inviato dopo la modifica del valore di un controllo, a differenza dell'evento textInput che viene inviato prima della modifica del valore. A differenza della versione del modello di evento W3C DOM dell'evento change, che invia l'evento solo dopo che il controllo non è più attivo, la versione ActionScript 3.0 dell'evento change viene inviata ogni volta che il controllo viene modificato. Ad esempio, se un utente immette del testo in un campo di testo, dopo ogni comando della tastiera viene inviato un evento change.

La costante Event.CHANGE definisce il valore della proprietà type di un oggetto evento change.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto il cui valore è stato modificato. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento.

Esempio  ( Come utilizzare questo esempio )

Nel seguente esempio, il testo immesso dall'utente (input dell'utente) viene immediatamente copiato (echoed) in un altro campo di testo con un diverso formato di testo.

Vengono creati due campi di testo: uno per l'input dell'utente e l'altro (headingTextField) per la copia dell'input dell'utente. Viene creato anche un oggetto TextFormat e il formato di testo predefinito viene assegnato al campo di testo headingTextField. Quando il contenuto del campo di testo subisce delle modifiche, viene chiamato il metodo changeHandler(), che assegna il testo contenuto nel campo di testo inputTextField al campo di testo headingTextField (se il metodo era stato richiamato per l'evento TextEvent.TEXT_INPUT invece che per l'evento Event.CHANGE, il contenuto dell'input dell'utente viene copiato solo dopo che l'utente ha immesso altro testo).

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 di oggetto evento: flash.events.TextEvent
proprietà TextEvent.type = flash.events.TextEvent.LINK

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Inviato quando un utente fa clic su un collegamento ipertestuale in un campo di testo abilitato per HTML, dove l'URL inizia con "event:". La parte restante dell'URL, dopo "event:", viene inserita nella proprietà di testo dell'evento LINK.

Nota: il comportamento predefinito, ovvero l'aggiunta di testo al campo di testo, si verifica solo quando Flash Player genera l'evento; in questo caso, quando un utente cerca di immettere del testo. Non è possibile immettere del testo in un campo di testo inviandogli degli eventi textInput.

Definisce il valore della proprietà type di un oggetto evento link.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetIl campo di testo contenente il collegamento ipertestuale su cui si è fatto clic. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento.
textLa parte restante dell'URL, dopo "event:",

Esempio  ( Come utilizzare questo esempio )

Nell'esempio seguente viene definita la funzione playMP3(). Viene creato un oggetto TextField denominato list che viene poi compilato con testo HTML. I testi "Track 1" e "Track 2" sono collegamenti all'interno del campo di testo. La funzione playMP3() viene chiamata nel momento in cui l'utente fa clic su uno dei due campi. Il nome del file MP3, che segue la stringa "event:" nell'attributo href del tag HTML, viene passato al metodo linkHandler() come proprietà text dell'oggetto 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 di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.SCROLL

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Inviato da un oggetto TextField dopo che l'utente ha eseguito lo scorrimento.

La costante Event.SCROLL definisce il valore della proprietà type di un oggetto evento scroll.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto TextField che è stato fatto scorrere. La proprietà target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento.

Esempio  ( Come utilizzare questo esempio )

Nell'esempio seguente vengono definiti due oggetti TextField. Al primo oggetto TextField sono associati due gestori di eventi. Quando fate clic con il mouse all'interno del primo campo di testo, viene inviato l'evento mouseDown e viene chiamato il gestore associato mouseDownScroll. Il gestore mouseDownScroll() causa lo scorrimento del campo. Viene quindi inviato l'evento scroll e il gestore associato scrollHandler() aggiorna il secondo campo di testo per visualizzare la posizione di scorrimento corrente.
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 di oggetto evento: flash.events.TextEvent
proprietà TextEvent.type = flash.events.TextEvent.TEXT_INPUT

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Flash Player invia l'evento textInput quando un utente immette uno o più caratteri di testo. Questo evento può essere generato da vari metodi di immissione del testo, quali tastiere, IME, sistemi di riconoscimento vocale o del contenuto parlato, e persino dalle operazioni Incolla di testo normale privo di informazioni di formattazione e stile.

Definisce il valore della proprietà type di un oggetto evento textInput.

Nota: questo evento non viene inviato per il tasto Canc o Backspace.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelabletrue; chiama il metodo preventDefault() per annullare il comportamento predefinito.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetIl campo di testo in cui vengono immessi i caratteri. Il target non è sempre l'oggetto contenuto nell'elenco di visualizzazione, che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento.
textIl carattere o la sequenza di caratteri immessi dall'utente.

Esempio  ( Come utilizzare questo esempio )

Nell'esempio seguente vengono definiti due oggetti TextField: il primo oggetto TextField è un campo di testo di input; il secondo oggetto TextField è un campo di testo dinamico. Mentre immettete caratteri di testo nel primo campo di testo, viene inviato l'evento textInput, viene chiamato il gestore textInputHandler()e i caratteri vengono visualizzati nel secondo campo di testo. Quando incollate un blocco di testo nel campo di testo, il gestore di eventi copia l'intero blocco nell'altro campo.
package
{
    import flash.display.Sprite;
    import flash.text.*;
    import flash.events.Event;
    import flash.events.TextEvent;
    import flash.events.MouseEvent;

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

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

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

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

textInteractionModeChange

Evento  
Tipo di oggetto evento: flash.events.Event

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 11, Flash Lite 4

Flash Player invia l'evento textInteractionModeChange quando un utente cambia la modalità di interazione di un campo di testo. in Android, ad esempio, è possibile passare dalla modalità NORMAL alla modalità SELECTION tramite le opzioni del menu contestuale.

TextFieldExample.as

L'esempio seguente utilizza la classe TextFieldExample per visualizzare un messaggio di testo. Questa operazione viene eseguita mediante la procedura seguente:
  1. Viene creata una proprietà label di tipo TextField.
  2. La funzione di costruzione della classe chiama la funzione configureLabel().
  3. Il metodo configureLabel() crea innanzitutto un nuovo oggetto TextField e lo assegna alla proprietà label, quindi imposta i relativi parametri nel modo seguente:
    • Campo di testo giustificato a sinistra.
    • Riempimento di sfondo abilitato.
    • Bordo abilitato.
  4. Il metodo configureLabel() crea la variabile format e la assegna a una nuova istanza TextFormat con i parametri impostati nel modo seguente:
    • Tipo di carattere = Verdana
    • Colore del carattere = rosso uniforme
    • Dimensioni del carattere = 10
    • Sottolineatura = true
  5. La proprietà defaultTextFormat del campo di testo label viene impostata su format e l'istanza label viene aggiunta all'elenco di visualizzazione, nel quale viene inizialmente visualizzato un campo di testo privo di testo sullo stage.
  6. La funzione di costruzione imposta il testo del campo di testo label su "Hello world and welcome to the show." mediante una chiamata al metodo 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 ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.