Referenshandbok för ActionScript® 3.0 i Adobe® Flash®-plattformen
Hem  |  Dölj paket och klasslista |  Paket  |  Klasser  |  Nyheter  |  Index  |  Bilagor  |  Varför på engelska?
Filter: AIR 30.0 och tidigare, Flash Player 30.0 och tidigare, Flash Lite 4
Flex 4.6 och tidigare, Flash Pro CS6 och tidigare
Dölj filter
flash.text 

TextField  - AS3

Paketx

Översta nivån
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

Språkelement

Globala konstanter
Globala funktioner
Operatorer
Programsatser, nyckelord och direktiv
Specialtyper

Bilagor

Nyheter
Kompilatorfel
Kompileringsvarningar
Körningsfel
Flytta till ActionScript 3
Teckenuppsättningar som stöds
Endast MXML-taggar
Motion XML-element
Timed Text-taggar
Lista över borttagna element
Konstanter för hjälpmedelsimplementering
Använda ActionScript-exempel
Juridiska meddelanden
Paketflash.text
Klasspublic class TextField
ArvTextField Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Underklasser FlexTextField

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Klassen TextField används för att skapa visningsobjekt för textvisning och textinmatning. Du kan ge ett textfält ett instansnamn i egenskapsinspektören och använda metoderna och egenskaperna för klassen TextField för att ändra det med ActionScript. Instansnamn för TextField visas i Filmutforskaren och i dialogrutan Infoga målsökväg på åtgärdspanelen.

Om du vill skapa ett textfält dynamiskt använder du konstruktorn TextField().

Med metoderna i klassen TextField kan du ställa in, markera och hantera text i ett dynamiskt textfält eller ett textinmatningsfält som du skapar under redigering eller körning.

Med hjälp av ActionScript kan du formatera texten på olika sätt vid körning. Med TextFormat-klassen anger du tecken- och styckeformatering för TextField-objekt. Du kan använda CSS-format (Cascading Style Sheet) för textfält med egenskapen TextField.styleSheet och klassen StyleSheet. Du kan använda CSS för att ändra inbyggda HTML-taggar, definiera nya formateringstaggar eller använda format. Du kan tilldela HTML-formaterad text, med eller utan CSS, direkt till ett textfält. HTML-text som du kopplar till ett textfält kan innehålla inbäddade medier (filmklipp, SWF-filer, GIF-filer, PNG-filer och JPEG-filer). Texten figursätts runt inbäddade medier på samma sätt som en webbläsare figursätter text runt inbäddade medier i ett HTML-dokument.

Flash Player stöder en delmängd av HTML-taggar som du kan använda vid textformatering. Se listan över de HTML-taggar som stöds i beskrivningen av htmlText-egenskapen.

Visa exemplen

Relaterade API-element



Publika egenskaper
 EgenskapDefinieras med
 InheritedaccessibilityImplementation : AccessibilityImplementation
Den aktuella hjälpmedelsimplementeringen (AccessibilityImplementation) för den här InteractiveObject-instansen.
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
De nuvarande hjälpmedelsalternativen för det här visningsobjektet.
DisplayObject
 Inheritedalpha : Number
Anger det angivna objektets alfagenomskinlighetsvärde.
DisplayObject
  alwaysShowSelection : Boolean
Om inställningen är true och textfältet inte är i fokus markerar Flash Player markeringen i textfältet med grått.
TextField
  antiAliasType : String
Den typ av kantutjämning som används för det här textfältet.
TextField
  autoSize : String
Styr automatisk storleksinställning och justering av textfält.
TextField
  background : Boolean
Anger om textfältet har en bakgrundsfyllning.
TextField
  backgroundColor : uint
Färgen på textfältets bakgrund.
TextField
 InheritedblendMode : String
Ett värde från klassen BlendMode som anger vilket blandningsläge som ska användas.
DisplayObject
 InheritedblendShader : Shader
[lässkyddad] Ställer in en skuggning som används för blandning av förgrund och bakgrund.
DisplayObject
  border : Boolean
Anger om textfältet har en kantlinje.
TextField
  borderColor : uint
Färgen på textfältets kantlinje.
TextField
  bottomScrollV : int
[skrivskyddad] Ett heltal (ett 1-baserat indexvärde) som visar den nedersta raden som är synlig i textfältet som anges.
TextField
 InheritedcacheAsBitmap : Boolean
Om det är true, sparar Flash-miljöerna en intern bitmappsrepresentation av visningsobjektet i cache-minnet.
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
Om detta inte är null definierar det här Matrix-objektet hur ett visningsobjekt återges när cacheAsBitmap har värdet true.
DisplayObject
  caretIndex : int
[skrivskyddad] Indexvärdet för inmatningspunkten.
TextField
  condenseWhite : Boolean
Ett booleskt värde som anger om extra tomrum (blanksteg, radbrytningar o.s.v.) i ett textfält med HTML-text tas bort.
TextField
 Inheritedconstructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.
Object
 InheritedcontextMenu : NativeMenu
Anger vilken snabbmeny som är associerad med det här objektet.
InteractiveObject
  defaultTextFormat : flash.text:TextFormat
Anger vilket format som ska användas för nyinfogad text, till exempel text som anges av en användare eller text som infogas med metoden replaceSelectedText().
TextField
  displayAsPassword : Boolean
Anger om textfältet har ett lösenord.
TextField
 InheriteddoubleClickEnabled : Boolean
Anger om det här objektet tar emot doubleClick-händelser.
InteractiveObject
  embedFonts : Boolean
Anger om rendering ska göras med inbäddade teckensnittskonturer.
TextField
 Inheritedfilters : Array
En indexerad array som innehåller varje filterobjekt som är associerat med visningsobjektet.
DisplayObject
 InheritedfocusRect : Object
Anger om det här objektet visar en fokusram.
InteractiveObject
  gridFitType : String
Den typ av rutnätspassning som används för det här textfältet.
TextField
 Inheritedheight : Number
Anger visningsobjektets höjd i pixlar.
DisplayObject
  htmlText : String
Innehåller HTML-representationen av textfältets innehåll.
TextField
  length : int
[skrivskyddad] Antalet tecken i ett textfält.
TextField
 InheritedloaderInfo : LoaderInfo
[skrivskyddad] Returnerar ett LoaderInfo-objekt som innehåller information om hur filen som visningsobjektet tillhör ska läsas in.
DisplayObject
 Inheritedmask : DisplayObject
Det anropande visningsobjektet maskeras av det angivna visningsobjektet.
DisplayObject
  maxChars : int
Det maximala antal tecken som en användare kan skriva i textfältet.
TextField
  maxScrollH : int
[skrivskyddad] Maxvärdet för scrollH.
TextField
  maxScrollV : int
[skrivskyddad] Maxvärdet för scrollV.
TextField
 InheritedmetaData : Object
Erhåller metadataobjektet för instansen DisplayObject om metadata har lagrats tillsammans med instansen för detta DisplayObject i SWF-filen via en PlaceObject4-tagg.
DisplayObject
 InheritedmouseEnabled : Boolean
Anger om det här objektet tar emot musmeddelanden eller annan indata från användaren.
InteractiveObject
  mouseWheelEnabled : Boolean
Ett booleskt värde som anger om Flash Player automatiskt ska rulla textfält med flera rader när användaren klickar i ett textfält och rullar på mushjulet.
TextField
 InheritedmouseX : Number
[skrivskyddad] Anger x-koordinaten för musens eller användarens indataenhets position i pixlar.
DisplayObject
 InheritedmouseY : Number
[skrivskyddad] Anger y-koordinaten för musens eller användarens indataenhets position i pixlar.
DisplayObject
  multiline : Boolean
Anger om textfältet har flera rader.
TextField
 Inheritedname : String
Anger instansnamnet för DisplayObject.
DisplayObject
 InheritedneedsSoftKeyboard : Boolean
Anger om ett virtuellt tangentbord (t.ex. ett skärmtangentbord) ska visas när den här InteractiveObject-instansen är i fokus.
InteractiveObject
  numLines : int
[skrivskyddad] Definierar antalet textrader i ett textfält med flera rader.
TextField
 InheritedopaqueBackground : Object
Anger om visningsobjektet är ogenomskinligt med en viss bakgrundsfärg.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[skrivskyddad] Anger DisplayObjectContainer-objektet som innehåller visningsobjektet.
DisplayObject
  restrict : String
Anger den teckenuppsättning en användare kan använda för att skriva i textfältet.
TextField
 Inheritedroot : DisplayObject
[skrivskyddad] För ett visningsobjekt i en inläst SWF-fil är rotegenskapen det översta visningsobjektet i den del av visningslistans trädstruktur som representeras av den SWF-filen.
DisplayObject
 Inheritedrotation : Number
Anger DisplayObject-instansens rotation i grader från den ursprungliga orienteringen.
DisplayObject
 InheritedrotationX : Number
Anger x-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren.
DisplayObject
 InheritedrotationY : Number
Anger y-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren.
DisplayObject
 InheritedrotationZ : Number
Anger z-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren.
DisplayObject
 Inheritedscale9Grid : Rectangle
Det skalningsrutnät som används för närvarande.
DisplayObject
 InheritedscaleX : Number
Anger vågrät skala (i procent) för objektet utifrån dess registreringspunkt.
DisplayObject
 InheritedscaleY : Number
Anger lodrät skala (i procent) för objektet utifrån dess registreringspunkt.
DisplayObject
 InheritedscaleZ : Number
Anger djupskala (procent) för objektet utifrån dess registreringspunkt.
DisplayObject
  scrollH : int
Den vågräta rullningspositionen.
TextField
 InheritedscrollRect : Rectangle
Visningsobjektets gränser för rullningsrektangeln.
DisplayObject
  scrollV : int
Den lodräta positionen för texten i ett textfält.
TextField
  selectable : Boolean
Ett booleskt värde som anger om ett textfält är markeringsbart.
TextField
  selectionBeginIndex : int
[skrivskyddad] Det nollbaserade teckenindexvärdet för det första tecknet i den aktuella markeringen.
TextField
  selectionEndIndex : int
[skrivskyddad] Det nollbaserade teckenindexvärdet för det sista tecknet i den aktuella markeringen.
TextField
  sharpness : Number
Skärpan på specialtecknens kanter i det här textfältet.
TextField
 Inherited    softKeyboard : String
Kontrollerar utseendet på skärmtangentbordet.
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
Definierar det område som ska behållas på skärmen när skärmtangentbordet visas (ej tillgängligt på iOS).
InteractiveObject
 Inheritedstage : Stage
[skrivskyddad] Visningsobjektets scen.
DisplayObject
  styleSheet : StyleSheet
Kopplar en formatmall till textfältet.
TextField
 InheritedtabEnabled : Boolean
Anger om det här objektet inkluderas i tabbordningen.
InteractiveObject
 InheritedtabIndex : int
Anger tabbordningen för objekt i en SWF-fil.
InteractiveObject
  text : String
En sträng som utgör den nuvarande texten i textfältet.
TextField
  textColor : uint
Färgen på texten i ett textfält, i hexadecimalt format.
TextField
  textHeight : Number
[skrivskyddad] Textens höjd i pixlar.
TextField
  textInteractionMode : String
[skrivskyddad] Egenskapen för interaktionsläge. Standardvärdet är TextInteractionMode.NORMAL.
TextField
  textWidth : Number
[skrivskyddad] Textens bredd i pixlar.
TextField
  thickness : Number
Tjockleken på specialtecknens kanter i det här textfältet.
TextField
 Inheritedtransform : flash.geom:Transform
Ett objekt med egenskaper som gäller ett visningsobjekts matris, färgomformning och pixelgränser.
DisplayObject
  type : String
Textfältets typ.
TextField
  useRichTextClipboard : Boolean
Anger om textformateringen ska kopieras och klistras in med texten.
TextField
 Inheritedvisible : Boolean
Om visingsobjektet är synligt eller inte.
DisplayObject
 Inheritedwidth : Number
Anger visningsobjektets bredd i pixlar.
DisplayObject
  wordWrap : Boolean
Ett booleskt värde som anger om textfältet har automatisk radbrytning.
TextField
 Inheritedx : Number
Anger x-koordinaten för DisplayObject-instansen i förhållande till de lokala koordinaterna för den överordnade DisplayObjectContainer.
DisplayObject
 Inheritedy : Number
Anger y-koordinaten för DisplayObject-instansen i förhållande till de lokala koordinaterna för den överordnade DisplayObjectContainer.
DisplayObject
 Inheritedz : Number
Anger z-koordinatens position längs DisplayObject-instansens z-axel i förhållande till den överordnade 3D-behållaren.
DisplayObject
Publika metoder
 MetodDefinieras med
  
Skapar en ny TextField-instans.
TextField
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser.
EventDispatcher
  
Lägger till strängen som angetts av parametern newText på en del av eller all text i ett textfält.
TextField
 Inherited
Skickar en händelse till händelseflödet.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Returnerar en rektangel som definierar visningsområdets område i relation till targetCoordinateSpace-objektets koordinatsystem.
DisplayObject
  
Returnerar en rektangel som utgör tecknets begränsningsram.
TextField
  
Returnerar det nollbaserade indexvärdet för tecknet vid den punkt som anges av parametrarna x och y.
TextField
  
Returnerar ett givet teckenindexvärde för det första tecknet i samma stycke.
TextField
  
Returnerar en DisplayObject-referens för det angivna ID:t för en bild eller SWF-fil som har lagts till i ett HTML-formaterat textfält med en <img>-tagg.
TextField
  
Returnerar det nollbaserade indexvärdet för raden vid den punkt som anges av parametrarna x och y.
TextField
  
Returnerar det nollbaserade indexvärdet för raden som innehåller tecknet som anges av parametern charIndex.
TextField
  
getLineLength(lineIndex:int):int
Returnerar antalet tecken på en viss textrad.
TextField
  
Returnerar måttinformation om en viss textram.
TextField
  
getLineOffset(lineIndex:int):int
Returnerar teckenindexvärdet för det första tecknet på raden som anges av parametern lineIndex.
TextField
  
Returnerar texten på raden som anges av parametern lineIndex.
TextField
  
Returnerar längden på det stycke som innehåller ett givet teckenindexvärde.
TextField
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Returnerar en rektangel som definierar visningsområdets gräns, baserat på koordinatsystemet som definieras av targetCoordinateSpace-parametern, exklusive eventuella linjer i former.
DisplayObject
  
getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Returnerar ett TextFormat-objekt som innehåller formateringsinformation för textintervallet som anges av parametrarna beginIndex och endIndex.
TextField
 Inherited
Konverterar punktobjektet från scenens (globala) koordinater till visningsobjektets (lokala) koordinater.
DisplayObject
 Inherited
Konverterar en tvådimensionell punkt från scenens (globala) koordinater till ett tredimensionellt visningsobjekts (lokala) koordinater.
DisplayObject
 Inherited
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.
EventDispatcher
 Inherited
Anger om det finns en egenskap angiven för ett objekt.
Object
 Inherited
Utvärderar begränsningsramen för visningsobjektet för att kontrollera om den överlappar eller korsar begränsningsramen för obj-visningsobjektet.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Utvärderar visningsobjektet för att avgöra om det överlappar eller korsar den punkt som anges av x- och y-parametrarna.
DisplayObject
  
isFontCompatible(fontName:String, fontStyle:String):Boolean
[statisk] Returnerar true om ett inbäddat teckensnitt är tillgängligt med angivet fontName och fontStyle, där Font.fontType är flash.text.FontType.EMBEDDED.
TextField
 Inherited
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.
Object
 Inherited
Konverterar en tredimensionell punkt för det tredimensionella visningsobjektets (lokala) koordinater till en tvådimensionell punkt i scenens (globala) koordinater.
DisplayObject
 Inherited
Konverterar punktobjektet från visningsobjektets (lokala) koordinater till scenens (globala) koordinater.
DisplayObject
 Inherited
Anger om den angivna egenskapen finns och är uppräkningsbar.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Tar bort en avlyssnare från EventDispatcher-objektet.
EventDispatcher
  
Ersätter markeringen med innehållet i parametern value.
TextField
  
replaceText(beginIndex:int, endIndex:int, newText:String):void
Ersätter teckenintervallet som anges av parametrarna beginIndex och endIndex med innehållet i parametern newText.
TextField
 Inherited
Visar ett virtuellt tangentbord.
InteractiveObject
 Inherited
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.
Object
  
setSelection(beginIndex:int, endIndex:int):void
Anges som markerad text som definierats av indexvärdena för det första och sista tecknet, som anges med parametrarna beginIndex och endIndex.
TextField
  
setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Använder textformateringen som angetts av formatparametern på den angivna texten i ett textfält.
TextField
 Inherited
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.
Object
 Inherited
Returnerar det angivna objektets strängbeteckning.
Object
 Inherited
Returnerar det angivna objektets primitiva värde.
Object
 Inherited
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen.
EventDispatcher
Händelser
 Händelse Sammanfattning Definieras med
 Inherited[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt.EventDispatcher
 InheritedSkickas när ett visningsobjekt läggs till i visningslistan.DisplayObject
 InheritedSkickas när ett visningsobjekt läggs till i scenens visningslista, antingen direkt eller genom tillägg av ett underträd som innehåller visningsobjektet.DisplayObject
  Skickas efter att ett kontrollvärde har modifierats, till skillnad från textInput-händelsen som skickas innan värdet är modifierat.TextField
 InheritedSkickas när användaren väljer ”Ta bort” på textinnehållsmenyn.InteractiveObject
 InheritedSkickas när en användare trycker ner och släpper upp huvudknappen på sitt pekdon över samma InteractiveObject.InteractiveObject
 Inherited
    contextMenu
Skickas när en användargest utlöser den snabbmeny som är kopplad till detta interaktiva objekt i ett AIR-program.InteractiveObject
 InheritedSkickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Kopiera eller väljer ”Kopiera” på snabbmenyn.InteractiveObject
 InheritedSkickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Klipp ut eller väljer Klipp ut på snabbmenyn.InteractiveObject
 Inherited[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.EventDispatcher
 InheritedSkickas när en användare trycker ner och släpper upp huvudknappen på ett pekdon två gånger i snabb följd över samma InteractiveObject när detta objekts doubleClickEnabled-flagga är satt till true.InteractiveObject
 Inherited[utsändningshändelse] Skickas när spelhuvudet går in i en ny bildruta.DisplayObject
 Inherited[utsändningshändelse] Skickas när spelhuvudet stänger den aktuella bildrutan.DisplayObject
 InheritedSkickas när ett visningsobjekt fokuserats.InteractiveObject
 InheritedSkickas när ett visningsobjekt tappar fokusering.InteractiveObject
 Inherited[utsändningshändelse] Skickas efter att konstruktorerna för bildrutevisningsobjekt har körts men innan bildruteskript har körts.DisplayObject
 InheritedSkickas när användaren skapar en kontaktpunkt längs pekytans kant med en InteractiveObject-instans (såsom att trycka längs kanten av pekytan på Siri Remote för Apple-TV). Vissa enheter kan också tolka denna kontakt som en kombination av flera pekhändelser.InteractiveObject
 InheritedSkickas när användaren trycker på två kontaktpunkter över samma InteractiveObject-instans på en beröringsaktiverad enhet (som att trycka med två fingrar och sedan släppa dem över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
 InheritedSkickas när användaren flyttar en kontaktpunkt över InteractiveObject-instansen på en beröringsaktiverad enhet (som att flytta ett finger från vänster till höger över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
 InheritedSkickas när användaren utför en rotationsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med två fingrar och rotera dem över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
 InheritedSkickas när användaren utför en svepningsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med tre fingrar och sedan flytta fingrarna parallellt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
 InheritedSkickas när användaren skapar en kontaktpunkt med en InteractiveObject-instans och sedan vidrör en beröringsaktiverad enhet (som att placera flera fingrar över ett visningsobjekt för att öppna en meny och sedan använda ett finger för att peka på ett menyalternativ på en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
 InheritedSkickas när användaren utför en zoomningsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med två fingrar och sedan snabbt sära på fingrarna över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
 InheritedDen här händelsen skickas till alla klientprogram som har stöd för indata via ett redigeringsprogram för inmatningsmetoder (IME).InteractiveObject
 InheritedSkickas när användaren trycker på en tangent.InteractiveObject
 InheritedSkickas när användaren försöker att ändra fokuseringen med tangentbordsnavigering.InteractiveObject
 InheritedSkickas när användaren släpper upp en tangent.InteractiveObject
  Skickas när en användare klickar på en hyperlänk i ett HTML-aktiverat textfält där URL-adressen börjar på "event".TextField
 InheritedSkickas när en användare trycker ned och släpper upp mittenknappen på sitt pekdon över samma InteractiveObject.InteractiveObject
 InheritedSkickas när en användare trycker på pekdonets mittenknapp över en InteractiveObject-instans.InteractiveObject
 InheritedSkickas när en användare släpper pekdonets knapp över en InteractiveObject-instans.InteractiveObject
 InheritedSkickas när en användare trycker på pekdonets knapp över en InteractiveObject-instans.InteractiveObject
 InheritedSkickas när användaren försöker att ändra fokuseringen med ett pekdon.InteractiveObject
 InheritedSkickas när en användare flyttar pekdonet när det befinner sig över ett InteractiveObject.InteractiveObject
 InheritedSkickas när användaren flyttar bort pekdonet från en InteractiveObject-instans.InteractiveObject
 InheritedSkickas när användaren flyttar pekdonet över en InteractiveObject-instans.InteractiveObject
 InheritedSkickas när en användare släpper pekdonets knapp över en InteractiveObject-instans.InteractiveObject
 InheritedSkickas när mushjulet rullas över en InteractiveObject-instans.InteractiveObject
 InheritedSkickas av drag initiator InteractiveObject när användaren släpper dragrörelsen.InteractiveObject
 InheritedSkickas av ett InteractiveObject-målobjekt när ett objekt dras till målobjektet och dragningen har accepterats med ett anrop till DragManager.acceptDragDrop().InteractiveObject
 InheritedSkickas av ett InteractiveObject-objekt när en dragrörelse går in i dess gränser.InteractiveObject
 InheritedSkickas av ett InteractiveObject-objekt när en dragrörelse går utanför dess gränser.InteractiveObject
 InheritedSkickas kontinuerligt av ett InteractiveObject-objekt när en dragrörelse pågår inom dess gränser.InteractiveObject
 InheritedSkickas i början av en dragning av det InteractiveObject-objekt som anges som dragningsinitierare i DragManager.doDrag()-anropet.InteractiveObject
 InheritedSkickas under en dragning av det InteractiveObject-objekt som anges som dragningsinitierare i DragManager.doDrag()-anropet.InteractiveObject
 InheritedSkickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Klistra in eller väljer Klistra in på snabbmenyn.InteractiveObject
 InheritedSkickas när användaren sänker en aktiv penna förbi skärmens upptäcktströskel.InteractiveObject
 Inherited
    proximityEnd
Skickas när användaren lyfter en aktiv penna över skärmens upptäcktströskel.InteractiveObject
 InheritedSkickas när användaren flyttar en aktiv penna över skärmen medan den behålls inom skärmens upptäcktströskel.InteractiveObject
 Inherited
    proximityOut
Skickas när användaren flyttar en aktiv penna bort från detta InteractiveObject medan den behålls inom skärmens upptäcktströskel.InteractiveObject
 InheritedSkickas när användaren flyttar en aktiv penna direkt över detta InteractiveObject medan den behålls inom skärmens upptäcktströskel.InteractiveObject
 InheritedSkickas när användaren flyttar en aktiv penna bort från detta InteractiveObject och något av dess underordnade objekt medan den behålls inom skärmens upptäcktströskel.InteractiveObject
 InheritedSkickas när användaren flyttar en aktiv penna över detta InteractiveObject från utsidan av objektets underordnade träd i visningslistan (men stannar kvar inom skärmens upptäcktströskel).InteractiveObject
 InheritedSkickas när användaren släpper knappen på pekaren efter att första ha tryckt på den över en InteractiveObject-instans och sedan flyttat pekaren bort från InteractiveObject-instansen.InteractiveObject
 InheritedSkickas när ett visningsobjekt ska tas bort från visningslistan.DisplayObject
 InheritedSkickas när ett visningsobjekt ska tas bort från visningslistan, antingen direkt eller genom borttagning av ett underträd som innehåller visningsobjektet.DisplayObject
 Inherited[utsändningshändelse] Skickas när visningslistan ska uppdateras och återges.DisplayObject
 InheritedSkickas när en användare trycker ned och släpper upp högerknappen på sitt pekdon över samma InteractiveObject.InteractiveObject
 InheritedSkickas när en användare trycker på pekdonets knapp över en InteractiveObject-instans.InteractiveObject
 InheritedSkickas när en användare släpper pekdonets knapp över en InteractiveObject-instans.InteractiveObject
 InheritedSkickas när användaren flyttar bort pekdonet från en InteractiveObject-instans.InteractiveObject
 InheritedSkickas när användaren flyttar pekdonet över en InteractiveObject-instans.InteractiveObject
  Skickas av ett TextField-objekt efter att användaren rullat.TextField
 InheritedSkickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Markera allt eller väljer Markera allt på snabbmenyn.InteractiveObject
 InheritedSkickas omedelbart efter att skärmtangentbordet tas fram (visas).InteractiveObject
 InheritedSkickas omedelbart innan skärmtangentbordet tas fram (visas).InteractiveObject
 InheritedSkickas omedelbart efter att skärmtangentbordet döljs.InteractiveObject
 InheritedSkickas när värdet på objektets tabChildren-flagga ändras.InteractiveObject
 InheritedSkickas när objektets tabEnabled-flagga ändras.InteractiveObject
 InheritedSkickas när värdet på objektets tabIndex-egenskap ändras.InteractiveObject
  Flash Player skickar textInput-händelsen när en användare anger ett eller fler texttecken.TextField
  Flash Player skickar textInteractionModeChange-händelsen när en användare ändrar interaktionsläget för ett textfält.TextField
 InheritedSkickas när användaren först kontaktar en beröringsaktiverad enhet (som att vidröra en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
 InheritedSkickas när användaren avslutar kontakten med en beröringsaktiverad enhet (som att lyfta fingret från en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
 InheritedSkickas när användaren rör enheten och skickas kontinuerligt tills kontaktpunkten avlägsnas.InteractiveObject
 InheritedSkickas när användaren flyttar kontaktpunkten bort från en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från ett visningsobjekt till ett annat på en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
 InheritedSkickas när användaren flyttar kontaktpunkten över en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från en punkt utanför ett visningsobjekt till en punkt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
 InheritedSkickas när användaren flyttar kontaktpunkten bort från en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från ett visningsobjekt till en punkt utanför visningsobjektet på en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
 InheritedSkickas när användaren flyttar kontaktpunkten över en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från en punkt utanför ett visningsobjekt till en punkt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
 InheritedSkickas när användaren lyfter kontaktpunkten över samma InteractiveObject-instans där kontakten initierades på en beröringsaktiverad enhet (som att trycka med fingret och sedan släppa det vid en enda kontaktpunkt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm).InteractiveObject
Egenskapsdetaljer

alwaysShowSelection

egenskap
alwaysShowSelection:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Om inställningen är true och textfältet inte är i fokus markerar Flash Player markeringen i textfältet med grått. Om inställningen är false och textfältet inte är i fokus markerar Flash Player markeringen i textfältet med grått.

Standardvärdet är false.



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

Relaterade API-element


Exempel  ( Så här använder du exemplet )
Kompilera och kör följande fil. När du kör filen kan du dra för att markera text i båda textfälten. Lägg märke till skillnaden i färgöverstrykning för markering när du markerar text i de båda fälten (ändring av fokus):
    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

egenskap 
antiAliasType:String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9

Den typ av kantutjämning som används för det här textfältet. Använd flash.text.AntiAliasType-konstanter för den här egenskapen. Du kan bara styra inställningen om teckensnittet är inbäddat (med egenskapen embedFonts inställd på true). Standardinställningen är flash.text.AntiAliasType.NORMAL.

Använd följande strängvärden när du ska ange värden för den här egenskapen:

SträngvärdeBeskrivning
flash.text.AntiAliasType.NORMALAnvänder kantutjämning för vanlig text. Detta värde motsvarar den typ av kantutjämning som används i Flash Player version 7 och tidigare.
flash.text.AntiAliasType.ADVANCEDAnvänder avancerad kantutjämning som gör texten mer läsbar. (Funktionen är tillgänglig i Flash Player 8.) Med avancerad kantutjämning kan typsnitt återges med mycket hög kvalitet för små teckenstorlekar. Detta fungerar bäst i program som innehåller stora mängder liten text. Avancerad kantutjämning rekommenderas inte för teckensnitt som är större än 48 punkter.



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

Relaterade API-element

autoSize

egenskap 
autoSize:String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Styr automatisk storleksinställning och justering av textfält. Tillåtna värden för TextFieldAutoSize-konstanter: TextFieldAutoSize.NONE (standard), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT och TextFieldAutoSize.CENTER.

Om autoSize är inställt på TextFieldAutoSize.NONE (standard) görs ingen storleksändring.

Om autoSize är inställd på TextFieldAutoSize.LEFT behandlas texten som vänsterjusterad text, vilket innebär att den vänstra sidan av textfältet förblir fast och eventuell storleksändring av en enstaka rad i textfältet sker på höger sida. Om texten innehåller en radbrytning (till exempel "\n" eller "\r") ändras storleken på den nedersta delen så att den passar med nästa textrad. Om wordWrap också är inställd på true ändras storleken bara för den nedersta delen av textfältet, medan högersidan förblir fast.

Om autoSize är inställd på TextFieldAutoSize.RIGHT behandlas texten som högerjusterad text, vilket innebär att den högra sidan av textfältet förblir fast och storleksändring av en enstaka rad i textfältet sker på vänster sida. Om texten innehåller en radbrytning (till exempel "\n" eller "\r") ändras storleken på den nedersta delen så att den passar med nästa textrad. Om wordWrap också är inställd på true ändras storleken bara för den nedersta delen av textfältet, medan vänstersidan förblir fast.

Om autoSize är inställd på TextFieldAutoSize.CENTER behandlas texten som centrerad text, vilket innebär att en storleksändring av en enstaka rad i textfältet distribueras jämnt på vänster och höger marginal. Om texten innehåller en radbrytning (till exempel "\n" eller "\r") ändras storleken på den nedersta delen så att den passar med nästa textrad. Om wordWrap också är inställd på true ändras storleken bara för den nedersta delen av textfältet, medan höger och vänster sida förblir fasta.



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

Utlöser
ArgumentError — Det angivna autoSize är inte medlem av flash.text.TextFieldAutoSize.

Relaterade API-element

background

egenskap 
background:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Anger om textfältet har en bakgrundsfyllning. Värdet true innebär att textfältet har en bakgrundsfyllning. Värdet false innebär att textfältet inte har någon bakgrundsfyllning. Använd egenskapen backgroundColor för att ställa in bakgrundsfärgen i ett textfält.

Standardvärdet är false.



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

Relaterade API-element

backgroundColor

egenskap 
backgroundColor:uint

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Färgen på textfältets bakgrund. Standardvärdet är 0xFFFFFF (vitt). Egenskapen kan hämtas eller ställas in, även om det inte finns någon bakgrund, men färgen är bara synlig om textfältet har egenskapen background inställd på true.



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

Relaterade API-element

border

egenskap 
border:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Anger om textfältet har en kantlinje. Värdet true innebär att textfältet har en kantlinje. Värdet false innebär att textfältet inte har en kantlinje. Använd egenskapen borderColor för att ställa in kantlinjefärgen.

Standardvärdet är false.



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

Relaterade API-element

borderColor

egenskap 
borderColor:uint

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Färgen på textfältets kantlinje. Standardvärdet är 0x000000 (svart). Egenskapen kan hämtas eller ställas in, även om det inte finns någon kantlinje, men färgen är bara synlig om textfältet har egenskapen border inställd på true.



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

Relaterade API-element

bottomScrollV

egenskap 
bottomScrollV:int  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Ett heltal (ett 1-baserat indexvärde) som visar den nedersta raden som är synlig i textfältet som anges. Se textfältet som ett fönster på ett textblock. Egenskapen scrollV är det ettbaserade indexvärdet i den översta synliga raden i fönstret.

All text mellan raderna som anges av scrollV och bottomScrollV är synliga i textfältet.



Implementering
    public function get bottomScrollV():int

Relaterade API-element

caretIndex

egenskap 
caretIndex:int  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Indexvärdet för inmatningspunkten. Om ingen inmatningspunkt visas är värdet det läge inmatningspunkten skulle ha om du återställde fokus till fältet (vanligtvis på den plats inmatningspunkten senast var, eller noll om fältet inte haft något fokus).

Index för markeringsomfång är nollbaserade (den första positionen är 0, den andra är 1 och så vidare).



Implementering
    public function get caretIndex():int

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I det här exemplet skapas en TextField-instans och fylls med text. En händelseavlyssnare tilldelas, så att metoden printCursorPosition anropas när användaren klickar på textfältet. I det här fallet visas värdena för egenskaperna caretIndex, selectionBeginIndex och selectionEndIndex.

Kör det här exemplet och försök att klicka i textfältet för att markera text. Klicka sedan i fältet utan att markera text. Om du klickar i texten utan att göra någon markering visar egenskapen caretIndex var inmatningspunkten är, och egenskaperna selectionBeginIndex och selectionEndIndex är lika med egenskapsvärdet 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

egenskap 
condenseWhite:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Ett booleskt värde som anger om extra tomrum (blanksteg, radbrytningar o.s.v.) i ett textfält med HTML-text tas bort. Standardvärdet är false. Egenskapen condenseWhite påverkar bara text som anges med egenskapen htmlText, inte med egenskapen text. Om du anger text med egenskapen text ignoreras condenseWhite.

Om du ställer in condenseWhitetrue måste du använda standard-HTML-kommandon, till exempel <BR> och <P>, för att placera radbrytningar i textfältet.

Ställ in egenskapen condenseWhite innan du ställer in egenskapen htmlText.



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

Relaterade API-element


Exempel  ( Så här använder du exemplet )
Följande visar skillnaden mellan att ställa in condenseWhitefalse och på 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

egenskap 
defaultTextFormat:flash.text:TextFormat

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Anger vilket format som ska användas för nyinfogad text, till exempel text som anges av en användare eller text som infogas med metoden replaceSelectedText().

Obs! När tecken som ska bytas ut markeras med setSelection() och replaceSelectedText(), används defaultTextFormat endast om texten har markerats upp till och med det sista tecknet. Exempel:

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

När du kommer åt egenskapen defaultTextFormat definieras alla egenskaper för TextFormat-objektet som returneras. Ingen egenskap är null.

Obs! Du kan inte ange den här egenskapen om en formatmall används på textfältet.



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

Utlöser
Error — Metoden kan inte användas på ett textfält med en formatmall.

Relaterade API-element

displayAsPassword

egenskap 
displayAsPassword:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Anger om textfältet har ett lösenord. Om värdet för egenskapen är true behandlas textfältet som ett password-textfält som döljer inmatningstecknen med asterisker i stället för de riktiga tecknen. Värdet false innebär att textfältet inte behandlas som ett password-textfält. När password-läget är aktiverat fungerar inte kommandona Klipp ut och Klistra in eller deras motsvarande kortkommandon. Den här säkerhetstekniken förebygger att obehöriga användare använder genvägar för att ta reda på ett lösenord på en dator som är obevakad.

Standardvärdet är false.



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

embedFonts

egenskap 
embedFonts:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Anger om rendering ska göras med inbäddade teckensnittskonturer. Om det är false visar Flash Player textfältet med enhetens teckensnitt.

Om du ställer in egenskapen embedFontstrue för ett textfält måste du ange ett teckensnitt för den texten med hjälp av font-egenskapen i ett TextFormat-objekt som tillämpas på textfältet. Om det angivna teckensnittet inte är inbäddat i SWF-filen visas inte texten.

Standardvärdet är false.



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

Relaterade API-element

gridFitType

egenskap 
gridFitType:String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9

Den typ av rutnätspassning som används för det här textfältet. Den här egenskapen gäller bara om textfältets flash.text.AntiAliasType-egenskap är inställd på flash.text.AntiAliasType.ADVANCED.

Den typ av rutnätspassning som används avgör om Flash Player tvingar tydliga vågräta och lodräta rader att passa till ett pixel- eller delpixelrutnät, eller inte alls.

För egenskapen flash.text.GridFitType kan du använda följande strängvärden:

SträngvärdeBeskrivning
flash.text.GridFitType.NONEIngen rutnätspassning används. Vågräta och lodräta linjer i glyferna tvingas inte till pixelrutnätet. Den här inställningen rekommenderas för animering och för stora teckenstorlekar.
flash.text.GridFitType.PIXELAnger att tydliga vågräta och lodräta linjer ska passas till rutnätet. Inställningen fungerar endast för vänsterjusterade textfält. Om du vill använda den här inställningen måste textfältets flash.dispaly.AntiAliasType-egenskap vara inställd på flash.text.AntiAliasType.ADVANCED. Inställningen ger normalt den bästa läsbarheten för vänsterjusterad text.
flash.text.GridFitType.SUBPIXELAnger att tydliga vågräta och lodräta linjer passas till delpixelrutnätet på en LCD-skärm. Om du vill använda den här inställningen måste textfältets flash.text.AntiAliasType-egenskap vara inställd på flash.text.AntiAliasType.ADVANCED. Inställningen flash.text.GridFitType.SUBPIXEL rekommenderas vid högerjusterad och centrerad dynamisk text. Detta är ibland en praktisk kompromiss mellan animering och textkvalitet.

Standardvärdet är pixel.



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

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I följande exempel visas tre textfält med olika inställningar för gridFitType-egenskapen. Lägg märke till skillnaden i läsbarhet mellan de första två raderna när du använder det här exemplet. Lägg även märke till den optimala användningen av GridFitType.PIXEL för vänsterjusterad text och GridFitType.SUBPIXEL för högerjusterad text.
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

egenskap 
htmlText:String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Innehåller HTML-representationen av textfältets innehåll.

Flash Player stöder följande HTML-taggar:

Tagg Beskrivning
Ankartagg Med <a>-taggen skapas en hypertextlänk och den används med följande attribut:
  • target: Anger namnet på målfönstret där sidan läses in. Alternativen är _self, _blank, _parent och _top. Med alternativet _self anges den aktuella bildrutan i aktuellt fönster. _blank anger ett nytt fönster, _parent anger den aktuella bildrutans överordnade bildruta och _top anger bildrutan på översta nivån i aktuellt fönster.
  • href: Anger en URL- eller en ActionScript link-händelse. URL:en kan vara antingen absolut eller relativ till placeringen av SWF-filen som läser in sidan. Ett exempel på en absolut referens till en URL är http://www.adobe.com; ett exempel på en relativ referens är /index.html. Absoluta URL:er måste inledas med http://, annars behandlas de som relativa URL:er. Du kan använda link-händelsen så att länken utför en ActionScript-funktion i en SWF-fil i stället för att öppna en URL-adress. Ange en link-händelse genom att använda händelseschemat i stället för HTTP-schemat i attributet href. Ett exempel är href="event:myText" i stället för href="http://myURL"; när användaren klickar på hyperlänken som innehåller händelseschemat skickar textfältet en link-texthändelse med egenskapen text inställd på "myText". Sedan kan du skapa en ActionScript-funktion som körs varje gång link-texthändelsen skickas. Du kan även definiera formaten a:link, a:hover och a:active för ankartaggar genom att använda formatmallar.
Tagg för fetstil Taggen <b> visar text i fetstil. Det måste finnas ett tillgängligt typsnitt för fetstil.
Tagg för radbrytning Med <br>-taggen skapas en radbrytning i textfältet. För att använda denna tagg måste du ange att textfältet ska innehålla flera rader.
Tagg för teckensnitt Med <font>-taggen anges ett teckensnitt eller lista med flera teckensnitt för textvisningen. Teckensnittstaggen kan användas med följande attribut:
  • color: Endast hexadecimala färgvärden (#FFFFFF) används.
  • face: Anger namnet på teckensnittet som används. Du kan ange en lista med kommaseparerade teckensnittsnamn från vilken Flash Player väljer det första tillgängliga teckensnittet. Om angivet teckensnitt inte är installerat på det lokala datorsystemet eller inte finns inbäddat i SWF-filen väljer Flash Player ett ersättningsteckensnitt.
  • size: Anger teckensnittets storlek. Du kan använda absoluta pixelstorlekar, t.ex. 16 eller 18, eller relativa teckenstorlekar som +2 eller -4.
Tagg för bild Med <img>-taggen bäddar du in externa bildfiler (JPEG, GIF, PNG), SWF-filer och filmklipp i textfält. Texten visas automatiskt runt de bilder som bäddas in i textfält. Du måste ange att textfältet ska innehålla flera rader för att kunna figursätta texten runt en bild.

<img>-taggen kan användas med följande attribut:

  • src: Anger URL:en till en bild- eller SWF-fil eller till länknings-ID:t för en filmklippssymbol i biblioteket. Det här attributet är obligatoriskt, de övriga är valfria. Externa filer (JPEG-, GIF-, PNG- och SWF-filer) visas inte förrän de är nedladdade.
  • width: Bredden (antal pixlar) på bilden, SWF-filen eller filmklippet som ska infogas.
  • height: Höjden (antal pixlar) på bilden, SWF-filen eller filmklippet som ska infogas.
  • align: Anger den vågräta justeringen av inbäddad bild inom textfältet. Giltiga värden är left och right. Standardvärdet är left.
  • hspace: Anger det vågräta utrymme som omger bilden. I utrymmet visas ingen text. Standardvärdet är 8.
  • vspace: Anger det lodräta utrymme som omger bilden. I utrymmet visas ingen text. Standardvärdet är 8.
  • id: Anger namnet på filmklippsinstansen (skapad i Flash Player) som innehåller den inbäddade bildfilen, SWF-filen eller filmklippet. Denna metod används för att kontrollera det inbäddade innehållet med ActionScript.
  • checkPolicyFile: Anger att Flash Player ska söka efter en URL-principfil på den server som är kopplad till bildens domän. Om det finns en principfil har de SWF-filer, som finns i domänerna i filens lista, tillgång till data i den inlästa bilden, t.ex. genom anrop av metoden BitmapData.draw() med den här bilden som source-parameter. Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.

Med Flash visas inbäddade medier i ett textfält i full storlek. Om du vill ange dimensionerna på de medier du bäddar in använder du <img>-taggens height och width-attribut.

Normalt visas en inbäddad bild i ett textfält på raden efter <img>-taggen. Men när <img>-taggen är det första tecknet i textfältet visas bilden på översta raden.

För AIR-innehåll i programmets säkerhetssandlåda ignoreras img-taggarna i HTML-innehållet i ActionScript TextField-objekt. På så sätt förhindras eventuella nätfiskeattacker.

Tagg för kursiv text Taggen <i> visar texten i kursiv stil. Det måste finnas ett tillgängligt teckensnitt för kursiv text.
Tagg för punktlista Med <li>-taggen placeras en punkttyp framför texten som omfattas. Obs! Eftersom Flash Player och AIR inte kan identifiera numrerade och onumrerade listtaggar (<ol> och <ul>) påverkar de inte hur din lista visas. I listor är onumrerade och alla listobjekt använder punkter.
Tagg för stycke Med <p>-taggen skapar du ett nytt stycke. För att använda denna tagg måste textfältet ställas in så att det innehåller flera rader. <p>-taggen kan användas med följande attribut:
  • align: Anger textjusteringen inom stycket. Giltiga värden är left, right, justify och center.
  • class: Anger en CSS-formatklass som definieras av ett flash.text.StyleSheet-objekt.
Tagg för textspann <span>-taggen används endast ihop med CSS-textformat. Taggen kan användas med följande attribut:
  • class: Anger en CSS-formatklass som definieras av ett flash.text.StyleSheet-objekt.
Tagg för textformat

Med <textformat>-taggen kan du använda en delmängd av egenskaper för textstyckeformatering i TextFormat-klassen inom textfält; vilket ger radavstånd, indrag, marginaler och tabbstopp. Du kan kombinera <textformat>-taggar med inbyggda HTML-taggar.

<textformat>-taggen kan användas med följande attribut:

  • blockindent: Anger indraget textblock i antal punkter; motsvarar TextFormat.blockIndent.
  • indent: Anger indrag från vänstermarginalen till det första tecknet i stycket; motsvarar TextFormat.indent. Både positiva och negativa tal kan användas.
  • leading: Anger inledande radavstånd (lodrätt utrymme); motsvarar TextFormat.leading. Både positiva och negativa tal kan användas.
  • leftmargin: Anger vänstermarginal för textstycket i antal punkter; motsvarar TextFormat.leftMargin.
  • rightmargin: Anger högermarginal för textstycket i antal punkter; motsvarar TextFormat.rightMargin.
  • tabstops: Anger anpassade tabbstopp som en array med positiva heltal, motsvarar TextFormat.tabStops.
Tagg för understruken text Taggen <u> visar texten understruken.

Flash Player och AIR stöder följande HTML-entiteter:

Entitet Beskrivning
&lt; < (mindre än)
&gt; > (större än)
&amp; & (et-tecken)
&quot; " (dubbla citattecken)
&apos; ' (apostrof, enkelt citattecken)

I Flash Player och AIR stöds även explicita teckenkoder, t.ex. &#38; (et-tecken, ASCII) och &#x20AC; (Unicode, €-symbol).



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

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I följande exempel skapas ett textfält med namnet tf1, och en HTML-formaterad sträng kopplas till dess text-egenskap. När egenskapen htmlText identifieras, visas den HTML-formaterade strängen med ytterligare taggar (t.ex. <P> och <FONT>) som lagts till automatiskt av Flash Player. När egenskapsvärdet text identifieras visas den oformaterade strängen utan HTML-taggar.

Samma steg utförs också på ett annat TextField-objekt med namnet tf2, med det tillägget att ett StyleSheet-objekt kopplas till tf2-objektets styleSheet-egenskap innan dess htmlText-egenskap anges. När htmlText-egenskapen identifieras i detta fall, omfattas endast den exakta HTML-texten som ursprungligen kopplades till htmlText-egenskapen, vilket visar att inga fler taggar har lagts till av 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

egenskap 
length:int  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Antalet tecken i ett textfält. Ett tecken som tabb (\t) räknas som ett tecken.



Implementering
    public function get length():int

maxChars

egenskap 
maxChars:int

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Det maximala antal tecken som en användare kan skriva i textfältet. Ett skript kan infoga mer text än vad maxChars tillåter. Egenskapen maxChars visar bara hur mycket text som en användare kan ange. Om värdet för den här egenskapen är 0 finns det ingen gräns för hur mycket text som en användare kan ange.

Standardvärdet är 0.



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

maxScrollH

egenskap 
maxScrollH:int  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Maxvärdet för scrollH.



Implementering
    public function get maxScrollH():int

Relaterade API-element

maxScrollV

egenskap 
maxScrollV:int  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Maxvärdet för scrollV.



Implementering
    public function get maxScrollV():int

Relaterade API-element

mouseWheelEnabled

egenskap 
mouseWheelEnabled:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9

Ett booleskt värde som anger om Flash Player automatiskt ska rulla textfält med flera rader när användaren klickar i ett textfält och rullar på mushjulet. Standardvärdet är true. Egenskapen är användbar om du vill förhindra att mushjulet rullar textfält eller om du vill implementera egen rullning av textfält.



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

multiline

egenskap 
multiline:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Anger om textfältet har flera rader. Om värdet är true har textfältet flera rader. Om värdet är false har textfältet en rad. I ett fält av typen TextFieldType.INPUT avgör värdet multiline om Enter-tangenten skapar en ny rad (om värdet är false ignoreras Enter-tangenten). Om du klistrar in text i TextField med ett multiline-värde som är false tas nya rader bort ur texten.

Standardvärdet är false.



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

Relaterade API-element

numLines

egenskap 
numLines:int  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Definierar antalet textrader i ett textfält med flera rader. Om wordWrap-egenskapen är inställd på true ökar antalet rader när texten figursätts.



Implementering
    public function get numLines():int

Relaterade API-element

restrict

egenskap 
restrict:String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Anger den teckenuppsättning en användare kan använda för att skriva i textfältet. Om värdet för egenskapen restrict är null kan du skriva vilket tecken som helst. Om värdet för egenskapen restrict är en tom sträng kan du inte skriva vilket tecken som helst. Om värdet för restrict-egenskapen är en teckensträng kan du bara ange tecknen i strängen i textfältet. Strängen läses från vänster till höger. Du kan ange intervall med hjälp av bindestreck (-). Endast användarinteraktionen är begränsad; ett skript kan lägga in alla slags texter i textfältet. Egenskapen synkroniseras inte med alternativen Bädda in teckensnittskonturer i egenskapsinspektören.

Om strängen börjar med cirkumflexen (^) accepteras alla tecken utom de som anges i strängen. Om strängen inte börjar med cirkumflexen (^) accepteras bara de tecken som anges i strängen.

I följande exempel tillåts bara att stora bokstäver, mellanslag och siffror i ett textfält:

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

I följande exempel tillåts alla tecken utom små bokstäver:

     my_txt.restrict = "^a-z";
     

Du kan använda omvänt snedstreck för att ange ett ^ eller - ordagrant. Sekvenserna med omvänt snedstreck är \-, \^ eller \\. Det omvända snedsträcket måste vara ett faktiskt tecken i strängen. Två omvända snedstreck måste användas i ActionScript. I följande kod finns bara strecket (-) och cirkumflexen (^):

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

^ kan användas var som helst i strängen för att växla mellan att inkludera och exkludera tecken. I följande exempel tillåts bara stora bokstäver, men stora Q utesluts:

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

Du kan använda escape-sekvensen \u för att skapa restrict-strängar. I följande kod inkluderas bara tecknen från ASCII 32 (mellanslag) till ASCII 126 (tilde).

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

Standardvärdet är null.



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

scrollH

egenskap 
scrollH:int

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Den vågräta rullningspositionen. Om egenskapen scrollH är 0 rullas inte texten vågrätt. Egenskapsvärdet är ett heltal som representerar den vågräta positionen i pixlar.

Enheten för vågrät rullning är pixlar, medan enheten för lodrät rullning är rader. Vågrät rullning mäts i pixlar, eftersom de flesta teckensnitten som du använder har proportionella mellanrum. Det innebär att tecknen kan ha olika bredd. Flash Player utför lodrät rullning efter rad, eftersom användare vanligtvis vill se en hel textrad i stället för en ofullständig rad. Även om det finns flera teckensnitt på en rad anpassas radens höjd för att passa det största teckensnittet som används.

Obs! Egenskapen scrollH är nollbaserad, inte ettbaserad som den lodräta rullningsegenskapen scrollV.



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

Relaterade API-element

scrollV

egenskap 
scrollV:int

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Den lodräta positionen för texten i ett textfält. Egenskapen scrollV är användbar när användare vill hitta ett visst stycke i en lång text eller ska skapa rullningsbara textfält.

Enheten för lodrät rullning är rader, medan enheten för vågrät rullning är pixlar. Om den första visade raden är den första raden i textfältet ställs scrollV in på 1 (inte 0). Vågrät rullning mäts i pixlar, eftersom de flesta teckensnitten har proportionella mellanrum. Det innebär att tecknen kan ha olika bredd. Flash utför lodrät rullning efter rad, eftersom användare vanligtvis vill se en hel textrad i stället för en ofullständig rad. Även om det finns flera teckensnitt på en rad anpassas radens höjd för att passa det största teckensnittet som används.



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

Relaterade API-element

selectable

egenskap 
selectable:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Ett booleskt värde som anger om ett textfält är markeringsbart. Värdet true anger att texten är markeringsbar. Egenskapen selectable kontrollerar om ett textfält är markeringsbart, inte om det är redigeringsbart. Ett dynamiskt textfält kan vara markeringsbart även om det inte är redigeringsbart. Om ett dynamiskt textfält inte är markeringsbart går det inte att markera texten i det.

Om selectable är inställt på false svarar inte texten i textfältet på markeringskommandon från musen eller tangentbordet, och texten kan inte kopieras med hjälp av kommandot Kopiera. Om selectable är inställt på true kan texten i textfältet markeras med musen eller tangentbordet, och texten kan kopieras med hjälp av kommandot Kopiera. Du kan markera text på det här sättet även om textfältet är dynamiskt i stället för ett textinmatningsfält.

Standardvärdet är true.



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

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I följande exempel skapas två dynamiska textfält: det ena textfältet har egenskapen selectable inställd på true och det andra textfältet har egenskapen selectable inställd på false. Försök att markera texten i textfälten när du använder det här exemplet.
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

egenskap 
selectionBeginIndex:int  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Det nollbaserade teckenindexvärdet för det första tecknet i den aktuella markeringen. Det första tecknet är 0, det andra 1 och så vidare. Om ingen text är markerad är värdet för den här egenskapen caretIndex.



Implementering
    public function get selectionBeginIndex():int

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I det här exemplet skapas en TextField-instans och fylls med text. En händelseavlyssnare tilldelas, så att metoden printCursorPosition anropas när användaren klickar på textfältet. I det här fallet visas värdena för egenskaperna caretIndex, selectionBeginIndex och selectionEndIndex.

Kör det här exemplet och försök att klicka i textfältet för att markera text. Klicka sedan i fältet utan att markera text. Om du klickar i texten utan att göra någon markering visar egenskapen caretIndex var inmatningspunkten är, och egenskaperna selectionBeginIndex och selectionEndIndex är lika med egenskapsvärdet 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

egenskap 
selectionEndIndex:int  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Det nollbaserade teckenindexvärdet för det sista tecknet i den aktuella markeringen. Det första tecknet är 0, det andra 1 och så vidare. Om ingen text är markerad är värdet för den här egenskapen caretIndex.



Implementering
    public function get selectionEndIndex():int

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I det här exemplet skapas en TextField-instans och fylls med text. En händelseavlyssnare tilldelas, så att metoden printCursorPosition anropas när användaren klickar på textfältet. I det här fallet visas värdena för egenskaperna caretIndex, selectionBeginIndex och selectionEndIndex.

Kör det här exemplet och försök att klicka i textfältet för att markera text. Klicka sedan i fältet utan att markera text. Om du klickar i texten utan att göra någon markering visar egenskapen caretIndex var inmatningspunkten är, och egenskaperna selectionBeginIndex och selectionEndIndex är lika med egenskapsvärdet 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

egenskap 
sharpness:Number

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9

Skärpan på specialtecknens kanter i det här textfältet. Den här egenskapen gäller bara om textfältets flash.text.AntiAliasType-egenskap är inställd på flash.text.AntiAliasType.ADVANCED. Intervallet för sharpness är ett tal från -400 till 400. Om du försöker ställa in sharpness på ett värde utanför det intervallet ställer Flash in egenskapen på det närmsta värdet som är i intervallet (antingen -400 eller 400).

Standardvärdet är 0.



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

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I följande exempel visas effekten av att ändra sharpness-egenskapen för ett TextField-objekt. Du måste bädda in teckensnittet och ställa in egenskapen antiAliasTypeADVANCED.
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

egenskap 
styleSheet:StyleSheet

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Kopplar en formatmall till textfältet. Information om att skapa formatmallar finns i klassen StyleSheet och Utvecklarhandbok för Adobe ActionScript 3.0.

Du kan när som helst byta ut den formatmall som är kopplad till ett textfält. Om formatmallen byts ut ritas textfältet om med den nya formatmallen. Du kan ställa in formatmallen på null eller undefined om du vill ta bort formatmallen. Om formatmallen som används tas bort ritas textfältet om utan formatmall.

Obs! Om formatmallen tas bort ändras innehållet i både TextField.text och TextField.htmlText till att omfatta den formatering som tidigare använts i formatmallen. Om du vill bevara det ursprungliga TextField.htmlText-innehållet utan formateringen sparar du värdet i en variabel innan du tar bort formatmallen.



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

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I följande exempel definieras ett enkelt StyleSheet-objekt som sedan tilldelas ett textfält med HTML-innehåll. Ställ in stylesheet-egenskapen innan du ställer in innehållet.
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

egenskap 
text:String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

En sträng som utgör den nuvarande texten i textfältet. Rader avgränsas med vagnreturtecknet ('\r', ASCII 13). Den här egenskapen innehåller oformaterad text i textfältet utan HTML-taggar.

Om du vill hämta texten i HTML-format använder du egenskapen htmlText.

Obs! Om en formatmall används på textfältet tolkas innehållet i egenskapen text som HTML.



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

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I följande exempel skapas ett textfält med namnet tf1, och en HTML-formaterad sträng kopplas till dess text-egenskap. När egenskapen htmlText identifieras, visas den HTML-formaterade strängen med ytterligare taggar (t.ex. <P> och <FONT>) som lagts till automatiskt av Flash Player. När egenskapsvärdet text identifieras visas den oformaterade strängen utan HTML-taggar.

Samma steg utförs också på ett annat TextField-objekt med namnet tf2, med det tillägget att ett StyleSheet-objekt kopplas till tf2-objektets styleSheet-egenskap innan dess htmlText-egenskap anges. När htmlText-egenskapen identifieras i detta fall, omfattas endast den exakta HTML-texten som ursprungligen kopplades till htmlText-egenskapen, vilket visar att inga fler taggar har lagts till av 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

egenskap 
textColor:uint

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Färgen på texten i ett textfält, i hexadecimalt format. I det hexadecimala färgsystemet används sex siffror som representerar färgvärden. Varje siffra har 16 möjliga värden eller tecken. Teckenintervallet går från 0 till -9 och sedan från A till F. Svart är till exempel 0x000000 och vitt är 0xFFFFFF.

Standardvärdet är 0 (0x000000).



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

Exempel  ( Så här använder du exemplet )
Följande ActionScript skapar ett TextField-objekt och ändrar dess textColor-egenskap till rött (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

egenskap 
textHeight:Number  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Textens höjd i pixlar.



Implementering
    public function get textHeight():Number

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I följande exempel skapas ett TextField-objekt och tilldelas text. Programsatserna trace visar värdet för egenskaperna textWidth och textHeight. Som jämförelse visas även egenskaperna width och height. (Tänk på att värdena du ser för textHeight och textWidth kan variera beroende på vilket teckensnitt som används på din dator.)
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

egenskap 
textInteractionMode:String  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 11, Flash Lite 4

Egenskapen för interaktionsläge. Standardvärdet är TextInteractionMode.NORMAL. På mobilplattformar innebär läget normal att användaren kan rulla i texten men inte markera den. Du kan växla till ett tillgängligt läge med hjälp av den inbyggda snabbmenyn i textfältet. På en stationär dator innebär läget normal att användaren både kan rulla i texten och markera den.



Implementering
    public function get textInteractionMode():String

textWidth

egenskap 
textWidth:Number  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Textens bredd i pixlar.



Implementering
    public function get textWidth():Number

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I följande exempel skapas ett TextField-objekt och tilldelas text. Programsatserna trace visar värdet för egenskaperna textWidth och textHeight. Som jämförelse visas även egenskaperna width och height. (Tänk på att värdena du ser för textHeight och textWidth kan variera beroende på vilket teckensnitt som används på din dator.)
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

egenskap 
thickness:Number

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9

Tjockleken på specialtecknens kanter i det här textfältet. Den här egenskapen gäller bara när flash.text.AntiAliasType är inställd på flash.text.AntiAliasType.ADVANCED.

Intervallet för thickness är ett tal från -200 till 200. Om du försöker ställa in thickness på ett värde utanför det intervallet ställs egenskapen in på det närmsta värdet som är i intervallet (antingen -200 eller 200).

Standardvärdet är 0.



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

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I följande exempel visas effekten av att ändra thickness-egenskapen för ett TextField-objekt. Du måste bädda in teckensnittet och ställa in egenskapen antiAliasTypeADVANCED.
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

egenskap 
type:String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Textfältets typ. Någon av följande TextFieldType-konstanter: TextFieldType.DYNAMIC som anger ett dynamiskt textfält som användaren inte kan redigera, eller TextFieldType.INPUT som anger ett inmatningsfält som användaren kan redigera.

Standardvärdet är dynamic.



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

Utlöser
ArgumentError — Det angivna type är inte medlem av flash.text.TextFieldType.

Relaterade API-element


Exempel  ( Så här använder du exemplet )
I följande exempel skapas två textfält: tfDynamic och tfInput. Texten anges i båda textfälten. tfDynamic har däremot type-egenskapen inställd på TextFieldType.DYNAMIC och tfInput har type-egenskapen inställd på TextFieldType.INPUT, så användaren kan ändra texten i tfInput men kan bara visa den i tfDynamic.
package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldType;

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

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

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

useRichTextClipboard

egenskap 
useRichTextClipboard:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9

Anger om textformateringen ska kopieras och klistras in med texten. Om värdet är true kopierar och klistrar Flash Player in formatering (t.ex. justering, fetstil och kursiv stil) när du kopierar och klistrar in mellan textfält. För både original- och måltextfältet måste useRichTextClipboard vara inställt på true. Standardvärdet är false.



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

Exempel  ( Så här använder du exemplet )
I det här exemplet skapas ett textinmatningsfält (tf1) och två dynamiska textfält (tf2 och tf3). Koden tilldelar varje enskilt dynamiskt textfält ett TextFormat-objekt (teckensnitt Courier Bold). Textfältet tf2har egenskapen useRichTextClipboard inställd på false. Textfältet tf3 har egenskapen useRichTextClipboard inställd på true. När du kopierar texten från textfältet tf2 och klistrar in den i textfältet tf1 följer inte formateringen med den inklistrade texten. När du kopierar texten från textfältet tf3 (som har useRichTextClipboard inställt på true) och klistrar in den i textfältet tf1 ingår formateringen i den inklistrade texten.
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

egenskap 
wordWrap:Boolean

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Ett booleskt värde som anger om textfältet har automatisk radbrytning. Om värdet för wordWrap är true innehåller textfältet automatisk radbrytning. Är värdet false innehåller textfältet inte automatisk radbrytning. Standardvärdet är false.



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

Exempel  ( Så här använder du exemplet )
Följande visar skillnaden mellan att ställa in egenskapen wordWraptrue och på false: Två TextFileld-instanser skapas vars innehåll är för stort för bredden. Den första instansens wordWrap-egenskap (med namnet tfWrap) ställs in på true och den andra ställs in på false (med namnet tfNoWrap).
package {
    import flash.display.Sprite;
    import flash.text.TextField;

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

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

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

TextField

()Konstruktor
public function TextField()

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Skapar en ny TextField-instans. När du har skapat en TextField-instans anropar du metoden addChild() eller addChildAt() i det överordnade DisplayObjectContainer-objektet och lägger till TextField-instansen i visningslistan.

Standardstorleken för ett textfält är 100 x 100 pixlar.


Exempel  ( Så här använder du exemplet )

I följande exempel visas hur du dynamiskt kan skapa ett TextField-objekt för indata i ActionScript 3.0 genom att ställa in textfältobjektets type-egenskap på konstanten TextFieldType.INPUT. Exempel från 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);
Metoddetaljer

appendText

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Lägger till strängen som angetts av parametern newText på en del av eller all text i ett textfält. Den här metoden är effektivare än additionstilldelning (+=) på en text-egenskap (t.ex. someTextField.text += moreText), särskilt för ett textfält med mycket innehåll.

Parametrar

newText:String — Den sträng som ska läggas till i den befintliga texten.


Exempel  ( Så här använder du exemplet )

I följande exempel visas tiden om det inte är helg. Om det är helg visas texten "It's the weekend". Dessutom räknas antalet tecken fram till en viss position och antalet rader i textfältet.

Textfältet outputText ställs automatiskt in så att texten passas och vänsterjusteras med egenskapen autoSize. Egenskapen outputText.text skriver den första raden innehåll och metoden appendText() lägger till resten av innehållet. (Det är inte nödvändigt att börja med egenskapen text. Metoden appendText() kan också användas för att lägga till text från början.) Om egenskapen text ställs in en andra gång skrivs den ursprungliga texten över. Använd operatorn += om du vill lägga till innehåll med egenskapen text.

if-satsen kontrollerar om datumet är lördag (6) eller söndag (0). Om det inte är det returnerar metoden toLocaleTimeString() lokal tid och lägger till den i textfältets innehåll.

Textfältets length-egenskap används för att avläsa antalet tecken fram tills funktionen anropas. Egenskapen numLines används för att räkna antalet rader i textfältet. Observera att tomma rader räknas till antalet rader och att blanksteg och radbrytningar (\n) räknas till innehållets längd.

  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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar en rektangel som utgör tecknets begränsningsram.

Parametrar

charIndex:int — Det nollbaserade indexvärdet för tecknet (den första positionen är 0, den andra är 1 och så vidare).

Returnerar
Rectangle — En rektangel med de lägsta och högsta x- ochy-värdena som definierar tecknets begränsningsram.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

I följande exempel används metoden getCharBoundaries() för att markera (belysa) ett tecken som användaren väljer.

I klassen definieras Shape-objektet spotlight som används för att rita en rektangel runt varje tecken som markeras. När användaren klickar på textfältet myTextField anropas metoden clickHandler().

I metoden clickHandler() får metoden getCharIndexAtPoint() det klickade tecknets indexvärde baserat på koordinaterna localX och localY för musklicket, vilket är relativt Sprite-behållarobjektet. Metoden getCharIndexAtPoint() returnerar -1 om punkten (musklicket) inte var över något tecken. Eftersom textfältet kan vara större än texten kontrolleras det returnerade heltalet (index) för att bekräfta att användaren har klickat på ett tecken. Heltalet index används också av getCharBoundaries() för att få ett Rectangle-objekt som innehåller tecknets gräns. Metoden clear() tar bort Shape-objektet spotlight om det fanns ett som visades sedan tidigare. En ny rektangel med samma storlek som tecknets höjd- och breddgränser skapas på samma ställe som tecknet (försljuten från koordinaterna (10, 10)) med den returnerade frame-rektangelns x- och y-koordinater. Tecknet lyses upp genom att Shape-objektet spotlight fylls med gul färg och opaciteten inställd på 35 procent så att tecknet fortfarande syns. Observera att blanksteg också räknas som tecken.

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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar det nollbaserade indexvärdet för tecknet vid den punkt som anges av parametrarna x och y.

Parametrar

x:Number — Tecknets x-koordinat.
 
y:Number — Tecknets y-koordinat.

Returnerar
int — Det nollbaserade indexvärdet för tecknet (den första positionen är 0, den andra är 1 och så vidare). Returnerar -1 om punkten inte ligger över ett tecken.

Exempel  ( Så här använder du exemplet )

I följande exempel kopieras tecken till ett annat textfält ovanför texten när användaren klickar på dem.

I det första textfältet finns texten användaren ska välja. För att texten ska klickas men inte markeras ställs egenskapen selectable in på false. När användaren klickar på textfältet firstTextField anropas metoden clickHandler().

I metoden clickHandler() returnerar metoden getCharIndexAtPoint() tecknets indexvärde baserat på koordinaterna localX och localY för musklicket. Eftersom textfältet kan vara större än texten kontrolleras det returnerade heltalet (index) för att bekräfta att användaren har klickat på ett tecken. (Metoden getCharIndexAtPoint() returnerar -1 om punkten (musklicket) inte var över något tecken.) Muskoordinaterna används för att ställa in koordinaterna för det nya textfältet där det kopierade tecknet ska placeras. Färgen för tecknet i det andra textfältet ställs in på röd. Slutligen ställs texten i det andra textfältet in på det valda tecknet, som hämtas med metoden charAt(). Observera att om egenskapen text används i stället för metoden appendText(), ersätts tecknet i det andra textfältet i stället för att det nya tecknet läggs till.

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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar ett givet teckenindexvärde för det första tecknet i samma stycke.

Parametrar

charIndex:int — Det nollbaserade indexvärdet för tecknet (det första tecknet är 0, det andra är 1 och så vidare).

Returnerar
int — Det nollbaserade indexvärdet för det första tecknet i samma stycke.

Utlöser
RangeError — Det angivna teckenindexvärdet är utanför intervallet.

Exempel  ( Så här använder du exemplet )

I följande exempel används styckeformatering i textfältets innehåll. När användaren klickar på ett stycke högerjusteras texten i stycket och när användaren klickar på det igen återgår det till den ursprungliga (standard-)formateringen (vänsterjustering).

I konstruktorn ställs textfältet myTextField in på radbrytning. Metoden getTextFormat returnerar det ursprungliga formatet för det första tecknet i textfältet. Formatet placeras i TextFormat-objektet originalFormat. Ett nytt TextFormat-objekt (newFormat) definieras också och dess align-egenskap ställs in på högerjustering. När användaren klickar på textfältet anropas metoden clickHandler().

I metoden clickHandler() returnerar metoden getCharIndexAtPoint() tecknets indexvärde baserat på koordinaterna localX och localY för musklicket. Den första if-satsen kontrollerar om användaren har klickat på något tecken. Med hjälp av heltalet clickIndex, som returnerades av metodengetCharIndexAtPoint(), returnerar metoden getFirstCharInParagraph() indexvärdet för det första tecknet i stycket som användaren klickade på. Indexvärdet för det sista tecknet i stycket avgörs genom att styckets längd (fås med metoden getParagraphLength()) läggs till indexvärdet för det första tecknet i stycket minus det sista tecknet (\n). Den andra if-satsen kontrollerar formatet för det första tecknet i stycket. Om dess justeringsvärde är samma som det ursprungliga formatet (vänsterjustering) tillämpas det nya formatet på alla tecken i stycket. Annars återställs styckets format till det ursprungliga formatet. Justering samt formatering som indrag, punkter, tabbstopp och vänster och höger marginal är format som är avsedda för stycken. Observera att när automatisk radbrytning eller radbrytning används, gäller bara formateringen för styckets första rad om argumentet endIndex inte är definierat för metoden 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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar en DisplayObject-referens för givet id för en bild eller SWF-fil som har lagts till i ett HTML-formaterat textfält med en <img>-tagg. Taggen <img> har följande format:

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

Parametrar

id:String — Det id som ska matcha (i id-attributet för <img>-taggen).

Returnerar
DisplayObject — Visningsobjektet som motsvarar bilden eller SWF-filen med det matchande id-attributet i <img>-taggen i textfältet. För medier som lästs in från en extern källa är det här objektet ett Loader-objekt. När medieobjektet har lästs in underordnas det detta Loader-objekt. För medier som är inbäddade i SWF-filen är detta det inlästa objektet. Om det inte finns någon <img>-tagg med matchande id returnerar metoden null.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

I följande exempel ställs bilden i fältet in på 25 procents opacitet och roteras 90 grader från ursprungsrotationen när användaren klickar på textfältet. Bilden fortsätter rotera varje gång användaren klickar.

Bilden (image.jpg) inkluderas via HTML. (Här antas bildfilen finnas i samma katalog som SWF-filen.) Ett id-attribut måste definieras för img-taggen för att bilden ska bli åtkomlig för metoden getImageReference(). Egenskapen htmlText används för att inkludera HTML-formaterat stränginnehåll. När användaren klickar på textfältet myTextField anropas metoden clickHandler().

I metoden clickHandler() returnerar metoden getImageReference() en referens till bilden som ett DisplayObject. Referensen kan användas för att manipulera bilden, precis som alla DisplayObject-objekt. Här ställs värdena alpha (genomskinlighet) och rotation in. Egenskapen transform kan också användas för att hantera visningsobjektets matris, färgomformning och pixelgränser. Observera också att flash.display.DisplayObject måste importeras.

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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar det nollbaserade indexvärdet för raden vid den punkt som anges av parametrarna x och y.

Parametrar

x:Number — Radens x-koordinat.
 
y:Number — Radens y-koordinat.

Returnerar
int — Det nollbaserade indexvärdet för raden (den första raden är 0, den andra är 1 och så vidare). Returnerar -1 om punkten inte ligger över någon rad.

Exempel  ( Så här använder du exemplet )

I följande exempel markerar användaren en rad i en Shakespeare-sonett. Raden kopieras och läggs till i ett nytt textfält.

I konstruktorn ställs textfältet poem in på att inte byta rad automatiskt (eftersom det är poesi). Egenskapen autoSize används också för att ställa in texten så att den passas och skalas automatiskt som vänsterjusterad text. Textfältet poemCopy placeras under textfältet poem. När användaren klickar på en rad i dikten anropas metoden clickHandler().

I metoden clickHandler() returnerar metoden getLineIndexAtPoint() indexvärdet för raden användaren klickat på baserat på koordinaterna localX och localY för musklicket. (Eftersom den ursprungliga dikten passar i textfältet här är det inte nödvändigt att kontrollera om ett utanför intervallet-fel (RangeError) genereras av metoden getCharIndexAtPoint().) Radens indexvärde används sedan för att hämta innehållet på raden som en sträng med metoden getLineText(). Raden läggs sedan till i textfältet poemCopy. Kopieringen kan göras flera gånger, men så småningom kommer texten att hamna utanför den del av textfältet poemCopy som kan visas.

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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar det nollbaserade indexvärdet för raden som innehåller tecknet som anges av parametern charIndex.

Parametrar

charIndex:int — Det nollbaserade indexvärdet för tecknet (det första tecknet är 0, det andra är 1 och så vidare).

Returnerar
int — Det nollbaserade indexvärdet för raden.

Utlöser
RangeError — Det angivna teckenindexvärdet är utanför intervallet.

Exempel  ( Så här använder du exemplet )

I följande exempel returnerar metoden getLineIndexOfChar() radnumren för de 100:e och 500:e tecknen i textfältet.

Textfältet myTextField ställs in på automatisk radbrytning och skalning som vänsterjusterad text. Metoden getLineIndexOfChar() returnerar radindexvärdena för de angivna teckenindexvärdena (100 och 500). Informationen läggs sedan till efter stycket. Obs! Eftersom radindex börjar med 0 ska radindex (index) ökas med 1 för att ge radnumret. Om visningsstorleken ändras kan radnumret också ändras, men informationen här ändras inte eftersom metoden bara anropas en gång.

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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar antalet tecken på en viss textrad.

Parametrar

lineIndex:int — Radnumret som du vill ha längden för.

Returnerar
int — Antalet tecken på raden.

Utlöser
RangeError — Det angivna radnumret är utanför intervallet.

Exempel  ( Så här använder du exemplet )

I följande exempel markerar användaren en rad. Radens längd (antal tecken) visas i ett separat textfält

För att illustrera detta ställs textfältet myTextField, som visar den text som ska räknas, in på INPUT så att användaren faktiskt kan ändra raderna eller lägga till rader mellan befintliga rader eller i slutet. (En tom rad skapas av radbrytning (\n) i slutet av sista raden.) Textfältet countLines, där resultatet av radlängdsräkningen visas, placeras nedanför textfältet myTextField och dess text kan inte markeras. När användaren klickar på en rad i textfältet myTextField anropas metoden clickHandler().

I metoden clickHandler() returnerar metoden getLineIndexAtPoint() indexvärdet för raden användaren klickat på med koordinaterna localX och localY för musklicket. if-satsen kontrollerar om användaren har klickat på något tecken. I så fall returnerar metoden getLineLength() antalet tecken på raden med hjälp av radens indexvärde. Observera att tomma rader mellan raderna inkluderar den andra radbrytningen (\n) och har teckenantalet 1. Raden efter den sista raden har däremot teckenantalet 0. Blanksteg räknas också som tecken. Användaren kan skriva en ny rad eller ändra en rad och visa teckenantalet för raden genom att klicka på den. Om automatisk radbrytning används och skärmens storlek ändras kan radindexvärdena ändras.

 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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar måttinformation om en viss textram.

Parametrar

lineIndex:int — Radnumret som du vill ha måttinformation om.

Returnerar
flash.text:TextLineMetrics — Ett TextLineMetrics-objekt.

Utlöser
RangeError — Det angivna radnumret är utanför intervallet.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

I följande exempel visas några radvärden för två textrader med olika formatering.

Texten är två rader från Song of Myself av Walt Whitman. Ett nytt TextFormat-objekt (newFormat) används för att formatera den andra raden. Den första raden har standardformat. Metoden getLineMetrics() returnerar ett TextLineMetrics-objekt för en specifik rad. (Radindex är nollbaserade.) Med hjälp av TextLineMetrics-objekten metrics1 och metrics2 för rad ett och två hämtas och visas värden för ascent, descent, height och weight för varje rad. Resultaten konverteras till strängformat men avrundas inte. Observera att värdet är för raden och inte för specifika tecken. Det återspeglar teckenomfånget för en rad. Om en rad till exempel har olika tecken med olika höjdformat avgör det högsta tecknet värdet. Det innebär också att om något teckens format ändras kan några av mätvärdena också ändras.

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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar teckenindexvärdet för det första tecknet på raden som anges av parametern lineIndex.

Parametrar

lineIndex:int — Det nollbaserade indexvärdet för raden (den första raden är 0, den andra är 1 och så vidare).

Returnerar
int — Det nollbaserade indexvärdet för det första tecknet på raden.

Utlöser
RangeError — Det angivna radnumret är utanför intervallet.

Exempel  ( Så här använder du exemplet )

I följande exempel identifieras det första tecknet på rad 4. Tecknet ändras om skärmens (och textfältets) storlek ändras.

Textfältet myTextField ställs in på automatisk radbrytning. I textfältet countField visas det första tecknet på rad 4. När användaren klickar på textfältet myTextField anropas metoden clickHandler().

I metoden clickHandler() returnerar metoden getLineOffset() indexvärdet för det första tecknet med radindex 3, det vill säga den fjärde textraden. (Den första raden har indexvärdet 0.) Metoden charAt() används för att hämta tecknet med hjälp av indexvärdet för det första tecknet på fjärde raden. Innehållet i textfältet countField uppdateras med informationen med hjälp av egenskapen text i textfältet countField. Att egenskapen countField.text används innebär att innehållet i textfältet countField skrivs över efter varje klick. Om användaren ändrar visningsstorleken görs radbrytningar automatiskt och vilket tecken som är det första på rad 4 kan ändras. När användaren klickar på fältet myTextField igen uppdateras innehållet i textfältet countField med det nya första tecknet på fjärde raden.

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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar texten på raden som anges av parametern lineIndex.

Parametrar

lineIndex:int — Det nollbaserade indexvärdet för raden (den första raden är 0, den andra är 1 och så vidare).

Returnerar
String — Textsträngen i den angivna raden.

Utlöser
RangeError — Det angivna radnumret är utanför intervallet.

Exempel  ( Så här använder du exemplet )

I följande exempel identifieras och visas radnumren för alla instanser av ordet "love" i Shakespeares sonett.

Textfältet poem ställs automatiskt in så att texten passas och vänsterjusteras. Egenskapen wordWrap ställs in på false så att diktens rader inte bryts. I vanliga fall är detta emellertid inget problem när egenskapen autoSize används. for-slingan itererar genom raderna i sonetten med textfältetsnumLines-egenskap. Metoden getLineText() returnerar radens innehåll som en sträng. (Observera att egenskapen numLines returnerar antalet rader från och med rad 1 medan radnumret börjar med 0 i metoden getLineText().) Med hjälp av mönstret för reguljära uttryck (/love/i) identifierar if-satsen alla delsträngar av ordet med stora eller små bokstäver. Om mönstret påträffas returnerar metoden search indexvärdet för den första matchande delsträngen. Annars returneras -1 (om det inte finns någon matchning). Radnumret där "love" hittades ((i + 1)) placeras sedan i strängen lineResult. Strängmetoden konverterar sedan talargumentet ((i + 1)) till en sträng, förutsatt att det finns ett annat argument som är en sträng (" "). Radresultatet för sökningen inkluderar rader med orden "loved" eller "Love's". Om strängen "Love was found in lines:" hade lagts till före for-slingan skulle ordet "Love" på den här raden också ha inkluderats.

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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar längden på det stycke som innehåller ett givet teckenindexvärde. Längden anges i förhållande till det första tecknet i stycket (som returneras av getFirstCharInParagraph()), inte i förhållande till det teckenindexvärde som skickats.

Parametrar

charIndex:int — Det nollbaserade indexvärdet för tecknet (det första tecknet är 0, det andra är 1 och så vidare).

Returnerar
int — Returnerar antalet tecken i stycket.

Utlöser
RangeError — Det angivna teckenindexvärdet är utanför intervallet.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

I följande exempel markerar användaren ett stycke. Styckets längd och antal "s" visas i en separat text.

I textfältet myTextField visas styckena som användaren markerar. När användaren klickar på textfältet skickas händelsen MouseEvent.CLICK och metoden clickHandler() anropas. Styckets längd och antalet "s" visas i textfältet countField, som placeras nedanför textfältet myTextField.

I metoden clickHandler() returnerar metoden getCharIndexAtPoint() tecknets indexvärde baserat på koordinaterna localX och localY för musklicket. Den första if-satsen kontrollerar om användaren har klickat på något tecken. Metoden getFirstCharInParagraph() använder indexvärdet för att returnera indexvärdet för det första tecknet i samma stycke. Styckets längd returneras av metoden getParagraphLength() och används tillsammans med indexvärdet för det första tecknet i stycket för att avgöra indexvärdet för styckets slut. En for-slinga itererar genom stycket och räknar alla "s".

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

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

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

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

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

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

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

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

getTextFormat

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar ett TextFormat-objekt som innehåller formateringsinformation för textintervallet som anges av parametrarna beginIndex och endIndex. Endast egenskaper som är gemensamma för hela den angivna texten ställs in i det resulterande TextFormat-objektet. Alla egenskaper som är mixed, vilket innebär att de har olika värden på olika ställen i texten, har värdet null.

Om du inte anger värden för de här parametrarna används metoden på hela texten i textfältet.

I följande tabell beskrivs tre möjliga användningar:

AnvändningBeskrivning
my_textField.getTextFormat()Returnerar ett TextFormat-objekt som innehåller formateringsinformation för all text i ett textfält. Endast egenskaper som är gemensamma för all text i textfältet ställs in i det resulterande TextFormat-objektet. Alla egenskaper som är mixed, vilket innebär att de har olika värden på olika ställen i texten, har värdet null.
my_textField.getTextFormat(beginIndex:Number)Returnerar ett TextFormat-objekt som innehåller en kopia av tecknets textformat på positionen beginIndex.
my_textField.getTextFormat(beginIndex:Number,endIndex:Number)Returnerar ett TextFormat-objekt som innehåller formateringsinformation för hela textens omfång från beginIndex till endIndex-1. Endast egenskaper som är gemensamma för all text i det angivna omfånget ställs in i det resulterande TextFormat-objektet. Alla egenskaper som är blandade (har olika värden på olika ställen i omfånget) får värdet null.

Parametrar

beginIndex:int (default = -1) — Valfritt: ett heltal som anger startpositionen för ett textintervall i textfältet.
 
endIndex:int (default = -1) — Valfritt. Ett heltal som anger positionen för det första tecknet efter det önskade textomfånget. Om du anger värden för beginIndex och endIndex läses texten från beginIndex till endIndex-1.

Returnerar
flash.text:TextFormat — Det TextFormat-objekt som representerar den angivna textens formateringsegenskaper.

Utlöser
RangeError beginIndex eller endIndex är utanför intervallet.

Relaterade API-element


Exempel
Så här använder du exemplet
Hur metoden getTextFormat() används visas i exemplen för metoderna getFirstCharInParagraph() och setTextFormat().

isFontCompatible

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: Flash Player 10, AIR 1.5, Flash Lite 4

Returnerar true om ett inbäddat teckensnitt är tillgängligt med angivet fontName och fontStyle, där Font.fontType är flash.text.FontType.EMBEDDED. Flash Player 10 har två olika inbäddade teckensnitt som kan visas i en SWF-fil. Normalt inbäddade teckensnitt används endast med TextField-objekt. CFF-inbäddade teckensnitt används endast med klasserna flash.text.engine. De två typerna skiljer sig åt genom fontType-egenskapen för klassen Font, som returneras av funktionen enumerateFonts().

TextField kan inte använda ett teckensnitt av typen EMBEDDED_CFF. Om embedFonts är inställt på true, och det enda teckensnitt som är tillgängligt vid körning med det namn och format som anges är av typen EMBEDDED_CFF, kan Flash Player inte återge texten (som om det inte fanns något inbäddat teckensnitt med det angivna namnet och formatet).

Om både EMBEDDED- och EMBEDDED_CFF-teckensnitten finns tillgängliga med samma namn och stil, kommer EMBEDDED-teckensnittet att väljas och texten kommer att renderas med teckensnittet EMBEDDED.

Parametrar

fontName:String — Namnet på det inbäddade teckensnittet ska undersökas.
 
fontStyle:String — Specificerar det teckensnitt som ska undersökas. Använd flash.text.FontStyle

Returnerar
Booleantrue om ett kompatibelt inbäddat teckensnitt är tillgängligt, i annat fall false.

Utlöser
ArgumentError — Angivet fontStyle är inte medlem av flash.text.FontStyle.

Relaterade API-element

replaceSelectedText

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Ersätter markeringen med innehållet i parametern value. Texten infogas i markeringens position med standardteckenformatet och standardstyckeformatet. Texten behandlas inte som HTML.

Du kan använda metoden replaceSelectedText() för att infoga och ta bort text utan att störa tecken- och styckeformateringen i resten av texten.

Obs!Metoden fungerar inte om en formatmall används på textfältet.

Parametrar

value:String — Den sträng som ska ersätta den markerade texten.


Utlöser
Error — Metoden kan inte användas på ett textfält med en formatmall.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

I följande exempel raderar användaren text från det första textfältet genom att markera den och ersätter en markerad text i det andra textfältet med strängen "NEW TEXT".

Två olika TextField-objekt skapas och händelseavlyssnare läggs till för MouseEvent.MOUSE_UP-händelserna. Händelsen inträffar när användaren släpper musknappen. Det sker vanligen efter en textmarkering. Observera att standardinställningen för ett textfält är att dess text ska vara markerad.

När en användare släpper musknappen över textfältet myTextField1 i metoden mouseHandler1(), raderas texten genom att den ersätts med en tom sträng. Detta kan fortsätta tills all text har raderats. När en användare markerar text i textfältet myTextField2 kontrolleras egenskaperna selectionBeginIndex och selectionEndIndex i metoden mouseHandler2() för att se om något tecken markerats. (Egenskaperna selectionBeginIndex och selectionEndIndex har inte samma värde om någon text är markerad.) Den markerade texten ersätts sedan av strängen "NEW TEXT". Detta kan fortsätta tills all ursprunglig text i det ursprungliga textfältet har ersatts av strängen "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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Ersätter teckenintervallet som anges av parametrarna beginIndex och endIndex med innehållet i parametern newText. Texten från beginIndex till endIndex-1 ersätts.

Obs!Metoden fungerar inte om en formatmall används på textfältet.

Parametrar

beginIndex:int — Det nollbaserade indexvärdet för ersättningsintervallets startposition.
 
endIndex:int — Den nollbaserade indexpositionen för det första tecknet i det önskade textomfånget.
 
newText:String — Den text som ska användas för att ersätta det angivna teckenintervallet.


Utlöser
Error — Metoden kan inte användas på ett textfält med en formatmall.

Exempel  ( Så här använder du exemplet )

I följande exempel används metoden replaceText() för att ta bort, ersätta och infoga text i ett textfält.

Textfältet outputText ställs automatiskt in så att texten passas och vänsterjusteras. I det första anropet till metoden replaceText() ersätts den första raden ("This is the wrong heading") med "THIS IS THE HEADING FOR EVERYONE." I det andra anropet till metoden infogas texten "CORRECT" mellan "THE" och "HEADING". I det tredje anropet till metoden tas orden "FOR EVERYONE" bort. Observera att den aktuella textens start- och slutindex ändras för varje anrop till metoden appendText(). Här visas bara den slutliga texten (efter alla ändringar).

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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Anges som markerad text som definierats av indexvärdena för det första och sista tecknet, som anges med parametrarna beginIndex och endIndex. Om de två parametervärdena är desamma anger den här metoden en inmatningspunkt, precis som om egenskapen caretIndex anges.

Parametrar

beginIndex:int — Det nollbaserade indexvärdet för det första tecknet i markeringen (det första tecknet är 0, det andra är 1 och så vidare).
 
endIndex:int — Det nollbaserade indexvärdet för det sista tecknet i markeringen.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

I följande exempel markeras ett fördefinierat textintervall när användaren klickar var som helst i textfältet (orden "TEXT IN ALL CAPS" markeras).

Två händelseavlyssnare för textfältet myTextField avlyssnar användarens musklick eller mussläpp. Mussläpp inträffar när användaren släpper musknappen. Det sker vanligen efter en textmarkering. Observera att standardinställningen för ett textfält är att dess text ska vara markerad. När användaren klickar på någon text anropas metoden clickHandler(). När text har markerats och musen släpps anropas metoden mouseUpHandler().

I både clickHandler() och mouseUpHandler() ställer metoden setSelection() bara in tecknen mellan indexvärde 54 och 70 (TEXT IN ALL CAPS) på att markeras.

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

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Använder textformateringen som angetts av format-parametern på den angivna texten i ett textfält. Värdet för format måste vara ett TextFormat-objekt som anger de önskade textformateringsändringarna. Endast de egenskaper som inte har värdet null i format används på textfältet. Inga format-egenskaper som är inställda på null används. Som standard ställs alla egenskaper i ett nyligen skapat TextFormat-objekt in på null.

Obs!Metoden fungerar inte om en formatmall används på textfältet.

Metoden setTextFormat() ändrar textformateringen som används för ett intervall med tecken eller för hela texten i ett textfält. Om du vill använda formategenskaperna på all text i textfältet ska du inte ange värden för beginIndex och endIndex. Om du vill använda formategenskaperna på ett textintervall anger du värden för parametrarna beginIndex och endIndex. Du kan använda length-egenskapen för att fastställa indexvärden.

De två typerna av formateringsinformation i ett TextFormat-objekt är formatering på teckennivå och på styckenivå. Varje tecken i ett textfält kan ha egna teckenformateringsinställningar, till exempel teckensnittsnamn, teckensnittsstorlek, fet stil och kursiv stil.

I stycken undersöks det första tecknet i stycket för att se om det finns styckeformateringsinställningar för hela stycket. Exempel på styckeformateringsinställningar är vänstermarginal, högermarginal och indrag.

All text som infogas manuellt av användaren eller ersätts med hjälp av metoden replaceSelectedText() får textfältets standardformatering för ny text, inte formateringen som har angetts för textens inmatningspunkt. Du ställer in standardformateringen för ny text med defaultTextFormat.

Parametrar

format:flash.text:TextFormat — Ett TextFormat-objekt som innehåller tecken och styckeformateringsinformation.
 
beginIndex:int (default = -1) — Valfritt. Ett heltal som anger den nollbaserade indexpositionen som anger det första tecknet i det önskade textintervallet.
 
endIndex:int (default = -1) — Valfritt. Ett heltal som anger det första tecknet efter det önskade textomfånget. Om du anger värden för beginIndex och endIndex uppdateras texten från beginIndex till endIndex-1.

AnvändningBeskrivning
my_textField.setTextFormat(textFormat:TextFormat)Tillämpar textFormat-egenskaperna på all text i textfältet.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int)Använder textFormat-egenskaperna på texten som startar med positionen beginIndex.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int, endIndex:int)Tillämpar textFormat-parameterns egenskaper på hela texten, från beginIndex-positionen till endIndex-1-positionen.

Observera att all text som infogas manuellt av användaren eller ersätts med hjälp av metoden replaceSelectedText() får textfältets standardformatering för ny text, inte formateringen som har angetts för textens inmatningspunkt. Om du vill ställa in ett textfälts standardformatering för ny text använder du egenskapen defaultTextFormat.


Utlöser
Error — Metoden kan inte användas på ett textfält med en formatmall.
 
RangeError beginIndex eller endIndex är utanför intervallet.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

I följande exempel växlas formatet för ett fördefinierat textintervall, "TEXT IN ALL CAPS", mellan standardtextformatet och det nya formatet när användaren klickar på texten.

En händelseavlyssnare för textfältet myTextField läggs till för att avlyssna musklick och anropa metoden clickHandler(). I metoden clickHandler() returnerar metoden getTextFormat() det nuvarande formatet för ett tecken (indexvärde 55) från det avsedda textintervallet. Formatet placeras sedan i TextFormat-objektet currentTextFormat. if-satsen avläser textformatet currentTextFormat för att se om tecknet i intervallet har det nya formatet (18 punkters textstorlek). Om det inte har det ändras det nya formatet till 18 punkters storlek, färgen ändras till röd och texten stryks under och görs kursiv i intervallet 54 till 70 (TEXT IN ALL CAPS). Om tecknet i intervallet har det nya formatet återställs intervallet till textfältets standardformat.

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);
            }    
        }    
    }
}
Händelsedetaljer

change

Händelse
Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.CHANGE

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Skickas efter att ett kontrollvärde har modifierats, till skillnad från textInput-händelsen som skickas innan värdet är modifierat. I W3C DOM Event Model-versionen av change-händelsen skickas händelsen när kontrollen har förlorat fokus, medan change-händelsen i ActionScript 3.0-versionen skickas närhelst kontrollen ändras. Om till exempel en användare skriver in text i ett fält skickas en change-händelse efter varje tangenttryckning.

Event.CHANGE-konstanten definierar värdet på type-egenskapen i ett change-händelseobjekt.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblestrue
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetObjektet vars värde har modifierats. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen.

Exempel  ( Så här använder du exemplet )

I följande exempel kopieras den text som användaren anger (användarindata) direkt till ett annat textfält med ett annat textformat.

Två textfält skapas. Det ena är för användarens indata och det andra (headingTextField) är för kopian av användarens indata. Dessutom skapas ett TextFormat-objekt och standardtextformatet tilldelas textfältet headingTextField. När textfältets innehåll ändras anropas metoden changeHandler(). Den tilldelar texten i textfältet inputTextField till textfältet headingTextField. (Om metoden anropades för händelsen TextEvent.TEXT_INPUT och inte för händelsen Event.CHANGE, kopieras innehållet i användarindata först efter att användaren har angett mer text.)

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

Händelse  
Typ av händelseobjekt: flash.events.TextEvent
egenskap TextEvent.type = flash.events.TextEvent.LINK

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Skickas när en användare klickar på en hyperlänk i ett HTML-aktiverat textfält där URL-adressen börjar på "event". Det som återstår av URL:en efter ”event:” placeras i textegenskapen i LINK-händelsen.

Obs! Standardbeteendet att texten läggs till i textfältet inträffar bara när Flash Player genererar händelsen, vilket i detta fall sker när en användare försöker skriva in text. Du kan inte ange text i ett textfält genom att skicka textInput-händelser.

Definierar värdet för ett link-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblestrue
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetTextfältet som innehåller den hyperlänk användaren har klickat på. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen.
textDet som återstår av URL:en efter "event:"

Exempel  ( Så här använder du exemplet )

I följande exempel definieras funktionen playMP3(). Ett TextField-objekt med namnet list skapas och fylls i med HTML-text. Texten "Track 1" och "Track 2" är länkar inuti textfältet. Funktionen playMP3() anropas när användaren klickar på en av länkarna. Namnet på MP3-filen som följs av strängen "event:" i HTML-taggens href-attribut, skickas till metoden linkHandler() som text-egenskap i händelseobjektet 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

Händelse  
Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.SCROLL

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Skickas av ett TextField-objekt efter att användaren rullat.

Event.SCROLL-konstanten definierar värdet på type-egenskapen i ett scroll-händelseobjekt.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblesfalse
cancelablefalse; det finns inget standardbeteende att avbryta.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetDet TextField-objekt som har rullats. target-egenskapen är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen.

Exempel  ( Så här använder du exemplet )

I följande exempel definieras två TextField-objekt. Det första TextField-objektet har två associerade händelsehanterare. När du klickar med musen i det första textfältet skickas mouseDown-händelsen och den associerade mouseDownScroll-hanteraren anropas. mouseDownScroll()-hanteraren gör att fältet rullar. Därefter skickas scroll-händelsen, och den associerade scrollHandler()-hanteraren uppdaterar det andra textfältet för att visa den aktuella rullningspositionen.
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

Händelse  
Typ av händelseobjekt: flash.events.TextEvent
egenskap TextEvent.type = flash.events.TextEvent.TEXT_INPUT

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Flash Player skickar textInput-händelsen när en användare anger ett eller fler texttecken. Olika textinmatningsmetoder kan utlösa den här händelsen, inklusive standardtangentbord, redigeringsprogram för inmatningsmetod (IME), röst- eller taligenkänningssystem och till och med åtgärden att klistra in oformaterad text utan formatinformation.

Definierar värdet för ett textInput-händelseobjekts type-egenskap.

Obs! Den här händelsen skickas inte för Delete- och backstegstangenterna.

Den här händelsen har följande egenskaper:

EgenskapVärde
bubblestrue
cancelabletrue; anropa preventDefault()-metoden för att avbryta standardbeteendet.
currentTargetDet objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
targetDet textfält som tecken anges i. Målet är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen.
textDet tecken eller den följd av tecken som användaren har angivit.

Exempel  ( Så här använder du exemplet )

I följande exempel definieras två TextField-objekt: det första TextField-objektet är ett textinmatningsfält och det andra TextField-objektet är ett dynamiskt textfält. När du skriver text i det första textfältet skickas textInput-händelsen, textInputHandler()-hanteraren anropas och tecknen visas i det andra textfältet. När du klistrar in ett textblock i inmatningsfältet kopierar händelsehanteraren hela blocket till det andra fältet.
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

Händelse  
Typ av händelseobjekt: flash.events.Event

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 11, Flash Lite 4

Flash Player skickar textInteractionModeChange-händelsen när en användare ändrar interaktionsläget för ett textfält. På Android kan du till exempel växla från läget NORMAL till SELECTION med hjälp av alternativ på snabbmenyn

TextFieldExample.as

I följande exempel används klassen TextFieldExample för att visa ett textmeddelande. Detta sker genom följande steg:
  1. En label-egenskap av typen TextField skapas.
  2. Klasskonstruktorn anropar funktionen configureLabel().
  3. Metoden configureLabel() skapar först ett nytt TextField-objekt och kopplar det till egenskapen label och ställer sedan in sina parametrar på följande:
    • Vänsterjustera textfältet.
    • Aktivera bakgrundsfyllningen.
    • Aktivera kantlinjen.
  4. Metoden configureLabel() skapar variabeln format och kopplar den till en ny TextFormat-instans med parametrarna inställda på följande:
    • Font type = Verdana
    • Font color = solid red
    • Font size = 10
    • Font underline = true
  5. Egenskapen defaultTextFormat i textfältet label är inställt på format och label-instansen läggs till i visningslistan som först visar ett textfält utan text på scenen.
  6. Konstruktorn anger texten i textfältet label till "Hello world and welcome to the show." genom att anropa metoden setLabel().
package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.text.TextFormat;


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

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

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

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

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

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




[ X ]Varför på engelska?
Innehåll i Referenshandbok för ActionScript 3.0 i Adobe Flash-plattformen är på engelska

Det är inte alla delar av Referenshandbok för ActionScript 3.0 i Adobe Flash-plattformen som översätts till alla språk. Om ett språkelement inte översätts visas det på engelska. Klassen ga.controls.HelpBox översätts till exempel inte till något språk. I den svenska versionen av referenshandboken visas därför klassen ga.controls.HelpBox på engelska.