ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: AIR 30.0 und früher, Flash Player 30.0 und früher, Flash Lite 4
Flex 4.6 und früher, Flash Pro CS6 und früher
Filter ausblenden
flash.text 

TextField  - AS3

Paketex

Oberste Ebene
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

Sprachelemente

Globale Konstanten
Globale Funktionen
Operatoren
Anweisungen, Schlüsselwörter und Direktiven
Sondertypen

Anhänge

Neue Funktionen
Compiler-Fehler
Compiler-Warnungen
Laufzeitfehler
Migration zu ActionScript 3
Unterstützte Zeichensätze
Nur MXML-Tags
Motion-XML-Elemente
Timed Text-Tags
Liste veralteter Elemente
Konstanten für die Implementierung von Eingabehilfen
Verwendung der ActionScript-Beispiele
Rechtliche Hinweise
Paketflash.text
Klassepublic class TextField
VererbungTextField Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Unterklassen FlexTextField

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die TextField-Klasse dient zum Erstellen von Anzeigeobjekten für die Texteingabe und -anzeige. Sie können einem Textfeld im Eigenschafteninspektor einen Instanznamen zuweisen und es mit den Methoden und Eigenschaften der TextField-Klasse per ActionScript bearbeiten. TextField-Instanznamen erscheinen im Film-Explorer und im Dialogfeld „Zielpfad einfügen“ des Aktionenbedienfelds.

Verwenden Sie zur dynamischen Erstellung eines Textfelds den Konstruktor TextField().

Mit den Methoden der TextField-Klasse können Sie Text in dynamischen Textfeldern oder Eingabetextfeldern, die Sie beim Authoring oder zur Laufzeit erstellen, festlegen, auswählen und ändern.

ActionScript bietet mehrere Möglichkeiten, Text zur Laufzeit zu formatieren. Mit der TextFormat-Klasse können Sie die Zeichen- und Absatzformatierung für TextField-Objekte festlegen. Sie können mit der Eigenschaft TextField.styleSheet und der StyleSheet-Klasse Cascading Style Sheets (CSS)-Stile auf Textfelder anwenden. Über CSS können integrierte HTML-Tags geändert, neue Formatierungstags definiert oder Stile angewendet werden. Sie können HTML-formatierten Text, der optional CSS-Stile verwendet, direkt einem Textfeld zuweisen. HTML-Text, den Sie einem Textfeld zuweisen, kann eingebettete Medien (Movieclips, SWF-, GIF-, PNG- und JPEG-Dateien) enthalten. Der Text umgibt die eingebetteten Medien. Dies ist mit der Art vergleichbar, in der Text in einem Webbrowser die in einem HTML-Dokument eingebetteten Medien umgibt.

Flash Player unterstützt einige HTML-Tags zum Formatieren von Text. Eine Liste der unterstützten HTML-Tags finden Sie in der Beschreibung der Eigenschaft htmlText.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedaccessibilityImplementation : AccessibilityImplementation
Die aktuelle Eingabehilfenimplementierung (AccessibilityImplementation) für diese InteractiveObject-Instanz.
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
Die aktuellen Optionen für Eingabehilfen zur Barrierefreiheit dieses Anzeigeobjekts.
DisplayObject
 Inheritedalpha : Number
Gibt den Alphatransparenzwert des angegebenen Objekts an.
DisplayObject
  alwaysShowSelection : Boolean
Wenn sich das Textfeld bei Einstellung „true“ nicht im Fokus befindet, markiert Flash Player die Auswahl im Textfeld in grau.
TextField
  antiAliasType : String
Der für dieses Textfeld verwendete Anti-Aliasing-Typ.
TextField
  autoSize : String
Steuert die automatische Größenänderung und Ausrichtung von Textfeldern.
TextField
  background : Boolean
Gibt an, ob das Textfeld einen gefüllten Hintergrund aufweist.
TextField
  backgroundColor : uint
Gibt die Hintergrundfarbe des Textfelds an.
TextField
 InheritedblendMode : String
Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll.
DisplayObject
 InheritedblendShader : Shader
[Nur Schreiben] Legt einen Shader fest, der für das Mischen von Vordergrund und Hintergrund verwendet wird.
DisplayObject
  border : Boolean
Gibt an, ob das Textfeld umrahmt ist.
TextField
  borderColor : uint
Gibt die Farbe des Textfeldrahmens an.
TextField
  bottomScrollV : int
[schreibgeschützt] Eine Ganzzahl (Index mit Basis 1), die die unterste der im angegebenen Textfeld sichtbaren Zeilen angibt.
TextField
 InheritedcacheAsBitmap : Boolean
Wird diese Eigenschaft auf „true“ gesetzt, speichern Flash-Laufzeitumgebungen eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache.
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
Bei einem Nicht-Null-Wert definiert dieses Matrix-Objekt, wie ein Anzeigeobjekt dargestellt wird, wenn cacheAsBitmap auf „true“ gesetzt ist.
DisplayObject
  caretIndex : int
[schreibgeschützt] Der Index der Position der Einfügemarke.
TextField
  condenseWhite : Boolean
Ein boolescher Wert, der angibt, ob zusätzliche Leerräume (beispielsweise Leerzeichen oder Zeilenumbrüche) aus einem Textfeld mit HTML-Text entfernt werden sollen.
TextField
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcontextMenu : NativeMenu
Gibt das diesem Objekt zugeordnete Kontextmenü an.
InteractiveObject
  defaultTextFormat : flash.text:TextFormat
Legt das Format fest, das auf neu eingefügten Text (z. B. von einem Benutzer eingegebener Text oder Text, der mit der replaceSelectedText()-Methode eingefügt wird) angewendet wird.
TextField
  displayAsPassword : Boolean
Gibt an, ob es sich um ein Kennworttextfeld handelt.
TextField
 InheriteddoubleClickEnabled : Boolean
Gibt an, ob das Objekt doubleClick-Ereignisse empfängt.
InteractiveObject
  embedFonts : Boolean
Gibt an, ob bei der Wiedergabe eingebettete Schriftkonturen verwendet werden sollen.
TextField
 Inheritedfilters : Array
Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält.
DisplayObject
 InheritedfocusRect : Object
Gibt an, ob für dieses Objekt ein Fokusrechteck angezeigt wird.
InteractiveObject
  gridFitType : String
Die für dieses Textfeld verwendete Art der Rasteranpassung.
TextField
 Inheritedheight : Number
Gibt die Höhe des Anzeigeobjekts in Pixeln an.
DisplayObject
  htmlText : String
Enthält die HTML-Darstellung des Inhalts des Textfelds.
TextField
  length : int
[schreibgeschützt] Die Anzahl der Zeichen in einem Textfeld.
TextField
 InheritedloaderInfo : LoaderInfo
[schreibgeschützt] Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört.
DisplayObject
 Inheritedmask : DisplayObject
Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert.
DisplayObject
  maxChars : int
Die von einem Benutzer festgelegte maximale Anzahl von Zeichen, die das Textfeld enthalten kann.
TextField
  maxScrollH : int
[schreibgeschützt] Der maximale Wert der Eigenschaft „scrollH“.
TextField
  maxScrollV : int
[schreibgeschützt] Der maximale Wert der Eigenschaft „scrollV“.
TextField
 InheritedmetaData : Object
Bezieht das Metadatenobjekt der DisplayObject-Instanz, wenn Metadaten neben der Instanz dieses DisplayObject in der SWF-Datei durch ein PlaceObject4-Tag gespeichert wurden.
DisplayObject
 InheritedmouseEnabled : Boolean
Gibt an, ob dieses Objekt Meldungen von der Maus oder einem anderen Benutzereingabegerät empfängt.
InteractiveObject
  mouseWheelEnabled : Boolean
Ein boolescher Wert, der angibt, ob Flash Player für mehrzeilige Textfelder automatisch einen Bildlauf durchführt, wenn der Benutzer ein Textfeld anklickt und das Mausrad dreht.
TextField
 InheritedmouseX : Number
[schreibgeschützt] Gibt die x-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an.
DisplayObject
 InheritedmouseY : Number
[schreibgeschützt] Gibt die y-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an.
DisplayObject
  multiline : Boolean
Gibt an, ob das Feld ein mehrzeiliges Textfeld ist.
TextField
 Inheritedname : String
Gibt den Instanznamen des Anzeigeobjekts an.
DisplayObject
 InheritedneedsSoftKeyboard : Boolean
Gibt an, ob eine virtuelle Tastatur (Bildschirmtastatur) angezeigt wird, wenn diese InteractiveObject-Instanz den Fokus erhält.
InteractiveObject
  numLines : int
[schreibgeschützt] Gibt die Anzahl der Textzeilen in einem mehrzeiligen Textfeld an.
TextField
 InheritedopaqueBackground : Object
Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[schreibgeschützt] Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält.
DisplayObject
  restrict : String
Gibt die Zeichen an, die ein Benutzer in das Textfeld eingeben kann.
TextField
 Inheritedroot : DisplayObject
[schreibgeschützt] Bei einem Anzeigeobjekt in einer geladenen SWF-Datei ist die root-Eigenschaft das oberste Anzeigeobjekt in dem Teil der Baumstruktur der Anzeigeliste, der diese SWF-Datei repräsentiert.
DisplayObject
 Inheritedrotation : Number
Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an.
DisplayObject
 InheritedrotationX : Number
Gibt die x-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container.
DisplayObject
 InheritedrotationY : Number
Gibt die y-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container.
DisplayObject
 InheritedrotationZ : Number
Gibt die Drehung der z-Achse der DisplayObject-Instanz in Grad an, ausgehend von ihrer ursprünglichen Ausrichtung relativ zum übergeordneten 3D-Container.
DisplayObject
 Inheritedscale9Grid : Rectangle
Das aktuell verwendete Skalierungsraster.
DisplayObject
 InheritedscaleX : Number
Gibt die horizontale Skalierung (Prozentwert) des Objekts ausgehend vom Registrierungspunkt an.
DisplayObject
 InheritedscaleY : Number
Gibt die vertikale Skalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an.
DisplayObject
 InheritedscaleZ : Number
Gibt die Tiefenskalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an.
DisplayObject
  scrollH : int
Die aktuelle horizontale Bildlaufposition.
TextField
 InheritedscrollRect : Rectangle
Die Begrenzungen des Bildlaufrechtecks für das Anzeigeobjekt.
DisplayObject
  scrollV : int
Die vertikale Textposition in einem Textfeld.
TextField
  selectable : Boolean
Ein boolescher Wert, der angibt, ob das Textfeld ausgewählt werden kann.
TextField
  selectionBeginIndex : int
[schreibgeschützt] Der auf null basierende Zeichenindexwert des ersten Zeichens in der aktuellen Auswahl.
TextField
  selectionEndIndex : int
[schreibgeschützt] Der auf null basierende Indexwert des letzten Zeichens in der aktuellen Auswahl.
TextField
  sharpness : Number
Die Schärfe der Glyphenkanten in diesem Textfeld.
TextField
 Inherited    softKeyboard : String
Steuert das Erscheinungsbild der Bildschirmtastatur.
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
Definiert einen Bereich, der auf dem Bildschirm sichtbar bleiben soll, wenn eine virtuelle Tastatur angezeigt wird (nicht unter iOS verfügbar).
InteractiveObject
 Inheritedstage : Stage
[schreibgeschützt] Die Bühne des Anzeigeobjekts.
DisplayObject
  styleSheet : StyleSheet
Fügt ein Stylesheet an das Textfeld an.
TextField
 InheritedtabEnabled : Boolean
Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet.
InteractiveObject
 InheritedtabIndex : int
Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an.
InteractiveObject
  text : String
Ein String, bei dem es sich um den aktuellen Text im Textfeld handelt.
TextField
  textColor : uint
Die Farbe des Textes in einem Textfeld (im Hexadezimalformat).
TextField
  textHeight : Number
[schreibgeschützt] Die Höhe des Texts in Pixel.
TextField
  textInteractionMode : String
[schreibgeschützt] Die Interaktionsmodus-Eigenschaft; der Standardwert ist TextInteractionMode.NORMAL.
TextField
  textWidth : Number
[schreibgeschützt] Die Breite des Texts in Pixel.
TextField
  thickness : Number
Die Stärke der Glyphenkanten in diesem Textfeld.
TextField
 Inheritedtransform : flash.geom:Transform
Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören.
DisplayObject
  type : String
Der Typ des Textfelds.
TextField
  useRichTextClipboard : Boolean
Gibt an, ob beim Kopieren und Einfügen auch die Textformatierung übernommen wird.
TextField
 Inheritedvisible : Boolean
Gibt an, ob das Anzeigeobjekt sichtbar ist oder nicht.
DisplayObject
 Inheritedwidth : Number
Gibt die Breite des Anzeigeobjekts in Pixeln an.
DisplayObject
  wordWrap : Boolean
Ein boolescher Wert, der angibt, ob im Textfeld ein Zeilenumbruch durchgeführt wird.
TextField
 Inheritedx : Number
Gibt die x-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an.
DisplayObject
 Inheritedy : Number
Gibt die y-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an.
DisplayObject
 Inheritedz : Number
Gibt die z-Koordinatenposition an der z-Achse der DisplayObject-Instanz relativ zum übergeordneten 3D-Container an.
DisplayObject
Öffentliche Methoden
 MethodeDefiniert von
  
Erstellt eine neue TextField-Instanz.
TextField
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
  
Hängt den vom Parameter „newText“ angegebenen String an das Ende des Texts im Textfeld an.
TextField
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert.
DisplayObject
  
Gibt ein Rechteck zurück, das die Begrenzungsbox für das Zeichen darstellt.
TextField
  
Gibt den auf null basierenden Indexwert des Zeichens an dem von den Parametern x und y angegebenen Punkt zurück.
TextField
  
Gibt anhand eines Zeichenindex den Index des ersten Zeichens im gleichen Absatz zurück.
TextField
  
Gibt einen DisplayObject-Verweis für die jeweilige ID, ein Bild oder eine SWF-Datei zurück, die bzw. das einem HTML-formatierten Textfeld über ein <img>-Tag hinzugefügt wurde.
TextField
  
Gibt den auf null basierenden Indexwert des Zeichens an dem von den Parametern x und y angegebenen Punkt zurück.
TextField
  
Gibt den auf null basierenden Indexwert der Zeile zurück, die das vom Parameter „charIndex“ angegebene Zeichen enthält.
TextField
  
getLineLength(lineIndex:int):int
Gibt die Zeichenanzahl in einer bestimmten Textzeile zurück.
TextField
  
Gibt metrische Informationen zu einer bestimmten Textzeile zurück.
TextField
  
getLineOffset(lineIndex:int):int
Gibt den Zeichenindex des ersten Zeichens in der vom Parameter „lineIndex“ angegebenen Zeile zurück.
TextField
  
Gibt den Text der durch den Parameter „lineIndex“ angegebenen Zeile zurück.
TextField
  
Gibt anhand eines Zeichenindex die Länge des Absatzes mit dem angegebenen Zeichen zurück.
TextField
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Gibt ein Rechteck zurück, das die Begrenzung des Anzeigeobjekts (ohne etwaige Striche oder Formen) definiert, und zwar aufgrund des vom Parameter „targetCoordinateSpace“ definierten Koordinatensystems.
DisplayObject
  
getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Gibt ein TextFormat-Objekt mit Formatierungsinformationen für den durch die Parameter „beginIndex“ und „endIndex“ angegebenen Textbereich zurück.
TextField
 Inherited
Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts.
DisplayObject
 Inherited
Konvertiert einen zweidimensionale Punkt von den (globalen) Bühnenkoordinaten in die dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts.
DisplayObject
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Untersucht den Begrenzungsrahmen des Anzeigeobjekts, um festzustellen, ob er sich mit dem Begrenzungsrahmen des obj-Anzeigeobjekts überschneidet.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter „x“ und „y“ festgelegten Punkt überdeckt oder schneidet.
DisplayObject
  
isFontCompatible(fontName:String, fontStyle:String):Boolean
[statisch] Gibt „true“ zurück, wenn eine eingebettete Schriftart mit dem angegebenen fontName und fontStyle verfügbar ist, wobei Font.fontType gleich flash.text.FontType.EMBEDDED ist.
TextField
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Konvertiert einen dreidimensionalen Punkt der dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts in einen zweidimensionalen Punkt der (globalen) Bühnenkoordinaten.
DisplayObject
 Inherited
Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten.
DisplayObject
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
  
Ersetzt die aktuelle Auswahl durch den Inhalt des Parameters „value“.
TextField
  
replaceText(beginIndex:int, endIndex:int, newText:String):void
Ersetzt den Zeichenbereich, der durch die Parameter „beginIndex“ und „endIndex“ angegeben wird, durch den Inhalt des Parameters „newText“.
TextField
 Inherited
Blendet eine virtuelle Tastatur ein.
InteractiveObject
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
setSelection(beginIndex:int, endIndex:int):void
Legt den durch die Indexwerte des ersten und letzten Zeichens (Parameter „beginIndex und „endIndex“) angegebenen Text als ausgewählt fest.
TextField
  
setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Weist dem angegebenen Text in einem Textfeld die mit dem Parameter „format“ angegebene Textformatierung zu.
TextField
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 InheritedWird ausgelöst, wenn ein Objekt der Anzeigeliste hinzugefügt wird.DisplayObject
 InheritedWird ausgelöst, wenn ein Anzeigeobjekt der Anzeigeliste für die Bühne hinzugefügt wird. Dies erfolgt entweder direkt oder über das Hinzufügen einer Unterstruktur, die das Anzeigeobjekt enthält.DisplayObject
  Wird ausgelöst, nachdem ein Steuerelementwert geändert wurde (im Gegensatz zum textInput-Ereignis, das ausgelöst wird, bevor der Wert geändert wird).TextField
 InheritedWird ausgelöst, wenn der Benutzer aus dem Kontextmenü die Option „Löschen“ wählt.InteractiveObject
 InheritedWird ausgelöst, wenn ein Benutzer die Haupttaste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und wieder loslässt.InteractiveObject
 Inherited
    contextMenu
Wird ausgelöst, wenn der Benutzer das Kontextmenü, das mit diesem interaktiven Objekt verknüpft ist, in einer AIR-Anwendung einblendet.InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Kopieren“ aktiviert oder im Kontextmenü des Texts „Kopieren“ wählt.InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Ausschneiden“ aktiviert oder im Kontextmenü des Texts „Ausschneiden“ wählt.InteractiveObject
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
 InheritedWird ausgelöst, wenn der Benutzer die Haupttaste des Zeigegeräts zweimal schnell hintereinander über dem gleichen InteractiveObject-Objekt drückt und das doubleClickEnabled-Flag des Objekts „true“ lautet.InteractiveObject
 Inherited[broadcast event] Wird ausgelöst, wenn der Abspielkopf ein neues Bild erreicht.DisplayObject
 Inherited[broadcast event] Wird ausgelöst, wenn der Abspielkopf das aktuelle Bild verlässt.DisplayObject
 InheritedWird ausgelöst, nachdem ein Anzeigeobjekt den Fokus erhalten hat.InteractiveObject
 InheritedWird ausgelöst, nachdem ein Anzeigeobjekt den Fokus verloren hat.InteractiveObject
 Inherited[broadcast event] Wird ausgelöst, nachdem die Konstruktoren von Bildanzeigeobjekten ausgeführt wurden, bevor Bildskripten ausgeführt wurden.DisplayObject
 InheritedWird abgesetzt, wenn der Benutzer einen Kontaktpunkt entlang der Kante der Touch-Oberfläche mit einer InteractiveObject-Instanz erstellt (z. B. durch Tippen entlang der Kante der Touch-Oberfläche auf Siri Remote für Apple TV). Bei einigen Geräten könnte dieser Kontakt auch als eine Kombination von verschiedenen Kontaktereignissen ausgelegt werden.InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer auf zwei Kontaktpunkte über derselben InteractiveObject-Instanz auf einem berührungsempfindlichen Gerät drückt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen zwei Finger auf ein Anzeigeobjekt drückt und wieder loslässt).InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer einen Berührungspunkt über die InteractiveObject-Instanz auf einem berührungsempfindlichen Gerät bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger über ein Anzeigeobjekt von links nach rechts bewegt).InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer eine Drehgeste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit zwei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann über einem Anzeigeobjekt dreht).InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer eine Swipe-Geste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit drei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann parallel über ein Anzeigeobjekt bewegt).InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer einen Kontaktpunkt mit einer InteractiveObject-Instanz erstellt und dann auf ein berührungsempfindliches Gerät tippt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen mehrere Finger auf einem Anzeigeobjekt platziert, um ein Menü zu öffnen, und dann mit einem Finger tippt, um einen Menüpunkt auszuwählen).InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer eine Zoom-Geste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit zwei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann schnell über einem Anzeigeobjekt spreizt).InteractiveObject
 InheritedDieses Ereignis wird an jede Client-Anwendung abgesetzt, die die Inline-Eingabe mit einem IME unterstütztInteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer eine Taste drückt.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe der Tastatur zu ändern.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer eine Taste loslässt.InteractiveObject
  Wird ausgelöst, wenn ein Benutzer auf einen Hyperlink in einem HTML-fähigen Textfeld klickt und die URL-Adresse mit „event:“ beginnt.TextField
 InheritedWird ausgelöst, wenn der Benutzer die mittlere Taste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und loslässt.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer die mittlere Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe eines Zeigegeräts zu ändern.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer das Zeigegerät bewegt, während es sich auf einer InteractiveObject-Instanz befindet.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt.InteractiveObject
 InheritedWird ausgelöst, wenn das Mausrad über einer InteractiveObject-Instanz gedreht wird.InteractiveObject
 InheritedWird vom InteractiveObject-Ziehinitiator ausgelöst, wenn der Benutzer die Ziehbewegung beendet.InteractiveObject
 InheritedWird vom InteractiveObject-Zielobjekt ausgelöst, wenn ein gezogenes Objekt darauf abgelegt wird und das Ablegen mit einem Aufruf von „DragManager.acceptDragDrop()“ akzeptiert wurde.InteractiveObject
 InheritedWird von einer InteractiveObject-Instanz ausgelöst, wenn eine Ziehbewegung in ihre Begrenzungen eintritt.InteractiveObject
 InheritedWird von einer InteractiveObject-Instanz ausgelöst, wenn eine Ziehbewegung ihre Begrenzungen verlässt.InteractiveObject
 InheritedWird von einer InteractiveObject-Instanz kontinuierlich ausgelöst, während eine Ziehbewegung innerhalb ihrer Begrenzungen verbleibt.InteractiveObject
 InheritedWird am Anfang eines Ziehvorgangs von der InteractiveObject-Instanz ausgelöst, die als Ziehinitiator im DragManager.doDrag()-Aufruf festgelegt ist.InteractiveObject
 InheritedWird während eines Ziehvorgangs von der InteractiveObject-Instanz ausgelöst, die als Ziehinitiator im DragManager.doDrag()-Aufruf festgelegt ist.InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Einfügen“ aktiviert oder im Kontextmenü des Texts „Einfügen“ wählt.InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer einen aktiven Eingabestift unter den Schwellenwert für die Abstandserkennung des Bildschirms senkt.InteractiveObject
 Inherited
    proximityEnd
Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift über den Schwellenwert für die Abstandserkennung des Bildschirms anhebt.InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer den aktiven Eingabestift über den Bildschirm bewegt, während er innerhalb des Schwellenwerts der Abstandserkennung bleibt.InteractiveObject
 Inherited
    proximityOut
Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift von diesem InteractiveObject wegbewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt.InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer den aktiven Eingabestift direkt über dieses InteractiveObject bewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt.InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer einen aktiven Eingabestift von diesem InteractiveObject und seinen untergeordneten Elementen wegbewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt.InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer einen aktiven Eingabestift von außerhalb der Nachfolgerstruktur des Objekts in der Anzeigeliste über dieses InteractiveObject bewegt (und dabei innerhalb des Schwellenwerts für die Abstandserkennung auf dem Bildschirm bleibt).InteractiveObject
 InheritedWird abgesetzt, wenn ein Benutzer die Taste des Zeigegeräts loslässt, nachdem er die Taste über einer InteractiveObject-Instanz gedrückt und das Zeigegerät dann von der InteractiveObject-Instanz wegbewegt hat.InteractiveObject
 InheritedWird ausgelöst, wenn ein Objekt aus der Anzeigeliste entfernt werden soll.DisplayObject
 InheritedWird ausgelöst, wenn ein Anzeigeobjekt aus der Anzeigeliste entfernt werden soll. Dies erfolgt entweder direkt oder über das Entfernen einer Unterstruktur, die das Anzeigeobjekt enthält.DisplayObject
 Inherited[broadcast event] Wird ausgelöst, wenn die Anzeigeliste kurz davor steht, aktualisiert und neu gezeichnet zu werden.DisplayObject
 InheritedWird ausgelöst, wenn der Benutzer die rechte Taste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und loslässt.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt.InteractiveObject
 InheritedWird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt.InteractiveObject
  Von einem TextField-Objekt ausgelöst, nachdem der Benutzer einen Bildlauf durchgeführt hat.TextField
 InheritedWird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Alles auswählen“ aktiviert oder im Kontextmenü des Texts „Alles auswählen“ wählt.InteractiveObject
 InheritedWird sofort nach dem Einblenden der Softwaretastatur abgesetzt.InteractiveObject
 InheritedWird direkt vor dem Einblenden der Softwaretastatur abgesetzt.InteractiveObject
 InheritedWird sofort nach dem Ausblenden der Softwaretastatur abgesetzt.InteractiveObject
 InheritedWird ausgelöst, wenn sich der Wert des tabChildren-Flags des Objekts ändert.InteractiveObject
 InheritedWird ausgelöst, wenn sich das tabEnabled-Flag des Objekts ändert.InteractiveObject
 InheritedWird ausgelöst, wenn sich der Wert der tabIndex-Eigenschaft des Objekts ändert.InteractiveObject
  Flash Player löst das textInput-Ereignis aus, wenn ein Benutzer ein oder mehr Textzeichen eingibt.TextField
  Flash Player setzt das textInteractionModeChange-Ereignis ab, wenn ein Benutzer den Interaktionsmodus eines Textfeldes ändert.TextField
 InheritedWird abgesetzt, wenn der Benutzer ein berührungsempfindliches Gerät erstmals berührt (zum Beispiel mit dem Finger das Touchscreen eines Mobiltelefons oder Tablets berührt).InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät entfernt (zum Beispiel den Finger vom Touchscreen eines Mobiltelefons oder Tablets hebt).InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer das Gerät berührt, und zwar kontinuierlich, bis der Kontaktpunkt entfernt wird.InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät von einer InteractiveObject-Instanz wegbewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Anzeigeobjekt zu einem anderen zieht).InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät über eine InteractiveObject-Instanz bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Punkt außerhalb des Anzeigeobjekts auf einen Punkt über einem Anzeigeobjekt zieht).InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät von einer InteractiveObject-Instanz wegbewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Anzeigeobjekt auf einen Punkt außerhalb des Anzeigeobjekts zieht).InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät über eine InteractiveObject-Instanz bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Punkt außerhalb des Anzeigeobjekts auf einen Punkt über einem Anzeigeobjekt zieht).InteractiveObject
 InheritedWird abgesetzt, wenn der Benutzer den Kontaktpunkt über derselben InteractiveObject-Instanz anhebt, auf der der Kontakt eingeleitet wurde (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem einzelnen Kontaktpunkt hebt).InteractiveObject
Eigenschaftendetails

alwaysShowSelection

Eigenschaft
alwaysShowSelection:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Wenn sich das Textfeld bei Einstellung true nicht im Fokus befindet, markiert Flash Player die Auswahl im Textfeld in grau. Wenn sich das Textfeld bei Einstellung false nicht im Fokus befindet, markiert Flash Player die Auswahl im Textfeld nicht.

Der Standardwert ist false.



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

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Kompilieren Sie die folgende Datei, und führen Sie sie aus. Wenn Sie die Datei ausführen, ziehen Sie den Text in beide Textfelder, um ihn auszuwählen. Achten Sie auf den Unterschied bei der Markierung der Auswahl, wenn Sie Text in den beiden Textfeldern auswählen (und damit den Fokus ändern):
    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

Eigenschaft 
antiAliasType:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Der für dieses Textfeld verwendete Anti-Aliasing-Typ. Verwenden Sie flash.text.AntiAliasType-Konstanten für diese Eigenschaft. Sie können diese Einstellung nur dann steuern, wenn die Schriftart eingebettet ist (die Eigenschaft embedFonts ist auf true gesetzt). Die Standardeinstellung ist flash.text.AntiAliasType.NORMAL.

Wenn Sie Werte für diese Eigenschaft definieren möchten, verwenden Sie die folgenden Stringwerte:

StringwertBeschreibung
flash.text.AntiAliasType.NORMALWendet das normale Text-Anti-Aliasing an. Dieser Wert entspricht dem Anti-Aliasing-Typ, den Flash Player 7 und frühere Versionen verwendeten.
flash.text.AntiAliasType.ADVANCEDWendet erweitertes Anti-Aliasing an, sodass der Text besser lesbar ist. (Diese Funktion ist seit Flash Player 8 verfügbar.) Erweitertes Anti-Aliasing ermöglicht die hochwertige Wiedergabe von kleinen Schriftarten. Es eignet sich am besten für Anwendungen mit sehr viel kleinem Text. Das erweiterte Anti-Aliasing bietet sich hingegen nicht für große Schriften (über 48 Punkte) an.



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

Verwandte API-Elemente

autoSize

Eigenschaft 
autoSize:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Steuert die automatische Größenänderung und Ausrichtung von Textfeldern. Zulässige Werte für die TextFieldAutoSize-Konstanten: TextFieldAutoSize.NONE (Standard), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT und TextFieldAutoSize.CENTER.

Wurde autoSize auf den Standardwert TextFieldAutoSize.NONE gesetzt, erfolgt keine Größenänderung.

Wurde autoSize auf TextFieldAutoSize.LEFT gesetzt, wird der Text als linksbündiger Text behandelt, d. h., die linke Seite des Textfelds bleibt fixiert, und Größenänderungen eines einzeiligen Textfelds werden auf der rechten Seite vorgenommen. Wenn Text einen Zeilenumbruch enthält (z. B. "\n" oder "\r"), wird die unterste Zeile ebenfalls so geändert, dass die nächste Textzeile eingefügt werden kann. Wenn wordWrap ebenfalls auf true eingestellt ist, wird nur die Größe der untersten Zeile des Textfelds geändert, die rechte Seite bleibt dagegen unverändert.

Wurde autoSize auf TextFieldAutoSize.RIGHT gesetzt, wird der Text als rechtsbündiger Text behandelt, d. h., die rechte Seite des Textfelds bleibt fixiert, und Größenänderungen eines einzeiligen Textfelds werden auf der linken Seite vorgenommen. Wenn Text einen Zeilenumbruch enthält (z. B. "\n" oder "\r"), wird die unterste Zeile ebenfalls so geändert, dass die nächste Textzeile eingefügt werden kann. Wenn wordWrap ebenfalls auf true eingestellt ist, wird nur die Größe der untersten Zeile des Textfelds geändert, die linke Seite bleibt dagegen unverändert.

Wurde autoSize auf TextFieldAutoSize.CENTER gesetzt, wird der Text als zentriert behandelt, d. h., eine Änderung der Größe eines einzeiligen Textfelds wird gleichmäßig auf den rechten und linken Rand verteilt. Wenn Text einen Zeilenumbruch enthält (z. B. "\n" oder "\r"), wird die unterste Zeile ebenfalls so geändert, dass die nächste Textzeile eingefügt werden kann. Wenn wordWrap ebenfalls auf true eingestellt ist, wird nur die Größe der untersten Zeile des Textfelds geändert, die linke und rechte Seite bleiben dagegen unverändert.



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

Auslöser
ArgumentError — Der angegebene autoSize-Wert gehört nicht zu „flash.text.TextFieldAutoSize“.

Verwandte API-Elemente

background

Eigenschaft 
background:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt an, ob das Textfeld einen gefüllten Hintergrund aufweist. Bei true weist das Textfeld einen gefüllten Hintergrund auf. Bei false weist das Textfeld keinen gefüllten Hintergrund auf. Mit der Eigenschaft backgroundColor legen Sie die Hintergrundfarbe eines Textfelds fest.

Der Standardwert ist false.



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

Verwandte API-Elemente

backgroundColor

Eigenschaft 
backgroundColor:uint

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt die Hintergrundfarbe des Textfelds an. Der Standardwert ist 0xFFFFFF (weiß). Diese Eigenschaft kann abgerufen oder eingestellt werden, selbst wenn derzeit kein Hintergrund verwendet wird. Die Farbe ist jedoch nur dann sichtbar, wenn die Eigenschaft background des Textfelds true ist.



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

Verwandte API-Elemente

border

Eigenschaft 
border:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt an, ob das Textfeld umrahmt ist. Bei true ist das Textfeld umrahmt. Bei false weist das Textfeld keinen Rahmen auf. Mit der Eigenschaft borderColor können Sie die Rahmenfarbe festlegen.

Der Standardwert ist false.



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

Verwandte API-Elemente

borderColor

Eigenschaft 
borderColor:uint

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt die Farbe des Textfeldrahmens an. Der Standardwert ist 0x000000 (schwarz). Diese Eigenschaft kann abgerufen oder eingestellt werden, selbst wenn derzeit kein Rahmen verwendet wird. Die Farbe ist jedoch nur dann sichtbar, wenn die Eigenschaft border des Textfelds true ist.



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

Verwandte API-Elemente

bottomScrollV

Eigenschaft 
bottomScrollV:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Eine Ganzzahl (Index mit Basis 1), die die unterste der im angegebenen Textfeld sichtbaren Zeilen angibt. Das Textfeld kann als Fenster zur Anzeige eines Textblocks betrachtet werden. Die Eigenschaft scrollV ist der auf eins basierende Index der obersten sichtbaren Zeile im Fenster.

Der gesamte Text zwischen den durch scrollV und bottomScrollV begrenzten Zeilen ist zurzeit im Textfeld sichtbar.



Implementierung
    public function get bottomScrollV():int

Verwandte API-Elemente

caretIndex

Eigenschaft 
caretIndex:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Der Index der Position der Einfügemarke. Wenn keine Einfügemarke angezeigt wird, ergibt sich der Wert aus der Position, die die Einfügemarke erhält, wenn das Feld den Fokus zurückerlangt (normalerweise die Stelle, an der sich die Einfügemarke zuvor befunden hat, oder 0, wenn das Feld bislang nicht den Fokus hatte).

Indizes für Auswahlbereiche haben die Basis null (d. h. die erste Position ist 0, die zweite Position 1 usw.).



Implementierung
    public function get caretIndex():int

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
In diesem Beispiel wird eine TextField-Instanz erstellt und mit Text gefüllt. Es wird ein Ereignis-Listener zugewiesen, damit die printCursorPosition-Methode aufgerufen wird, sobald der Benutzer auf die TextField-Instanz klickt. In diesem Fall werden die Werte der Eigenschaften caretIndex, selectionBeginIndex und selectionEndIndex ausgegeben.

Führen Sie dieses Beispiel aus, und versuchen Sie, durch Klicken in die TextField-Instanz Text auszuwählen. Klicken Sie anschließend in das Feld, ohne Text auszuwählen. Wenn Sie in den Text klicken, ohne eine Auswahl vorzunehmen, gibt die Eigenschaft caretIndex an, wo sich die Einfügemarke befindet, und die Eigenschaften selectionBeginIndex und selectionEndIndex sind identisch mit dem Wert der Eigenschaft 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

Eigenschaft 
condenseWhite:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein boolescher Wert, der angibt, ob zusätzliche Leerräume (beispielsweise Leerzeichen oder Zeilenumbrüche) aus einem Textfeld mit HTML-Text entfernt werden sollen. Der Standardwert ist false. Die Eigenschaft condenseWhite betrifft nur Text mit der Eigenschaft htmlText, nicht mit der Eigenschaft text. Wenn Sie Text mit der Eigenschaft text festlegen, wird condenseWhite ignoriert.

Wenn condenseWhite auf true gesetzt ist, verwenden Sie HTML-Standardbefehle wie <BR> und <P>, um in das Textfeld Zeilenumbrüche einzufügen.

Legen Sie die Eigenschaft condenseWhite fest, bevor Sie die Eigenschaft htmlText festlegen.



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

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Aus dem folgenden Beispiel geht der Unterschied zwischen der Einstellung false und true für condenseWhite hervor:
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

Eigenschaft 
defaultTextFormat:flash.text:TextFormat

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Legt das Format fest, das auf neu eingefügten Text (z. B. von einem Benutzer eingegebener Text oder Text, der mit der replaceSelectedText()-Methode eingefügt wird) angewendet wird.

Hinweis: Wenn Zeichen ausgewählt werden, die mit setSelection() und replaceSelectedText() ersetzt werden sollen, wird das defaultTextFormat nur angewendet, wenn der Text bis zu und einschließlich dem letzten Zeichen ausgewählt wurde. Hier ist ein Beispiel:

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

Bei Aufruf der Eigenschaft defaultTextFormat sind alle Eigenschaften des zurückgegebenen TextFormat-Objekts definiert. Keine Eigenschaft besitzt den Wert null.

Hinweis: Diese Eigenschaft kann nicht festgelegt werden, wenn ein Stylesheet auf das Textfeld angewendet wird.



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

Auslöser
Error — Diese Methode kann bei einem Textfeld mit Stylesheet nicht verwendet werden.

Verwandte API-Elemente

displayAsPassword

Eigenschaft 
displayAsPassword:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt an, ob es sich um ein Kennworttextfeld handelt. Weist die Eigenschaft den Wert true auf, handelt es sich um ein Kennworttextfeld, und statt der eingegebenen Zeichen werden Sternchen angezeigt. Bei false handelt es sich nicht um ein Kennworttextfeld. Wenn der Kennwortmodus aktiviert ist, können die Befehle „Ausschneiden“ und „Kopieren“ sowie die entsprechenden Tastaturbefehle nicht verwendet werden. Dieser Sicherheitsmechanismus verhindert, dass skrupellose Benutzer anhand des Tastaturbefehls das Kennwort eines unbeaufsichtigten Computers herausfinden.

Der Standardwert ist false.



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

embedFonts

Eigenschaft 
embedFonts:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt an, ob bei der Wiedergabe eingebettete Schriftkonturen verwendet werden sollen. Bei false wird das Textfeld mit Geräteschriftarten dargestellt.

Wenn Sie die Eigenschaft embedFonts für ein Textfeld auf true setzen, müssen Sie für diesen Text mit der Eigenschaft font eines auf das Textfeld angewendeten TextFormat-Objekts eine Schriftart angeben. Wenn die angegebene Schriftart nicht in der SWF-Datei eingebettet ist, wird der Text nicht angezeigt.

Der Standardwert ist false.



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

Verwandte API-Elemente

gridFitType

Eigenschaft 
gridFitType:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Die für dieses Textfeld verwendete Art der Rasteranpassung. Diese Eigenschaft gilt nur dann, wenn die Eigenschaft flash.text.AntiAliasType des Textfelds auf flash.text.AntiAliasType.ADVANCED gesetzt ist.

Anhand der verwendeten Art der Rasteranpassung wird bestimmt, ob Flash Player breite horizontale und vertikale Linien an ein Pixel- oder Subpixelraster anpasst.

Für die Eigenschaft flash.text.GridFitType können Sie die folgenden Stringwerte verwenden:

StringwertBeschreibung
flash.text.GridFitType.NONEDefiniert keine Rasteranpassung. Horizontale und vertikale Linien in den Glyphen werden nicht am Pixelraster ausgerichtet. Diese Einstellung wird für Animationen und große Schriftgrade empfohlen.
flash.text.GridFitType.PIXELDefiniert die Anpassung breiter horizontaler und vertikaler Linien an das Pixelraster. Diese Einstellung funktioniert nur für linksbündig ausgerichtete Textfelder. Wenn Sie diese Einstellung nutzen möchten, muss die Eigenschaft flash.display.AntiAliasType des Textfelds auf flash.text.AntiAliasType.ADVANCED gesetzt sein. Diese Einstellung bietet im Allgemeinen die beste Lesbarkeit für linksbündigen Text.
flash.text.GridFitType.SUBPIXELBreite horizontale und vertikale Linien werden an das Sub-Pixelraster auf LCD-Displays angepasst. Wenn Sie diese Einstellung nutzen möchten, muss die Eigenschaft flash.text.AntiAliasType des Textfelds auf flash.text.AntiAliasType.ADVANCED gesetzt sein. Die Einstellung flash.text.GridFitType.SUBPIXEL eignet sich oft für rechtsbündigen oder zentrierten dynamischen Text und ist manchmal eine praktische Alternative, wenn zwischen Animations- und Textqualität abzuwägen ist.

Der Standardwert ist pixel.



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

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Das folgende Beispiel zeigt drei Textfelder mit verschiedenen Einstellungen für die gridFitType-Eigenschaft. Achten Sie bei diesem Beispiel auf den Unterschied in der Lesbarkeit der ersten beiden Zeilen. Beachten Sie auch die optimale Verwendung von GridFitType.PIXEL für link ausgerichteten Text und GridFitType.SUBPIXEL für rechts ausgerichteten 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

Eigenschaft 
htmlText:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Enthält die HTML-Darstellung des Inhalts des Textfelds.

Flash Player unterstützt die folgenden HTML-Tags:

Tag Beschreibung
Anker-Tag Mit dem Tag <a> wird ein Hyperlink erstellt. Das Tag unterstützt die folgenden Attribute:
  • target: Gibt den Namen des Zielfensters an, in das die Seite geladen werden soll. Folgende Optionen stehen zur Verfügung: _self, _blank, _parent und _top. Mit der Option _self wird der aktuelle Frame im aktuellen Fenster angegeben, mit _blank ein neues Fenster, mit _parent der dem aktuellen Frame übergeordnete Frame und mit _top der Frame der obersten Stufe im aktuellen Fenster.
  • href: Legt eine URL oder ein ActionScript link-Ereignis fest. Die URL kann ein absoluter oder relativer Pfad zum Speicherort der SWF-Datei sein, von der die Seite geladen wird. Ein Beispiel für einen absoluten Verweis auf eine URL ist http://www.adobe.com, während /index.html ein relativer Verweis ist. Absolute URLs müssen mit dem Präfix http:// versehen sein, da Flash Player bzw. AIR sie ansonsten als relative URLs behandelt. Sie können mit dem Ereignis link festlegen, dass der Link eine ActionScript-Funktion in einer SWF-Datei ausführt, anstatt eine URL zu öffnen. Um ein link-Ereignis anzugeben, verwenden Sie das Ereignisschema anstelle des http-Schemas im href-Attribut. Ein Beispiel ist href="event:myText" anstelle von href="http://myURL"; wenn der Benutzer auf einen Hypertext-Link klickt, der das Ereignisschema enthält, löst das Textfeld ein link TextEvent aus, dessen text-Eigenschaft den Wert "myText" aufweist. Sie können dann eine ActionScript-Funktion erstellen, die ausgeführt wird, wann immer das link-TextEvent ausgelöst wird. Sie können auch mit Stylesheets die Stile a:link, a:hover und a:active für Anker-Tags definieren.
Fettdruck-Tag Mit dem Tag <b> wird Text fett dargestellt. Für die verwendete Schriftart muss ein fettes Schriftbild vorhanden sein.
Zeilenumbruch-Tag Das Tag <br> fügt einen Zeilenumbruch in das Textfeld ein. Definieren Sie das Textfeld als mehrzeiliges Textfeld, um dieses Tag zu verwenden.
Schriftart-Tag Mit dem Tag <font> legen Sie fest, welche Schriftarten für die Textanzeige verwendet werden. Die folgenden Attribute werden vom font-Tag unterstützt::
  • color: Es werden nur hexadezimale Farbwerte (#FFFFFF) unterstützt.
  • face: Gibt den Namen der zu verwendenden Schriftart an. Sie können wie im folgenden Beispiel dargestellt eine durch Kommas getrennte Liste von Schriftartnamen angeben. In diesem Fall wählt Flash Player die erste verfügbare Schriftart. Wenn die angegebene Schriftart nicht auf dem lokalen Computersystem installiert oder nicht in der SWF-Datei eingebettet ist, wählt Flash Player eine Ersatzschriftart aus.
  • size: Gibt die Größe der Schriftart an. Sie können absolute Pixelgrößen wie 16 oder 18 oder relative Punktgrößen wie +2 und -4 verwenden.
Bild-Tag Mit dem Tag <img> können Sie externe Bilddateien (JPEG, GIF, PNG), SWF-Dateien und Movieclips in Textfelder einbetten. Text fließt automatisch um in Textfelder eingebettete Bilder herum. Sie müssen das Textfeld als mehrzeilig definieren, um Text um ein Bild fließen zu lassen.

Die folgenden Attribute werden vom <img>-Tag unterstützt:

  • src: Definiert die URL zu einer Bild- oder SWF-Datei bzw. den Verknüpfungsbezeichner eines Movieclip-Symbols in der Bibliothek. Dieses Attribut ist erforderlich. Alle anderen sind optional. Externe Dateien (JPEG, GIF, PNG und SWF) werden erst dann angezeigt, wenn sie komplett heruntergeladen worden sind.
  • width: Die Breite des einzufügenden Bilds, der SWF-Datei oder des Movieclips in Pixel.
  • height: Die Höhe des einzufügenden Bilds, der SWF-Datei oder des Movieclips in Pixel.
  • align: Legt die horizontale Ausrichtung des eingebetteten Bilds im Textfeld fest. Gültige Werte sind left und right. Der Standardwert ist left.
  • hspace: Legt die Größe des horizontalen Bereichs um das Bild fest, in dem kein Text zu sehen ist. Der Standardwert ist 8.
  • vspace: Legt die Größe des vertikalen Bereichs um das Bild fest, in dem kein Text zu sehen ist. Der Standardwert ist 8.
  • id: Definiert den Namen der Movieclip-Instanz (von Flash Player erstellt), die die eingebettete Bild- oder SWF-Datei bzw. den Movieclip enthält. Diese Methode wird verwendet, um den eingebetteten Inhalt mit ActionScript zu steuern.
  • checkPolicyFile: Gibt an, dass Flash Player nach einer URL-Richtliniendatei auf dem Server suchen soll, der mit der Bilddomäne verknüpft ist. Wenn eine Richtliniendatei existiert, können SWF-Dateien in den Domänen, die in der Datei aufgelistet sind, auf die Daten des geladenen Bildes zugreifen, indem sie beispielsweise die BitmapData.draw()-Methode mit diesem Bild als source-Parameter aufrufen. Weitere Informationen zum Thema Sicherheit finden Sie im Flash Player Developer Center im Abschnitt Sicherheit.

Medieninhalte, die in Textfelder eingebettet sind, werden in voller Größe angezeigt. Um die Abmessung der Medien anzugeben, die Sie einbetten, verwenden Sie das <img>-Tag und das height- und width-Attribut.

Im Allgemeinen wird ein in ein Textfeld eingebettetes Bild in der Zeile nach dem Tag <img> angezeigt. Ist jedoch das <img>-Tag das erste Zeichen im Textfeld, erscheint das Bild dort in der ersten Zeile.

Wenn sich in der Sicherheitssandbox der Anwendung AIR-Inhalt befindet, ignoriert AIR img-Tags im HTML-Inhalt in ActionScript TextField-Objekten. Hierdurch werden eventuelle Phishing-Angriffe verhindert.

Kursiv-Tag Mit dem <i>-Tag markierter Text wird kursiv angezeigt. Für die verwendete Schriftart muss ein kursives Schriftbild vorhanden sein.
Listenelement-Tag Das Tag <li> sorgt dafür, dass vor dem Text, der vom Tag umschlossen ist, ein Aufzählungszeichen platziert wird. Hinweis: Dae Flash Player und AIR sortierte und unsortierte Listen-Tags (<ol> und <ul> nicht erkennen, ändern sie nicht, wie Ihre Liste wiedergegeben wird. Alle Listen werden unsortiert und mit Aufzählungszeichen vor jedem einzelnen Element angezeigt.
Absatz-Tag Mit dem Tag <p> wird ein neuer Absatz erstellt. Das Textfeld muss als mehrzeiliges Textfeld definiert werden, um dieses Tag zu verwenden. Die folgenden Attribute werden vom <p>-Tag unterstützt:
  • align: Gibt die Ausrichtung des Texts innerhalb des Absatzes an. Gültige Werte sind left, right, justify und center.
  • class: Legt eine von einem flash.text.StyleSheet-Objekt definierte CSS-Stilklasse fest.
Bereichs-Tag Das Tag <span> ist nur im Einsatz mit CSS-Textstilen verfügbar. Das folgende Attribut wird dabei unterstützt:
  • class: Legt eine von einem flash.text.StyleSheet-Objekt definierte CSS-Stilklasse fest.
Textformat-Tag

Mit dem Tag <textformat> können Sie einige Eigenschaften der TextFormat-Klasse zur Absatzformatierung in Textfeldern nutzen. Dazu zählen Zeilenabstand, Einzug, Ränder und Tabstopps. Sie können das Tag <textformat> mit den integrierten HTML-Tags kombinieren.

Die folgenden Attribute werden vom Tag <textformat> unterstützt:

  • blockindent: Legt den Blockeinzug in Punkten fest; entspricht TextFormat.blockIndent.
  • indent: Legt den Einzug vom linken Rand bis zum ersten Zeichen im Absatz fest; entspricht TextFormat.indent. Es können positive und negative Werte verwendet werden.
  • leading: Legt den Zeilenabstand (vertikal) fest; entspricht TextFormat.leading. Es können positive und negative Werte verwendet werden.
  • leftmargin: Legt den linken Rand im Absatz in Punkten fest; entspricht TextFormat.leftMargin.
  • rightmargin: Legt den rechten Rand im Absatz in Punkten fest; entspricht TextFormat.rightMargin.
  • tabstops: Gibt benutzerdefinierte Tabstopps als Array aus nicht negativen Ganzzahlen an; entspricht TextFormat.tabStops.
Unterstreichungs-Tag Mit dem <u>-Tag markierter Text wird unterstrichen angezeigt.

Flash Player und AIR unterstützen die folgenden HTML-Entitäten:

Entität Beschreibung
&lt; < (kleiner als)
&gt; > (größer als)
&amp; & (Und-Zeichen)
&quot; " (doppelte Anführungszeichen)
&apos; ' (Apostroph, einfaches Anführungszeichen)

Flash Player und AIR unterstützen auch explizite Zeichencodes wie z. B. &#38; (Und-Zeichen, ASCII) und &#x20AC; ( €-Symbol, Unicode).



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

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Im folgenden Beispiel wird ein TextField-Objekt mit der Bezeichnung tf1 erstellt, und der Eigenschaft text wird ein String im HTML-Format zugewiesen. Wenn die Eigenschaft htmlText nachverfolgt wird, wird der String im HTML-Format mit zusätzlichen Tags (z. B. <P> und <FONT>) automatisch von Flash Player hinzugefügt. Wenn der Wert der Eigenschaft text nachverfolgt wird, wird der unformatierte String ohne HTML-Tags angezeigt.

Zum Vergleich werden die gleichen Schritte mit einem weiteren TextField-Objekt mit der Bezeichnung tf2. Zusätzlich wird der Eigenschaft styleSheet von tf2 ein StyleSheet-Objekt zugewiesen, bevor die Eigenschaft htmlText festgelegt wird. In diesem Fall enthält die Eigenschaft htmlText, wenn sie nachverfolgt wird, nur den genauen HTML-Text, der ursprünglich der Eigenschaft htmlText zugewiesen war. Es wurden keine zusätzlichen Tags von Flash Player eingefügt.

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

Eigenschaft 
length:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die Anzahl der Zeichen in einem Textfeld. Ein Steuerzeichen wie Tab (\t) zählt als ein Zeichen.



Implementierung
    public function get length():int

maxChars

Eigenschaft 
maxChars:int

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die von einem Benutzer festgelegte maximale Anzahl von Zeichen, die das Textfeld enthalten kann. Mit einem Skript kann mehr Text eingefügt werden, als die Eigenschaft maxChars zulässt. maxChars gibt lediglich an, wie viel Text ein Benutzer eingeben kann. Wenn der Wert dieser Eigenschaft 0 ist, können die Benutzer unbegrenzt viel Text eingeben.

Der Standardwert ist 0.



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

maxScrollH

Eigenschaft 
maxScrollH:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Der maximale Wert der Eigenschaft scrollH.



Implementierung
    public function get maxScrollH():int

Verwandte API-Elemente

maxScrollV

Eigenschaft 
maxScrollV:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Der maximale Wert der Eigenschaft scrollV.



Implementierung
    public function get maxScrollV():int

Verwandte API-Elemente

mouseWheelEnabled

Eigenschaft 
mouseWheelEnabled:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Ein boolescher Wert, der angibt, ob Flash Player für mehrzeilige Textfelder automatisch einen Bildlauf durchführt, wenn der Benutzer ein Textfeld anklickt und das Mausrad dreht. Der Standardwert ist true. Diese Eigenschaft ist nützlich, wenn Sie verhindern möchten, dass in Textfeldern ein Bildlauf mit dem Mausrad durchgeführt wird oder wenn Sie Ihre eigene Bildlaufeigenschaften für Textfelder erstellen möchten.



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

multiline

Eigenschaft 
multiline:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt an, ob das Feld ein mehrzeiliges Textfeld ist. Bei true ist das Textfeld mehrzeilig, bei false ist es einzeilig. In einem Feld des Typs TextFieldType.INPUT gibt der multiline-Wert an, ob die Enter-Taste eine neue Zeile erstellt (bei false wird die Enter-Taste ignoriert). Wenn Sie Text in ein TextField einfügen, dessen multiline-Wert auf false gesetzt ist, werden neue Zeilen aus dem Text entfernt.

Der Standardwert ist false.



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

Verwandte API-Elemente

numLines

Eigenschaft 
numLines:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt die Anzahl der Textzeilen in einem mehrzeiligen Textfeld an. Falls die Eigenschaft wordWrap auf true gesetzt ist, erhöht sich die Zeilenzahl beim Textumbruch.



Implementierung
    public function get numLines():int

Verwandte API-Elemente

restrict

Eigenschaft 
restrict:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt die Zeichen an, die ein Benutzer in das Textfeld eingeben kann. Wenn die restrict-Eigenschaft auf null gesetzt ist, kann jedes beliebige Zeichen eingegeben werden. Wenn die restrict-Eigenschaft einen leeren String enthält, können keine Zeichen eingegeben werden. Weist die Eigenschaft restrict eine bestimmte Zeichenfolge als Wert auf, können nur diese Zeichen in das Textfeld eingegeben werden. Der String wird von links nach rechts gelesen. Sie können mithilfe eines Bindestrichs (-) einen Zeichenbereich angeben. Nur die Benutzerinteraktion ist beschränkt; ein Skript kann jeden Text in das Textfeld einfügen. Diese Eigenschaft wird nicht an die Optionen unter „Schriftarten einbetten“ im Eigenschafteninspektor angeglichen.

Wenn der String mit dem Einfügezeichen (^) beginnt, werden anfänglich alle Zeichen akzeptiert, aber nachfolgende Zeichen im String werden nicht in die Liste der zulässigen Zeichen aufgenommen. Wenn der String nicht mit dem Einfügezeichen (^) beginnt, werden anfänglich keine Zeichen akzeptiert, aber nachfolgende Zeichen im String werden in die Liste der zulässigen Zeichen aufgenommen.

Im folgenden Beispiel können nur Großbuchstaben, Leerzeichen und Zahlen in das Textfeld eingegeben werden:

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

Im folgenden Beispiel werden alle Zeichen bis auf Kleinbuchstaben akzeptiert:

     my_txt.restrict = "^a-z";
     

Wenn Sie „^“ bzw. „-“ als normale Zeichen verwenden möchten, müssen Sie ihnen einen umgekehrten Schrägstrich (\) voranstellen. Zulässige Backslash-Folgen: \-, \^ oder \\. Der umgekehrte Schrägstrich muss ein echtes Zeichen im String sein; in ActionScript muss der umgekehrte Schrägstrich also doppelt eingegeben werden. Im folgenden Beispiel werden nur der Bindestrich (-) und das Einfügezeichen (^) zugelassen:

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

Das Einfügezeichen (^) kann an jeder beliebigen Stelle im String verwendet werden, um Zeichen ein- oder auszuschließen. Im folgenden Beispiel werden alle Großbuchstaben außer Q akzeptiert:

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

Sie können die Escape-Sequenz \u verwenden, um restrict-Strings zu konstruieren. Im folgenden Beispiel werden nur die Zeichen zwischen ASCII 32 (Leerzeichen) und ASCII 126 (Tilde) akzeptiert:

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

Der Standardwert ist null.



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

scrollH

Eigenschaft 
scrollH:int

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die aktuelle horizontale Bildlaufposition. Ist die Eigenschaft scrollH auf 0 gesetzt, erfolgt kein horizontaler Bildlauf. Bei diesem Eigenschaftswert handelt es sich um eine Ganzzahl, die die horizontale Position in Pixeln angibt.

Die Maßeinheit für den horizontalen Bildlauf sind Pixel, die Maßeinheit für den vertikalen Bildlauf Zeilen. Der horizontale Bildlauf wird in Pixeln gemessen, da die am häufigsten verwendeten Schriftarten normalerweise Proportionalschriftarten sind, die unterschiedlich breite Zeichen aufweisen. Flash Player nimmt den vertikalen Bildlauf nach Zeilen vor, da Benutzer normalerweise eine Textzeile vollständig und nicht nur teilweise sehen möchten. Hierbei kommt es nicht darauf an, ob eine Zeile mehrere Schriftarten enthält, da die Höhe der Zeile immer an die größte verwendete Schriftart angepasst wird.

Hinweis: Die Eigenschaft scrollH basiert auf 0, nicht auf 1 wie die Eigenschaft scrollV für den vertikalen Bildlauf.



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

Verwandte API-Elemente

scrollV

Eigenschaft 
scrollV:int

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die vertikale Textposition in einem Textfeld. Die Eigenschaft scrollV ist besonders nützlich, wenn Benutzer auf einen bestimmten Abschnitt in einem längeren Text hingewiesen werden sollen, und bietet sich auch zum Erstellen von Textfeldern an, in denen ein Bildlauf durchgeführt werden kann.

Die Maßeinheit für den vertikalen Bildlauf sind Zeilen, die Maßeinheit für den horizontalen Bildlauf Pixel. Wenn die erste angezeigte Zeile auch die erste Zeile im Textfeld ist, hat „scrollV“ den Wert 1 (nicht 0). Der horizontale Bildlauf wird in Pixeln gemessen, da die meisten Schriftarten Proportionalschriftarten sind, die unterschiedlich breite Zeichen aufweisen. Flash Player nimmt den vertikalen Bildlauf nach Zeilen vor, da Benutzer normalerweise eine Textzeile vollständig und nicht nur teilweise sehen möchten. Selbst wenn eine Zeile mehrere Schriftarten enthält, wird die Höhe der Zeile an die größte verwendete Schriftart angepasst.



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

Verwandte API-Elemente

selectable

Eigenschaft 
selectable:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein boolescher Wert, der angibt, ob das Textfeld ausgewählt werden kann. Bei true kann der Text ausgewählt werden. Die Eigenschaft selectable steuert, ob ein Textfeld ausgewählt werden kann, und nicht, ob es bearbeitet werden kann. Ein dynamisches Textfeld kann auswählbar sein, ohne dass es bearbeitet werden kann. Wenn ein dynamisches Textfeld nicht auswählbar ist, kann der enthaltene Text nicht ausgewählt werden.

Wenn selectable auf false gesetzt ist, kann der Text im Textfeld nicht über die Maus oder Tastatur mit den Auswahlbefehlen ausgewählt und daher nicht mit dem Befehl „Kopieren“ kopiert werden. Wenn selectable auf true gesetzt ist, kann der Text im Textfeld über die Maus oder Tastatur mit den Auswahlbefehlen ausgewählt und daher mit dem Befehl „Kopieren“ kopiert werden. In diesem Feld können Sie Text auch dann auswählen, wenn es sich um ein dynamisches Textfeld und nicht um ein Eingabetextfeld handelt.

Der Standardwert ist true.



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

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Das folgende Beispiel erstellt zwei dynamische Textfelder: ein Textfeld, in dem die selectable-Eigenschaft auf true gesetzt ist, und ein anderes Textfeld, in dem die selectable-Eigenschaft auf false gesetzt ist. Wenn Sie dieses Beispiel verwenden, versuchen Sie, den Text in diesen Feldern mit der Maus oder der Tastatur auszuwählen.
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

Eigenschaft 
selectionBeginIndex:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Der auf null basierende Indexwert des ersten Zeichens in der aktuellen Auswahl. Das erste Zeichen ist beispielsweise 0, das zweite Zeichen 1 usw. Wenn kein Text ausgewählt ist, hat diese Eigenschaft den Wert caretIndex.



Implementierung
    public function get selectionBeginIndex():int

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
In diesem Beispiel wird eine TextField-Instanz erstellt und mit Text gefüllt. Es wird ein Ereignis-Listener zugewiesen, damit die printCursorPosition-Methode aufgerufen wird, sobald der Benutzer auf die TextField-Instanz klickt. In diesem Fall werden die Werte der Eigenschaften caretIndex, selectionBeginIndex und selectionEndIndex ausgegeben.

Führen Sie dieses Beispiel aus, und versuchen Sie, durch Klicken in die TextField-Instanz Text auszuwählen. Klicken Sie anschließend in das Feld, ohne Text auszuwählen. Wenn Sie in den Text klicken, ohne eine Auswahl vorzunehmen, gibt die Eigenschaft caretIndex an, wo sich die Einfügemarke befindet, und die Eigenschaften selectionBeginIndex und selectionEndIndex sind identisch mit dem Wert der Eigenschaft 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

Eigenschaft 
selectionEndIndex:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Der auf null basierende Indexwert des letzten Zeichens in der aktuellen Auswahl. Das erste Zeichen ist beispielsweise 0, das zweite Zeichen 1 usw. Wenn kein Text ausgewählt ist, hat diese Eigenschaft den Wert caretIndex.



Implementierung
    public function get selectionEndIndex():int

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
In diesem Beispiel wird eine TextField-Instanz erstellt und mit Text gefüllt. Es wird ein Ereignis-Listener zugewiesen, damit die printCursorPosition-Methode aufgerufen wird, sobald der Benutzer auf die TextField-Instanz klickt. In diesem Fall werden die Werte der Eigenschaften caretIndex, selectionBeginIndex und selectionEndIndex ausgegeben.

Führen Sie dieses Beispiel aus, und versuchen Sie, durch Klicken in die TextField-Instanz Text auszuwählen. Klicken Sie anschließend in das Feld, ohne Text auszuwählen. Wenn Sie in den Text klicken, ohne eine Auswahl vorzunehmen, gibt die Eigenschaft caretIndex an, wo sich die Einfügemarke befindet, und die Eigenschaften selectionBeginIndex und selectionEndIndex sind identisch mit dem Wert der Eigenschaft 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

Eigenschaft 
sharpness:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Die Schärfe der Glyphenkanten in diesem Textfeld. Diese Eigenschaft gilt nur dann, wenn die Eigenschaft flash.text.AntiAliasType des Textfelds auf flash.text.AntiAliasType.ADVANCED gesetzt ist. Der Wert für sharpness kann aus dem Bereich von -400 bis 400 gewählt werden. Wenn Sie versuchen, sharpness auf einen Wert außerhalb dieses Bereichs zu setzen, setzt Flash die Eigenschaft auf den nächstgelegenen Wert im Bereich (-400 oder 400).

Der Standardwert ist 0.



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

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Das folgende Beispiel zeigt, was passiert, wenn die sharpness-Eigenschaft für ein TextField-Objekt geändert wird. Sie müssen die Schriftart einbetten und die antiAliasType-Eigenschaft auf ADVANCED setzen.
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

Eigenschaft 
styleSheet:StyleSheet

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Fügt ein Stylesheet an das Textfeld an. Informationen zum Erstellen von Stylesheets finden Sie im Eintrag zur StyleSheet-Klasse und im ActionScript 3.0 Entwicklerhandbuch.

Sie können das mit einem Textfeld verknüpfte Stylesheet jederzeit ändern. Bei Änderung des verwendeten Stylesheets wird das Textfeld mit dem neuen Stylesheet neu gezeichnet. Wenn Sie das Stylesheet entfernen möchten, setzen Sie es auf null oder undefined. Wenn Sie das verwendete Stylesheet entfernen, wird das Textfeld ohne Stylesheet neu gezeichnet.

Hinweis: Wenn das Stylesheet entfernt wird, wird der Inhalt von TextField.text und TextField.htmlText in der vorher vom Stylesheet angewendeten Formatierung angezeigt. Um den ursprünglichen Inhalt von TextField.htmlText ohne Formatierung zu bewahren, speichern Sie den Wert in einer Variablen, bevor Sie das Stylesheet entfernen.



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

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Im folgenden Beispiel wird ein einfaches StyleSheet-Objekt definiert und mit einem Textfeld mit HTML-Inhalt verknüpft. Legen Sie die stylesheet-Eigenschaft fest, bevor Sie den Inhalt festlegen.
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

Eigenschaft 
text:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein String, bei dem es sich um den aktuellen Text im Textfeld handelt. Zeilen sind durch das Wagenrücklaufzeichen ('\r', ASCII 13) getrennt. Diese Eigenschaft enthält unformatierten Text im Textfeld (ohne HTML-Tags).

Verwenden Sie die Eigenschaft htmlText, um den Text in das HTML-Format zu konvertieren.

Hinweis: Wenn ein Stylesheet auf das Textfeld angewendet wird, wird der Inhalt der text-Eigenschaft als HTML interpretiert.



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

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Im folgenden Beispiel wird ein TextField-Objekt mit der Bezeichnung tf1 erstellt, und der Eigenschaft text wird ein String im HTML-Format zugewiesen. Wenn die Eigenschaft htmlText nachverfolgt wird, wird der String im HTML-Format mit zusätzlichen Tags (z. B. <P> und <FONT>) automatisch von Flash Player hinzugefügt. Wenn der Wert der Eigenschaft text nachverfolgt wird, wird der unformatierte String ohne HTML-Tags angezeigt.

Zum Vergleich werden die gleichen Schritte mit einem weiteren TextField-Objekt mit der Bezeichnung tf2. Zusätzlich wird der Eigenschaft styleSheet von tf2 ein StyleSheet-Objekt zugewiesen, bevor die Eigenschaft htmlText festgelegt wird. In diesem Fall enthält die Eigenschaft htmlText, wenn sie nachverfolgt wird, nur den genauen HTML-Text, der ursprünglich der Eigenschaft htmlText zugewiesen war. Es wurden keine zusätzlichen Tags von Flash Player eingefügt.

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

Eigenschaft 
textColor:uint

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die Farbe des Textes in einem Textfeld (im Hexadezimalformat). Das Hexadezimalfarbsystem stellt Farbwerte anhand von sechs Ziffern dar. Jede Ziffer hat 16 mögliche Werte oder Zeichen. Die Zeichen reichen von 0-9 und dann A-F. Schwarz ist beispielsweise 0x000000; weiß ist 0xFFFFFF.

Der Standardwert ist 0 (0x000000).



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

Beispiel  ( Verwendung dieses Beispiels )
Mit dem folgenden ActionScript wird ein TextField-Objekt erstellt und die Eigenschaft textColor in Rot (0xFF0000) geändert.
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

Eigenschaft 
textHeight:Number  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die Höhe des Texts in Pixel.



Implementierung
    public function get textHeight():Number

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Im folgenden Beispiel wird ein TextField-Objekt erstellt. Anschließend wird dem Objekt Text zugewiesen. Mit den trace-Anweisungen werden die Werte der Eigenschaften textWidth und textHeight aufgerufen. Zum Vergleich werden auch die Eigenschaften width und height angezeigt. (Beachten Sie, dass die Werte für textHeight und textWidth von der auf Ihrem Computer verwendeten Schriftart abhängen).
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

Eigenschaft 
textInteractionMode:String  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 11, Flash Lite 4

Die Interaktionsmodus-Eigenschaft; der Standardwert ist TextInteractionMode.NORMAL. Auf mobilen Plattformen bedeutet der normale Modus, dass ein Bildlauf ausgeführt, der Text jedoch nicht ausgewählt werden kann. Über das integrierte Kontextmenü des Textfeldes ist es jedoch möglich, in den Auswahlmodus zu wechseln. Auf dem Desktop bedeutet der normale Modus, dass ein Bildlauf ausgeführt und der Text ausgewählt werden kann.



Implementierung
    public function get textInteractionMode():String

textWidth

Eigenschaft 
textWidth:Number  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die Breite des Texts in Pixel.



Implementierung
    public function get textWidth():Number

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Im folgenden Beispiel wird ein TextField-Objekt erstellt. Anschließend wird dem Objekt Text zugewiesen. Mit den trace-Anweisungen werden die Werte der Eigenschaften textWidth und textHeight aufgerufen. Zum Vergleich werden auch die Eigenschaften width und height angezeigt. (Beachten Sie, dass die Werte für textHeight und textWidth von der auf Ihrem Computer verwendeten Schriftart abhängen).
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

Eigenschaft 
thickness:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Die Stärke der Glyphenkanten in diesem Textfeld. Diese Eigenschaft gilt nur dann, wenn flash.text.AntiAliasType auf flash.text.AntiAliasType.ADVANCED gesetzt ist.

Der Wert für thickness kann aus dem Bereich von -200 bis 200 gewählt werden. Wenn Sie versuchen, thickness auf einen Wert außerhalb dieses Bereichs zu setzen, wird die Eigenschaft auf den nächstgelegenen Wert im Bereich gesetzt (-200 oder 200).

Der Standardwert ist 0.



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

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Das folgende Beispiel zeigt, was passiert, wenn die thickness-Eigenschaft für ein TextField-Objekt geändert wird. Sie müssen die Schriftart einbetten und die antiAliasType-Eigenschaft auf ADVANCED setzen.
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

Eigenschaft 
type:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Der Typ des Textfelds. Eine der folgenden TextFieldType-Konstanten: TextFieldType.DYNAMIC zur Angabe eines dynamischen Textfelds, das nicht von den Benutzern bearbeitet werden kann, oder TextFieldType.INPUT zur Angabe eines Eingabefelds, das von den Benutzern bearbeitet werden kann.

Der Standardwert ist dynamic.



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

Auslöser
ArgumentError — Der angegebene type-Wert gehört nicht zu „flash.text.TextFieldType“.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )
Im folgenden Beispiel werden zwei Textfelder erstellt: tfDynamic und tfInput. In beide Felder wird Text eingegeben. Für tfDynamic wird die type-Eigenschaft jedoch auf TextFieldType.DYNAMIC gesetzt wohingegen die type-Eigenschaft von tfInput auf TextFieldType.INPUT gesetzt wird. Daher kann der Benutzer den Text bei tfInput bearbeiten, während er bei tfDynamic keine Änderungen am Text vornehmen kann.
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

Eigenschaft 
useRichTextClipboard:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9

Gibt an, ob beim Kopieren und Einfügen auch die Textformatierung übernommen wird. Wenn dieses Objekt auf true gesetzt ist, kopiert Flash Player Formatierungen (wie z. B. Ausrichtung, fett und kursiv) und fügt diese ein, wenn Sie zwischen Textfeldern kopieren und einfügen. Sowohl im Ausgangs- als auch im Zieltextfeld des Kopier- und Einfügevorgangs muss useRichTextClipboard auf true gesetzt sein. Der Standardwert ist false.



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

Beispiel  ( Verwendung dieses Beispiels )
Dieses Beispiel erstellt ein Eingabetextfeld (tf1) und zwei dynamische Textfelder (tf2 und tf3). Der Code verknüpft jedes dynamische Feld mit einem TextFormat-Objekt (Courier Bold-Schrift). Für das Textfeld tf2 ist die Eigenschaft useRichTextClipboard auf false gesetzt. Für das Textfeld tf3 ist die Eigenschaft useRichTextClipboard auf true gesetzt. Wenn Sie den Text im Textfeld tf2 kopieren und ihn in das Textfeld tf1 einfügen, enthält der eingefügte Text keine Formatierung. Wenn Sie den Text im Textfeld tf3 (für das useRichTextClipboard auf true gesetzt ist) kopieren und ihn in das Textfeld tf1 einfügen, enthält der eingefügte Text die Formatierung.
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

Eigenschaft 
wordWrap:Boolean

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ein boolescher Wert, der angibt, ob im Textfeld ein Zeilenumbruch durchgeführt wird. Wenn die Eigenschaft wordWrap auf true gesetzt ist, findet im Textfeld ein Zeilenumbruch statt. Wenn der Wert false ist, findet im Textfeld kein Zeilenumbruch statt. Der Standardwert ist false.



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

Beispiel  ( Verwendung dieses Beispiels )
Aus dem folgenden Beispiel geht der Unterschied zwischen der Einstellung true und false für wordWrap hervor: Es werden zwei TextField-Instanzen erstellt, deren Inhalt zu groß für die Breite der Textfelder ist. Die Eigenschaft wordWrap der ersten Instanz (tfWrap) wird auf true gesetzt, die der zweiten Instanz (tfNoWrap) auf false.
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;
        }
    }
}
Konstruktordetails

TextField

()Konstruktor
public function TextField()

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt eine neue TextField-Instanz. Rufen Sie nach der Erstellung der TextField-Instanz die addChild()- bzw. addChildAt()-Methode des übergeordneten DisplayObjectContainer-Objekts auf, um die TextField-Instanz der Anzeigeliste hinzuzufügen.

Die Standardgröße für ein Textfeld beträgt 100 x 100 Pixel.


Beispiel  ( Verwendung dieses Beispiels )

Das folgende Beispiel zeigt, wie Sie in ActionScript dynamisch ein TextField-Objekt erstellen können, indem Sie die type-Eigenschaft des Textfeldobjekts auf die TextFieldType.INPUT-Konstante einstellen. Beispiel bereitgestellt von 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);
Methodendetails

appendText

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Hängt den vom Parameter newText angegebenen String an das Ende des Texts im Textfeld an. Diese Methode ist effizienter als eine Additionszuweisung (+=) bei einer text-Eigenschaft (wie z. B. someTextField.text += moreText), insbesondere bei Textfeldern mit erheblichem Inhalt.

Parameter

newText:String — Der an den vorhandenen Text anzuhängende String.


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird die Uhrzeit angezeigt, falls nicht gerade Wochenende ist. Am Wochenende wird dagegen der Text „It's the weekend“ angezeigt. Außerdem werden bis zu einer bestimmten Position die Anzahl der Zeichen und die Anzahl der Zeilen im Textfeld gezählt.

Das Textfeld outputText wird so eingestellt, dass es sich automatisch an den Text anpasst und dass der Text links ausgerichtet ist. Dazu wird die Eigenschaft autoSize verwendet. Die outputText.text-Eigenschaft schreibt die erste Zeile des Inhalts, und die appendText()-Methode hängt den Rest des Inhalts an. (Es ist nicht erforderlich, mit der text-Eigenschaft zu beginnen. Die appendText()-Methode könnte auch verwendet werden, um Text von außerhalb des Rahmens anzuhängen.) Wenn die text-Eigenschaft ein zweites Mals gesetzt wird, wird der ursprüngliche Text überschrieben. Verwenden Sie den +=-Operator, um Inhalt mit der text-Eigenschaft anzuhängen.

Die if-Anweisung überprüft, ob es sich beim Datum um Samstag (6) oder Sonntag (0) handelt. Ist dies nicht der Fall, gibt die toLocaleTimeString()-Methode die Ortszeit zurück, die an den Inhalt des Textfelds angehängt wird.

Die length-Eigenschaft des Textfelds wird verwendet, um die Anzahl der Zeichen bis direkt vor dem Aufrufen der Funktion zu lesen, und die pnumLines-Eigenschaft zählt die Zeilen im Textfeld. Beachten Sie, dass die leeren Zeilen sowie die Leerräume und Zeilenumbrüche (\n) mitgezählt werden, um die Länge des Inhalts zu bestimmen.

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

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

            this.addChild(outputText);
        }
    }
}

getCharBoundaries

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt ein Rechteck zurück, das die Begrenzungsbox für das Zeichen darstellt.

Parameter

charIndex:int — Der Indexwert für das Zeichen mit Basis null (d. h., die erste Position ist 0, die zweite Position 1 usw.).

Rückgabewerte
Rectangle — Ein Rechteck mit Mindest- und Höchstwerten für x und y, mit dem die Begrenzungsbox für das Zeichen definiert wird.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein vom Benutzer ausgewähltes Zeichen mithilfe der getCharBoundaries()-Methode markiert (hervorgehoben).

Die Klasse definiert das Shape-Objekt spotlight, das ein Rechteck um jedes ausgewählte Zeichen zeichnet. Wenn der Benutzer auf das Textfeld myTextField klickt, wird die clickHandler()-Methode aufgerufen.

In der clickHandler()-Methode ruft die getCharIndexAtPoint()-Methode den Index des ausgewählten Zeichens basierend auf den localX- und localY-Koordinaten des Mausklicks ab, der relativ zum Sprite-Objekt, in dem er sich befindet, ist. Die getCharIndexAtPoint()-Methode gibt -1 zurück, wenn der Punkt (der Mausklick) sich auf keinem Zeichen befindet. Da das Textfeld größer sein kann als der Text, wird die zurückgegebene Ganzzahl (index) überprüft, um sicherzustellen, dass der Benutzer auf ein Zeichen geklickt hat. Die Ganzzahl index wird auch von getCharBoundaries() verwendet, um ein Rectangle-Objekt abzurufen, das die Grenzen des Zeichens enthält. Die clear()-Methode löscht alle zuvor angezeigten spotlight-Shape-Objekte. An der Position des Zeichens (ausgehend von den Koordinaten (10, 10)) wird mithilfe der zurückgegebenen x- und y-Koordinaten des frame-Rechtecks ein neues Rechteck in der Größe der Breite- und Höhe-Werte des Zeichens gezeichnet. Um das Zeichen hervorzuheben, wird das Shape-Objekt spotlight mit Gelb gefüllt und die Deckkraft wird auf 35 Prozent gesetzt, sodass das Zeichen zu erkennen ist. Beachten Sie, dass Leerzeichen auch als Zeichen behandelt werden.

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

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

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

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

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

getCharIndexAtPoint

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt den auf null basierenden Indexwert des Zeichens an dem von den Parametern x und y angegebenen Punkt zurück.

Parameter

x:Number — Die x-Koordinate des Zeichens.
 
y:Number — Die y-Koordinate des Zeichens.

Rückgabewerte
int — Der Indexwert für das Zeichen mit Basis null (d. h., die erste Position ist 0, die zweite Position 1 usw.). Wenn der Wert -1 zurückgegeben wird, befindet sich der Punkt nicht über einem Zeichen.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird das Zeichen in ein anderes Textfeld über dem Text kopiert, wenn der Benutzer auf ein Zeichen klickt.

Das erste Textfeld enthält dann den Text, den der Benutzer auswählt. Um sicherzustellen, dass nur auf den Text geklickt, dieser aber nicht ausgewählt wird, wird die selectable-Eigenschaft auf „false“ gesetzt. Wenn der Benutzer auf das Textfeld firstTextField klickt, wird die clickHandler()-Methode aufgerufen.

In der clickHandler()-Methode gibt die getCharIndexAtPoint()-Methode den Index des Zeichens zurück, basierend auf den localX- und localY-Koordinaten des Mausklicks. Da das Textfeld größer sein kann als der Text, wird die zurückgegebene Ganzzahl (index) überprüft, um sicherzustellen, dass der Benutzer auf ein Zeichen geklickt hat. Die getCharIndexAtPoint()-Methode gibt -1 zurück, wenn der Punkt (der Mausklick) sich nicht auf einem Zeichen befindet. Anhand der Mauskoordinaten werden die Koordinaten des neuen Textfelds, in dem die kopierten Zeichen angezeigt werden, festgelegt. Die Farbe der Zeichen im zweiten Textfeld wird auf „rot“ gesetzt. Zum Schluss wird der Text des zweiten Feldes auf das ausgewählte Zeichen festgelegt, das mit der charAt()-Methode abgerufen wird. Beachten Sie, dass bei Verwendung der text-Eigenschaft anstelle der appendText()-Methode das Zeichen im zweiten Feld überschrieben wird, anstatt das Zeichen anzuhängen.

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

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

            firstTextField.addEventListener(MouseEvent.CLICK, clickHandler);

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

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

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

getFirstCharInParagraph

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt anhand eines Zeichenindex den Index des ersten Zeichens im gleichen Absatz zurück.

Parameter

charIndex:int — Der Indexwert für das Zeichen mit Basis null (d. h., das erste Zeichen ist 0, das zweite Zeichen 1 usw.).

Rückgabewerte
int — Der auf null basierende Indexwert des ersten Zeichens im gleichen Absatz.

Auslöser
RangeError — Der angegebene Zeichenindex befindet sich nicht im gültigen Bereich.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird eine Absatzformatierung auf den Inhalt des Textfelds angewendet. Wenn der Benutzer auf einen Absatz klickt, wird der Text des Absatzes rechts ausgerichtet; klickt der Benutzer erneut auf den Absatz, wird das ursprüngliche (Standard-)Format, Ausrichtung links, angewendet.

Im Konstruktor wird das Textfeld myTextField für den Zeilenumbruch eingerichtet. Die getTextFormat-Methode gibt das ursprüngliche Format des ersten Zeichens des Textfeldinhalts zurück, das in das TextFormat-Objekt originalFormat platziert wird. Ein neues TextFormat-Objekt (newFormat) wird definiert, dessen align-Eigenschaft auf die Ausrichtung rechts gesetzt wird. Wenn der Benutzer auf das Textfeld klickt, wird die clickHandler()-Methode aufgerufen.

In der clickHandler()-Methode gibt die getCharIndexAtPoint()-Methode den Index des Zeichens zurück, basierend auf den localX- und localY-Koordinaten des Mausklicks. Die erste if-Anweisung überprüft, ob der Benutzer auf ein Zeichen geklickt hat. Unter Verwendung der clickIndex-Ganzzahl, die von der getCharIndexAtPoint()-Methode zurückgegeben wird, gibt die getFirstCharInParagraph()-Methode den Index des ersten Zeichens in dem Absatz, auf den der Benutzer geklickt hat, zurück. Der Index des letzten Zeichens im Absatz wird bestimmt, indem die Länge des Absatzes (mithilfe der getParagraphLength()-Methode) zum Index des ersten Zeichens im Absatz hinzugefügt wird, abzüglich des letzten Zeichens (\n). Die zweite if-Anweisung überprüft das Format des ersten Zeichens im Absatz. Wenn dessen Ausrichtung mit der des ursprünglichen Formats (Linksausrichtung) übereinstimmt, wird das neue Format auf alle Zeichen im Absatz angewendet. Andernfalls wird das Format des Absatzes auf das ursprüngliche Format zurückgesetzt. Die Ausrichtung ist genau wie Einzug, Aufzählungszeichen, Tabulator, linker und rechter Rand eine Formatierung, die für Absätze gilt. Beachten Sie, dass bei Verwendung eines Zeilenumbruchs die Formatierung nur auf die erste Zeile des Absatzes angewendet wird, wenn das Argument endIndex für die setTextFormat()-Methode nicht definiert ist.

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

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

            originalFormat = myTextField.getTextFormat(0);

            newFormat.align = TextFormatAlign.RIGHT;

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

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

getImageReference

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt einen DisplayObject-Verweis für die angegebene id zurück, bei einem Bild bzw. einer SWF-Datei, das/die einem HTML-formatierten Textfeld mit dem Tag <img> hinzugefügt wurde. Das Tag <img> liegt im folgenden Format vor:

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

Parameter

id:String — Die id, für die eine Entsprechung vorliegen muss (im Attribut id des Tags <img>).

Rückgabewerte
DisplayObject — Das Anzeigeobjekt, das dem Bild bzw. der SWF-Datei mit dem passenden id-Attribut im Tag <img> des Textfelds entspricht. Bei Medien von einer externen Quelle handelt es sich um ein Loader-Objekt. Sobald das Medienobjekt geladen ist, handelt es sich um ein untergeordnetes Objekt dieses Loader-Objekts. Für in die SWF-Datei eingebetteten Medien ist dies das geladene Objekt. Wenn kein <img>-Tag mit der übereinstimmenden id existiert, gibt die Methode null zurück.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird das Bild im Feld beim Klicken auf das Textfeld auf eine Deckkraft von 25 Prozent gesetzt und um 90 Grad gedreht. Mit jedem folgenden Mausklick wird das Bild erneut um 90 Grad gedreht.

Das Bild (image.jpg) wird über HTML eingeschlossen. (Hier wird davon ausgegangen, dass sich die Bilddatei im selben Verzeichnis wie die SWF-Datei befindet). Ein id-Attribut muss für das img-Tag definiert werden, damit mit der getImageReference()-Methode auf das Bild zugegriffen werden kann. Die htmlText-Eigenschaft wird verwendet, um HTML-formatierte Stringinhalte einzuschließen. Wenn der Benutzer auf das Textfeld myTextField klickt, wird die clickHandler()-Methode aufgerufen.

In der clickHandler()-Methode gibt die getImageReference()-Methode einen Verweis auf das Bild als DisplayObject zurück. Mit diesem Verweis kann das Bild wie jedes DisplayObject-Objekt bearbeitet werden. Hier werden die Eigenschaften alpha (Transparenz) und rotation festgelegt. Die transform-Eigenschaft kann verwendet werden, um auf die Matrix, die Farbtransformation und die Pixelgrenzen des Anzeigeobjekts zuzugreifen. Beachten Sie auch, dass flash.display.DisplayObject importiert werden muss.

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

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

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

getLineIndexAtPoint

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt den auf null basierenden Indexwert der Zeile an dem von den Parametern x und y angegebenen Punkt zurück.

Parameter

x:Number — Die x-Koordinate der Zeile.
 
y:Number — Die y-Koordinate der Zeile.

Rückgabewerte
int — Der Indexwert für die Zeile mit Basis null (d. h., die erste Zeile ist 0, die zweite Zeile 1 usw.). Wenn der Wert -1 zurückgegeben wird, befindet sich der Punkt nicht über einer Zeile.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird eine Zeile aus einem Shakespeare-Sonett in eines neues Textfeld kopiert, wenn der Benutzer auf die Zeile klickt.

Im Konstruktor wird das Textfeld poem so festgelegt, dass kein Zeilenumbruch verwendet wird (da es sich um ein Gedicht handelt). Die autoSize-Eigenschaft wird verwendet, um den Text automatisch anzupassen und ggf. seine Größe als links ausgerichteter Text zu ändern. Das Textfeld poemCopy wird unter dem Textfeld poem platziert. Wenn der Benutzer auf eine Zeile des Gedichts klickt, wird die clickHandler()-Methode aufgerufen.

In der clickHandler()-Methode gibt die getLineIndexAtPoint()-Methode den Zeilenindex der Zeile zurück, auf die der Benutzer geklickt hat, basierend auf den localX- und localY-Koordinaten des Mausklicks. (Da das Originalgedicht in das Textfeld passt, ist es hier nicht erforderlich, zu überprüfen, ob der Text außerhalb des Bereichs liegt (RangeError), von der getCharIndexAtPoint()-Methode ausgegeben.) Der Zeilenindex wird verwendet, um den Inhalt der Zeile mit der getLineText()-Methode als String abzurufen, der dann an den Inhalt des Textfelds poemCopy angehängt wird. Das Kopieren kann kontinuierlich fortgeführt werden, ab einem bestimmten Punkt befindet sich der Text jedoch außerhalb des sichtbaren Bereichs des Textfelds poemCopy.

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

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

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

           poem.addEventListener(MouseEvent.CLICK, clickHandler); 

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

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

getLineIndexOfChar

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt den auf null basierenden Indexwert der Zeile zurück, die das vom charIndex-Parameter angegebene Zeichen enthält.

Parameter

charIndex:int — Der Indexwert für das Zeichen mit Basis null (d. h., das erste Zeichen ist 0, das zweite Zeichen 1 usw.).

Rückgabewerte
int — Der auf null basierende Indexwert der Zeile.

Auslöser
RangeError — Der angegebene Zeichenindex befindet sich nicht im gültigen Bereich.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel gibt die getLineIndexOfChar()-Methode die Zeilennummern für das 100. und 500. Zeichen im Textfeld zurück.

Das Textfeld myTextField wurde mit Zeilenumbruch und als links ausgerichteter Text definiert. Die getLineIndexOfChar()-Methode gibt den Zeilenindex für die angegebenen Zeichenindizes (100 und 500) zurück. Diese Informationen werden dann an den Absatz angehängt. Beachten Sie, dass der Zeilenindex (index) um 1 erhöht wird, um die Zeilennummer zu erhalten, da der Zeilenindex mit 0 beginnt. Wenn die Anzeigegröße geändert wird, kann sich die Zeilennummer zwar ändern, die Informationen hier bleiben jedoch unverändert, da die Methode nur ein Mal aufgerufen wird.

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

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

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

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

            this.addChild(myTextField);
        }
    }
}

getLineLength

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt die Zeichenanzahl in einer bestimmten Textzeile zurück.

Parameter

lineIndex:int — Die Nummer der Zeile, deren Länge Sie ermitteln möchten.

Rückgabewerte
int — Die Anzahl der Zeichen in der Zeile.

Auslöser
RangeError — Die angegebene Zeilennummer befindet sich nicht im Bereich.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird die Zeilenlänge (Anzahl der Zeichen) einer Zeile in einem separaten Feld angezeigt, wenn der Benutzer auf die Zeile klickt.

Zur Veranschaulichung wird das Textfeld myTextField, in dem der zu zählende Text angezeigt wird, auf INPUT gesetzt, sodass der Benutzer die Zeilen ändern oder zwischen den Zeilen bzw. am Ende Zeilen hinzufügen kann. (Am Ende der letzten Zeile wird mithilfe eines Zeilenumbruchs (\n) eine leere Zeile erstellt.) Das Textfeld countLines, in dem das Ergebnis der Zeilenlängenermittlung angezeigt wird, wird unter dem Textfeld myTextField platziert, der Text in diesem Feld kann nicht ausgewählt werden. Wenn der Benutzer auf eine Zeile im Textfeld myTextField klickt, wird die clickHandler()-Methode aufgerufen.

In der clickHandler()-Methode gibt die getLineIndexAtPoint()-Methode den Zeilenindex der Zeile zurück, auf die der Benutzer geklickt hat. Dazu werden die localX- und localY-Koordinaten des Mausklicks verwendet. Die if-Anweisung überprüft, ob der Benutzer auf ein Zeichen geklickt hat. Ist dies der Fall, gibt die getLineLength()-Methode unter Verwendung des Zeilenindex die Anzahl der Zeichen in der Zeile zurück. Beachten Sie, dass die leeren Zeilen zwischen den Zeilen das zweite Zeilenumbruchzeichen (\n) enthalten und eine Zählung von 1 Zeichen aufweisen, während die Zeile nach der letzten Zeile eine Zählung von 0 aufweist. Leerzeichen zählen ebenfalls als ein Zeichen. Der Benutzer kann eine neue Zeile schreiben oder eine Zeile ändern und die Zeichenzählung der Zeile erhalten, indem er auf die Zeile klickt. Wenn Zeilenumbrüche verwendet werden und die Bildschirmgröße geändert wird, könnte sich der Zeilenindex ändern.

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

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

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

            this.addChild(myTextField);

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

           this.addChild(countLines);    

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

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

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

getLineMetrics

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt metrische Informationen zu einer bestimmten Textzeile zurück.

Parameter

lineIndex:int — Die Nummer der Zeile, für die Sie metrische Informationen ermitteln möchten.

Rückgabewerte
flash.text:TextLineMetrics — Ein TextLineMetrics-Objekt.

Auslöser
RangeError — Die angegebene Zeilennummer befindet sich nicht im Bereich.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel werden einige metrische Zeilenwerte für zwei unterschiedlich formatierte Textzeilen angezeigt.

Der angehängte Text befindet sich zwei Zeilen unter dem Gedicht Song of Myself von Walt Whitman. Mit einem neuen TextFormat-Objekt (newFormat) wird das Format der zweiten Zeile festgelegt. Die erste Zeile enthält das Standardformat. Die getLineMetrics()-Methode gibt ein TextLineMetrics-Objekt für eine bestimmte Zeile zurück. (Der Zeilenindex beginnt mit 0.) Mit den TextLineMetrics-Objekten metrics1 und metrics2 für die erste und zweite Zeile werden jeweils die Werte für die Oberlänge (ascent), Unterlänge (descent), Höhe (height) und Strichstärke (weight) der Zeile abgerufen und angezeigt. Die resultierenden Zahlen werden in Strings konvertiert, jedoch nicht gerundet. Beachten Sie, dass dieser Wert für die Zeile und nicht für ein bestimmtes Zeichen gilt. Er spiegelt den Bereich der Zeichen für eine Zeile wieder. Wenn in einer Zeile zum Beispiel Zeichen mit unterschiedlichen Höhen vorkommen, bestimmt das Zeichen mit dem höchsten Wert für die Höhe den Wert. Dies bedeutet auch, dass sich einige metrische Werte ändern können, wenn das Format eines Zeichens geändert wird.

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

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

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

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

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

            addChild(myTextField);
        }
    }
}

getLineOffset

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt den Zeichenindex des ersten Zeichens in der vom Parameter lineIndex angegebenen Zeile zurück.

Parameter

lineIndex:int — Der Indexwert für die Zeile mit Basis null (d. h., die erste Zeile ist 0, die zweite Zeile 1 usw.).

Rückgabewerte
int — Der auf null basierende Indexwert des ersten Zeichens in der Zeile.

Auslöser
RangeError — Die angegebene Zeilennummer befindet sich nicht im Bereich.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird das erste Zeichen in Zeile 4 überprüft, welches sich ändert, wenn die Größe des Bildschirms (und des Textfelds) geändert wird.

Für das Textfeld myTextField wird der Zeilenumbruch festgelegt. Im Textfeld countField wird das erste Zeichen der Zeile 4 angezeigt. Wenn der Benutzer auf das Textfeld myTextField klickt, wird die clickHandler()-Methode aufgerufen.

In der clickHandler()-Methode gibt die getLineOffset()-Methode den Index des ersten Zeichens bei Zeilenindex 3, also in der vierten Zeile des Textes, zurück. (Die erste Zeile hat den Index 0.) Die charAt()-Methode wird verwendet, um das Zeichen mithilfe des Index des ersten Zeichens der vierten Zeile abzurufen. Der Inhalt des Textfelds countField wird mit diesen Informationen aktualisiert; dazu wird die text-Eigenschaft des Textfelds countField verwendet. Die Verwendung der countField.text-Eigenschaft bedeutet, dass nach jedem Klick der Inhalt des Textfelds countField überschrieben wird. Wenn der Benutzer die Größe der Anzeige ändert, wird für den Inhalt ein Zeilenumbruch ausgeführt, und das erste Zeichen der Zeile 4 könnte sich ändern. Durch erneutes Klicken auf das Textfeld myTextField wird der Inhalt des Textfelds countField mit dem neuen ersten Zeichen der vierten Zeile aktualisiert.

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

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

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

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

getLineText

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt den Text der durch den Parameter lineIndex angegebenen Zeile zurück.

Parameter

lineIndex:int — Der Indexwert für die Zeile mit Basis null (d. h., die erste Zeile ist 0, die zweite Zeile 1 usw.).

Rückgabewerte
String — Der in der angegebenen Zeile enthaltene Textstring.

Auslöser
RangeError — Die angegebene Zeilennummer befindet sich nicht im Bereich.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel werden die Zeilennummern aller Vorkommnisse des Wortes „love“ im Shakespeare-Sonett gesucht und angezeigt.

Das Textfeld poem wird so eingerichtet, dass es sich an den Text anpasst und links ausgerichteten Text anzeigt. Die wordWrap-Eigenschaft wird auf false gesetzt, sodass für die Zeilen des Gedichts kein Zeilenumbruch ausgeführt wird, obwohl dies normalerweise kein Problem sein sollte, wenn die autoSize-Eigenschaft verwendet wird. Die for -Schleife durchläuft die Zeilen des Sonetts mithilfe der numLines-Eigenschaft des Textfelds. Die getLineText()-Methode gibt den Inhalt der Zeile als String zurück. (Beachten Sie, dass die numLines-Eigenschaft die Anzahl der Zeilen ab 1 zurückgibt, während bei der getLineText()-Methode die Zeilennummern bei 0 anfangen.) Unter Verwendung des regulären Ausdrucks (/love/i) sucht die if-Anweisung nach Teilstrings des Worts und Groß- oder Kleinschreibung. Wenn der Ausdruck gefunden wird, gibt die search-Methode den Index des ersten übereinstimmenden Teilstrings zurück, andernfalls wird -1 zurückgegeben (wenn kein Treffer gefunden wird). Die Nummer der Zeile, in der „love“ gefunden wurde ((i + 1)), wird dann in den String lineResult platziert. Die string-Methode konvertiert das number-Argument ((i + 1)) in einen String, sofern es ein anderes Argument gibt, das ein String ist (" "). Das Zeilenergebnis der Suche schließt Zeilen mit den Wörtern „loved“ oder „Love's“ mit ein. Wenn der String „Love was found in lines:“ (Liebe wurde in diesen Zeilen gefunden:) der for-Schleife vorangestellt würde, wäre das Wort „Love“ in dieser Zeile ebenfalls eingeschlossen worden.

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

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

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

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

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

getParagraphLength

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt anhand eines Zeichenindex die Länge des Absatzes mit dem angegebenen Zeichen zurück. Die Länge wird relativ zum ersten Zeichen im Absatz (wie von getFirstCharInParagraph() zurückgegeben) und nicht zum vorliegenden Zeichenindex angegeben.

Parameter

charIndex:int — Der Indexwert für das Zeichen mit Basis null (d. h., das erste Zeichen ist 0, das zweite Zeichen 1 usw.).

Rückgabewerte
int — Gibt die Anzahl der Zeichen im Absatz zurück.

Auslöser
RangeError — Der angegebene Zeichenindex befindet sich nicht im gültigen Bereich.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird die Länge des Absatzes sowie die Anzahl des Zeichens „s“ im Absatz in einem separaten Textfeld angezeigt, wenn der Benutzer eine Absatz auswählt.

Im Textfeld myTextField werden die Absätze angezeigt, die der Benutzer auswählt. Wenn der Benutzer auf das Textfeld klickt, wird das MouseEvent.CLICK-Ereignis ausgelöst und die clickHandler()-Methode wird aufgerufen. Die Länge des Absatzes und die Anzahl der „s“-Zeichen wird im Textfeld countField angezeigt, das unter dem Textfeld myTextField platziert wird.

In der clickHandler()-Methode gibt die getCharIndexAtPoint()-Methode den Index des Zeichens zurück, basierend auf den localX- und localY-Koordinaten des Mausklicks. Die erste if-Anweisung überprüft, ob der Benutzer auf ein Zeichen geklickt hat. Die getFirstCharInParagraph()-Methode verwendet diesen Index, um den Index des ersten Zeichens im selben Absatz zurückzugeben. Die von der getParagraphLength()-Methode zurückgegebene Absatzlänge wird zusammen mit dem Index des ersten Zeichens im Absatz verwendet, um den Index für das Absatzende zu bestimmen. Eine for-Schleife durchläuft den Absatz und ermittelt die Anzahl der „s“-Zeichen.

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

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

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

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

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

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

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

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

getTextFormat

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt ein TextFormat-Objekt mit Formatierungsinformationen für den durch die Parameter beginIndex und endIndex angegebenen Textbereich zurück. Nur Eigenschaften, die für den gesamten Text gelten, sind im resultierenden TextFormat-Objekt eingestellt. Für jede gemischte Eigenschaft, die an unterschiedlichen Stellen im Text unterschiedliche Werte aufweist, wird der Wert auf null gesetzt.

Wenn Sie keine Werte für diese Parameter angeben, wird diese Methode auf den gesamten Text im Textfeld angewendet.

In der folgenden Tabelle sind drei Verwendungsmöglichkeiten aufgeführt:

VerwendungBeschreibung
my_textField.getTextFormat()Gibt ein TextFormat-Objekt mit den Formatierungsinformationen für den gesamten Text in einem Textfeld zurück. Nur Eigenschaften, die für den gesamten Text im Textfeld gelten, sind im resultierenden TextFormat-Objekt eingestellt. Für jede gemischte Eigenschaft, die an unterschiedlichen Stellen im Text unterschiedliche Werte aufweist, wird der Wert auf null gesetzt.
my_textField.getTextFormat(beginIndex:Number)Gibt ein TextFormat-Objekt mit einer Kopie des Textformats an der durch beginIndex gekennzeichneten Position zurück.
my_textField.getTextFormat(beginIndex:Number,endIndex:Number)Gibt ein TextFormat-Objekt mit Formatierungsinformationen für den Textbereich zwischen beginIndex und endIndex-1 zurück. Nur Eigenschaften, die für den gesamten Text im angegebenen Textbereich gelten, sind im resultierenden TextFormat-Objekt eingestellt. Alle „gemischten“ Eigenschaften (mixed), die an unterschiedlichen Stellen im Textbereich unterschiedliche Werte aufweisen, besitzen den Wert null.

Parameter

beginIndex:int (default = -1) — Optional; eine Ganzzahl, die den Startpunkt eines Textbereichs innerhalb des Textfelds angibt.
 
endIndex:int (default = -1) — Optional; eine Ganzzahl zur Angabe der Position des ersten Zeichens nach dem gewünschten Textbereich. Wenn Sie die Werte beginIndex und endIndex angeben, wird wie gewünscht der Text von beginIndex bis endIndex-1 gelesen.

Rückgabewerte
flash.text:TextFormat — Das TextFormat-Objekt, das die Formatierungseigenschaften des angegebenen Texts wiedergibt.

Auslöser
RangeError — Der angegebene beginIndex bzw. endIndex befindet sich nicht im gültigen Bereich.

Verwandte API-Elemente


Beispiel
Verwendung dieses Beispiels
Bitte sehen Sie sich das Beispiel für die getFirstCharInParagraph()- oder setTextFormat()-Methode an, in dem illustriert ist, wie die getTextFormat()-Methode verwendet wird.

isFontCompatible

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5, Flash Lite 4

Gibt „true“ zurück, wenn eine eingebettete Schriftart mit dem angegebenen fontName und fontStyle verfügbar ist, wobei Font.fontType gleich flash.text.FontType.EMBEDDED ist. Ab Flash Player 10 können zwei Arten von eingebetteten Schriftarten in einer SWF-Datei erscheinen. Normale eingebettete Schriftarten werden nur mit TextField-Objekten verwendet. CFF-Schriftarten werden nur von den flash.text.engine-Klassen verwendet. Die beiden Arten unterscheiden sich durch die fontType-Eigenschaft der Font-Klasse, die von der enumerateFonts()-Funktion zurückgegeben wird.

TextField kann keine Schriftarten des Typs EMBEDDED_CFF verwenden. Wenn embedFonts auf true gesetzt ist und die einzige Schriftart, die zur Laufzeit mit dem angegebenen Namen und Stil verfügbar ist, vom Typ EMBEDDED_CFF ist, kann Flash Player den Text nicht wiedergeben (so als ob keine eingebetteten Schriftarten mit dem angegebenen Namen und Stil zur Verfügung stünden).

Wenn sowohl EMBEDDED- als auch EMBEDDED_CFF-Schriftarten mit dem gleichen Namen und Stil verfügbar sind, wird die EMBEDDED-Schriftart ausgewählt und Text wird mit der EMBEDDED-Schriftart wiedergegeben.

Parameter

fontName:String — Der Name der zu überprüfenden eingebetteten Schriftart.
 
fontStyle:String — Legt den Schriftstil fest, der geprüft werden soll. Verwenden Sie flash.text.FontStyle

Rückgabewerte
Booleantrue, wenn eine kompatible eingebettete Schriftart verfügbar ist, wenn nicht, dann false.

Auslöser
ArgumentError — Der angegebene fontStyle ist kein Mitglied von flash.text.FontStyle.

Verwandte API-Elemente

replaceSelectedText

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ersetzt die aktuelle Auswahl durch den Inhalt des Parameters value. Der Text wird an der Stelle eingefügt, an der sich die aktuelle Auswahl befindet; es werden das Standardzeichenformat und das Standardabsatzformat verwendet. Der Text wird nicht als HTML behandelt.

Mit der replaceSelectedText()-Methode können Sie Text einfügen und löschen, ohne die Zeichen- und Absatzformatierung des übrigen Textes zu beeinflussen.

Hinweis: Diese Methode funktioniert nicht, wenn ein Stylesheet auf das Textfeld angewendet wird.

Parameter

value:String — Der String, mit dem der aktuell ausgewählte Text ersetzt wird.


Auslöser
Error — Diese Methode kann bei einem Textfeld mit Stylesheet nicht verwendet werden.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel löscht der Benutzer Text aus dem ersten Textfeld, indem er ihn auswählt und den ausgewählten Text im zweiten Textfeld durch den String „NEW TEXT“ ersetzt.

Es werden zwei verschiedene TextField-Objekte erstellt, und für die MouseEvent.MOUSE_UP-Ereignisse werden Ereignis-Listener hinzugefügt. „Mouse up“ tritt ein, wenn der Benutzer die Maustaste loslässt, ein Ereignis, das normalerweise nach der Auswahl eines Textabschnitts vorkommt. Beachten Sie, dass die Standardeinstellung eines Textfelds vorsieht, dass der darin befindliche Text ausgewählt werden kann.

Mit der mouseHandler1()-Methode wird der Text gelöscht, indem er durch einen leeren String ersetzt wird, wenn der Benutzer die Maustaste im Textfeld myTextField1 loslässt. Dies kann wiederholt werden, bis der gesamte Text gelöscht wurde. In der mouseHandler2()-Methode werden die Eigenschaften selectionBeginIndex und selectionEndIndex überprüft, um festzustellen, ob Zeichen ausgewählt wurden, wenn ein Benutzer Text im Textfeld myTextField2 auswählt. (Die Eigenschaften selectionBeginIndex und selectionEndIndex haben nicht denselben Wert, wenn Text ausgewählt wurde.) Der ausgewählte Text wird dann durch den String „NEW TEXT“ ersetzt. Dies kann wiederholt werden, bis der gesamte ursprüngliche Text des zweiten Textfelds durch den String „NEW TEXT“ ersetzt wurde.

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

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

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

replaceText

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Ersetzt den Zeichenbereich, der durch die Parameter beginIndex und endIndex angegeben wird, durch den Inhalt des Parameters newText. Wie geplant wird der Text ab beginIndex bis endIndex-1 ersetzt.

Hinweis: Diese Methode funktioniert nicht, wenn ein Stylesheet auf das Textfeld angewendet wird.

Parameter

beginIndex:int — Der auf Null basierende Indexwert für die Startposition des Ersetzungsbereichs.
 
endIndex:int — Die auf null basierende Indexposition des ersten Zeichens nach dem gewünschten Textabschnitt.
 
newText:String — Der Text, durch den der angegebene Zeichenbereich ersetzt werden soll.


Auslöser
Error — Diese Methode kann bei einem Textfeld mit Stylesheet nicht verwendet werden.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird die replaceText()-Methode verwendet, um Text in einem Textfeld zu löschen, zu ersetzen und einzufügen.

Das Textfeld outputText wird so eingerichtet, dass es sich an den Text anpasst und links ausgerichteten Text anzeigt. Mit dem ersten Aufruf der replaceText()-Methode wird die erste Zeile („This is the wrong heading“) durch „THIS IS THE HEADING FOR EVERYONE“ ersetzt. Mit dem zweiten Aufruf der Methode wird der Text „CORRECT“ zwischen „THE“ und „HEADING“ eingefügt. Mit dem dritten Aufruf der Methode werden die Worte „FOR EVERYONE“ gelöscht. Beachten Sie, dass mit jedem Aufruf der appendText()-Methode der Anfangs- und Endindex des Textes geändert wird. Hier wird nur der endgültige Text (nachdem alle Änderungen vorgenommen wurden) angezeigt.

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

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

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

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

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

setSelection

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Legt den durch die Indexwerte des ersten und letzten Zeichens (Parameter beginIndex und endIndex) angegebenen Text als ausgewählt fest. Wenn die beiden Parameterwerte gleich sind, setzt diese Methode den Einfügepunkt (so als ob Sie die caretIndex-Eigenschaft setzen).

Parameter

beginIndex:int — Der auf null basierende Indexwert für das erste Zeichen der Auswahl (d. h., das erste Zeichen ist 0, das zweite Zeichen 1 usw.).
 
endIndex:int — Der auf null basierende Indexwert des letzten Zeichens in der Auswahl.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Wenn der Benutzer im folgenden Beispiel auf eine beliebige Stelle im Textfeld klickt, wird ein vordefinierter Textbereich ausgewählt (der die Wörter „TEXT IN ALL CAPS“ hervorhebt).

Zwei Ereignis-Listener für das Textfeld myTextField antworten auf das Betätigen bzw. auf das Loslassen der Maustaste durch den Benutzer. „Mouse up“ tritt ein, wenn der Benutzer die Maustaste loslässt, ein Ereignis, das normalerweise nach der Auswahl eines Textabschnitts vorkommt. Beachten Sie, dass die Standardeinstellung eines Textfelds vorsieht, dass der darin befindliche Text ausgewählt werden kann. Wenn auf Text geklickt wird, wird die clickHandler()-Methode aufgerufen. Wenn Text ausgewählt wurde und die Maustaste losgelassen wird, wird die mouseUpHandler()-Methode aufgerufen.

In beiden Methoden, clickHandler() und mouseUpHandler(), legt die setSelection()-Methode nur die Zeichen zwischen den Indizes 54 und 70 (TEXT IN ALL CAPS) als ausgewählt fest.

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

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

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

            this.addChild(myTextField);
        }

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

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

    }
}

setTextFormat

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

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Weist dem angegebenen Text in einem Textfeld die mit dem Parameter format angegebene Textformatierung zu. Der Wert des Parameters format muss ein TextFormat-Objekt mit den gewünschten Änderungen bei der Textformatierung sein. Nur die Eigenschaften von format, die nicht null lauten, werden dem Textfeld zugewiesen. Eigenschaften von format, die auf null gesetzt wurden, werden nicht zugewiesen. Standardmäßig sind alle Eigenschaften eines neu erstellten TextFormat-Objekts auf null gesetzt.

Hinweis: Diese Methode funktioniert nicht, wenn ein Stylesheet auf das Textfeld angewendet wird.

Mit der Methode setTextFormat() wird das Textformat geändert, das auf einen Zeichenbereich oder den gesamten Text in einem Textfeld angewendet wird. Geben Sie keine Werte für beginIndex und endIndex an, wenn die Eigenschaften des Formats auf den kompletten Text im Textfeld angewendet werden sollen. Wenn Sie die Eigenschaften des Formats auf einen Textbereich anwenden möchten, geben Sie Werte für die Parameter beginIndex und endIndex an. Mit der Eigenschaft length können Sie die Indexwerte bestimmen.

Die beiden Arten von Formatierungsinformationen in einem TextFormat-Objekt sind Formatierungen auf Zeichen- und auf Absatzebene. Jedes Zeichen in einem Textfeld kann seine eigenen Zeichenformatierungseinstellungen (z. B. Schriftname, Schriftgrad, fett und kursiv) haben.

Bei Absätzen wird das erste Zeichen im Absatz auf die für den gesamten Absatz geltenden Absatzformatierungseinstellungen überprüft. Es gibt unter anderem folgende Absatzformatierungseinstellungen: linker Rand, rechter Rand und Einzug.

Jeder Text, der manuell vom Benutzer eingefügt oder durch die replaceSelectedText()-Methode ersetzt wird, erhält die Textfeld-Standardformatierung für neuen Text und nicht die Formatierung, die für den Texteinfügepunkt angegeben ist. Um die Standardformatierung für neuen Text festzulegen, verwenden Sie defaultTextFormat.

Parameter

format:flash.text:TextFormat — Ein TextFormat-Objekt, das sowohl Zeichen- als auch Absatzformatierungsinformationen enthält.
 
beginIndex:int (default = -1) — Optional; eine Ganzzahl, die die auf null basierende Indexposition angibt, die ihrerseits das erste Zeichen im gewünschten Textbereich angibt.
 
endIndex:int (default = -1) — Optional; eine Ganzzahl zur Angabe des ersten Zeichens nach dem gewünschten Textbereich. Wenn Sie die Werte beginIndex und endIndex angeben, wird wie gewünscht der Text von beginIndex bis endIndex-1 aktualisiert.

VerwendungBeschreibung
my_textField.setTextFormat(textFormat:TextFormat)Wendet die Eigenschaften von textFormat auf den gesamten Text im Textfeld an.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int)Wendet die Eigenschaften von textFormat auf den Text an, der an der Position beginIndex beginnt.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int, endIndex:int)Wendet die Eigenschaften von textFormat auf den Textbereich zwischen beginIndex und endIndex-1 an.

Beachten Sie, dass manuell vom Benutzer eingefügter oder mit der replaceSelectedText()-Methode ersetzter Text nicht die für die Texteinfügemarke angegebene Formatierung, sondern die Standardformatierung für neuen Text des Textfelds erhält. Wenn Sie die Standardformatierung eines Textfelds für neuen Text definieren möchten, verwenden Sie die Eigenschaft defaultTextFormat.


Auslöser
Error — Diese Methode kann bei einem Textfeld mit Stylesheet nicht verwendet werden.
 
RangeError — Der angegebene beginIndex bzw. endIndex befindet sich nicht im gültigen Bereich.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wechselt beim Klicken auf den Text ein definierter Textbereich, „TEXT IN ALL CAPS“ zwischen dem Standardtextformat und dem neuen Format.

Es wird ein Ereignis-Listener für das Textfeld myTextField hinzugefügt, das auf Mausklicks reagiert, indem die clickHandler()-Methode aufgerufen wird. In der clickHandler()-Methode gibt die getTextFormat()-Methode das aktuelle Format eines Zeichens (Index 55) aus dem eingerückten Bereich des Texts zurück, welches dann in das TextFormat-Objekt currentTextFormat platziert wird. Die if-Anweisung überprüft das Textformat currentTextFormat, um festzustellen, ob die Zeichen in dem Bereich das neue Format verwenden (Schriftgröße 18 Punkt). Ist dies nicht der Fall, ändert das neue Format die Größe auf 18 Punkt, die Farbe auf Rot und wendet die Formate Unterstrichen und Kursiv auf den Bereich zwischen 54 und 70 (TEXT IN ALL CAPS) an. Wenn das Zeichen in dem Bereich das neue Format verwendet, wird das Format des Bereichs auf das Standardformat (das ursprüngliche Format) des Textfelds zurückgesetzt.

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

change

Ereignis
Ereignisobjekttyp: flash.events.Event
Eigenschaft Event.type = flash.events.Event.CHANGE

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Wird ausgelöst, nachdem ein Steuerelementwert geändert wurde (im Gegensatz zum textInput-Ereignis, das ausgelöst wird, bevor der Wert geändert wird). Im Gegensatz zur W3C DOM-Ereignismodell-Version des change-Ereignisses, bei der das Ereignis erst nach einem Wechsel des Fokus auf ein anderes Steuerelement ausgelöst wird, wird das Ereignis bei der ActionScript 3.0-Version des change-Ereignisses ausgelöst, sobald sich das Steuerelement ändert. Wenn ein Benutzer z. B. Text in ein Textfeld eingibt, wird ein change-Ereignis nach jedem Tastendruck ausgelöst.

Die Event.CHANGE-Konstante definiert den Wert der type-Eigenschaft eines change-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Objekt, dessen Wert geändert wurde. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird der Text, den der Benutzer eingibt (die Benutzereingabe), sofort in ein anderes Textfeld mit einem anderen Textformat kopiert.

Es werden zwei Textfelder erstellt, eines für die Benutzereingabe und das andere (headingTextField) für die Kopie der Benutzereingabe. Es wird auch ein TextFormat-Objekt erstellt und das Standardtextformat wird dem Textfeld headingTextField zugewiesen. Wenn der Inhalt des Textfelds geändert wird, wird die changeHandler()-Methode aufgerufen, die den Text aus dem Textfeld inputTextField dem Textfeld headingTextField zuweist. (Wenn die Methode für das TextEvent.TEXT_INPUT-Ereignis und nicht für das Event.CHANGE-Ereignis aufgerufen wird, wird der Inhalt der Benutzereingabe erst kopiert, nachdem der Benutzer weiteren Text eingegeben hat.)

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

Ereignis  
Ereignisobjekttyp: flash.events.TextEvent
Eigenschaft TextEvent.type = flash.events.TextEvent.LINK

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Wird ausgelöst, wenn ein Benutzer auf einen Hyperlink in einem HTML-fähigen Textfeld klickt und die URL-Adresse mit „event:“ beginnt. Der Rest der URL nach „event:“ wird in die Texteigenschaft des LINK-Ereignisses platziert.

Hinweis: Das Standardverhalten (dem Textfeld wird Text hinzugefügt) tritt nur dann ein, wenn Flash Player das Ereignis erstellt. Dies ist der Fall, wenn ein Benutzer versucht, Text einzugeben. Eine Texteingabe in ein Textfeld durch Senden von textInput-Ereignissen ist nicht möglich.

Definiert den Wert der Eigenschaft type eines link-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetEs wurde auf das Textfeld mit dem Hyperlink geklickt. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
textDer Rest der URL nach „event:“

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird die Funktion playMP3() definiert. Es wird das TextField-Objekt list erstellt und mit HTML-Text gefüllt. Die Texte "Track 1" und "Track 2" sind Links innerhalb des Textfelds. Die Funktion playMP3() wird aufgerufen, wenn der Benutzer auf einen der Links klickt. Der Name der MP3-Datei nach dem String „event:“ im href-Attribut des HTML-Tags wird an die linkHandler()-Methode als text-Eigenschaft des link-Ereignisobjekts übergeben.
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

Ereignis  
Ereignisobjekttyp: flash.events.Event
Eigenschaft Event.type = flash.events.Event.SCROLL

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Von einem TextField-Objekt ausgelöst, nachdem der Benutzer einen Bildlauf durchgeführt hat.

Die Event.SCROLL-Konstante definiert den Wert der type-Eigenschaft eines scroll-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas TextField-Objekt, für das ein Bildlauf durchgeführt wurde. Die target-Eigenschaft entspricht nicht immer dem Objekt in der Anzeigeliste, das den Ereignis-Listener registriert hat. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.

Beispiel  ( Verwendung dieses Beispiels )

Das folgende Beispiel definiert zwei TextField-Objekte: Das erste TextField-Objekt hat zwei verknüpfte Ereignisprozeduren: Wenn Sie mit der Maus in dieses erste Textfeld klicken, wird das mouseDown-Ereignis ausgelöst und die verknüpfte mouseDownScroll-Prozedur aufgerufen. Die mouseDownScroll()-Prozedur führt dazu, dass im Feld ein Bildlauf durchgeführt wird. Danach wird das scroll-Ereignis ausgelöst und die verknüpfte scrollHandler()-Prozedur aktualisiert das zweite Textfeld, um die aktuelle Bildlaufposition anzuzeigen.
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

Ereignis  
Ereignisobjekttyp: flash.events.TextEvent
Eigenschaft TextEvent.type = flash.events.TextEvent.TEXT_INPUT

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Flash Player löst das Ereignis textInput aus, wenn ein Benutzer ein oder mehr Textzeichen eingibt. Dieses Ereignis kann durch verschiedene Texteingabemethoden ausgelöst werden, z. B. die Standardtastatur, Eingabemethodeneditoren (Input Method Editors, IMEs), Spracherkennungssysteme oder das Einfügen von Text ohne Formatierungs- oder Stilinformationen.

Definiert den Wert der Eigenschaft type eines textInput-Ereignisobjekts.

Hinweis: Dieses Ereignis wird für die Entf- und Rücktaste nicht ausgelöst.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelabletrue; rufen Sie die Methode preventDefault() auf, um das Standardverhalten abzubrechen.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Textfeld, in das die Zeichen eingegeben werden. Das Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
textDas bzw. die Zeichen wird/werden vom Benutzer eingegeben.

Beispiel  ( Verwendung dieses Beispiels )

Das folgende Beispiel definiert zwei TextField-Objekte: das erste TextField-Objekt ist ein Eingabetextfeld, das zweite ein dynamisches Textfeld. Wenn Sie Textzeichen in das erste Textfeld eingeben, wird das textInput-Ereignis ausgelöst, die textInputHandler()-Prozedur aufgerufen und die Zeichen werden im zweiten Textfeld angezeigt. Wenn Sie einen Textblock in das Eingabefeld einfügen, kopiert die Ereignisprozedur den ganzen Block in das andere Feld.
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

Ereignis  
Ereignisobjekttyp: flash.events.Event

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 11, Flash Lite 4

Flash Player setzt das textInteractionModeChange-Ereignis ab, wenn ein Benutzer den Interaktionsmodus eines Textfeldes ändert. Unter Android ist es zum Beispiel möglich, mithilfe von Kontextmenüoptionen zwischen dem NORMAL-Modus und dem SELECTION-Modus zu wechseln

TextFieldExample.as

Beim folgenden Beispiel wird die Klasse TextFieldExample zur Anzeige einer Textmeldung verwendet. Dies wird in den folgenden Schritten erreicht:
  1. Es wird eine label-Eigenschaft vom Typ „TextField“ erstellt.
  2. Der Klassenkonstruktor ruft die Funktion configureLabel() auf.
  3. Mit der Methode configureLabel() wird zuerst ein neues TextField-Objekt erstellt, das anschließend der Eigenschaft label zugewiesen wird. Danach werden die Parameter wie folgt eingestellt:
    • Textfeld links ausrichten.
    • Hintergrundfüllung aktivieren.
    • Rahmen aktivieren.
  4. Mit der Methode configureLabel() wird die Variable format erstellt und einer neuen TextFormat-Instanz mit den folgenden Parametern zugewiesen:
    • Schriftart = Verdana
    • Schriftfarbe = reines Rot
    • Schriftgröße = 10
    • Unterstreichung = true
  5. Die Eigenschaft defaultTextFormat des Textfelds label ist auf format gesetzt, und die label-Instanz wird der Anzeigeliste hinzugefügt. In dieser wird zuerst ein Textfeld ohne Text angezeigt.
  6. Der Konstruktor setzt den Text des label-Textfelds auf "Hello world and welcome to the show." fest, indem er die setLabel()-Methode aufruft.
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 ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.