Naslaggids voor Adobe ActionScript® 3.0 voor het Adobe® Flash®-platform
Startpagina  |  Lijst met pakketten en klassen verbergen |  Pakketten  |  Klassen  |  Nieuw  |  Index  |  Bijlagen  |  Waarom in het Engels?
Filters: AIR 30.0 en eerder, Flash Player 30.0 en eerder, Flash Lite 4
Flex 4.6 en eerder, Flash Pro CS6 en eerder
Filters verbergen
flash.text 

TextField  - AS3

Pakkettenx

Hoofdniveau
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

Taalelementen

Algemene constanten
Algemene functies
Operatoren
Programmeerinstructies, gereserveerde woorden en compileraanwijzingen
Speciale typen

Bijlagen

Nieuw
Compilerfouten
Compilerwaarschuwingen
Uitvoeringsfouten
Migreren naar ActionScript 3
Ondersteunde tekensets
Alleen MXML-labels
Elementen van bewegings-XML
Timed Text-tags
Lijst van vervangen elementen
Constanten voor toegankelijkheidsimplementatie
ActionScript-voorbeelden gebruiken
Juridische kennisgeving
Pakketflash.text
Klassepublic class TextField
OverervingTextField Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Subklassen FlexTextField

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De klasse TextField wordt gebruikt om weergaveobjecten voor tekstweergave en tekstinvoer te maken. U kunt een tekstveld een instantienaam geven in Eigenschapcontrole en de methoden en eigenschappen van de klasse TextField gebruiken om het tekstveld te bewerken met ActionScript-code. Instantienamen voor TextField worden weergegeven in Filmverkenner en in het dialoogvenster Doelpad invoegen in het deelvenster Handelingen.

Wanneer u dynamisch een tekstveld wilt maken, gebruikt u de constructor TextField().

Met de methoden van de klasse TextField kunt u tekst in een dynamisch tekstveld of een invoertekstveld dat u tijdens het ontwerp of de uitvoering hebt gemaakt, instellen, selecteren en bewerken.

Met ActionScript kunt u tekst bij uitvoering op diverse manieren opmaken. Met de klasse TextFormat kunt u teken- en alineaopmaak instellen voor objecten TextField. U kunt CSS-stijlen (Cascading Style Sheets) op tekstvelden toepassen met de eigenschapTextField.styleSheet en de klasse StyleSheet. U kunt CSS gebruiken voor het opmaken van ingebouwde HTML-tags, het definiëren van nieuwe opmaakcodes of het toepassen van stijlen. U kunt tekst met HTML-opmaak rechtstreeks toewijzen aan een tekstveld (met optioneel gebruik van CSS-stijlen). HTML-tekst die u toewijst aan een tekstveld kan ingesloten media bevatten (filmclips, SWF-bestanden, GIF-bestanden, PNG-bestanden en JPEG-bestanden). De tekst loopt om de ingesloten media heen, net als tekstomloop in een webbrowser bij ingesloten media in een HTML-document.

Flash Player ondersteunt een aantal HTML-tags voor de opmaak van tekst. Zie de lijst met ondersteunde HTML-tags in de beschrijving van de eigenschap htmlText.

Bekijk de voorbeelden

Verwante API-elementen



Openbare eigenschappen
 EigenschapGedefinieerd door
 InheritedaccessibilityImplementation : AccessibilityImplementation
De huidige toegankelijkheidsimplementatie (AccessibilityImplementation) voor deze InteractiveObject-instantie.
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
De huidige toegankelijkheidsopties voor dit weergaveobject.
DisplayObject
 Inheritedalpha : Number
Geeft de alpha-transparantiewaarde van het opgegeven object aan.
DisplayObject
  alwaysShowSelection : Boolean
Wanneer ingesteld op true en het tekstveld geen focus heeft, maakt Flash Player de selectie in het tekstveld grijs.
TextField
  antiAliasType : String
Het type antialiasing dat wordt gebruikt voor dit tekstveld.
TextField
  autoSize : String
Bepaalt de automatische aanpassing van grootte en uitlijning van tekstvelden.
TextField
  background : Boolean
Geeft op of het tekstveld een opvulkleur voor de achtergrond heeft.
TextField
  backgroundColor : uint
De kleur van de tekstveldachtergrond.
TextField
 InheritedblendMode : String
Een waarde uit de klasse BlendMode die opgeeft welke overvloeimodus moet worden gebruikt.
DisplayObject
 InheritedblendShader : Shader
[alleen-schrijven] Stelt de arcering in die moet worden gebruikt om voor- en achtergrond in elkaar te laten overvloeien.
DisplayObject
  border : Boolean
Geeft op of het tekstveld een rand heeft.
TextField
  borderColor : uint
De kleur van de tekstveldrand.
TextField
  bottomScrollV : int
[alleen-lezen] Een geheel getal (een op 1 gebaseerde index) dat aangeeft welke regel als onderste regel wordt weergegeven in het opgegeven tekstveld.
TextField
 InheritedcacheAsBitmap : Boolean
Indien ingesteld op true, plaatsen Flash-runtimes een interne bitmaprepresentatie van het weergaveobject in cache.
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
Als dit Matrix-object niet null is, definieert het hoe een weergaveobject wordt gerenderd als cacheAsBitmap wordt ingesteld op true.
DisplayObject
  caretIndex : int
[alleen-lezen] De index van de positie van het invoegpunt (invoegteken).
TextField
  condenseWhite : Boolean
Een booleaanse waarde die aangeeft of extra witruimte (spaties, regeleinden, enzovoort) in een tekstveld met HTML-tekst wordt verwijderd.
TextField
 Inheritedconstructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.
Object
 InheritedcontextMenu : NativeMenu
Geeft het contextmenu op dat is gekoppeld aan dit object.
InteractiveObject
  defaultTextFormat : flash.text:TextFormat
Geeft de opmaak op die op nieuw ingevoegde tekst wordt toegepast, zoals tekst die door de gebruiker is ingevoerd of tekst die met de methode replaceSelectedText() is ingevoegd.
TextField
  displayAsPassword : Boolean
Geeft aan of het tekstveld een tekstveld voor wachtwoorden is.
TextField
 InheriteddoubleClickEnabled : Boolean
Geeft op of dit object gebeurtenissen doubleClick ontvangt.
InteractiveObject
  embedFonts : Boolean
Geeft op of moet worden gerenderd met ingesloten lettertypecontouren.
TextField
 Inheritedfilters : Array
Een geïndexeerde array die elk filterobject bevat dat momenteel is gekoppeld aan het weergaveobject.
DisplayObject
 InheritedfocusRect : Object
Geeft op of dit object een focusrechthoek weergeeft.
InteractiveObject
  gridFitType : String
Het type rasteraanpassing dat wordt gebruikt voor dit tekstveld
TextField
 Inheritedheight : Number
Geeft de hoogte van het weergaveobject aan, in pixels.
DisplayObject
  htmlText : String
Bevat de HTML-representatie van de inhoud van het tekstveld.
TextField
  length : int
[alleen-lezen] Het aantal tekens in een tekstveld.
TextField
 InheritedloaderInfo : LoaderInfo
[alleen-lezen] Retourneert een object LoaderInfo dat informatie bevat over het laden van het bestand waartoe dit weergaveobject behoort.
DisplayObject
 Inheritedmask : DisplayObject
Het aanroepende weergaveobject wordt gemaskeerd door het opgegeven object mask.
DisplayObject
  maxChars : int
Het maximum aantal tekens dat het tekstveld kan bevatten (ingevoerd door de gebruiker).
TextField
  maxScrollH : int
[alleen-lezen] De maximumwaarde van scrollH.
TextField
  maxScrollV : int
[alleen-lezen] De maximumwaarde van scrollV.
TextField
 InheritedmetaData : Object
Krijgt het metagegevensobject van de DisplayObject-instantie als de metagegevens zijn opgeslagen naast de instantie van dit DisplayObject in het SWF-bestand door een PlaceObject4-markering.
DisplayObject
 InheritedmouseEnabled : Boolean
Geeft aan of dit object berichten van de muis of gebruikersinvoer ontvangt.
InteractiveObject
  mouseWheelEnabled : Boolean
Een booleaanse waarde die aangeeft of Flash Player automatisch door tekstvelden met meerdere regels schuift wanneer de gebruiker op een tekstveld klikt en het muiswiel gebruikt.
TextField
 InheritedmouseX : Number
[alleen-lezen] Geeft de x-coördinaat van de apparaatpositie van de muis of de gebruikersinvoer aan in pixels.
DisplayObject
 InheritedmouseY : Number
[alleen-lezen] Geeft de y-coördinaat van de apparaatpositie van de muis of de gebruikersinvoer aan in pixels.
DisplayObject
  multiline : Boolean
Hiermee wordt aangegeven of het veld een tekstveld met meerdere regels is.
TextField
 Inheritedname : String
Geeft de instantienaam van het DisplayObject aan.
DisplayObject
 InheritedneedsSoftKeyboard : Boolean
Geeft aan of een virtueel toetsenbord (een softwaretoetsenbord op het scherm) moet worden weergegeven wanneer deze InteractiveObject-instantie focus krijgt.
InteractiveObject
  numLines : int
[alleen-lezen] Definieert het aantal tekstregels in een tekstveld met meerdere regels.
TextField
 InheritedopaqueBackground : Object
Geeft op of het weergaveobject dekkend is met een bepaalde achtergrondkleur.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[alleen-lezen] Geeft het object DisplayObjectContainer aan dat dit weergaveobject bevat.
DisplayObject
  restrict : String
Geeft de set tekens aan die een gebruiker in het tekstveld kan invoeren.
TextField
 Inheritedroot : DisplayObject
[alleen-lezen] Voor een weergaveobject in een geladen SWF-bestand is de eigenschap root het bovenste weergaveobject in het gedeelte van de boomstructuur van het weergaveoverzicht dat wordt vertegenwoordigd door dat SWF-bestand.
DisplayObject
 Inheritedrotation : Number
Geeft de rotatie van de instantie DisplayObject vanaf de oorspronkelijke oriëntatie (in graden) aan.
DisplayObject
 InheritedrotationX : Number
Geeft in graden de X-asrotatie van de DisplayObject-instantie aan ten opzichte van de 3D parent-container.
DisplayObject
 InheritedrotationY : Number
Geeft in graden de y-asrotatie van de DisplayObject-instantie aan ten opzichte van de 3D parent-container.
DisplayObject
 InheritedrotationZ : Number
Geeft in graden de z-asrotatie van de DisplayObject-instantie aan ten opzichte van de 3D parent-container.
DisplayObject
 Inheritedscale9Grid : Rectangle
Het huidige schaalraster dat wordt gebruikt.
DisplayObject
 InheritedscaleX : Number
Bepaalt de horizontale schaal (percentage) van het object zoals deze wordt toegepast vanuit het registratiepunt.
DisplayObject
 InheritedscaleY : Number
Bepaalt de verticale schaal (percentage) van een object zoals deze wordt toegepast vanuit het registratiepunt van het object.
DisplayObject
 InheritedscaleZ : Number
Bepaalt de diepteschaal (percentage) van een object zoals deze wordt toegepast vanuit het registratiepunt van het object.
DisplayObject
  scrollH : int
De huidige horizontale schuifpositie.
TextField
 InheritedscrollRect : Rectangle
De verschuivende rechthoekgrenzen van het weergaveobject.
DisplayObject
  scrollV : int
De verticale positie van tekst in een tekstveld.
TextField
  selectable : Boolean
Een booleaanse waarde die aangeeft of het tekstveld kan worden geselecteerd.
TextField
  selectionBeginIndex : int
[alleen-lezen] De op nul gebaseerde indexwaarde van het eerste teken in de huidige selectie.
TextField
  selectionEndIndex : int
[alleen-lezen] De op nul gebaseerde indexwaarde van het laatste teken in de huidige selectie.
TextField
  sharpness : Number
De scherpte van de glyph-randen in dit tekstveld.
TextField
 Inherited    softKeyboard : String
Bepaalt het uiterlijk van het schermtoetsenbord.
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
Definieert het gebied dat als scherm moet blijven fungeren wanneer een softwaretoetsenbord wordt weergegeven (niet beschikbaar op iOS).
InteractiveObject
 Inheritedstage : Stage
[alleen-lezen] Het werkgebied van het weergaveobject.
DisplayObject
  styleSheet : StyleSheet
Koppelt een stijlpagina aan het tekstveld.
TextField
 InheritedtabEnabled : Boolean
Geeft op of dit object in de tabvolgorde is opgenomen.
InteractiveObject
 InheritedtabIndex : int
Geeft de tabvolgorde van objecten in een SWF-bestand op.
InteractiveObject
  text : String
Een tekenreeks die de huidige tekst in het tekstveld is.
TextField
  textColor : uint
De kleur van de tekst in een tekstveld, in hexadecimale notatie.
TextField
  textHeight : Number
[alleen-lezen] De hoogte van de tekst in pixels.
TextField
  textInteractionMode : String
[alleen-lezen] De eigenschap van de interactiemodus. De standaardwaarde is TextInteractionMode.NORMAL.
TextField
  textWidth : Number
[alleen-lezen] De breedte van de tekst in pixels.
TextField
  thickness : Number
De dikte van de glyph-randen in dit tekstveld.
TextField
 Inheritedtransform : flash.geom:Transform
Een object met eigenschappen die betrekking hebben op de matrix van een weergaveobject, de kleurtransformatie en de pixelbeperkingen.
DisplayObject
  type : String
Het type tekstveld.
TextField
  useRichTextClipboard : Boolean
Geeft aan of de tekstopmaak samen met de tekst moet worden gekopieerd en geplakt.
TextField
 Inheritedvisible : Boolean
Bepaalt of het weergaveobject zichtbaar is.
DisplayObject
 Inheritedwidth : Number
Geeft de breedte van het weergaveobject aan, in pixels.
DisplayObject
  wordWrap : Boolean
Een booleaanse waarde die aangeeft of voor het tekstveld tekstomloop is ingesteld.
TextField
 Inheritedx : Number
Bepaalt de x-coördinaat van de instantie DisplayObject ten opzichte van de lokale coördinaten van de bovenliggende DisplayObjectContainer.
DisplayObject
 Inheritedy : Number
Bepaalt de y-coördinaat van de instantie DisplayObject ten opzichte van de lokale coördinaten van de bovenliggende DisplayObjectContainer.
DisplayObject
 Inheritedz : Number
Geeft de z-coördinaatpositie langs de z-as van de DisplayObject-instantie aan ten opzichte van de bovenliggende 3D-container.
DisplayObject
Openbare methoden
 MethodeGedefinieerd door
  
Maakt een nieuwe instantie TextField.
TextField
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.
EventDispatcher
  
Voegt de tekenreeks die is opgegeven met de parameter newText toe aan het einde van de tekst in het tekstveld.
TextField
 Inherited
Verzendt een gebeurtenis naar de gebeurtenisstroom.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Retourneert een rechthoek die het gebied van het weergaveobject aangeeft ten opzichte van het coördinatensysteem van het object targetCoordinateSpace.
DisplayObject
  
Retourneert een rechthoek die het selectiekader van het teken vormt.
TextField
  
Retourneert de op nul gebaseerde indexwaarde van het teken op het punt dat is opgegeven met de parameters x en y.
TextField
  
Op basis van een tekenindex wordt hiermee de index van het eerste teken in dezelfde alinea geretourneerd.
TextField
  
Retourneert een DisplayObject-verwijzing voor de opgegeven id voor een afbeeldings- of SWF-bestand dat is toegevoegd aan een tekstveld met HTML-opmaak met de tag <img>.
TextField
  
Retourneert de op nul gebaseerde indexwaarde van de regel op het punt dat is opgegeven met de parameters x en y.
TextField
  
Retourneert de op nul gebaseerde indexwaarde van de regel die het teken bevat dat door de parameter charIndex wordt opgegeven.
TextField
  
getLineLength(lineIndex:int):int
Retourneert het aantal tekens in een opgegeven tekstregel.
TextField
  
Geeft metrische informatie over een bepaalde tekstregel weer.
TextField
  
getLineOffset(lineIndex:int):int
Retourneert de tekenindex van het eerste teken op de regel die wordt opgegeven door de parameter lineIndex.
TextField
  
Retourneert de tekst van de regel die wordt opgegeven door de parameter lineIndex.
TextField
  
Op basis van een tekenindex wordt hiermee de lengte van de alinea met het opgegeven teken geretourneerd.
TextField
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Retourneert een rechthoek die de grens van het weergaveobject aangeeft op basis van het coördinatensysteem dat wordt gedefinieerd door de paramater targetCoordinateSpace, minus enige streken op vormen.
DisplayObject
  
getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Retourneert een object TextFormat met opmaakgegevens voor de tekst die is opgegeven met de parameters beginIndex en endIndex.
TextField
 Inherited
Hiermee worden de (algemene) werkgebiedcoördinaten van het object point omgezet in (lokale) objectcoördinaten.
DisplayObject
 Inherited
Converteert een tweedimensionaal punt van de (algemene) werkruimtecoördinaten naar (lokale) coördinaten van een driedimensionaal weergaveobject.
DisplayObject
 Inherited
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.
EventDispatcher
 Inherited
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.
Object
 Inherited
Evalueert het selectiekader van het weergaveobject om te zien of dit het selectiekader van het weergaveobject obj overlapt of snijdt.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Hiermee wordt het weergaveobject geëvalueerd om te zien of deze een punt dat is opgegeven door de parameters x en y, overlapt of doorsnijdt.
DisplayObject
  
isFontCompatible(fontName:String, fontStyle:String):Boolean
[statisch] Hiermee wordt true geretourneerd als een ingesloten lettertype beschikbaar is met de opgegeven fontName en fontStyle waarbij Font.fontType flash.text.FontType.EMBEDDED is.
TextField
 Inherited
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.
Object
 Inherited
Converteert een driedimensionaal punt van de (lokale) coördinaten van het driedimensionale weergaveobject naar een tweedimensionaal punt in de (algemene) werkruimtecoördinaten.
DisplayObject
 Inherited
Hiermee worden de (lokale) weergaveobjectcoördinaten van het object point omgezet in (algemene) werkgebiedcoördinaten.
DisplayObject
 Inherited
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Verwijdert een listener uit het object EventDispatcher.
EventDispatcher
  
Hiermee wordt de huidige selectie door de inhoud van de parameter value vervangen.
TextField
  
replaceText(beginIndex:int, endIndex:int, newText:String):void
Vervangt de met de parameters beginIndex en endIndex opgegeven tekenreeks door de inhoud van de parameter newText.
TextField
 Inherited
Geeft een virtueel toetsenbord weer.
InteractiveObject
 Inherited
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.
Object
  
setSelection(beginIndex:int, endIndex:int):void
Stelt de tekst als geselecteerd in die wordt bepaald door de indexwaarden van het eerste en laatste teken, opgegeven door de parameters beginIndex en endIndex.
TextField
  
setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Past de tekstopmaak die is opgegeven met de parameter format toe op de opgegeven tekst in een tekstveld.
TextField
 Inherited
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.
Object
 Inherited
Retourneert een tekenreeksrepresentatie van het opgegeven object.
Object
 Inherited
Retourneert de primitieve waarde van het opgegeven object.
Object
 Inherited
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.
EventDispatcher
Gebeurtenissen
 Gebeurtenis Overzicht Gedefinieerd door
 Inherited[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.EventDispatcher
 InheritedWordt verzonden wanneer een weergaveobject aan het weergaveoverzicht wordt toegevoegd.DisplayObject
 InheritedWordt verzonden wanneer een weergaveobject direct of via toevoeging van een subboomstructuur die het weergaveobject bevat, aan het weergaveoverzicht van het werkgebied wordt toegevoegd.DisplayObject
  Wordt verzonden nadat een besturingswaarde is gewijzigd, in tegenstelling tot de gebeurtenis textInput, die wordt verzonden voordat de waarde wordt gewijzigd.TextField
 InheritedWordt verzonden wanneer de gebruiker Wissen of Verwijderen kiest in het snelmenu.InteractiveObject
 InheritedWordt verzonden wanneer een gebruiker op de hoofdknop van het aanwijsapparaat drukt en deze boven hetzelfde InteractiveObject loslaat.InteractiveObject
 Inherited
    contextMenu
Wordt verzonden wanneer een handeling van de gebruiker het snelmenu opent dat aan dit interactieve object in een AIR-toepassing is gekoppeld.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker de platformspecifieke toetsencombinatie voor een kopieerbewerking gebruikt of Kopiëren kiest in het contextmenu.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker de platformspecifieke toetsencombinatie voor een knipbewerking gebruikt of Knippen kiest in het contextmenu.InteractiveObject
 Inherited[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.EventDispatcher
 InheritedWordt verzonden wanneer de gebruiker tweemaal snel achtereen op de hoofdknop van een aanwijsapparaat drukt en deze boven hetzelfde InteractiveObject loslaat wanneer de markering doubleClickEnabled van dit object op true is ingesteld.InteractiveObject
 Inherited[uitzendgebeurtenis] Wordt verzonden wanneer de afspeelkop een nieuw frame ingaat.DisplayObject
 Inherited[uitzendgebeurtenis] Wordt verzonden wanneer de afspeelkop het huidige frame verlaat.DisplayObject
 InheritedWordt verzonden nadat een weergaveobject focus heeft gekregen.InteractiveObject
 InheritedWordt verzonden nadat een weergaveobject focus heeft verloren.InteractiveObject
 Inherited[uitzendgebeurtenis] Wordt verzonden nadat de constructors van frameweergaveobjecten zijn uitgevoerd, maar voordat framescripts zijn uitgevoerd.DisplayObject
 InheritedWordt verzonden wanneer de gebruiker een aanraakpunt langs de rand van het touchoppervlak maakt met een InteractiveObject-instantie (zoals wanneer u langs de rand van het touchoppervlak op Siri Extern voor Apple TV tikt). Sommige apparaten interpreteren dit contact misschien ook als een combinatie van verschillende aanraakgebeurtenissen.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker op twee aanraakpunten drukt op dezelfde InteractiveObject-instantie op een apparaat met aanraakbediening (zoals wanneer de gebruiker met twee vingers op een weergaveobject op een gsm of tablet met aanraakscherm drukt en vervolgens weer loslaat).InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een aanraakpunt over de InteractiveObject-instantie beweegt op een apparaat met aanraakbediening (zoals wanneer de gebruiker een vinger van links naar rechts beweegt over een weergaveobject op een gsm of tablet met aanraakscherm).InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een zoombeweging maakt op een aanraakpunt met een InteractiveObject-instantie (zoals wanneer de gebruiker een scherm aanraakt met twee vingers en deze vervolgens roteert over een weergaveobject op een gsm of tablet met een aanraakscherm).InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een veegbeweging maakt op een aanraakpunt met een InteractiveObject-instantie (zoals wanneer de gebruiker een scherm aanraakt met drie vingers en deze vervolgens parallel beweegt over een weergaveobject op een gsm of tablet met een aanraakscherm).InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een aanraakpunt maakt met een InteractiveObject-instantie en vervolgens op een apparaat met aanraakbediening drukt (zoals wanneer de gebruiker een paar vingers op een weergaveobject plaatst om een menu te openen en er met een vinger op drukt om een menu-item op een gsm of tablet met een aanraakscherm te selecteren).InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een zoombeweging maakt op een aanraakpunt met een InteractiveObject-instantie (zoals wanneer de gebruiker een scherm aanraakt met twee vingers en deze vervolgens snel spreidt over een weergaveobject op een gsm of tablet met een aanraakscherm).InteractiveObject
 InheritedDeze gebeurtenis wordt verzonden naar elke clienttoepassing die inline-invoer met een IME ondersteunt.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker op een toets drukt.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker focus probeert te wijzigen met toetsenbordnavigatie.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een toets loslaat.InteractiveObject
  Wordt verzonden wanneer een gebruiker op een hyperlink in een HTML-tekstveld klikt waarbij de URL begint met 'event:'.TextField
 InheritedWordt verzonden wanneer een gebruiker op de middelste knop van het aanwijsapparaat drukt en deze boven hetzelfde InteractiveObject loslaat.InteractiveObject
 InheritedWordt verzonden wanneer een gebruiker op de middelste aanwijsapparaatknop drukt over een instantie InteractiveObject.InteractiveObject
 InheritedWordt verzonden wanneer een gebruiker de aanwijsapparaatknop over een instantie InteractiveObject beweegt.InteractiveObject
 InheritedWordt verzonden wanneer een gebruiker op de aanwijsapparaatknop drukt over een instantie InteractiveObject.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker focus probeert te wijzigen met een aanwijsapparaat.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker het aanwijsapparaat verplaatst terwijl het zich boven een InteractiveObject bevindt.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een aanwijsapparaat van een instantie InteractiveObject af verplaatst.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een aanwijsapparaat over een instantie InteractiveObject beweegt.InteractiveObject
 InheritedWordt verzonden wanneer een gebruiker de aanwijsapparaatknop over een instantie InteractiveObject beweegt.InteractiveObject
 InheritedWordt verzonden wanneer een muiswiel over een instantie InteractiveObject wordt gedraaid.InteractiveObject
 InheritedWordt verzonden door de sleepinitiator InteractiveObject wanneer de gebruiker de sleepbeweging onderbreekt.InteractiveObject
 InheritedWordt verzonden door het doel InteractiveObject wanneer een gesleept object erop wordt neergezet en het neerzetten is geaccepteerd met een aanroep van DragManager.acceptDragDrop().InteractiveObject
 InheritedWordt verzonden door een InteractiveObject wanneer een sleepbeweging binnen de grens komt.InteractiveObject
 InheritedWordt verzonden door een InteractiveObject wanneer een sleepbeweging buiten de grens komt.InteractiveObject
 InheritedWordt continu verzonden door een InteractiveObject zolang een sleepbeweging binnen de grenzen blijft.InteractiveObject
 InheritedWordt verzonden aan het begin van een sleepbewerking door het InteractiveObject dat in de aanroep DragManager.doDrag() is opgegeven als de sleepinitiator.InteractiveObject
 InheritedWordt verzonden tijdens een sleepbewerking door het InteractiveObject dat in de aanroep DragManager.doDrag() is opgegeven als de sleepinitiator.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker de platformspecifieke toetsencombinatie voor een plakbewerking gebruikt of Plakken kiest in het contextmenu.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een actieve stylus omlaag en binnen de detectiedrempel van het scherm plaatst.InteractiveObject
 Inherited
    proximityEnd
Wordt verzonden wanneer de gebruiker een actieve stylus boven de detectiedrempel van het scherm tilt.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een actieve stylus boven het scherm plaatst en binnen de detectiedrempel blijft.InteractiveObject
 Inherited
    proximityOut
Wordt verzonden wanneer de gebruiker een actieve stylus bij dit InteractiveObject weghaalt, maar wel binnen de detectiedrempel van het scherm blijft.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een actieve stylus recht boven dit InteractiveObject plaatst en binnen de detectiedrempel van het scherm blijft.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een actieve stylus van dit InteractiveObject en eventuele onderliggende elementen weghaalt, maar wel binnen de detectiedrempel van het scherm blijft.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een actieve stylus van buiten de afstammelingenstructuur van het object in de weergavelijst (maar dicht genoeg bij het scherm om binnen de detectiedrempel te blijven) boven dit InteractiveObject plaatst.InteractiveObject
 InheritedVerzonden wanneer een gebruiker de knop op het aanwijsapparaat loslaat nadat hij de knop eerst boven een InteractiveObject-instantie heeft ingedrukt en het aanwijsapparaat vervolgens van deze instantie heeft verplaatst.InteractiveObject
 InheritedWordt verzonden vlak voordat een weergaveobject uit het weergaveoverzicht wordt verwijderd.DisplayObject
 InheritedWordt verzonden vlak voordat een weergaveobject uit het weergaveoverzicht wordt verwijderd. Dit kan rechtstreeks gebeuren of door de subboomstructuur te verwijderen die het weergaveobject bevat.DisplayObject
 Inherited[uitzendgebeurtenis] Wordt verzonden wanneer de weergavelijst op het punt staat te worden bijgewerkt en gerenderd.DisplayObject
 InheritedWordt verzonden wanneer een gebruiker op de rechterknop van het aanwijsapparaat drukt en deze boven hetzelfde InteractiveObject loslaat.InteractiveObject
 InheritedWordt verzonden wanneer een gebruiker op de aanwijsapparaatknop drukt over een instantie InteractiveObject.InteractiveObject
 InheritedWordt verzonden wanneer een gebruiker de aanwijsapparaatknop over een instantie InteractiveObject beweegt.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een aanwijsapparaat van een instantie InteractiveObject af verplaatst.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker een aanwijsapparaat over een instantie InteractiveObject beweegt.InteractiveObject
  Wordt verzonden door een object TextField nadat de gebruiker schuift.TextField
 InheritedWordt verzonden wanneer de gebruiker de platformspecifieke toetsencombinatie gebruikt voor de bewerking Alles selecteren of Alles selecteren kiest in het snelmenu.InteractiveObject
 InheritedWordt meteen verzonden nadat het softwaretoetsenbord wordt weergegeven.InteractiveObject
 InheritedWordt verzonden vlak voordat het softwaretoetsenbord wordt weergegeven.InteractiveObject
 InheritedWordt meteen verzonden nadat het softwaretoetsenbord van het scherm is verdwenen.InteractiveObject
 InheritedWordt verzonden wanneer de waarde van de markering tabChildren van het object wordt gewijzigd.InteractiveObject
 InheritedWordt verzonden wanneer de markering tabEnabled van het object wordt gewijzigd.InteractiveObject
 InheritedWordt verzonden wanneer de waarde van de eigenschap tabIndex van het object wordt gewijzigd.InteractiveObject
  Flash Player verzendt de gebeurtenis textInput wanneer een gebruiker een of meer tekens invoert.TextField
  Flash Player verzendt de gebeurtenis textInteractionModeChange wanneer een gebruiker de interactiemodus van een tekstveld wijzigt.TextField
 InheritedWordt verzonden wanneer de gebruiker voor het eerst een apparaat met aanraakbediening aanraakt (zoals wanneer de gebruiker een gsm of tablet met aanraakscherm met een vinger aanraakt).InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker het contact met een apparaat met aanraakbediening verwijdert (zoals wanneer de gebruiker een vinger van een gsm of tablet met aanraakscherm tilt).InteractiveObject
 InheritedDe gebeurtenis wordt continu verzonden, vanaf het moment dat de gebruiker het apparaat aanraakt, tot het moment dat de aanraking ophoudt.InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker het contactpunt over een InteractiveObject-instantie op een apparaat met aanraakbediening beweegt (zoals wanneer de gebruiker een vinger van een weergaveobject naar een ander weergaveobject op een gsm of tablet met aanraakscherm sleept).InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker het contactpunt over een InteractiveObject-instantie op een apparaat met aanraakbediening beweegt (zoals wanneer de gebruiker een vinger van een punt buiten een weergaveobject naar een punt op een weergaveobject op een gsm of tablet met aanraakscherm versleept).InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker het aanraakpunt bij een InteractiveObject-instantie vandaan verplaatst op een apparaat met aanraakfunctionaliteit (zoals wanneer de gebruiker een vinger van een punt boven het weergaveobject naar een punt buiten het object sleept op een mobiele telefoon of een tablet met een aanraakscherm).InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker het contactpunt over een InteractiveObject-instantie op een apparaat met aanraakbediening beweegt (zoals wanneer de gebruiker een vinger van een punt buiten een weergaveobject naar een punt op een weergaveobject op een gsm of tablet met aanraakscherm versleept).InteractiveObject
 InheritedWordt verzonden wanneer de gebruiker het contactpunt op dezelfde InteractiveObject-instantie tilt waarop het contact op een apparaat met aanraakbediening was geïnitialiseerd (zoals wanneer de gebruiker een vinger op één punt van een weergaveobject drukt en vervolgens loslaat op een gsm of tablet met aanraakscherm).InteractiveObject
Eigenschapdetails

alwaysShowSelection

eigenschap
alwaysShowSelection:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Wanneer ingesteld op true en het tekstveld geen focus heeft, maakt Flash Player de selectie in het tekstveld grijs. Wanneer ingesteld op false en het tekstveld geen focus heeft, wordt de selectie in het tekstveld niet gemarkeerd.

De standaardwaarde is false.



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

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
Compileer het volgende bestand en voer het uit. Wanneer u het bestand uitvoert, sleept u in elk van de twee tekstvelden om tekst te selecteren. Let op het verschil in selectiemarkering wanneer u tekst in de twee tekstvelden selecteert (de focus wijzigt):
    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

eigenschap 
antiAliasType:String

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9

Het type antialiasing dat wordt gebruikt voor dit tekstveld. Gebruikt constanten flash.text.AntiAliasType voor deze eigenschap. U kunt deze instelling alleen beheren wanneer het lettertype is ingesloten (met de eigenschap embedFonts op true ingesteld). De standaardinstelling is flash.text.AntiAliasType.NORMAL.

Wanneer u waarden voor deze eigenschap wilt instellen, gebruikt u de volgende tekenreekswaarden:

TekenreekswaardeBeschrijving
flash.text.AntiAliasType.NORMALNormale antialiasing van tekst wordt toegepast. Deze waarde komt overeen met het type antialiasing dat in Flash Player 7 en lagere versies werd gebruikt.
flash.text.AntiAliasType.ADVANCEDGeavanceerde antialiasing wordt toegepast, waardoor de tekst beter leesbaar wordt. (Dit kenmerk was voor het eerst beschikbaar in Flash Player 8.) Bij geavanceerde antialiasing kunnen kleine lettertypen met zeer hoge kwaliteit worden weergegeven. U kunt deze instelling het best gebruiken bij toepassingen met een grote hoeveelheid kleine tekst. Geavanceerde antialiasing wordt niet aangeraden voor lettertypen groter dan 48 punten.



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

Verwante API-elementen

autoSize

eigenschap 
autoSize:String

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Bepaalt de automatische aanpassing van grootte en uitlijning van tekstvelden. Acceptabele waarden voor de constanten TextFieldAutoSize zijn: TextFieldAutoSize.NONE (de standaardwaarde), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT enTextFieldAutoSize.CENTER.

Wanneer autoSize is ingesteld op TextFieldAutoSize.NONE (standaardwaarde), wordt de grootte niet gewijzigd.

Wanneer autoSize wordt ingesteld op TextFieldAutoSize.LEFT, wordt de tekst behandeld als links uitgevulde tekst. Dit betekent dat de linkermarge van het tekstveld een vaste positie heeft en dat een wijziging van de grootte van één regel van het tekstveld invloed heeft op de rechtermarge. Wanneer in het tekstveld een regeleinde is opgenomen (bijvoorbeeld '\n' of '\r'), wordt de grootte aan de onderkant ook gewijzigd zodat de volgende regel tekst past. Wanneer wordWrap ook is ingesteld op true, wordt alleen de grootte van de onderkant van het tekstveld aangepast en heeft de rechterzijde een vaste positie.

Wanneer autoSize wordt ingesteld op TextFieldAutoSize.RIGHT, wordt de tekst behandeld als rechts uitgevulde tekst. Dit betekent dat de rechtermarge van het tekstveld een vaste positie heeft en dat een wijziging van de grootte van één regel van het tekstveld invloed heeft op de linkermarge. Wanneer in het tekstveld een regeleinde is opgenomen (bijvoorbeeld '\n' of '\r'), wordt de grootte aan de onderkant ook gewijzigd zodat de volgende regel tekst past. Wanneer wordWrap ook is ingesteld op true, wordt alleen de grootte van de onderkant van het tekstveld aangepast en heeft de linkerzijde een vaste positie.

Wanneer autoSize is ingesteld op TextFieldAutoSize.CENTER, wordt de tekst behandeld als gecentreerd uitgevulde tekst. Dit betekent dat bij een aanpassing van de grootte van één regel van een tekstveld de linker- en rechtermarge in gelijke mate worden aangepast. Wanneer in het tekstveld een regeleinde is opgenomen (bijvoorbeeld '\n' of '\r'), wordt de grootte aan de onderkant ook gewijzigd zodat de volgende regel tekst past. Wanneer wordWrap ook is ingesteld op true, wordt alleen de grootte van de onderkant van het tekstveld aangepast en hebben de linker- en rechterzijde een vaste positie.



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

Gegenereerde uitzondering
ArgumentError — De opgegeven autoSize is geen lid van flash.text.TextFieldAutoSize.

Verwante API-elementen

background

eigenschap 
background:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Geeft op of het tekstveld een opvulkleur voor de achtergrond heeft. Indien true, heeft het tekstveld een opvulkleur voor de achtergrond. Indien false, heeft het tekstveld geen opvulkleur voor de achtergrond. Gebruik de eigenschap backgroundColor om de achtergrondkleur van een tekstveld in te stellen.

De standaardwaarde is false.



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

Verwante API-elementen

backgroundColor

eigenschap 
backgroundColor:uint

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De kleur van de tekstveldachtergrond. De standaardwaarde is 0xFFFFFF (wit). Deze eigenschap kan worden opgehaald of ingesteld, zelfs wanneer momenteel geen achtergrond is ingesteld, maar de kleur is alleen zichtbaar wanneer voor het tekstveld de eigenschap background is ingesteld op true.



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

Verwante API-elementen

border

eigenschap 
border:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Geeft op of het tekstveld een rand heeft. Indien true, heeft het tekstveld een rand. Indien false, heeft het tekstveld geen rand. Gebruik de eigenschap borderColor om de randkleur in te stellen.

De standaardwaarde is false.



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

Verwante API-elementen

borderColor

eigenschap 
borderColor:uint

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De kleur van de tekstveldrand. De standaardwaarde is 0x000000 (zwart). Deze eigenschap kan worden opgehaald of ingesteld, zelfs wanneer momenteel geen achtergrond is ingesteld, maar de kleur is alleen zichtbaar wanneer voor het tekstveld de eigenschap border is ingesteld op true.



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

Verwante API-elementen

bottomScrollV

eigenschap 
bottomScrollV:int  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Een geheel getal (een op 1 gebaseerde index) dat aangeeft welke regel als onderste regel wordt weergegeven in het opgegeven tekstveld. U kunt een tekstveld zien als een venster met uitzicht op een (gedeelte van een) blok tekst. De eigenschap scrollV is de op één gebaseerde index van de regel die als bovenste regel wordt weergegeven in het venster.

De tekst tussen de regels die worden aangegeven door scrollV en bottomScrollV wordt momenteel weergegeven in het tekstveld.



Implementatie
    public function get bottomScrollV():int

Verwante API-elementen

caretIndex

eigenschap 
caretIndex:int  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De index van de positie van het invoegpunt (invoegteken). Wanneer geen invoegpunt wordt weergegeven, wordt als waarde de positie ingesteld die het invoegpunt inneemt als u de focus weer instelt op het veld (doorgaans de laatste positie van het invoegpunt of 0 als het veld nog geen focus heeft gehad).

Selectiebereikindexen zijn gebaseerd op nul (de eerste positie is bijvoorbeeld 0, de tweede positie 1, enzovoort).



Implementatie
    public function get caretIndex():int

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In dit voorbeeld wordt een instantie TextField gemaakt en gevuld met tekst. Er wordt een gebeurtenislistener toegewezen zodat wanneer de gebruiker op een TextField klikt, de methode printCursorPosition wordt aangeroepen. In dat geval worden de waarden van de eigenschappen caretIndex, selectionBeginIndex en selectionEndIndex uitgevoerd.

Voer dit voorbeeld uit en probeer in het tekstveld te klikken om tekst te selecteren. Klik vervolgens in het veld zonder tekst te selecteren. Wanneer u zonder een selectie te maken in het tekstveld klikt, geeft de eigenschap caretIndex aan waar het invoegpunt zich bevindt en komen de eigenschappen selectionBeginIndex en selectionEndIndex overeen met de waarde van de eigenschap 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

eigenschap 
condenseWhite:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Een booleaanse waarde die aangeeft of extra witruimte (spaties, regeleinden, enzovoort) in een tekstveld met HTML-tekst wordt verwijderd. De standaardwaarde is false. De eigenschap condenseWhite heeft uitsluitend invloed op tekst die is ingesteld met de eigenschap htmlText, niet met de eigenschap text. Wanneer u tekst instelt met de eigenschap text, wordt condenseWhite genegeerd.

Als condenseWhite is ingesteld op true, moet u standaard-HTML-opdrachten zoals <BR> en <P> gebruiken om regeleinden in het tekstveld op te nemen.

Stel de eigenschap condenseWhite in voordat u de eigenschap htmlText instelt.



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

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In het volgende voorbeeld wordt het verschil getoond tussen het instellen van de eigenschap condenseWhite op false en op 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

eigenschap 
defaultTextFormat:flash.text:TextFormat

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Geeft de opmaak op die op nieuw ingevoegde tekst wordt toegepast, zoals tekst die door de gebruiker is ingevoerd of tekst die met de methode replaceSelectedText() is ingevoegd.

Opmerking: wanneer u met setSelection() en replaceSelectedText() de tekens selecteert die u wilt vervangen, wordt de eigenschap defaultTextFormat alleen toegepast als de tekst is geselecteerd tot en met het laatste teken. Hier volgt een voorbeeld:

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

Wanneer u de eigenschap defaultTextFormat benadert, zijn alle eigenschappen van het geretourneerde object TextFormat gedefinieerd. Voor geen enkele eigenschap is de waarde null ingesteld.

Opmerking: u kunt deze eigenschap niet instellen als er een stijlpagina op het tekstveld wordt toegepast.



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

Gegenereerde uitzondering
Error — Deze methode kan niet worden gebruikt voor een tekstveld met een stijlpagina.

Verwante API-elementen

displayAsPassword

eigenschap 
displayAsPassword:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Geeft aan of het tekstveld een tekstveld voor wachtwoorden is. Wanneer de waarde van deze eigenschap true is, wordt het tekstveld behandeld als een tekstveld voor wachtwoorden en worden de invoertekens weergegeven als sterretjes om de echte tekens te verbergen. Wanneer de waarde false is, wordt het tekstveld niet behandeld als een tekstveld voor wachtwoorden. Wanneer de wachtwoordmodus is ingeschakeld, werken de opdrachten Knippen en Kopiëren en de bijbehorende sneltoetsen niet. Met dit beveiligingsmechanisme wordt voorkomen dat een kwaadwillende gebruiker de sneltoetsen gebruikt om achter een wachtwoord te komen op een onbeheerde computer.

De standaardwaarde is false.



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

embedFonts

eigenschap 
embedFonts:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Geeft op of moet worden gerenderd met ingesloten lettertypecontouren. Indien false, rendert Flash Player het tekstveld met apparaatlettertypen.

Als u de eigenschap embedFonts op true instelt voor een tekstveld, moet u voor die tekst een lettertype opgeven met de eigenschap font van een object TextFormat dat is toegepast op het tekstveld. Wanneer het opgegeven lettertype niet is opgenomen in het SWF-bestand, wordt de tekst niet weergegeven.

De standaardwaarde is false.



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

Verwante API-elementen

gridFitType

eigenschap 
gridFitType:String

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9

Het type rasteraanpassing dat wordt gebruikt voor dit tekstveld Deze eigenschap is alleen van toepassing wanneer de eigenschap flash.text.AntiAliasType van het tekstveld op flash.text.AntiAliasType.ADVANCED is ingesteld.

Het type rasteraanpassing dat wordt gebruikt, bepaalt of in Flash Player krachtige horizontale en verticale lijnen wel of niet passend worden gemaakt op een pixel- of subpixelraster.

U kunt de volgende tekenreekswaarden voor de eigenschap flash.text.GridFitType gebruiken:

TekenreekswaardeBeschrijving
flash.text.GridFitType.NONEPassend op raster wordt niet toegepast. Horizontale en verticale lijnen in de glyphs worden niet gedwongen passend gemaakt op het pixelraster. Deze instelling wordt aanbevolen voor animaties en grote lettertypen.
flash.text.GridFitType.PIXELKrachtige horizontale en verticale lijnen worden passend gemaakt op het pixelraster. Deze instelling werkt alleen voor tekstvelden met linkse uitlijning. Wanneer u deze instelling wilt gebruiken, moet de eigenschap flash.display.AntiAliasType van het tekstveld op flash.text.AntiAliasType.ADVANCED worden ingesteld. Deze instelling resulteert doorgaans in de beste leesbaarheid voor links uitgelijnde tekst.
flash.text.GridFitType.SUBPIXELKrachtige horizontale en verticale lijnen worden passend gemaakt op het subpixelraster van een LCD-scherm. Wanneer u deze instelling wilt gebruiken, moet de eigenschap flash.text.AntiAliasType van het tekstveld op flash.text.AntiAliasType.ADVANCED worden ingesteld. De instelling flash.text.GridFitType.SUBPIXEL is meestal geschikt voor rechts uitgelijnde en gecentreerde dynamische tekst en kan helpen bij de keuze tussen animatie- en tekstkwaliteit.

De standaardwaarde is pixel.



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

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In het volgende voorbeeld ziet u drie tekstvelden met verschillende instellingen voor de eigenschap gridFitType. Wanneer u dit voorbeeld gebruikt, let u dan op het verschil in leesbaarheid tussen de eerste twee regels. Let ook op het optimale gebruik van GridFitType.PIXEL voor links uitgevulde tekst en GridFitType.SUBPIXEL voor rechts uitgevulde tekst.
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

eigenschap 
htmlText:String

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Bevat de HTML-representatie van de inhoud van het tekstveld.

Flash Player ondersteunt de volgende HTML-tags:

Tag Beschrijving
Tag voor anker De tag <a> maakt een hyperlink en ondersteunt de volgende kenmerken:
  • target: Hiermee wordt de naam van het doelvenster opgegeven waar u de pagina laadt. De opties zijn _self, _blank, _parent en _top. De optie _self geeft het huidige frame aan in het huidige venster, _blank geeft een nieuw venster aan, _parent geeft het bovenliggende frame aan en _top geeft het frame aan op het hoogste niveau in het huidige venster.
  • href: geeft een URL of een ActionScript-gebeurtenis link op. De URL kan een absolute of relatieve verwijzing zijn naar de locatie van het SWF-bestand dat de pagina laadt. Een voorbeeld van een absolute verwijzing naar een URL is http://www.adobe.com. Een voorbeeld van een relatieve verwijzing is /index.html. Absolute URL's moeten worden voorafgegaan door http://, anders worden ze in Flash Player of AIR als relatieve URL's behandeld. U kunt de gebeurtenis link gebruiken om ervoor te zorgen dat de koppeling een ActionScript-functie uitvoert in een SWF-bestand en geen URL opent. Als u een gebeurtenis link wilt opgeven, gebruikt u het gebeurtenisschema in plaats van het http-schema in het kenmerk href. Een voorbeeld is href="event:myText" in plaats van href="http://myURL"; wanneer de gebruiker op een hyperlink klikt die het gebeurtenisschema bevat, verzendt het tekstveld een TextEvent link met de eigenschap text ingesteld op myText. U kunt vervolgens een ActionScript-functie maken die wordt uitgevoerd wanneer de TextEvent link wordt verzonden. U kunt ook de stijlen a:link, a:hover en a:active voor ankertags definiëren door stijlpagina's te gebruiken.
Tag voor vette tekst Met de tag <b> wordt tekst vet weergegeven. Er moet wel een vet lettertype beschikbaar zijn voor de weergave van de tekst.
Tag voor regeleinde De tag <br> voegt een regeleinde in het tekstveld in. Stel het tekstveld in op een tekstveld met meerdere regels om deze tag te gebruiken.
Tag voor lettertype De tag <font> geeft een lettertype of lijst met lettertypen op voor weergave van de tekst. De tag font ondersteunt de volgende kenmerken:
  • color: Alleen hexadecimale kleurwaarden (#FFFFFF) worden ondersteund.
  • face: geeft de naam van het te gebruiken lettertype op. Zoals u in het volgende voorbeeld ziet, kunt u een lijst met lettertypenamen (door komma's gescheiden) opgeven. In Flash Player wordt dan het eerste beschikbare lettertype geselecteerd. Wanneer het opgegeven lettertype niet is geïnstalleerd op de lokale computer of niet is ingesloten in het SWF-bestand, wordt in Flash Player een vervangend lettertype geselecteerd.
  • size: geeft de grootte van het lettertype op. U kunt absolute pixelgrootten, zoals 16 of 18, of relatieve puntgrootten, zoals +2 of -4, opgeven.
Tag voor afbeelding Met de tag <img> kunt u externe afbeeldingsbestanden (JPEG, GIF, PNG), SWF-bestanden en filmclips in tekstvelden insluiten. Tekst wordt automatisch rond ingesloten afbeeldingen in tekstvelden weergegeven. U moet het tekstveld instellen op een tekstveld met meerdere regels zodat tekst om een afbeelding heen loopt.

De tag <img> ondersteunt de volgende kenmerken:

  • src: geeft de URL op naar een afbeeldingsbestand, een SWF-bestand of de koppelings-id van een filmclipsymbool in de bibliotheek. Dit kenmerk is vereist, alle andere kenmerken zijn optioneel. Externe bestanden (JPEG-, GIF-, PNG- en SWF-bestanden) worden pas zichtbaar wanneer het downloaden ervan is voltooid.
  • width: geeft de breedte op van een afbeelding, SWF-bestand of filmclip in pixels.
  • height: geeft de hoogte op van een afbeelding, SWF-bestand of filmclip in pixels.
  • align: geeft de horizontale uitlijning op van de ingesloten afbeelding in het tekstveld. Geldige waarden zijn left en right. De standaardwaarde is left.
  • hspace: geeft de horizontale ruimte op rondom de afbeelding waar geen tekst wordt weergegeven. De standaardwaarde is 8.
  • vspace: geeft de verticale ruimte op rondom de afbeelding waar geen tekst wordt weergegeven. De standaardwaarde is 8.
  • id: geeft de naam van de filmclipinstantie (gemaakt in Flash Player) op met het ingesloten afbeeldingsbestand, SWF-bestand of de filmclip. Deze benadering wordt gebruikt om de ingesloten inhoud te besturen met ActionScript.
  • checkPolicyFile: hiermee wordt opgegeven dat in Flash Player wordt gecontroleerd of een bestand met URL-beleid aanwezig is op de server die is gekoppeld aan het domein van de afbeelding. Als een bestand met URL-beleid bestaat, hebben SWF-bestanden in de domeinen die worden vermeld in het bestand toegang tot de gegevens van de geladen afbeelding, bijvoorbeeld door de methode BitmapData.draw() aan te roepen met deze afbeelding als de parameter source. Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.

In Flash worden ingesloten media in een tekstveld op volledige grootte weergegeven. Wanneer u de afmetingen wilt opgeven van de media die u insluit, gebruikt u de kenmerken height en width van de tag <img>.

Over het algemeen wordt een ingesloten afbeelding weergegeven in een tekstveld op de regel na de tag <img>. Wanneer de tag <img> echter het eerste teken in het tekstveld is, wordt de afbeelding weergegeven op de eerste regel van het tekstveld.

Voor AIR-inhoud in de beveiligingssandbox van de toepassing, negeert AIR img-tags in HTML-inhoud in TextField-objects van ActionScript. Dit gebeurt om mogelijke aanvallen via phishing te voorkomen.

Tag voor cursieve tekst Met de tag <i> wordt de tekst tussen tags cursief weergegeven. Er moet wel een cursief lettertype beschikbaar zijn voor de weergave van de tekst.
Tag voor lijstitem Met de tag <li> wordt een opsommingsteken voorafgaand aan de aangeduide tekst geplaatst. Opmerking: omdat tags voor gesorteerde en niet-gesorteerde lijsten (<ol> en <ul>) niet worden herkend in Flash Player en AIR, hebben deze geen invloed op de wijze waarop uw lijst wordt weergegeven. Alle lijsten zijn niet-gesorteerd en alle lijstitems gebruiken opsommingstekens.
Tag voor alinea De tag <p> voegt een nieuwe alinea in. U kunt deze tag alleen gebruiken als het tekstveld is ingesteld op een tekstveld met meerdere regels. De tag <p> ondersteunt de volgende kenmerken:
  • align: geeft de uitlijning van tekst in de alinea op. Geldige waarden zijn left, right, justify en center.
  • class: geeft een CSS-opmaakklasse op die door een object flash.text.StyleSheet wordt gedefinieerd.
Tag voor bereik De tag <span> is alleen beschikbaar voor gebruik met CSS-tekststijlen. De tag ondersteunt het volgende kenmerk:
  • class: geeft een CSS-opmaakklasse op die door een object flash.text.StyleSheet wordt gedefinieerd.
Tag voor tekstopmaak

Met de tag <textformat> kunt u een subset alineaopmaakeigenschappen gebruiken van de klasse TextFormat in HTML-tekstvelden, zoals regelafstand, inspringing, marges en tabstops. U kunt de tag <textformat> combineren met de ingebouwde HTML-tags.

De tag <textformat> heeft de volgende kenmerken:

  • blockindent: geeft de blokinspringing op in punten. Komt overeen met TextFormat.blockIndent.
  • indent: geeft de inspringing op van de linkermarge tot het eerste teken in de alinea. Komt overeen met TextFormat.indent. Zowel positieve als negatieve getallen zijn acceptabel.
  • leading: geeft de verticale afstand tussen regels op. Komt overeen met TextFormat.leading. Zowel positieve als negatieve getallen zijn acceptabel.
  • leftmargin: geeft de linkermarge van de alinea op, in punten. Komt overeen met TextFormat.leftMargin.
  • rightmargin: geeft de rechtermarge van de alinea op, in punten. Komt overeen met TextFormat.rightMargin.
  • tabstops: geeft aangepaste tabstops op als een serie niet-negatieve gehele getallen. Komt overeen met TextFormat.tabStops.
Tag voor onderstreping Met de tag <u> wordt de tekst tussen tags onderstreept weergegeven.

Flash Player en AIR ondersteunen de volgende HTML-entiteiten:

Entiteit Beschrijving
&lt; < (kleiner dan)
&gt; > (groter dan)
&amp; & (en-teken)
&quot; " (dubbele aanhalingstekens)
&apos; ' (apostrof, enkel aanhalingsteken)

Flash Player en AIR ondersteunen tevens expliciete tekencodes, zoals &#38; (ASCII-ampersand) en &#x20AC; (€-teken Unicode).



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

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In het volgende voorbeeld wordt een object met de naam tf1 gemaakt en wordt een tekenreeks met HTML-opmaak toegewezen aan de eigenschap text. Wanneer de eigenschap htmlText wordt getraceerd, is de uitvoer de tekenreeks met HTML-opmaak, waarbij extra tags (zoals <P> en <FONT>) automatisch zijn toegevoegd door Flash Player. Wanneer de waarde van text wordt getraceerd, wordt de niet-opgemaakte tekenreeks zonder HTML-tags weergegeven.

Ter vergelijking worden dezelfde stappen ook uitgevoerd op een ander object TextField met de naam tf2. In dit geval wordt echter een object StyleSheet toegewezen aan de eigenschap styleSheet van tf2 voordat de eigenschap htmlText wordt ingesteld. Wanneer in dit geval de eigenschap htmlText wordt getraceerd, bevat deze alleen de exacte HTML-tekst die oorspronkelijk was toegewezen aan de eigenschap htmlText en zijn geen extra tags toegevoegd door Flash Player.

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

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

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

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

length

eigenschap 
length:int  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Het aantal tekens in een tekstveld. Een teken zoals tab (\t) telt als één teken.



Implementatie
    public function get length():int

maxChars

eigenschap 
maxChars:int

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Het maximum aantal tekens dat het tekstveld kan bevatten (ingevoerd door de gebruiker). Een script kan meer tekst invoegen dan maxChars toestaat. Met de eigenschap maxChars wordt slechts aangegeven hoeveel tekst een gebruiker kan invoeren. Wanneer de waarde van deze eigenschap 0 is, kan een gebruiker een onbeperkte hoeveelheid tekst invoeren.

De standaardwaarde is 0.



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

maxScrollH

eigenschap 
maxScrollH:int  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De maximumwaarde van scrollH.



Implementatie
    public function get maxScrollH():int

Verwante API-elementen

maxScrollV

eigenschap 
maxScrollV:int  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De maximumwaarde van scrollV.



Implementatie
    public function get maxScrollV():int

Verwante API-elementen

mouseWheelEnabled

eigenschap 
mouseWheelEnabled:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9

Een booleaanse waarde die aangeeft of Flash Player automatisch door tekstvelden met meerdere regels schuift wanneer de gebruiker op een tekstveld klikt en het muiswiel gebruikt. Deze waarde is standaard ingesteld op true. Deze eigenschap is nuttig wanneer u wilt voorkomen dat met het muiswiel door tekstvelden wordt geschoven of u uw eigen schuifmethode voor tekstvelden wilt implementeren.



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

multiline

eigenschap 
multiline:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Hiermee wordt aangegeven of het veld een tekstveld met meerdere regels is. Wanneer de waarde true is, bevat het tekstveld meerdere regels. Wanneer de waarde false is, bevat het tekstveld slechts één regel. In een veld van het type TextFieldType.INPUT bepaalt de waarde multiline of met de toets Enter een nieuwe regel kan worden gemaakt (wanneer de waarde false is, wordt de toets Enter genegeerd). Als u tekst plakt in een TextField waarvan de waarde multiline is ingesteld op false, worden nieuwe regels uit de tekst verwijderd.

De standaardwaarde is false.



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

Verwante API-elementen

numLines

eigenschap 
numLines:int  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Definieert het aantal tekstregels in een tekstveld met meerdere regels. Wanneer de eigenschap wordWrap op true is ingesteld, neemt het aantal regels toe bij tekstomloop.



Implementatie
    public function get numLines():int

Verwante API-elementen

restrict

eigenschap 
restrict:String

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Geeft de set tekens aan die een gebruiker in het tekstveld kan invoeren. Wanneer de waarde van de eigenschap restrict null is, kunt u een willekeurig teken invoeren. Wanneer de waarde van de eigenschap restrict een lege tekenreeks is, kunt u geen willekeurig teken invoeren. Wanneer de waarde van de eigenschap restrict een reeks tekens is, kunt u alleen tekens in die reeks in het tekstveld invoeren. De tekenreeks wordt van links naar rechts gescand. U kunt een bereik opgeven met het koppelteken (-). Alleen gebruikersinteractie is beperkt; een script kan alle mogelijke tekst in het tekstveld plaatsen. Deze eigenschap synchroniseert niet met de opties voor het insluiten van lettertypen in Eigenschapcontrole.

Wanneer de tekenreeks begint met een invoegteken (^), worden alle tekens eerst geaccepteerd, maar worden de tekens na het invoegteken in de tekenreeks uitgesloten van de set met geaccepteerde tekens. Wanneer de tekenreeks niet begint met een invoegteken (^), worden eerst geen tekens geaccepteerd, maar worden alle tekens in de tekenreeks opgenomen in de set met geaccepteerde tekens.

In het volgende voorbeeld kunnen alleen hoofdletters, spaties en getallen worden ingevoerd in een tekstveld:

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

In het volgende voorbeeld worden alle tekens opgenomen, maar worden twee kleine letters uitgesloten:

     my_txt.restrict = "^a-z";
     

U kunt een backslash gebruiken om de letterlijke tekens ^ of - op te geven. De geaccepteerde backslash-reeksen zijn \-, \^ en \\. De backslash moet een echt teken in de tekenreeks zijn. In ActionScript-code moet dus een dubbele backslash worden gebruikt. De volgende code bevat bijvoorbeeld alleen het streepje (-) en invoegpunt (^):

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

Het invoegpunt ^ kan overal in de tekenreeks worden gebruikt om te schakelen tussen het opnemen en uitsluiten van tekens. Met de volgende code worden alleen hoofdletters opgenomen, maar wordt de hoofdletter Q uitgesloten:

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

Met de escape-reeks \u kunt u restrict-tekenreeksen maken. Met de volgende code worden alleen tekens vanaf ASCII 32 (spatie) tot ASCII 126 (tilde) opgenomen.

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

De standaardwaarde is null.



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

scrollH

eigenschap 
scrollH:int

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De huidige horizontale schuifpositie. Wanneer de eigenschap scrollH is ingesteld op 0, wordt de tekst niet horizontaal geschoven. Deze eigenschapwaarde is een geheel getal dat de horizontale positie in pixels vertegenwoordigt.

Horizontaal schuiven wordt uitgedrukt in pixels, verticaal schuiven in regels. Horizontaal schuiven wordt in pixels gemeten omdat de meeste lettertypen die u doorgaans gebruikt proportioneel gespatieerd zijn. Dit betekent dat de tekens verschillende breedten kunnen hebben. In Flash Player wordt verticaal schuiven in regels gemeten omdat gebruikers doorgaans een tekstregel in zijn geheel willen zien. Zelfs wanneer een regel meerdere lettertypen bevat, wordt de hoogte van de regel aangepast aan het grootste lettertype.

Opmerking: de eigenschap scrollH is op nul gebaseerd, niet op één zoals de eigenschap scrollV voor verticaal schuiven.



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

Verwante API-elementen

scrollV

eigenschap 
scrollV:int

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De verticale positie van tekst in een tekstveld. De eigenschap scrollV is nuttig om gebruikers naar een bepaalde alinea in een lange passage te leiden of tekstvelden te maken waarin kan worden geschoven.

Verticaal schuiven wordt uitgedrukt in regels, horizontaal schuiven in pixels. Wanneer de eerste regel die wordt weergegeven ook de eerste regel in het tekstveld is, is scrollV ingesteld op 1 (niet op 0). Horizontaal schuiven wordt in pixels gemeten omdat de meeste lettertypen proportioneel gespatieerd zijn. Dit betekent dat de tekens verschillende breedten kunnen hebben. In Flash wordt verticaal schuiven in regels gemeten omdat gebruikers doorgaans een tekstregel in zijn geheel willen zien. Zelfs wanneer een regel meerdere lettertypen bevat, wordt de hoogte van de regel aangepast aan het grootste lettertype.



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

Verwante API-elementen

selectable

eigenschap 
selectable:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Een booleaanse waarde die aangeeft of het tekstveld kan worden geselecteerd. De waarde true geeft aan dat de tekst kan worden geselecteerd. Met de eigenschap selectable wordt bepaald of een tekstveld kan worden geselecteerd, niet of een tekstveld kan worden bewerkt. Een dynamisch tekstveld kan ook selecteerbaar zijn wanneer het niet bewerkbaar is. Wanneer een dynamisch tekstveld niet selecteerbaar is, kan de gebruiker de tekst niet selecteren.

Wanneer selectable is ingesteld op false, reageert de tekst in het tekstveld niet op selectieopdrachten van de muis of het toetsenbord en kan de tekst niet worden gekopieerd met de opdracht Kopiëren. Wanneer selectable is ingesteld op true, kan de tekst in het tekstveld worden geselecteerd met de muis of het toetsenbord en kan de tekst worden gekopieerd met de opdracht Kopiëren. U kunt tekst ook op deze manier selecteren als het tekstveld een dynamisch tekstveld is in plaats van een invoertekstveld.

De standaardwaarde is true.



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

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In het volgende voorbeeld worden twee dynamische tekstvelden gemaakt: een tekstveld met de eigenschap selectable ingesteld op true en het andere tekstveld met de eigenschap selectable ingesteld op false. Wanneer u dit voorbeeld gebruikt, probeert u dan de tekst in deze velden te selecteren met de muis of het toetsenbord.
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

eigenschap 
selectionBeginIndex:int  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De op nul gebaseerde indexwaarde van het eerste teken in de huidige selectie. Het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort. Wanneer geen tekst wordt geselecteerd, heeft deze eigenschap de waarde caretIndex.



Implementatie
    public function get selectionBeginIndex():int

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In dit voorbeeld wordt een instantie TextField gemaakt en gevuld met tekst. Er wordt een gebeurtenislistener toegewezen zodat wanneer de gebruiker op een TextField klikt, de methode printCursorPosition wordt aangeroepen. In dat geval worden de waarden van de eigenschappen caretIndex, selectionBeginIndex en selectionEndIndex uitgevoerd.

Voer dit voorbeeld uit en probeer in het tekstveld te klikken om tekst te selecteren. Klik vervolgens in het veld zonder tekst te selecteren. Wanneer u zonder een selectie te maken in het tekstveld klikt, geeft de eigenschap caretIndex aan waar het invoegpunt zich bevindt en komen de eigenschappen selectionBeginIndex en selectionEndIndex overeen met de waarde van de eigenschap 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

eigenschap 
selectionEndIndex:int  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De op nul gebaseerde indexwaarde van het laatste teken in de huidige selectie. Het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort. Wanneer geen tekst wordt geselecteerd, heeft deze eigenschap de waarde caretIndex.



Implementatie
    public function get selectionEndIndex():int

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In dit voorbeeld wordt een instantie TextField gemaakt en gevuld met tekst. Er wordt een gebeurtenislistener toegewezen zodat wanneer de gebruiker op een TextField klikt, de methode printCursorPosition wordt aangeroepen. In dat geval worden de waarden van de eigenschappen caretIndex, selectionBeginIndex en selectionEndIndex uitgevoerd.

Voer dit voorbeeld uit en probeer in het tekstveld te klikken om tekst te selecteren. Klik vervolgens in het veld zonder tekst te selecteren. Wanneer u zonder een selectie te maken in het tekstveld klikt, geeft de eigenschap caretIndex aan waar het invoegpunt zich bevindt en komen de eigenschappen selectionBeginIndex en selectionEndIndex overeen met de waarde van de eigenschap 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

eigenschap 
sharpness:Number

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9

De scherpte van de glyph-randen in dit tekstveld. Deze eigenschap is alleen van toepassing wanneer de eigenschap flash.text.AntiAliasType van het tekstveld op flash.text.AntiAliasType.ADVANCED is ingesteld. Het bereik voor sharpness is een getal tussen -400 en 400. Wanneer u sharpness probeert in te stellen op een waarde buiten dat bereik, wordt voor de eigenschap de dichtstbijzijnde waarde in het bereik ingesteld (-400 of 400).

De standaardwaarde is 0.



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

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In het volgende voorbeeld ziet u het effect van het wijzigen van de eigenschap sharpness voor een TextField-object. U moet het lettertype insluiten en de eigenschap antiAliasType instellen op 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

eigenschap 
styleSheet:StyleSheet

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Koppelt een stijlpagina aan het tekstveld. Zie de StyleSheet-klasse en de Adobe ActionScript 3.0-ontwikkelaarsgids voor informatie over het maken van stijlpagina's.

U kunt de stijlpagina die aan tekstveld is gekoppeld op elk moment wijzigen. Wanneer u de stijlpagina in gebruik wijzigt, wordt het tekstveld opnieuw getekend met de nieuwe stijlpagina. U kunt de stijlpagina op null of undefined instellen om de stijlpagina te verwijderen. Wanneer de stijlpagina in gebruik is verwijderd, wordt het tekstveld opnieuw getekend zonder een stijlpagina.

Opmerking: wanneer de stijlpagina wordt verwijderd, wordt de inhoud van zowel TextField.text als TextField.htmlText gewijzigd om de opmaak op te nemen die eerder door de stijlpagina is toegepast. Wanneer u de oorspronkelijke inhoud TextField.htmlText zonder de opmaak wilt behouden, slaat u de waarde in een variabele op voordat u de stijlpagina verwijdert.



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

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In het volgende voorbeeld wordt een eenvoudig StyleSheet-object gedefinieerd en aan een tekstveld met HTML-inhoud toegewezen. Stel de eigenschap stylesheet in voordat u de inhoud instelt.
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

eigenschap 
text:String

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Een tekenreeks die de huidige tekst in het tekstveld is. Regels worden gescheiden door het Enter-teken ('\r', ASCII 13). Deze eigenschap bevat niet-opgemaakte tekst in het tekstveld, zonder HTML-tags

Wanneer u de tekst in HTML-notatie wilt weergeven, gebruikt u de eigenschap htmlText.

Opmerking: Als een stijlpagina wordt toegepast op het tekstveld, wordt de inhoud van de eigenschap text geïnterpreteerd als HTML.



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

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In het volgende voorbeeld wordt een object met de naam tf1 gemaakt en wordt een tekenreeks met HTML-opmaak toegewezen aan de eigenschap text. Wanneer de eigenschap htmlText wordt getraceerd, is de uitvoer de tekenreeks met HTML-opmaak, waarbij extra tags (zoals <P> en <FONT>) automatisch zijn toegevoegd door Flash Player. Wanneer de waarde van text wordt getraceerd, wordt de niet-opgemaakte tekenreeks zonder HTML-tags weergegeven.

Ter vergelijking worden dezelfde stappen ook uitgevoerd op een ander object TextField met de naam tf2. In dit geval wordt echter een object StyleSheet toegewezen aan de eigenschap styleSheet van tf2 voordat de eigenschap htmlText wordt ingesteld. Wanneer in dit geval de eigenschap htmlText wordt getraceerd, bevat deze alleen de exacte HTML-tekst die oorspronkelijk was toegewezen aan de eigenschap htmlText en zijn geen extra tags toegevoegd door Flash Player.

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

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

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

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

textColor

eigenschap 
textColor:uint

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De kleur van de tekst in een tekstveld, in hexadecimale notatie. In het hexadecimale kleurensysteem worden zes cijfers gebruikt voor kleurwaarden. Elk cijfer heeft 16 mogelijke waarden of tekens. Als tekens kunt u 0 tot en met -9 en A-F gebruiken. Zwart is bijvoorbeeld 0x000000, wit is 0xFFFFFF.

De standaardwaarde is 0 (0x000000).



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

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
Met de volgende ActionScript-code wordt een object TextField gemaakt en wordt de eigenschap textColor ervan gewijzigd in rood (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

eigenschap 
textHeight:Number  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De hoogte van de tekst in pixels.



Implementatie
    public function get textHeight():Number

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In het volgende voorbeeld wordt een object TextField gemaakt en wordt hieraan tekst toegewezen. De instructie trace geeft de waarden van de eigenschappen textWidth en textHeight weer. Ter vergelijking worden tevens de eigenschappen width en height weergegeven. (De waarden voor textHeight en textWidth kunnen variëren, afhankelijk van het lettertype dat op uw computer wordt gebruikt).
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

eigenschap 
textInteractionMode:String  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 11, Flash Lite 4

De eigenschap van de interactiemodus. De standaardwaarde is TextInteractionMode.NORMAL. Op mobiele platformen impliceert de normale modus dat er door de tekst kan worden geschoven, maar dat de tekst niet kan worden geselecteerd. Via het ingebouwde contextmenu in het tekstveld kan worden geschakeld naar de selectiemodus. Op bureaubladsystemen impliceert de normale modus dat er door de tekst kan worden geschoven en dat de tekst ook kan worden geselecteerd.



Implementatie
    public function get textInteractionMode():String

textWidth

eigenschap 
textWidth:Number  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

De breedte van de tekst in pixels.



Implementatie
    public function get textWidth():Number

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In het volgende voorbeeld wordt een object TextField gemaakt en wordt hieraan tekst toegewezen. De instructie trace geeft de waarden van de eigenschappen textWidth en textHeight weer. Ter vergelijking worden tevens de eigenschappen width en height weergegeven. (De waarden voor textHeight en textWidth kunnen variëren, afhankelijk van het lettertype dat op uw computer wordt gebruikt).
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

eigenschap 
thickness:Number

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9

De dikte van de glyph-randen in dit tekstveld. Deze eigenschap wordt alleen toegepast wanneer flash.text.AntiAliasType op flash.text.AntiAliasType.ADVANCED is ingesteld.

Het bereik voor thickness is een getal tussen -200 en 200. Wanneer u thickness probeert in te stellen op een waarde buiten dat bereik, wordt voor de eigenschap de dichtstbijzijnde waarde in het bereik ingesteld (-200 of 200).

De standaardwaarde is 0.



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

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In het volgende voorbeeld ziet u het effect van het wijzigen van de eigenschap thickness voor een TextField-object. U moet het lettertype insluiten en de eigenschap antiAliasType instellen op 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

eigenschap 
type:String

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Het type tekstveld. Een van de volgende TextFieldType-constanten: TextFieldType.DYNAMIC, die een dynamisch tekstveld opgeeft dat niet kan worden bewerkt door een gebruiker, of TextFieldType.INPUT, dat een invoertekstveld opgeeft dat wel kan worden bewerkt door een gebruiker.

De standaardwaarde is dynamic.



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

Gegenereerde uitzondering
ArgumentError — Het opgegeven type is geen lid van flash.text.TextFieldType.

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In het volgende voorbeeld worden twee tekstvelden gemaakt: tfDynamic entfInput. In beide tekstvelden wordt tekst ingevoerd. Voor tfDynamic is de eigenschap type echter op TextFieldType.DYNAMIC ingesteld en voor tfInput is de eigenschap type op TextFieldType.INPUT ingesteld, zodat de gebruiker de tekst in tfInput kan wijzigen maar de tekst in tfDynamic alleen kan bekijken.
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

eigenschap 
useRichTextClipboard:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9

Geeft aan of de tekstopmaak samen met de tekst moet worden gekopieerd en geplakt. Indien true wordt opmaak (zoals uitlijning en vette en cursieve tekst) in Flash Player ook gekopieerd en geplakt wanneer u kopieert en plakt tussen tekstvelden. Voor de procedure voor kopiëren en plakken moet zowel voor het oorspronkelijke tekstveld als voor het tekstveld van bestemming useRichTextClipboard op true worden ingesteld. De standaardwaarde is false.



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

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In dit voorbeeld worden een invoertekstveld (tf1) en twee dynamische tekstvelden (tf2 en tf3) gemaakt. Aan elk dynamisch tekstveld wordt door de code een TextFormat-object (lettertype Courier Bold) toegewezen. Voor het tekstveld tf2 is de eigenschap useRichTextClipboard ingesteld op false. Voor het tekstveld tf3 is de eigenschap useRichTextClipboard ingesteld op true. Wanneer u de tekst uit tekstveld tf2 kopieert en in tekstveld tf1 plakt, is de geplakte tekst niet opgemaakt. Wanneer u de tekst uit tekstveld tf3 kopieert (waarvoor useRichTextClipboard is ingesteld op true) en deze in tekstveld tf1 plakt, is de geplakte tekst wel opgemaakt.
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

eigenschap 
wordWrap:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Een booleaanse waarde die aangeeft of voor het tekstveld tekstomloop is ingesteld. Wanneer de waarde van wordWrap true is, heeft het tekstveld tekstomloop. Wanneer de waarde false is, heeft het veld geen tekstomloop. De standaardwaarde is false.



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

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In het volgende voorbeeld wordt het verschil getoond tussen het instellen van de eigenschap wordWrap op true en het instellen ervan op false: Er worden twee instanties TextField gemaakt met inhoud die te groot is voor de breedte. De eigenschap wordWrap van de eerste instantie (tfWrap genoemd) is op true ingesteld. Voor de tweede instantie (tfNoWrap) wordt deze eigenschap op false ingesteld.
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;
        }
    }
}
Constructordetails

TextField

()Constructor
public function TextField()

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Maakt een nieuwe instantie TextField. Wanneer u een object Bitmap hebt gemaakt, roept u de methode addChild() of addChildAt() aan van het bovenliggende object DisplayObjectContainer om de instantie TextField in het weergaveoverzicht op te nemen.

De standaardgrootte voor een tekstveld is 100 x 100 pixels.


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt aangegeven hoe u dynamisch een TextField-object voor invoer kunt maken in ActionScript 3.0 door de eigenschap type van het tekstveldobject in te stellen op de TextFieldType.INPUT-constante. Voorbeeld van 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);
Methodedetails

appendText

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Voegt de tekenreeks die is opgegeven met de parameter newText toe aan het einde van de tekst in het tekstveld. Deze methode is efficiënter dan het toewijzen van (+=) aan een eigenschap text (bijvoorbeeld someTextField.text += moreText), met name wanneer een tekstveld een aanzienlijke hoeveelheid inhoud bevat.

Parameters

newText:String — De tekenreeks die moet worden toegevoegd aan de bestaande tekst.


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt de tijd getoond wanneer het geen weekend is, of de tekst 'It's the weekend' wanneer het wel weekend is. Bovendien wordt het aantal tekens tot een bepaalde positie en het aantal regels in het tekstveld geteld.

De grootte van het tekstveld outputText wordt automatisch gewijzigd zodat de tekst erin past en de tekst wordt ingesteld op links uitvullen met de eigenschap autoSize. De eigenschap outputText.text schrijft de eerste regel van de inhoud en de methode appendText() voegt de rest van de inhoud toe. (U hoeft niet te beginnen met de eigenschap text. De methode appendText() kan ook worden gebruikt om tekst vanaf het begin toe te voegen.) Wanneer u de eigenschap text nogmaals instelt, wordt de oorspronkelijke tekst overschreven. Gebruik de operator voor optellen en toewijzen (+=) om inhoud toe te voegen met de eigenschap text.

De instructie if controleert of de datum zaterdag (6) of zondag (0) is. Wanneer dit niet het geval is, retourneert de methode toLocaleTimeString() de lokale tijd, die aan de inhoud van het tekstveld wordt toegevoegd.

De eigenschap length van het tekstveld wordt gebruikt om het aantal tekens te lezen net voordat de functie wordt aangeroepen. De eigenschap numLines wordt gebruikt om het aantal regels in het tekstveld te tellen. De lege regels worden meegenomen in het aantal regels en de lege spaties en regeleinden (\n) worden meegenomen bij het bepalen van de lengte van de inhoud.

  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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Retourneert een rechthoek die het selectiekader van het teken vormt.

Parameters

charIndex:int — De op nul gebaseerde indexwaarde voor het teken (de eerste positie is bijvoorbeeld 0, de tweede positie 1, enzovoort).

Geretourneerde waarde
Rectangle — Een rechthoek met minimum- en maximumwaarden voor x en y die het selectiekader van het teken definiëren.

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt de methode getCharBoundaries() gebruikt om een teken te markeren (er een spotlight op te zetten) dat door de gebruiker is geselecteerd.

De klasse definieert het Shape-object spotlight dat wordt gebruikt om een rechthoek te tekenen rondom elk teken dat is geselecteerd. Wanneer de gebruiker op het tekstveld myTextField klikt, wordt de methode clickHandler() aangeroepen.

Bij de methode clickHandler() haalt de methode getCharIndexAtPoint() de index op van het teken waarop is geklikt op basis van de coördinaten localX en localY van de muisklik, die relatief is ten opzichte van de bevattende Sprite. De methode getCharIndexAtPoint() retourneert -1 wanneer het punt (de muisklik) zich niet op een teken bevond. Aangezien het tekstveld groter kan zijn dan de tekst, wordt het geretourneerde gehele getal (index) gecontroleerd om er zeker van te zijn dat de gebruiker op een teken heeft geklikt. Het gehele getal index wordt ook gebruikt doorgetCharBoundaries() om een object Rectangle op te halen dat de grens van het teken bevat. De methode clear() wist een eventueel eerder weergegeven Shape-object spotlight. Op de locatie van het teken (verschoven van de coördinaten (10, 10)) wordt een nieuwe rechthoek gemaakt ter grootte van de breedte- en hoogtegrenzen van het teken met behulp van het geretourneerde frame op de x- en y-coördinaten van de rechthoek. Om het spotlight op het teken te zetten, wordt het Shape-object spotlight gevuld met een gele kleur en wordt de dekking op 35 procent ingesteld, zodat het teken zichtbaar is. Spaties worden ook als een teken beschouwd.

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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Retourneert de op nul gebaseerde indexwaarde van het teken op het punt dat is opgegeven met de parameters x en y.

Parameters

x:Number — De x-coördinaat van het teken.
 
y:Number — De y-coördinaat van het teken.

Geretourneerde waarde
int — De op nul gebaseerde indexwaarde van het teken (de eerste positie is bijvoorbeeld 0, de tweede positie 1, enzovoort). Retourneert -1 wanneer het punt zich niet op een teken bevindt.

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt het teken gekopieerd naar een ander tekstveld boven de tekst wanneer een gebruiker op een teken klikt.

Het eerste tekstveld bevat de tekst die de gebruiker zal selecteren. Om te zorgen dat op de tekst wordt geklikt maar deze niet wordt geselecteerd, wordt de eigenschap selectable op false ingesteld. Wanneer de gebruiker op het tekstveld firstTextField klikt, wordt de methode clickHandler() aangeroepen.

Bij de methode clickHandler() retourneert de methode getCharIndexAtPoint() de index van het teken op basis van de coördinaten localX en localY van de muisklik. Aangezien het tekstveld groter kan zijn dan de tekst, wordt het geretourneerde gehele getal (index) gecontroleerd om er zeker van te zijn dat de gebruiker op een teken heeft geklikt. (De methode getCharIndexAtPoint() retourneert -1 wanneer het punt (de muisklik) zich niet op een teken bevond.) De muiscoördinaten worden gebruikt om de coördinaten van het nieuwe tekstveld in te stellen waar het gekopieerde teken wordt geplaatst. De kleur van het teken in het tweede tekstveld wordt op rood ingesteld. Ten slotte wordt de tekst in het tweede veld op het geselecteerde teken ingesteld, dat met de methode charAt() wordt opgehaald. Wanneer de eigenschap text wordt gebruikt in plaats van de methode appendText(), wordt het teken in het tweede tekstveld overschreven, niet toegevoegd.

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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Op basis van een tekenindex wordt hiermee de index van het eerste teken in dezelfde alinea geretourneerd.

Parameters

charIndex:int — De op nul gebaseerde indexwaarde van het teken (het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort).

Geretourneerde waarde
int — De op nul gebaseerde indexwaarde van het eerste teken in dezelfde alinea.

Gegenereerde uitzondering
RangeError — De opgegeven tekenindex bevindt zich buiten het bereik.

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt alineaopmaak op de inhoud van het tekstveld toegepast. Wanneer de gebruiker op een alinea klikt, wordt de tekst in de alinea rechts uitgelijnd. Wanneer de gebruiker nogmaals op de alinea klikt, wordt deze teruggezet in de oorspronkelijke (standaard)opmaak (links uitgelijnd).

In de constructor wordt het tekstveld myTextField ingesteld op tekstomloop. De methode getTextFormat retourneert de oorspronkelijke opmaak van het eerste teken van de inhoud van het tekstveld, dat in het TextFormat-object originalFormat wordt geplaatst. Er wordt ook een nieuw TextFormat-object (newFormat) gedefinieerd en de eigenschap align ervan wordt toegewezen aan rechts uitvullen. Wanneer de gebruiker op het tekstveld klikt, wordt de methode clickHandler() aangeroepen.

Bij de methode clickHandler() retourneert de methode getCharIndexAtPoint() de index van het teken op basis van de coördinaten localX en localY van de muisklik. De eerste instructie if controleert of de gebruiker op een teken heeft geklikt. Met het gehele getal clickIndex dat door de methode getCharIndexAtPoint() is geretourneerd, retourneert de methode getFirstCharInParagraph() de index van het eerste teken in de alinea waarop de gebruiker heeft geklikt. De index van het laatste teken in de alinea wordt bepaald door de lengte van de alinea (met de methode getParagraphLength()) toe te voegen aan de index van het eerste teken in de alinea, min het laatste teken (\n). De tweede instructie if controleert de opmaak van het eerste teken in de alinea. Wanneer de uitlijningswaarde gelijk is aan die van de oorspronkelijke opmaak (links uitvullen), wordt de nieuwe opmaak toegepast op alle tekens in de alinea. Anders wordt de opmaak van de alinea teruggezet naar de oorspronkelijke opmaak. Uitlijning, samen met opmaak zoals inspringen, opsommingsteken, tabstop, linker- en rechtermarge, zijn opmaakvormen voor alinea's. Zodra tekstomloop of regeleinde wordt gebruikt, is de opmaak alleen van toepassing op de eerste regel van de alinea wanneer het argument endIndex niet is gedefinieerd voor de methode setTextFormat().

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

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

            originalFormat = myTextField.getTextFormat(0);

            newFormat.align = TextFormatAlign.RIGHT;

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

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

getImageReference

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Retourneert een referentie DisplayObject voor de opgegeven id voor een afbeeldings- of SWF-bestand dat aan een tekstveld met HTML-opmaak is toegevoegd met een tag <img>. De tag <img> heeft de volgende indeling:

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

Parameters

id:String — De id die moet overeenkomen (in het kenmerk id van de tag <img>).

Geretourneerde waarde
DisplayObject — Het weergaveobject dat overeenkomt met het afbeeldings- of SWF-bestand met het overeenkomende kenmerk id in de tag <img> van het tekstveld. Voor media die worden geladen vanaf een externe bron, is dit object een object Loader; na het laden is het mediaobject een onderliggend object van dat object Loader. Voor media die zijn ingesloten in het SWF-bestand is dit het geladen object. Als er geen tag <img> met de overeenkomendeid bestaat, retourneert de methode null.

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt de afbeelding in het veld ingesteld op 25 procent dekking en roteert deze 90 graden vanaf de oorspronkelijke rotatie wanneer op het tekstveld wordt geklikt. De afbeelding blijft roteren bij elke volgende muisklik.

De afbeelding image.jpg) wordt via de HTML opgenomen. (Hier wordt aangenomen dat een afbeeldingsbestand zich in dezelfde map bevindt als het SWF-bestand.) Er moet een kenmerk id worden gedefinieerd voor de tag img om de afbeelding te kunnen benaderen met behulp van de methode getImageReference(). De eigenschap htmlText wordt gebruikt om tekenreeksinhoud met HTML-opmaak op te nemen. Wanneer de gebruiker op het tekstveld myTextField klikt, wordt de methode clickHandler() aangeroepen.

Bij de methode clickHandler() retourneert de methode getImageReference() een verwijzing naar de afbeelding als een DisplayObject. Deze verwijzing kan worden gebruikt om de afbeelding te manipuleren, net als elk object DisplayObject. Hier worden de eigenschappen alpha (transparantie) en rotation ingesteld. De eigenschap transform kan ook worden gebruik om de matrix, de kleurentransformatie en de pixelbeperkingen van het weergaveobject te benaderen. flash.display.DisplayObject moet worden geïmporteerd.

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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Retourneert de op nul gebaseerde indexwaarde van de regel op het punt dat is opgegeven met de parameters x en y.

Parameters

x:Number — De x-coördinaat van de regel.
 
y:Number — De y-coördinaat van de regel.

Geretourneerde waarde
int — De op nul gebaseerde indexwaarde van de regel (de eerste regel is bijvoorbeeld 0, de tweede regel 1, enzovoort). Retourneert -1 wanneer het punt zich niet op een regel bevindt.

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt wanneer een gebruiker een regel uit het sonnet van Shakespeare selecteert, deze gekopieerd naar (toegevoegd aan) een nieuw tekstveld.

In de constructor wordt het tekstveld poem ingesteld op geen tekstomloop (aangezien het een gedicht is). De eigenschap autoSize wordt ook gebruikt om de tekst in te stellen op automatische grootte en links uitvullen. Het tekstveld poemCopy wordt onder het tekstveld poem geplaatst. Wanneer de gebruiker op een regel in het gedicht klikt, wordt de methode clickHandler() aangeroepen.

Bij de methode clickHandler() retourneert de methode getLineIndexAtPoint() de index van de regel waarop de gebruiker heeft geklikt op basis van de coördinaten localX en localY van de muisklik. (Aangezien het oorspronkelijke gedicht hier in het formaat van het tekstveld past, is het niet nodig te controleren op buiten-bereikfouten (RangeError), gegenereerd door de methodegetCharIndexAtPoint().) De index van de regel wordt vervolgens gebruikt om de inhoud van de regel met de methode getLineText() op te halen als een tekenreeks, waarna deze aan de inhoud van het tekstveld poemCopy wordt toegevoegd. Het kopiëren kan eindeloos doorgaan, maar op een gegeven moment zal de tekst zich buiten het bereik van het zichtbare tekstveld poemCopy bevinden

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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Retourneert de op nul gebaseerde indexwaarde van de regel die het teken bevat dat door de parameter charIndex wordt opgegeven.

Parameters

charIndex:int — De op nul gebaseerde indexwaarde van het teken (het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort).

Geretourneerde waarde
int — De op nul gebaseerde indexwaarde van de regel.

Gegenereerde uitzondering
RangeError — De opgegeven tekenindex bevindt zich buiten het bereik.

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld retourneert de methode getLineIndexOfChar() het regelnummer voor het 100e en 500e teken in het tekstveld.

Het tekstveld myTextField is gedefinieerd op tekstomloop en de tekst wordt ingesteld op links uitlijnen. De methode getLineIndexOfChar() retourneert de index van de regel voor de opgegeven tekenindexen (100 en 500). Deze informatie wordt vervolgens na de alinea toegevoegd. Aangezien de index van de regel met 0 begint, wordt de index van de regel index) met 1 opgehoogd om het regelnummer te bepalen. Wanneer de grootte van de weergave wordt gewijzigd, kan het regelnummer veranderen maar de informatie blijft gelijk aangezien de methode slechts eenmaal wordt aangeroepen.

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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Retourneert het aantal tekens in een opgegeven tekstregel.

Parameters

lineIndex:int — Het nummer van de regel waarvan u de lengte wilt weten.

Geretourneerde waarde
int — Het aantal tekens op de regel.

Gegenereerde uitzondering
RangeError — Het opgegeven regelnummer bevindt zich buiten het bereik.

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt de regellengte (aantal tekens) in een apart tekstveld weergegeven nadat de gebruiker een regel heeft geselecteerd.

Als voorbeeld wordt het tekstveld myTextField, dat de tekst bevat die zal worden geteld, op INPUT ingesteld, zodat gebruikers regels kunnen wijzigen of regels tussen de regels of aan het eind kunnen toevoegen. (Er wordt een lege regel gemaakt door een regeleinde (\n) te gebruiken aan het einde van de laatste regel.) Het tekstveld countLines, waarin het resultaat van de telling van de regellengte wordt weergegeven, wordt onder het tekstveld myTextField geplaatst en de tekst ervan kan niet worden geselecteerd. Wanneer de gebruiker op een regel in het tekstveld myTextField klikt, wordt de methode clickHandler() aangeroepen.

Bij de methode clickHandler() retourneert de methode getLineIndexAtPoint() de index van de regel waarop de gebruiker heeft geklikt door gebruik te maken van de coördinaten localX en localY van de muisklik. De instructie if controleert of de gebruiker op een teken heeft geklikt. Zo ja, dan retourneert de methode getLineLength(), met gebruikmaking van de index van de regel, het aantal tekens in de regel. De lege regels tussen de regels omvatten het tweede regeleinde (\n) en hebben een telling van 1; de regel na de laatste regel heeft een telling van 0. Spaties tellen als één teken. De gebruiker kan een nieuwe regel schrijven of een regel wijzigen en de tekentelling van de regel opvragen door erop te klikken. Wanneer tekstomloop wordt gebruikt en de grootte van het scherm is gewijzigd, kan de index van de regel veranderen.

 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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Geeft metrische informatie over een bepaalde tekstregel weer.

Parameters

lineIndex:int — Het nummer van de regel waarover u metrische informatie wilt krijgen.

Geretourneerde waarde
flash.text:TextLineMetrics — Een object TextLineMetrics.

Gegenereerde uitzondering
RangeError — Het opgegeven regelnummer bevindt zich buiten het bereik.

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt een aantal cijferwaarden weergegeven voor twee regels tekst met verschillende opmaak.

De toegevoegde tekst is twee regels van Song of Myself van Walt Whitman. Een nieuw object TextFormat (newFormat) wordt gebruikt om de opmaak van de tweede regel in te stellen. De eerste regel bevat de standaardopmaak. De methode getLineMetrics() retourneert een object TextLineMetrics voor een specifieke regel. (Index van de regel begint met 0.) Met de TextLineMetrics-objecten metrics1 en metrics2 voor respectievelijk regel één en twee worden de waarden ascent, descent, height en weight van de regel opgehaald en weergegeven. De resultaatgetallen worden omgezet in een tekenreeks, maar niet afgerond. Deze waarde is van toepassing op de regel en niet op een specifiek teken. De waarde weerspiegelt de reeks tekens voor een regel. Wanneer een regel bijvoorbeeld verschillende tekens bevat met verschillende hoogten, zal het teken met de hoogste hoogte de waarde bepalen. Dit houdt tevens in dat wanneer de opmaak van een teken wordt gewijzigd, een aantal cijferwaarden ook kan wijzigen.

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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Retourneert de tekenindex van het eerste teken op de regel die wordt opgegeven door de parameter lineIndex.

Parameters

lineIndex:int — De op nul gebaseerde indexwaarde van de regel (de eerste regel is bijvoorbeeld 0, de tweede regel 1, enzovoort).

Geretourneerde waarde
int — De op nul gebaseerde indexwaarde van het eerste teken in de regel.

Gegenereerde uitzondering
RangeError — Het opgegeven regelnummer bevindt zich buiten het bereik.

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt op het eerste teken in regel 4 gecontroleerd, dat verandert wanneer de grootte van het scherm (en het tekstveld) wordt gewijzigd.

Het tekstveld myTextField wordt op tekstomloop ingesteld. Het tekstveld countField bevat het eerste teken van regel 4. Wanneer de gebruiker op het tekstveld myTextField klikt, wordt de methode clickHandler() aangeroepen.

Bij de methode clickHandler() retourneert de methode getLineOffset() de index van het eerste teken in regelindex 3 (de vierde regel van de tekst). (De eerste regel heeft een index 0.) De methode charAt() wordt gebruikt om het teken op te halen met de index van het eerste teken van de vierde regel. De inhoud van het tekstveld countField wordt bijgewerkt met deze informatie via de eigenschap text van het tekstveld countField. Door gebruik te maken van de eigenschap countField.text, wordt de inhoud van het tekstveld countField telkens overschreven nadat is geklikt. Wanneer de gebruiker de grootte van het scherm wijzigt, wordt tekstomloop toegepast en kan het eerste teken van regel 4 veranderen. Door nogmaals te klikken op het veld myTextField wordt de inhoud van het tekstveld countField bijgewerkt met het eerste nieuwe teken voor de vierde regel.

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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Retourneert de tekst van de regel die wordt opgegeven door de parameter lineIndex.

Parameters

lineIndex:int — De op nul gebaseerde indexwaarde van de regel (de eerste regel is bijvoorbeeld 0, de tweede regel 1, enzovoort).

Geretourneerde waarde
String — De tekstreeks in de opgegeven regel.

Gegenereerde uitzondering
RangeError — Het opgegeven regelnummer bevindt zich buiten het bereik.

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld worden de regelnummers van alle instanties van het woord 'love' in het sonnet van Shakespeare gezocht en weergegeven.

Het tekstveld poem wordt automatisch gewijzigd zodat de tekst erin past en de tekst wordt ingesteld op links uitvullen. De eigenschap wordWrap wordt op false ingesteld, zodat de regels van het gedicht niet omlopen, hoewel dit normaalgesproken geen probleem moet zijn bij gebruik van de eigenschap autoSize. De lus for doorloopt de regels van het sonnet met de eigenschap numLines van het tekstveld. De methode getLineText() retourneert de inhoud van de regel als een tekenreeks. (De eigenschap numLines retourneert het aantal regels beginnend met regel 1, terwijl bij de methode getLineText() het regelnummer begint met 0.) Bij gebruik van het reguliere-expressiepatroon (/love/i) zoekt de instructie if naar elke subtekenreeks van het woord in hoofdletters of kleine letters. Wanneer het patroon wordt gevonden, retourneert de methode search de index van de eerste overeenkomende subtekenreeks; anders wordt -1 geretourneerd (wanneer er geen overeenkomst is). Het regelnummer waar 'love' werd gevonden ((i + 1)) wordt vervolgens in de tekenreeks lineResult geplaatst. De tekenreeksmethode zet het getalsargument ((i + 1)) om in een tekenreeks zolang er een ander argument is dat een tekenreeks is (' '). Het regelresultaat van de zoekopdracht bevat regels met de woorden 'loved' of 'Love's'. Wanneer de tekenreeks 'Love was found in lines:' was toegevoegd voor de lus for, zou het woord 'Love' in deze regel ook zijn opgenomen.

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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Op basis van een tekenindex wordt hiermee de lengte van de alinea met het opgegeven teken geretourneerd. De lengte is relatief ten opzichte van het eerste teken in de alinea (zoals wordt geretourneerd door getFirstCharInParagraph()), niet ten opzichte van de doorgegeven tekenindex.

Parameters

charIndex:int — De op nul gebaseerde indexwaarde van het teken (het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort).

Geretourneerde waarde
int — Retourneert het aantal tekens in de alinea.

Gegenereerde uitzondering
RangeError — De opgegeven tekenindex bevindt zich buiten het bereik.

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt de lengte van de alinea en het aantal 's'-tekens in de alinea in een apart tekstveld weergegeven nadat de gebruiker een alinea heeft geselecteerd.

Het tekstveld myTextField bevat de alinea's die de gebruiker zal selecteren. Wanneer de gebruiker op het tekstveld klikt, wordt de gebeurtenis MouseEvent.CLICK verzonden en wordt de methode clickHandler() aangeroepen. De lengte van de alinea en het aantal 's'- tekens worden weergegeven in het tekstveld countField dat onder het tekstveld myTextField wordt geplaatst.

Bij de methode clickHandler() retourneert de methode getCharIndexAtPoint() de index van het teken op basis van de coördinaten localX en localY van de muisklik. De eerste instructie if controleert of de gebruiker op een teken heeft geklikt. De methode getFirstCharInParagraph() gebruikt deze index om de index van het eerste teken in dezelfde alinea te retourneren. De lengte van de alinea die wordt geretourneerd door de methode getParagraphLength(), wordt gebruikt met de index van het eerste teken in de alinea om de index voor het einde van de alinea te bepalen. Een lus for doorloopt de alinea en zoekt naar het aantal 's'-tekens.

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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Retourneert een object TextFormat met opmaakgegevens voor het tekstbereik dat is opgegeven met de parameters beginIndex en endIndex. Alleen eigenschappen die worden gedeeld door de volledige opgegeven tekst, worden ingesteld in het resulterende object TextFormat. Voor elke variërende eigenschap (verschillende waarden op verschillende punten in de tekst) wordt de waarde ingesteld op null.

Wanneer u geen waarden voor deze parameters opgeeft, wordt deze methode toegepast op de volledige tekst van het tekstveld.

In de volgende tabel worden drie mogelijke toepassingen beschreven:

GebruikBeschrijving
my_textField.getTextFormat()Retourneert een object TextFormat met opmaakgegevens voor alle tekst in een tekstveld. Alleen eigenschappen die worden gedeeld door alle tekst in het tekstveld, worden ingesteld in het resulterende object TextFormat. Voor elke variërende eigenschap (verschillende waarden op verschillende punten in de tekst) wordt de waarde ingesteld op null.
my_textField.getTextFormat(beginIndex:Number)Retourneert een object TextFormat met een kopie van de tekstopmaak van het teken op de positie beginIndex.
my_textField.getTextFormat(beginIndex:Number,endIndex:Number)Retourneert een object TextFormat met opmaakgegevens voor de tekst van beginIndex tot endIndex-1. Alleen eigenschappen die worden gedeeld door alle tekst in het opgegeven bereik, worden ingesteld in het resulterende object TextFormat. Voor elke variërende eigenschap (verschillende waarden op verschillende punten in het bereik) wordt de waarde ingesteld op null.

Parameters

beginIndex:int (default = -1) — Optioneel: een geheel getal waarmee de beginlocatie van een tekstbereik in het tekstveld wordt opgegeven.
 
endIndex:int (default = -1) — Optioneel: een geheel getal dat de positie van het eerste teken na het gewenste tekstbereik opgeeft. Wanneer u waarden opgeeft voor beginIndex en endIndex, wordt de tekst van beginIndex tot endIndex-1 gelezen.

Geretourneerde waarde
flash.text:TextFormat — Het object TextFormat dat de opmaakeigenschappen voor de opgegeven tekst vertegenwoordigt.

Gegenereerde uitzondering
RangeError — De opgegeven parameter beginIndex of endIndex bevindt zich buiten het bereik.

Verwante API-elementen


Voorbeeld
Hoe dit voorbeeld te gebruiken
Zie het voorbeeld van de methode getFirstCharInParagraph() of setTextFormat() voor een toelichting op het gebruik van de methode getTextFormat().

isFontCompatible

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10, AIR 1.5, Flash Lite 4

Hiermee wordt true geretourneerd als er een ingesloten lettertype beschikbaar is met de opgegeven fontName en fontStyle waarbij Font.fontType flash.text.FontType.EMBEDDED is. Vanaf Flash Player 10 kunnen twee ingesloten lettertypen in een SWF-bestand worden weergegeven. Gewone ingesloten lettertypen worden alleen gebruikt bij TextField-objecten. Ingesloten CFF-lettertypen worden alleen gebruikt bij de klassen flash.text.engine. Het verschil tussen de twee typen is de eigenschap fontType van de klasse Font, zoals geretourneerd door de functie enumerateFonts().

TextField kan geen lettertype van het type EMBEDDED_CFF gebruiken. Als embedFonts is ingesteld op true en EMBEDDED_CFF het enige lettertype met de opgegeven naam en opmaak dat tijdens runtime beschikbaar is, kan de tekst niet in Flash Player worden weergegeven, alsof er geen ingesloten lettertype met de opgegeven naam en opmaak beschikbaar is.

Als de lettertypen EMBEDDED en EMBEDDED_CFF beide beschikbaar zijn met dezelfde naam en opmaak, wordt het lettertype EMBEDDED geselecteerd en wordt de tekst met het lettertype EMBEDDED weergegeven.

Parameters

fontName:String — De naam van het ingesloten lettertype dat moet worden gecontroleerd.
 
fontStyle:String — Hiermee wordt de tekenopmaak weergegeven die gecontroleerd moet worden. flash.text.FontStyle gebruiken

Geretourneerde waarde
Booleantrue als er een compatibel ingesloten lettertype beschikbaar is, anders false.

Gegenereerde uitzondering
ArgumentError — De opgegeven fontStyle is geen lid van flash.text.FontStyle.

Verwante API-elementen

replaceSelectedText

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Vervangt de huidige selectie door de inhoud van de parameter value. De tekst wordt met de huidige standaardinstellingen voor teken- en alineaopmaak ingevoegd op de positie van de huidige selectie. De tekst wordt niet beschouwd als HTML.

U kunt de methode replaceSelectedText() gebruiken om tekst in te voegen en te verwijderen zonder de teken- en alineaopmaak van de rest van de tekst te wijzigen.

Opmerking: Deze methode werkt niet wanneer een stijlpagina op het tekstveld wordt toegepast.

Parameters

value:String — De tekenreeks die de geselecteerde tekst moet vervangen.


Gegenereerde uitzondering
Error — Deze methode kan niet worden gebruikt voor een tekstveld met een stijlpagina.

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wist de gebruiker enige tekst uit het eerste tekstveld door deze te selecteren en vervangt een geselecteerde tekst in het tweede tekstveld door de tekenreeks NEW TEXT.

Er worden twee verschillende objecten TextField gemaakt en er worden gebeurtenislisteners toegevoegd voor de gebeurtenissenMouseEvent.MOUSE_UP. MouseUp vindt plaats wanneer de gebruiker de muis loslaat, een gebeurtenis die normaalgesproken plaatsvindt nadat tekst is geselecteerd. De standaardinstelling voor een tekstveld is dat de tekst ervan moet worden geselecteerd.

Wanneer een gebruiker de muisknop loslaat in het tekstveld myTextField1, wordt bij de methode mouseHandler1() de tekst gewist door deze te vervangen door een lege tekenreeks. Dit kan worden gedaan totdat alle tekst is gewist. Wanneer een gebruiker tekst selecteert in het tekstveld myTextField2, worden bij de methode mouseHandler2() de eigenschappen selectionBeginIndex en selectionEndIndex gecontroleerd om na te gaan of een teken is geselecteerd. (De eigenschappen selectionBeginIndex en selectionEndIndex hebben niet dezelfde waarde wanneer enige tekst is geselecteerd.) De geselecteerde tekst wordt vervolgens vervangen door de tekenreeks NEW TEXT. Dit kan worden gedaan totdat alle oorspronkelijke tekst in het tweede tekstveld is vervangen door de tekenreeks 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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Vervangt de met de parameters beginIndex en endIndex opgegeven tekenreeks door de inhoud van de parameter newText. De tekst van beginIndex tot endIndex-1 wordt vervangen.

Opmerking: Deze methode werkt niet wanneer een stijlpagina op het tekstveld wordt toegepast.

Parameters

beginIndex:int — De op nul gebaseerde indexwaarde voor de beginpositie van het vervangingsbereik.
 
endIndex:int — De op nul gebaseerde indexpositie van het eerste teken na het gewenste tekstbereik.
 
newText:String — De tekst die moet worden gebruikt om het opgegeven tekenbereik te vervangen.


Gegenereerde uitzondering
Error — Deze methode kan niet worden gebruikt voor een tekstveld met een stijlpagina.

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt de methode replaceText() gebruikt om enige tekst in een tekstveld te verwijderen, te vervangen en in te voegen.

Het tekstveld outputText wordt automatisch gewijzigd zodat de tekst erin past en de tekst wordt ingesteld op links uitvullen. Bij de eerste aanroep van de methode replaceText() wordt de eerste regel (This is the wrong heading) vervangen door THIS IS THE HEADING FOR EVERYONE. Bij de tweede aanroep van de methode wordt de tekst CORRECT ingevoegd tussen THE en HEADING. Bij de derde aanroep van de methode worden de woorden FOR EVERYONE verwijderd. Bij elke aanroep van de methode appendText() worden de huidige begin- en eindindex van de tekst gewijzigd. Hier wordt alleen de uiteindelijke tekst weergegeven (nadat de wijzigingen zijn doorgevoerd).

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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Stelt de tekst in als geselecteerd die wordt bepaald door de indexwaarden van het eerste en laatste teken, opgegeven door de parameters beginIndex en endIndex. Wanneer de twee parameterwaarden hetzelfde zijn, stelt deze methode het invoegpunt in, net als wanneer u de eigenschap caretIndex instelt.

Parameters

beginIndex:int — De op nul gebaseerde indexwaarde van het eerste teken in de selectie (het eerste teken is bijvoorbeeld 0, het tweede teken 1, enzovoort).
 
endIndex:int — De op nul gebaseerde indexwaarde van het laatste teken in de selectie.

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt een vooraf gedefinieerde tekstreeks gemarkeerd wanneer de gebruiker ergens in het tekstveld klikt (de woorden TEXT IN ALL CAPS worden gemarkeerd).

Twee gebeurtenislisteners voor het tekstveld myTextField reageren op de muisklikken of mouseUp-gebeurtenissen van de gebruiker. MouseUp vindt plaats wanneer de gebruiker de muis loslaat, een gebeurtenis die normaalgesproken plaatsvindt nadat tekst is geselecteerd. De standaardinstelling voor een tekstveld is dat de tekst ervan moet worden geselecteerd. Wanneer op tekst wordt geklikt, wordt de methode clickHandler() aangeroepen. Wanneer enige tekst wordt geselecteerd en de muis wordt losgelaten, wordt de methode mouseUpHandler() aangeroepen

Bij de methoden clickHandler() en mouseUpHandler() stelt de methode setSelection() alleen de tekens in tussen index 54 en 70 (TEXT IN ALL CAPS) die moeten worden geselecteerd.

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

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

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Past de tekstopmaak die is opgegeven met de parameter format toe op de opgegeven tekst in een tekstveld. De waarde van format moet een object TextFormat zijn dat de gewenste wijzigingen in de tekstopmaak opgeeft. Alleen de niet-null-eigenschappen van format worden toegepast op het tekstveld. Een eigenschap van format die is ingesteld op null, wordt niet toegepast. Alle eigenschappen van een nieuw object TextFormat worden standaard ingesteld op null.

Opmerking: Deze methode werkt niet wanneer een stijlpagina op het tekstveld wordt toegepast.

De methode setTextFormat() wijzigt de tekstopmaak die op een reeks tekens of op een gehele tekst in een tekstveld wordt toegepast. Wanneer u de opmaakeigenschappen wilt toepassen op alle tekst in het tekstveld, moet u geen waarden opgeven voor beginIndex en endIndex. Wanneer u de opmaakeigenschappen op een reeks tekens wilt toepassen, geeft u waarden op voor de parameters beginIndex en endIndex. U kunt de eigenschap length gebruiken om de indexwaarden te bepalen.

De twee typen opmaakgegevens in een object TextFormat zijn opmaak op tekenniveau en opmaak op alineaniveau. Voor elk teken in een tekstveld kan aparte tekenopmaak worden ingesteld, zoals een lettertypenaam, tekengrootte, vet en cursief.

Voor alinea's wordt het eerste teken van de alinea gecontroleerd voor de instellingen voor alineaopmaak voor de hele alinea. Voorbeelden van alineaopmaak zijn linkermarge, rechtermarge en inspringing.

Op tekst die handmatig wordt ingevoerd door de gebruiker of wordt vervangen met de methode replaceSelectedText(), wordt de standaardopmaak voor nieuwe tekst toegepast, niet de opmaak die is opgegeven voor het tekstinvoegpunt. Gebruik defaultTextFormat om de standaardopmaak voor nieuwe tekst in te stellen.

Parameters

format:flash.text:TextFormat — Een object TextFormat dat informatie over tekenopmaak en alineaopmaak bevat.
 
beginIndex:int (default = -1) — Optioneel: een geheel getal dat de op nul gebaseerde indexpositie opgeeft waarmee het eerste teken van de gewenste tekenreeks wordt opgegeven.
 
endIndex:int (default = -1) — Optioneel: een geheel getal dat het eerste teken na het gewenste tekstbereik opgeeft. Wanneer u waarden opgeeft voor beginIndex en endIndex, wordt de tekst van beginIndex tot endIndex-1 bijgewerkt.

GebruikBeschrijving
my_textField.setTextFormat(textFormat:TextFormat)Past de eigenschappen van textFormat toe op alle tekst in het tekstveld.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int)Past de eigenschappen van textFormat toe op de tekst vanaf de positie beginIndex.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int, endIndex:int)Past de eigenschappen van de parameter textFormat toe op het tekstbereik vanaf de positie beginIndex tot de positie endIndex-1.

Op tekst die handmatig wordt ingevoerd door de gebruiker of wordt vervangen door de methode replaceSelectedText(), wordt de standaardopmaak voor nieuwe tekst van het tekstveld toegepast, niet de opmaak die is opgegeven voor het tekstinvoegpunt. Wanneer u de standaardopmaak voor nieuwe tekst van een tekstveld wilt instellen, gebruikt u de eigenschap defaultTextFormat.


Gegenereerde uitzondering
Error — Deze methode kan niet worden gebruikt voor een tekstveld met een stijlpagina.
 
RangeError — De opgegeven parameter beginIndex of endIndex bevindt zich buiten het bereik.

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt bij een vooraf gedefinieerd tekstreeks (TEXT IN ALL CAPS) gewisseld tussen de standaardtekstopmaak en de nieuwe opmaak wanneer op de tekst wordt geklikt.

Er wordt een gebeurtenislistener voor het tekstveld myTextField toegevoegd om te reageren op de muisklikken door de methode clickHandler() aan te roepen. Bij de methode clickHandler() retourneert de methode getTextFormat() de huidige opmaak van een teken (index 55) uit het bedoelde bereik van de tekst, waarna deze in het TextFormat-object currentTextFormat wordt geplaatst. De instructie if controleert de tekstopmaak currentTextFormat om na te gaan of het teken in het bereik de nieuwe opmaak gebruikt (puntgrootte is ingesteld op 18). Als dat niet het geval is, wijzigt de nieuwe opmaak de grootte in 18, wijzigt de kleur in rood en past onderstrepen en cursief maken toe op het tekstbereik tussen 54-70 (TEXT IN ALL CAPS). Wanneer het teken in het bereik de nieuwe opmaak gebruikt, wordt de opmaak van het bereik teruggezet naar de standaardopmaak (oorspronkelijke opmaak) van het tekstveld.

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);
            }    
        }    
    }
}
Gebeurtenisdetails

change

Gebeurtenis
Type gebeurtenisobject: flash.events.Event
eigenschap Event.type = flash.events.Event.CHANGE

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Wordt verzonden nadat een besturingswaarde is gewijzigd, in tegenstelling tot de gebeurtenis textInput, die wordt verzonden voordat de waarde wordt gewijzigd. In tegenstelling tot het W3C DOM-gebeurtenismodel van de gebeurtenis change dat de gebeurtenis pas verzendt nadat de opties focus verliest, wordt de ActionScript 3.0-versie van de gebeurtenis change verzonden zodra de optie wordt gewijzigd. Wanneer een gebruiker bijvoorbeeld tekst in een tekstveld typt, wordt de gebeurtenis change na elke toetsdruk verzonden.

De constante Event.CHANGE definieert de waarde van de eigenschap type van een change-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

EigenschapWaarde
bubblestrue
cancelablefalse; er is geen standaardgedrag om te annuleren.
currentTargetHet object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
targetHet object waarvan de waarde is gewijzigd. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt.

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt de tekst die de gebruiker invoert direct gekopieerd in een ander tekstveld met een andere tekstopmaak.

Er worden twee tekstvelden gemaakt, een voor de gebruikersinvoer en een (headingTextField) voor de kopie van de gebruikersinvoer. Er wordt tevens een object TextFormat gemaakt en toegewezen aan de standaardtekstopmaak van het tekstveld headingTextField. Wanneer de inhoud van het tekstveld wordt gewijzigd, wordt de methode changeHandler() aangeroepen. Hiermee wordt de tekst in het tekstveld inputTextField toegewezen aan het tekstveld headingTextField. (Wanneer de methode wordt aangeroepen voor de gebeurtenis TextEvent.TEXT_INPUT in plaats van voor de gebeurtenis Event.CHANGE, wordt de inhoud van de gebruikersinvoer alleen gekopieerd nadat de gebruiker meer tekst heeft ingevoerd.)

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

Gebeurtenis  
Type gebeurtenisobject: flash.events.TextEvent
eigenschap TextEvent.type = flash.events.TextEvent.LINK

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Wordt verzonden wanneer een gebruiker op een hyperlink in een HTML-tekstveld klikt waarbij de URL begint met 'event:'. De rest van de URL na 'event:' wordt in de teksteigenschap van de gebeurtenis LINK geplaatst.

Opmerking: het standaardgedrag (de tekst aan het tekstveld toevoegen) vindt alleen plaats wanneer Flash Player de gebeurtenis genereert, wat in dit geval gebeurt wanneer een gebruiker probeert tekst in te voeren. U kunt geen tekst in een tekstveld opnemen door hiernaar gebeurtenissen textInput te verzenden.

Definieert de waarde van de eigenschap type van een gebeurtenisobject link.

Deze gebeurtenis heeft de volgende eigenschappen:

EigenschapWaarde
bubblestrue
cancelablefalse; er is geen standaardgedrag om te annuleren.
currentTargetHet object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
targetHet tekstveld dat de hyperlink bevat die is aangeklikt. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt.
textDe rest van de URL na 'event:'

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt de functie playMP3() gedefinieerd. Een object TextField met de naam list wordt gemaakt en gevuld met HTML-tekst. De teksten Track 1 en Track 2 zijn koppelingen binnen het tekstveld. De functie playMP3() wordt aangeroepen wanneer de gebruiker op één van de koppelingen klikt. De naam van het MP3-bestand, die volgt op de tekenreeks 'event:' in het kenmerk href van de HTML-tag, wordt doorgegeven aan de methode linkHandler() als de eigenschap text van het gebeurtenisobject 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

Gebeurtenis  
Type gebeurtenisobject: flash.events.Event
eigenschap Event.type = flash.events.Event.SCROLL

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Wordt door een object TextField verzonden nadat de gebruiker schuift.

De constante Event.SCROLL definieert de waarde van de eigenschap type van een scroll-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

EigenschapWaarde
bubblesfalse
cancelablefalse; er is geen standaardgedrag om te annuleren.
currentTargetHet object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
targetHet object TextField dat is geschoven. De eigenschap target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt.

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld worden twee TextField-objecten gedefinieerd. Aan het eerste TextField-object zijn twee gebeurtenishandlers gekoppeld. Wanneer u binnen het eerste tekstveld op de muis klikt, wordt de gebeurtenis mouseDown verzonden en wordt de gekoppelde mouseDownScroll-handler aangeroepen. De mouseDownScroll()-handler zorgt ervoor dat het veld kan schuiven. Vervolgens wordt de gebeurtenis scroll verzonden en werkt de scrollHandler()-handler het tweede tekstveld bij en wordt de huidige verschuivingspositie weergegeven.
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

Gebeurtenis  
Type gebeurtenisobject: flash.events.TextEvent
eigenschap TextEvent.type = flash.events.TextEvent.TEXT_INPUT

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 9, Flash Lite 4

Flash Player verzendt de gebeurtenis textInput wanneer een gebruiker een of meer tekens invoert. Deze gebeurtenis kan door een verschillende tekstinvoermethoden worden gegenereerd, inclusief standaardtoetsenborden, invoermethode-editors (IME's), stem- of spraakherkenningssystemen en zelfs het plakken van onbewerkte tekst zonder opmaak- of stijlinformatie.

Definieert de waarde van de eigenschap type van een gebeurtenisobject textInput.

Opmerking: deze gebeurtenis wordt niet verzonden voor de toetsen Delete of Backspace.

Deze gebeurtenis heeft de volgende eigenschappen:

EigenschapWaarde
bubblestrue
cancelabletrue; roep de methode preventDefault() aan om het standaardgedrag te annuleren.
currentTargetHet object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
targetHet tekstveld waarin de tekens worden ingevoerd. Het doel is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt.
textHet teken of de tekenreeks dat/die door de gebruiker is ingevoerd.

Voorbeeld  ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld worden twee TextField-objecten gedefinieerd: het eerste TextField-object is een invoertekstveld en het tweede TextField-object is een dynamisch tekstveld. Wanneer u teksttekens in het eerste tekstveld invoert, wordt de gebeurtenis textInput verzonden, de textInputHandler()-handler aangeroepen en worden de tekens in het tweede tekstveld weergegeven. Wanneer u een blok tekst in het invoerveld plakt, kopieert de gebeurtenishandler het hele blok naar het andere veld.
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

Gebeurtenis  
Type gebeurtenisobject: flash.events.Event

Taalversie: ActionScript 3.0
Runtimeversies: AIR 1.0, Flash Player 11, Flash Lite 4

Flash Player verzendt de gebeurtenis textInteractionModeChange wanneer een gebruiker de interactiemodus van een tekstveld wijzigt. Op Android-systemen kunt u bijvoorbeeld met de opties in contextmenu's schakelen tussen de modus NORMAL en de modus SELECTION.

TextFieldExample.as

In het volgende voorbeeld wordt de klasse TextFieldExample gebruikt om een tekstbericht weer te geven. Hierbij moeten de volgende stappen worden uitgevoerd:
  1. Een eigenschap label van het type TextField wordt gemaakt.
  2. De klasseconstructor roept de functie configureLabel() aan.
  3. De methode configureLabel() maakt eerst een nieuw object TextField en wijst dit toe aan de eigenschap label. Vervolgens worden de parameters ervan als volgt ingesteld:
    • Het tekstveld wordt links uitgevuld.
    • De opvulkleur voor de achtergrond wordt ingeschakeld.
    • De rand wordt ingeschakeld.
  4. De methode configureLabel() maakt de variabele format en wijst deze toe aan een nieuwe instantie TextFormat met de volgende parameterinstellingen:
    • Font type = Verdana
    • Font color = solid red
    • Font size = 10
    • Font underline = true
  5. De eigenschap defaultTextFormat van het tekstveld label wordt ingesteld op format en de instantie label wordt toegevoegd aan het weergaveoverzicht, waarin eerst een tekstveld zonder tekst wordt weergegeven in het werkgebied.
  6. De constructor stelt de tekst van het tekstveld label in op'Hello world and welcome to the show.' door de methode setLabel() aan te roepen.
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 ]Waarom in het Engels?
Sommige inhoud van de Naslaggids voor ActionScript 3.0 staat in het Engels

Niet alle onderdelen van de Naslaggids voor ActionScript 3.0 zijn in alle talen vertaald. Wanneer een taalelement niet is vertaald, wordt het in het Engels weergegeven. Zo is de klasse ga.controls.HelpBox niet in elke taal vertaald. In de Nederlandse versie van de naslaggids wordt de klasse ga.controls.HelpBox bijvoorbeeld in het Engels weergegeven.