ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: AIR 30.0 i wcześniejsze, Flash Player 30.0 i wcześniejsze, Flash Lite 4
Flex 4.6 i wcześniejsze, Flash Pro CS6 i wcześniejsze
Ukryj filtry
flash.text 

TextField  - AS3

Pakietyx

Najwyższy poziom
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

Elementy językowe

Stałe globalne
Funkcje globalne
Operatory
Instrukcje, słowa kluczowe i dyrektywy
Typy specjalne

Dodatki

Nowości
Błędy kompilatora
Ostrzeżenia kompilatora
Błędy czasu wykonywania
Migracja kodu ActionScript 3
Obsługiwane zestawy znaków
Tylko MXML
Elementy XML dotyczące ruchu
Znaczniki tekstu z synchronizacją czasową
Przestarzały indeks
Stałe implementacji dostępności
Instrukcje dotyczące przykładów
Informacje prawne
Pakietflash.text
Klasapublic class TextField
DziedziczenieTextField Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Podklasy FlexTextField

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Klasa TextField pozwala tworzyć obiekty wyświetlane do wyświetlania tekstu i wprowadzania danych. W Inspektorze właściwości można polu tekstowemu nadać nazwę instancji oraz użyć metod i właściwości klasy TextField, aby nim sterować za pomocą skryptu ActionScript. Nazwy instancji TextField są wyświetlane w Eksploratorze filmów i oknie dialogowym wstawiania ścieżki docelowej w panelu Operacje.

Aby dynamicznie utworzyć pole tekstowe, należy użyć konstruktora TextField().

Metody klasy TextField umożliwiają ustawienie, zaznaczenie oraz sterowanie tekstem w polu tekstowym dynamicznym lub wejściowym, które zostało utworzone w trakcie projektowania lub odtwarzania.

Język ActionScript udostępnia kilka sposobów na formatowanie tekstu podczas odtwarzania. Klasa TextFormat umożliwia ustawienie formatowania znaków i akapitu dla obiektu TextField. Za pomocą właściwości TextField.styleSheet oraz klasy StyleSheet można zastosować style arkusza stylów kaskadowych do pola tekstowego. Za pomocą arkusza CSS można modyfikować wbudowane znaczniki HTML, definiować nowe lub zastosować styl. Sformatowany tekst HTML opcjonalnie korzystający ze stylów CSS można przypisać bezpośrednio do pola tekstowego. Tekst HTML przypisany do pola tekstowego może zawierać osadzone nośniki (klipy filmowe, pliki w formacie SWF, GIF, PNG oraz JPEG). Tekst będzie zawijany wokół osadzonych nośników w taki sam sposób, w jaki przeglądarka zawija tekst wokół nośników osadzonych w dokumencie HTML.

Program Flash Player obsługuje podzbiór znaczników HTML, których można użyć do formatowania tekstu. Lista obsługiwanych znaczników HTML znajduje się w opisie właściwości htmlText.

Wyświetl przykłady

Powiązane elementy interfejsu API



Właściwości publiczne
 WłaściwośćZdefiniowane przez
 InheritedaccessibilityImplementation : AccessibilityImplementation
Bieżąca implementacja dostępności (AccessibilityImplementation) dla tego wystąpienia klasy InteractiveObject.
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
Bieżące opcje dostępności tego obiektu wyświetlanego.
DisplayObject
 Inheritedalpha : Number
Wartość przezroczystości alfa określonego obiektu.
DisplayObject
  alwaysShowSelection : Boolean
Jeśli ma wartość prawda, a pole tekstowe nie jest aktywne, program Flash Player wyróżnia zaznaczenie w polu tekstowym kolorem szarym.
TextField
  antiAliasType : String
Typ wygładzania w tym polu tekstowym.
TextField
  autoSize : String
Steruje automatycznym wymiarowaniem oraz wyrównywaniem pola tekstowego.
TextField
  background : Boolean
Określa, czy pole tekstowe ma wypełnione tło.
TextField
  backgroundColor : uint
Kolor tła pola tekstowego.
TextField
 InheritedblendMode : String
Wartość z klasy BlendMode określająca, jakiego trybu mieszania należy użyć.
DisplayObject
 InheritedblendShader : Shader
[tylko do zapisu] Ustawia moduł cieniujący, który jest używany do mieszania pierwszego planu oraz tła.
DisplayObject
  border : Boolean
Określa, czy pole tekstowe ma obramowanie.
TextField
  borderColor : uint
Kolor obramowania pola tekstowego.
TextField
  bottomScrollV : int
[tylko do odczytu] Liczba całkowita oznaczająca indeks ostatniego (na samym dole) z wierszy widocznych w polu tekstowym, liczona od 1.
TextField
 InheritedcacheAsBitmap : Boolean
Jeśli ustawiono wartość true, środowisko wykonawcze Flash buforuje wewnętrzną reprezentację bitmapy obiektu wyświetlanego.
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
W przypadku wartości innej niż null ten obiekt Matrix definiuje sposób renderowania obiektu wyświetlanego, gdy cacheAsBitmap jest ustawione na true.
DisplayObject
  caretIndex : int
[tylko do odczytu] Indeks położenia punktu wstawiania (karetki).
TextField
  condenseWhite : Boolean
Wartość typu Boolean, która określa czy z pola tekstowego HTML mają być usuwane pewne puste elementy (np. spacje i znaki podziału).
TextField
 Inheritedconstructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.
Object
 InheritedcontextMenu : NativeMenu
Określa menu kontekstowe tego obiektu.
InteractiveObject
  defaultTextFormat : flash.text:TextFormat
Określa format wstawianego tekstu, np. tekstu wprowadzanego przez użytkownika lub wstawianego za pomocą metody replaceSelectedText().
TextField
  displayAsPassword : Boolean
Wskazuje, czy pole tekstowe jest polem hasła.
TextField
 InheriteddoubleClickEnabled : Boolean
Określa, czy ten obiekt reaguje na zdarzenia doubleClick (dwukrotne kliknięcia).
InteractiveObject
  embedFonts : Boolean
Określa, czy mają być stosowane osadzone kontury czcionek.
TextField
 Inheritedfilters : Array
Indeksowana tablica zawierająca wszystkie filtry aktualnie skojarzone z obiektem wyświetlanym.
DisplayObject
 InheritedfocusRect : Object
Określa, czy z tym obiektem skojarzono ramkę aktywności.
InteractiveObject
  gridFitType : String
Typ dopasowywania do siatki w tym polu tekstowym.
TextField
 Inheritedheight : Number
Wysokość obiektu ekranowego w pikselach.
DisplayObject
  htmlText : String
Zawiera reprezentację zawartości pola tekstowego w formacie HTML.
TextField
  length : int
[tylko do odczytu] Liczba znaków w polu tekstowym.
TextField
 InheritedloaderInfo : LoaderInfo
[tylko do odczytu] Zwraca obiekt LoaderInfo zawierający informacje o ładowaniu pliku, do którego należy ten obiekt wyświetlany.
DisplayObject
 Inheritedmask : DisplayObject
Wywoływany obiekt wyświetlany jest maskowany przez określony obiekt maski.
DisplayObject
  maxChars : int
Maksymalna liczba znaków, które użytkownik może wprowadzić w polu tekstowym.
TextField
  maxScrollH : int
[tylko do odczytu] Maksymalna wartość scrollH.
TextField
  maxScrollV : int
[tylko do odczytu] Maksymalny zakres scrollV
TextField
 InheritedmetaData : Object
Pobiera obiekt metadanych wystąpienia klasy DisplayObject, jeśli metadane są przechowywane razem z tym wystąpieniem klasy DisplayObject w pliku SWF, korzystając ze znacznika PlaceObject4.
DisplayObject
 InheritedmouseEnabled : Boolean
Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika.
InteractiveObject
  mouseWheelEnabled : Boolean
Wartość typu Boolean określająca, czy program Flash Player powinien automatycznie przewijać wielowierszowe pole tekstowe, gdy użytkownik kliknie na nie i poruszy pokrętłem myszy.
TextField
 InheritedmouseX : Number
[tylko do odczytu] Określa współrzędną x myszy lub urządzenia wejściowego użytkownika w pikselach.
DisplayObject
 InheritedmouseY : Number
[tylko do odczytu] Określa współrzędną y myszy lub urządzenia wejściowego użytkownika w pikselach.
DisplayObject
  multiline : Boolean
Określa, czy pole tekstowe jest polem wielowierszowym.
TextField
 Inheritedname : String
Nazwa instancji obiektu DisplayObject.
DisplayObject
 InheritedneedsSoftKeyboard : Boolean
Określa, czy klawiatura wirtualna (klawiatura programowa wyświetlana na ekranie) powinna być wyświetlana, gdy to wystąpienie klasy InteractiveObject staje się aktywne.
InteractiveObject
  numLines : int
[tylko do odczytu] Określa liczbę wierszy w wielowierszowym polu tekstowym.
TextField
 InheritedopaqueBackground : Object
Określa, czy przy konkretnym kolorze tła obiekt wyświetlany jest nieprzejrzysty.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[tylko do odczytu] Odnosi się do obiektu DisplayObjectContainer, który zawiera obiekt wyświetlany.
DisplayObject
  restrict : String
Oznacza zestaw znaków, które użytkownik może wprowadzać w polu tekstowym.
TextField
 Inheritedroot : DisplayObject
[tylko do odczytu] Dla obiektu wyświetlanego w załadowanym pliku SWF główną właściwość stanowi obiekt wyświetlany na samym szczycie na liście wyświetlania w postaci struktury drzewa, którą reprezentuje plik SWF.
DisplayObject
 Inheritedrotation : Number
Określa wielkość obrotu instancji obiektu DisplayObject (w kątach).
DisplayObject
 InheritedrotationX : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi x — od pozycji początkowej względem nadrzędnego kontenera 3D.
DisplayObject
 InheritedrotationY : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi y — od pozycji początkowej względem nadrzędnego kontenera 3D.
DisplayObject
 InheritedrotationZ : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi z — od pozycji początkowej względem nadrzędnego kontenera 3D.
DisplayObject
 Inheritedscale9Grid : Rectangle
Aktualnie stosowana siatka skalowania.
DisplayObject
 InheritedscaleX : Number
Wskazuje skalę poziomą (procent) obiektu względem punktu odniesienia.
DisplayObject
 InheritedscaleY : Number
Wskazuje skalę pionową (procent) obiektu względem punktu odniesienia.
DisplayObject
 InheritedscaleZ : Number
Wskazuje skalę głębokości (procent) obiektu względem punktu odniesienia.
DisplayObject
  scrollH : int
Bieżące położenie podczas przewijania poziomego.
TextField
 InheritedscrollRect : Rectangle
Granice obszaru przewijania obiektu wyświetlanego.
DisplayObject
  scrollV : int
Pionowe położenie tekstu w polu tekstowym.
TextField
  selectable : Boolean
Wartość typu Boolean wskazująca, czy dane pole tekstowe można zaznaczać.
TextField
  selectionBeginIndex : int
[tylko do odczytu] Indeks pierwszego znaku w bieżącym zaznaczeniu, liczony od 0.
TextField
  selectionEndIndex : int
[tylko do odczytu] Indeks ostatniego znaku w bieżącym zaznaczeniu, liczony od 0.
TextField
  sharpness : Number
Ostrość krawędzi glifów w polu tekstowym.
TextField
 Inherited    softKeyboard : String
Steruje wyglądem klawiatury programowej.
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
Definiuje obszar, który powinien pozostać na ekranie po wyświetleniu klawiatury programowej (niedostępna w systemie iOS).
InteractiveObject
 Inheritedstage : Stage
[tylko do odczytu] Stół montażowy obiektu wyświetlanego.
DisplayObject
  styleSheet : StyleSheet
Dołącza do pola tekstowego arkusz stylu.
TextField
 InheritedtabEnabled : Boolean
Określa, czy do tego obiektu można przejść za pomocą klawisza Tab.
InteractiveObject
 InheritedtabIndex : int
Określa kolejność uaktywniania obiektów (z pliku SWF) za pomocą klawisza Tab.
InteractiveObject
  text : String
Ciąg znaków odpowiadający bieżącemu tekstowi w polu tekstowym.
TextField
  textColor : uint
Kolor tekstu w polu tekstowym (w formacie szesnastkowym).
TextField
  textHeight : Number
[tylko do odczytu] Wysokość tekstu w pikselach.
TextField
  textInteractionMode : String
[tylko do odczytu] Właściwość trybu interakcji, której wartością domyślną jest TextInteractionMode.NORMAL.
TextField
  textWidth : Number
[tylko do odczytu] Szerokość tekstu w pikselach.
TextField
  thickness : Number
Grubość krawędzi glifów w polu tekstowym.
TextField
 Inheritedtransform : flash.geom:Transform
Obiekt z właściwościami dotyczącymi matrycy obiektu wyświetlanego, transformacji kolorów oraz granic pikseli.
DisplayObject
  type : String
Typ pola tekstowego.
TextField
  useRichTextClipboard : Boolean
Określa, czy razem z tekstem można kopiować i wklejać jego format.
TextField
 Inheritedvisible : Boolean
Decyduje, czy obiekt wyświetlany jest widoczny, czy nie.
DisplayObject
 Inheritedwidth : Number
Szerokość obiektu ekranowego w pikselach.
DisplayObject
  wordWrap : Boolean
Wartość typu Boolean wskazująca, że tekst w polu tekstowym może być zawijany.
TextField
 Inheritedx : Number
Oznacza współrzędną x instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer.
DisplayObject
 Inheritedy : Number
Oznacza współrzędną y instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer.
DisplayObject
 Inheritedz : Number
Wskazuje współrzędną wzdłuż osi Z instancji DisplayObject względem nadrzędnego kontenera 3D.
DisplayObject
Metody publiczne
 MetodaZdefiniowane przez
  
Tworzy nową instancję klasy TextField.
TextField
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.
EventDispatcher
  
Dołącza ciąg wskazany w parametrze newText na końcu tekstu w polu tekstowym.
TextField
 Inherited
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Zwraca prostokąt definiujący obszar obiektu wyświetlanego (w układzie współrzędnych obiektu targetCoordinateSpace).
DisplayObject
  
Zwraca prostokąt będący obwiednią znaku.
TextField
  
Zwraca indeks znaku (liczony od 0) w punkcie określonym za pomocą parametrów x i y.
TextField
  
Po otrzymaniu indeksu znaku zwraca indeks pierwszego znaku w tym samym akapicie.
TextField
  
Zwraca odwołanie do obiektu DisplayObject o podanym identyfikatorze. Operacja dotyczy obrazu lub pliku SWF, które dodano do sformatowanego pola tekstowego HTML za pomóc znacznika <img>.
TextField
  
Zwraca indeks (liczony od 0) wiersza określonego za pomocą parametrów x i y.
TextField
  
Zwraca liczony od 0 indeks wiersza zawierającego znak określony przez parametr charIndex.
TextField
  
getLineLength(lineIndex:int):int
Zwraca liczbę znaków w określonym wierszu tekstowym.
TextField
  
Zwraca informacje o wymiarach danego wiersza tekstu.
TextField
  
getLineOffset(lineIndex:int):int
Zwraca indeks pierwszego znaku w wierszu określonego przez parametr lineIndex.
TextField
  
Zwraca wiersz tekstowy określony przez parametr lineIndex.
TextField
  
Po podaniu indeksu znaku zwraca wartość długości akapitu zawierający dany znak.
TextField
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Zwraca prostokąt definiujący granice obiektu wyświetlanego w układzie współrzędnych określonych przez parametr targetCoordinateSpace (z wyłączeniem konturów kształtów).
DisplayObject
  
getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Zwraca obiekt TextFormat, który zawiera informacje o formatowaniu dla zakresu tekstu określonego przez parametry beginIndex i endIndex.
TextField
 Inherited
Konwertuje obiekt punktowy ze współrzędnych obiektu Stage (globalne) do współrzędnych obiektu wyświetlanego (lokalne).
DisplayObject
 Inherited
Konwertuje punkt dwuwymiarowy ze współrzędnych stołu wymiarowego (globalnych) na współrzędne trójwymiarowego obiektu wyświetlanego (lokalne).
DisplayObject
 Inherited
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.
EventDispatcher
 Inherited
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
 Inherited
Wyznacza prostokąt ograniczający obiekt wyświetlany w celu sprawdzenia, czy zachodzi on lub przecina się z prostokątem ograniczającym obiektu wyświetlanego obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Analizuje obiekt wyświetlany w celu ustalenia czy nakłada się on lub przecina punkt określony przez parametry x i y.
DisplayObject
  
isFontCompatible(fontName:String, fontStyle:String):Boolean
[statyczny] Zwraca wartość, jeśli osadzona czcionka jest dostępna z określonymi parametrami fontName i fontStyle, gdzie Font.fontType ma wartość flash.text.FontType.EMBEDDED.
TextField
 Inherited
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
 Inherited
Konwertuje punkt trójwymiarowy trójwymiarowego obiektu wyświetlanego (lokalnego) na punkt dwuwymiarowy we współrzędnych stołu montażowego (globalnych).
DisplayObject
 Inherited
Konwertuje obiekt punktowy ze współrzędnych obiektu wyświetlanego (lokalne) do współrzędnych obiektu Stage (globalne).
DisplayObject
 Inherited
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Usuwa detektor z obiektu EventDispatcher.
EventDispatcher
  
Zastępuje bieżące zaznaczenie zawartością określoną przez parametr wartości.
TextField
  
replaceText(beginIndex:int, endIndex:int, newText:String):void
Zastępuje zakres znaków określony przez parametry beginIndex i endIndex zawartością parametru newText.
TextField
 Inherited
Powoduje uniesienie klawiatury wirtualnej.
InteractiveObject
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
  
setSelection(beginIndex:int, endIndex:int):void
Zaznacza tekst określony wartościami indeksu pierwszego i ostatniego znaku, podanymi w parametrach beginIndex oraz endIndex.
TextField
  
setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Stosuje formatowanie tekstowe określone przez parametr formatowania do danego tekstu w polu tekstowym.
TextField
 Inherited
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
 Inherited
Zwraca ciąg reprezentujący określony obiekt.
Object
 Inherited
Zwraca pierwotną wartość dla określonego obiektu.
Object
 Inherited
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.
EventDispatcher
Zdarzenia
 Zdarzenie Podsumowanie Zdefiniowane przez
 Inherited[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.EventDispatcher
 InheritedWywoływane, gdy obiekt wyświetlany jest dodawany do listy wyświetlania.DisplayObject
 InheritedWywoływane, gdy obiekt wyświetlany jest dodawany do listy wyświetlania na scenie — albo bezpośrednio, albo wskutek dodania poddrzewa zawierającego obiekt wyświetlany.DisplayObject
  Wywoływane po zmodyfikowaniu wartości kontrolnej — inaczej niż zdarzenie textInput, które jest wywoływane przed modyfikacją wartości.TextField
 InheritedWywoływane, gdy użytkownik wybierz opcje „Wyczyść” (lub „Usuń”) z menu kontekstowego dla tekstu.InteractiveObject
 InheritedWywoływane w momencie naciśnięcia i zwolnienia głównego przycisku urządzenia wskazującego przez użytkownika na tej samej instancji InteractiveObject.InteractiveObject
 Inherited
    contextMenu
Wywoływane, gdy w wyniku gestu użytkownika zostanie uaktywnione menu kontekstowe skojarzone z tym obiektem interaktywnym w aplikacji AIR.InteractiveObject
 InheritedWywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację kopiowania lub wybiera polecenie Kopiuj z menu kontekstowego dla tekstu.InteractiveObject
 InheritedWywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację wycięcia lub wybiera polecenie Wytnij z menu kontekstowego dla tekstu.InteractiveObject
 Inherited[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.EventDispatcher
 InheritedWywoływane w momencie, gdy użytkownik naciska i zwalnia główny przycisk urządzenia wskazującego dwukrotnie w krótkim odstępie czasu nad tym samym obiektem InteractiveObject, podczas gdy flaga doubleClickEnabled obiektu jest ustawiona na wartość true.InteractiveObject
 Inherited[zdarzenie broadcast] Wywoływane, gdy głowica odtwarzania przechodzi do nowej klatki.DisplayObject
 Inherited[zdarzenie broadcast] Wywoływane, gdy głowica odtwarzania kończy odtwarzanie bieżącej klatki.DisplayObject
 InheritedWywoływane po uaktywnieniu obiektu wyświetlanego.InteractiveObject
 InheritedDysponowana, gdy obiekt ekranowy przestaje być aktywny.InteractiveObject
 Inherited[zdarzenie broadcast] Wywoływane po zadziałaniu konstruktorów obiektów wyświetlanych klatek, ale przed działaniem skryptów klatek.DisplayObject
 InheritedZostaje rozesłane, gdy użytkownik utworzy punkt styku wzdłuż krawędzi powierzchni dotykowej z instancją obiektu InteractiveObject (np. dotknięcie wzdłuż krawędzi powierzchni dotykowej pilota Siri Remote do telewizora firmy Apple). Niektóre urządzenia mogą również interpretować taki styk, jako kombinację różnych zdarzeń dotykowych.InteractiveObject
 InheritedWywoływane, gdy użytkownik naciśnie na dwa punkty kontaktu nad tą samą instancją klasy InteractiveObject na urządzeniu dotykowym (np. naciśnie dwoma palcami i zwolni obiekt wyświetlany na ekranie dotykowym telefonu komórkowego lub tabletu).InteractiveObject
 InheritedWywoływane, gdy użytkownik przesuwa punkt kontaktu nad wystąpieniem klasy InteractiveObject na urządzeniu dotykowym (na przykład przez przesuwanie palców z lewej strony na prawą nad obiektem ekranowym na telefonie komórkowym lub tablecie z ekranem dotykowym).InteractiveObject
 InheritedWywoływane, gdy użytkownik wykona gest obrotu w punkcie kontaktu z instancją klasy InteractiveObject (np. dotknie obiektu wyświetlanego dwoma palcami i obróci palce na ekranie dotykowym telefonu komórkowego lub tabletu).InteractiveObject
 InheritedWywoływane, gdy użytkownik wykona gest machnięcia w punkcie kontaktu na instancji obiektu InteractiveObject (np. dotknięcie trzema złączonymi palcami ekranu, a następnie szybkie przesunięcie ich nad obiektem wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu).InteractiveObject
 InheritedWywoływane, gdy użytkownik utworzy punkt kontaktu z instancją obiektu InteractiveObject, a następnie stuknie w urządzenie dotykowe (np. przyłoży kilka palców do obiektu wyświetlanego w celu otwarcia menu, a następnie stuknie jednym palcem, aby wybrać element menu na ekranie dotykowym telefonu komórkowego lub tabletu).InteractiveObject
 InheritedWywoływane, gdy użytkownik wykona gest powiększenia w punkcie kontaktu na instancji obiektu InteractiveObject (np. dotknięcie dwoma palcami ekranu, a następnie szybkie rozsunięcie palców nad obiektem wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu).InteractiveObject
 InheritedTo zdarzenie jest wywoływane w każdej aplikacji klienckiej, która obsługuje lokalne wprowadzanie znaków za pomocą edytora IME.InteractiveObject
 InheritedWywoływane, gdy użytkownik naciśnie klawisz.InteractiveObject
 InheritedDysponowana, gdy użytkownik próbuje uaktywnić inny element za pomocą klawiatury.InteractiveObject
 InheritedWywoływane, gdy użytkownik zwolni klawisz.InteractiveObject
  Wywoływane, gdy użytkownik klika hiperłącze w polu tekstowym HTML, którego adres URL zaczyna się od ciągu „event:”.TextField
 InheritedWywoływane, gdy użytkownik naciśnie i zwolni środkowy przycisk urządzenia wskazującego nad tą samą instancją klasy InteractiveObject.InteractiveObject
 InheritedWywoływane, gdy użytkownik naciśnie środkowy przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject.InteractiveObject
 InheritedWywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject.InteractiveObject
 InheritedWywoływane, gdy użytkownik naciśnie przycisk urządzenia wskazującego nad instancją klasy InteractiveObject.InteractiveObject
 InheritedWywoływane, gdy użytkownik próbuje uaktywnić inny element za pomocą urządzenia wskazującego.InteractiveObject
 InheritedDysponowana, gdy użytkownik ustawi kursor nad instancją obiektu InteractiveObject i poruszy urządzenie wskazujące.InteractiveObject
 InheritedWywoływane, gdy użytkownik przesunie kursor poza instancję obiektu InteractiveObject (za pomocą urządzenia wskazującego).InteractiveObject
 InheritedDysponowana, gdy użytkownik przesunie kursor nad instancję obiektu InteractiveObject (za pomocą urządzenia wskazującego).InteractiveObject
 InheritedWywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject.InteractiveObject
 InheritedWywoływane, gdy kółko myszy zostanie obrócone nad instancją klasy InteractiveObject.InteractiveObject
 InheritedWywoływane przez obiekt InteractiveObject inicjujący przeciąganie, gdy użytkownik zwolni przycisk podczas przeciągania.InteractiveObject
 InheritedWywoływane przez docelowy obiekt InteractiveObject, gdy przeciągany obiekt zostanie na niego upuszczony i upuszczenie zostanie zaakceptowane wywołaniem DragManager.acceptDragDrop().InteractiveObject
 InheritedWywoływane przez obiekt InteractiveObject, gdy podczas gestu przeciągania wskaźnik wchodzi w granice tego obiektu.InteractiveObject
 InheritedWywoływane przez obiekt InteractiveObject, gdy podczas gestu przeciągania wskaźnik opuści granice tego obiektu.InteractiveObject
 InheritedRegularnie wywoływane przez obiekt InteractiveObject, gdy wskaźnik podczas przeciągania pozostaje w granicach tego obiektu.InteractiveObject
 InheritedWywoływane na początku operacji przeciągania przez obiekt InteractiveObject określony jako inicjator przeciągania w wywołaniu DragManager.doDrag().InteractiveObject
 InheritedWywoływane podczas operacji przeciągania przez obiekt InteractiveObject określony jako inicjator przeciągania w wywołaniu DragManager.doDrag().InteractiveObject
 InheritedWywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację wklejenia lub wybiera polecenie Wklej z menu kontekstowego dla tekstu.InteractiveObject
 InheritedWywoływane, gdy użytkownik opuści aktywny pisak na odległość mniejszą niż graniczna odległość wykrywania dla ekranu.InteractiveObject
 Inherited
    proximityEnd
Wywoływane, gdy użytkownik uniesie aktywny pisak na odległość większą niż graniczna odległość wykrywania dla ekranu.InteractiveObject
 InheritedWywoływane, gdy użytkownik przesuwa aktywny pisak nad ekranem, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu.InteractiveObject
 Inherited
    proximityOut
Wywoływane, gdy użytkownik przesuwa aktywny pisak poza dany obiekt InteractiveObject, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu.InteractiveObject
 InheritedWywoływane, gdy użytkownik przesuwa aktywny pisak bezpośrednio nad danym obiektem InteractiveObject, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu.InteractiveObject
 InheritedWywoływane, gdy użytkownik przesuwa aktywny pisak poza obiekt InteractiveObject i jego obiekty potomne, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu.InteractiveObject
 InheritedWywoływane, gdy użytkownik przesuwa aktywny pisak z obszaru poza drzewem obiektów potomnych danego obiektu InteractiveObject na liście wyświetlania nad ten obiekt (przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna wartość wykrywania dla ekranu).InteractiveObject
 InheritedWywoływane, gdy użytkownik zwalnia przycisk urządzenia wskazującego, jeśli wcześniej nacisnął ten przycisk na wystąpieniu klasy InteractiveObject i przesunął wskaźnik urządzenia poza to wystąpienie klasy InteractiveObject.InteractiveObject
 InheritedDysponowana, gdy obiekt ekranowy ma być usunięty z listy wyświetlania.DisplayObject
 InheritedDysponowana, gdy obiekt ekranowy ma być usunięty z listy wyświetlania na scenie — albo bezpośrednio, albo wskutek usunięcia poddrzewa zawierającego obiekt ekranowy.DisplayObject
 Inherited[zdarzenie broadcast] Wywoływane, gdy lista wyświetlania ma być aktualizowana lub renderowana.DisplayObject
 InheritedWywoływane, gdy użytkownik naciśnie i zwolni prawy przycisk urządzenia wskazującego nad tą samą instancją klasy InteractiveObject.InteractiveObject
 InheritedWywoływane, gdy użytkownik naciśnie przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject.InteractiveObject
 InheritedWywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad instancją klasy InteractiveObject.InteractiveObject
 InheritedWywoływane, gdy użytkownik przesunie kursor poza wystąpienie klasy InteractiveObject (za pomocą urządzenia wskazującego).InteractiveObject
 InheritedWywoływane, gdy użytkownik przesunie kursor nad wystąpienie klasy InteractiveObject (za pomocą urządzenia wskazującego).InteractiveObject
  Wywoływane przez obiekt TextField, gdy użytkownik przewinął tekst.TextField
 InheritedWywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację zaznaczenia wszystkiego lub wybiera polecenie „Zaznacz wszystko” z menu kontekstowego dla tekstu.InteractiveObject
 InheritedWywoływane bezpośrednio po uniesieniu klawiatury programowej.InteractiveObject
 InheritedWywoływane bezpośrednio przed uniesieniem klawiatury programowej.InteractiveObject
 InheritedWywoływane bezpośrednio po opuszczeniu klawiatury programowej.InteractiveObject
 InheritedWywoływane, gdy zmienia się wartość flagi tabChildren obiektu.InteractiveObject
 InheritedWywoływane, gdy zmienia się flaga tabEnabled obiektu.InteractiveObject
 InheritedWywoływane, gdy zmienia się wartość właściwości tabIndex obiektu.InteractiveObject
  Program Flash Player wywołuje zdarzenie textInput, kiedy użytkownik wprowadzi co najmniej jeden znak.TextField
  Program Flash Player wywołuje zdarzenie textInteractionModeChange, gdy użytkownik zmienia tryb interakcji pola tekstowego.TextField
 InheritedWywoływane, gdy użytkownik zainicjuje kontakt z urządzeniem dotykowym (np. dotknie palcem ekranu dotykowego telefonu komórkowego lub tabletu).InteractiveObject
 InheritedWywoływane, gdy użytkownik przerwie kontakt z urządzeniem dotykowym (np. uniesie palec z ekranu dotykowego telefonu komórkowego lub tabletu).InteractiveObject
 InheritedWywoływane, gdy użytkownik dotyka urządzenia. Wywołanie jest powtarzane w sposób ciągły do momentu usunięcia punktu kontaktu.InteractiveObject
 InheritedWywoływane, gdy użytkownik przemieści punkt kontaktu od instancji klasy InteractiveObject na urządzeniu dotykowym (np. przeciągnie palcem z jednego obiektu wyświetlanego do punktu na drugim obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu).InteractiveObject
 InheritedWywoływane, gdy użytkownik przemieści punkt kontaktu nad instancję klasy InteractiveObject na urządzeniu dotykowym (np. przeciągnie palcem z punktu poza obiektem wyświetlanym do punktu na obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu).InteractiveObject
 InheritedWywoływane, gdy użytkownik przesuwa punkt kontaktu poza wystąpienie klasy InteractiveObject na urządzeniu dotykowym (na przykład przez przeciągnięcie palcem znad obiektu ekranowego do punktu poza obiektem ekranowym na telefonie komórkowym lub tablecie z ekranem dotykowym).InteractiveObject
 InheritedWywoływane, gdy użytkownik przemieści punkt kontaktu nad instancję klasy InteractiveObject na urządzeniu dotykowym (np. przeciągnie palcem z punktu poza obiektem wyświetlanym do punktu na obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu).InteractiveObject
 InheritedWywoływane, gdy użytkownik zwolni nacisk na ekran dotykowy w punkcie kontaktu na tej samej instancji klasy InteractiveObject, na której kontakt został zainicjowany (na przykład naciśnie palcem i zwolni pojedynczy punkt na obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu).InteractiveObject
Szczegół właściwości

alwaysShowSelection

właściwość
alwaysShowSelection:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Jeśli ma wartość true, a pole tekstowe nie ma fokusu, program Flash Player wyróżnia zaznaczenie w polu tekstowym kolorem szarym. Jeśli ma wartość false, a pole tekstowe jest aktywne, program Flash Player nie wyróżnia zaznaczenia w polu tekstowym kolorem szarym.

Wartością domyślną jest false.



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

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Skompiluj i uruchom następujący plik. Po uruchomieniu pliku, należy zaznaczyć tekst w każdym z dwóch pól tekstowych, aby zaobserwować różnicę w podświetleniu zaznaczenia tekstu w tych dwóch polach (zmiana aktywności):
    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

właściwość 
antiAliasType:String

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9

Typ wygładzania w tym polu tekstowym. Dal tej właściwości użyj wartości stałych flash.text.AntiAliasType. Tym ustawieniem można sterować tylko w przypadku, gdy czcionka została osadzona (właściwość embedFonts ustawiona na wartość true). Ustawienie domyślne to flash.text.AntiAliasType.NORMAL.

W celu ustawienia wartości tej właściwości należy użyć następujących wartości ciągu znaków:

Wartość ciągu znakówOpis
flash.text.AntiAliasType.NORMALStosuje zwykłe wygładzanie tekstu. Ta wartość odpowiada typowi wygładzania dostępnego w programie Flash Player 7 i starszych wersjach.
flash.text.AntiAliasType.ADVANCEDStosuje zaawansowane wygładzanie tekstu, dzięki któremu tekst jest bardziej czytelny. (Ta opcja została udostępniona w programie Flash Player 8). Zaawansowane wygładzanie umożliwia renderowanie czcionek wysokiej jakości nawet przy ich niewielkich rozmiarach. Zaleca się stosowanie tej funkcji w przypadku aplikacji, które zawierają dużo tekstu o małym rozmiarze czcionki. Nie zaleca się stosowania zaawansowanego wygładzania w przypadku czcionek o wielkości większej niż 48 punktów.



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

Powiązane elementy interfejsu API

autoSize

właściwość 
autoSize:String

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Steruje automatycznym wymiarowaniem oraz wyrównywaniem (do prawej, lewej) pola tekstowego. Dopuszczalne wartości dla stałych TextFieldAutoSize: TextFieldAutoSize.NONE (domyślna), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT oraz TextFieldAutoSize.CENTER.

Ustawianie właściwości autoSize na wartość TextFieldAutoSize.NONE (domyślna) nie powoduje zmiany rozmiaru.

Ustawienie właściwości autoSize na wartość TextFieldAutoSize.LEFT spowoduje, że tekst zostanie potraktowany jak tekst wyrównany do lewej, co oznacza, że lewy margines tekstu w polu tekstowym pozostaje bez zmiany, a jakakolwiek zmiana rozmiaru pojedynczego wiersza pola tekstowego wpływa na prawy margines. Jeśli tekst zawiera znak podziału (na przykład, "\n" lub "\r"), rozmiar dolnej krawędzi również zostaje zmieniony celem dopasowania do następnego wiersza tekstowego. Ustawienie właściwości wordWrap na wartość true spowoduje, że tylko rozmiar dolnej krawędzi pola tekstowego ulegnie zmianie, a prawa strona pozostanie stała.

Ustawienie właściwości autoSize na wartość TextFieldAutoSize.RIGHT spowoduje, że tekst zostanie potraktowany jako tekst wyrównany do prawej, co oznacza, że prawy margines pola tekstowego pozostaje stały, a jakakolwiek zmiana rozmiaru pojedynczego wiersza tekstowego wpływa na lewy margines. Jeśli tekst zawiera znak podziału (na przykład, "\n" lub "\r"), rozmiar dolnej krawędzi ulegnie zmianie celem dopasowania do następnego wiersza tekstowego. Ustawienie właściwości wordWrap na wartość true spowoduje, że rozmiar tylko dolnej krawędzi pola tekstowego ulegnie zmianie, a lewa jego strona pozostanie bez zmian.

Ustawienie właściwości autoSize na wartość TextFieldAutoSize.CENTER spowoduje, że tekst zostanie potraktowany jak tekst wyrównany do środka, co oznacza, że jakakolwiek zmiana wielkości pojedynczego wiersza w polu tekstowym spowoduje jego równe rozłożenie między prawym i lewym marginesem. Jeśli tekst zawiera znak podziału (na przykład, "\n" lub "\r"), rozmiar dolnej krawędzi również zostaje zmieniony celem dopasowania do następnego wiersza tekstu. Ustawienie właściwości wordWrap również na wartość true spowoduje, że wielkość dolnej krawędzi pola tekstowego ulegnie zmianie, a prawa i lewa strona pozostanie bez zmian.



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

Zgłasza
ArgumentError — Określona właściwość autoSize nie należy do obiektu flash.text.TextFieldAutoSize.

Powiązane elementy interfejsu API

background

właściwość 
background:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Określa, czy pole tekstowe ma wypełnione tło. Wartość true oznacza, że tło pola tekstowego zawiera wypełnienie. Wartość false oznacza, że tło pola tekstowego nie zawiera wypełnienia. Właściwość backgroundColor służy do ustawienia koloru tła pola tekstowego.

Wartością domyślną jest false.



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

Powiązane elementy interfejsu API

backgroundColor

właściwość 
backgroundColor:uint

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Kolor tła pola tekstowego. Wartość domyślna to 0xFFFFFF (biały). Tę właściwość można pobrać lub ustawić, nawet w przypadku braku tła w danym momencie. Jednakże kolor będzie widoczny tylko wówczas, gdy właściwość background pola tekstowego zostanie ustawiona na wartośćtrue.



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

Powiązane elementy interfejsu API

border

właściwość 
border:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Określa, czy pole tekstowe ma obramowanie. Wartość true oznacza, że pole tekstowe ma obramowanie. Wartość false oznacza, że pole tekstowe nie ma obramowania. Właściwość borderColor umożliwia ustawienie koloru obramowania.

Wartością domyślną jest false.



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

Powiązane elementy interfejsu API

borderColor

właściwość 
borderColor:uint

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Kolor obramowania pola tekstowego. Wartość domyślna to 0x000000 (czarny). Tę właściwość można pobrać lub ustawić, nawet w przypadku braku obramowania w danym momencie. Jednakże kolor będzie widoczny tylko wówczas, gdy właściwość border pola tekstowego zostanie ustawiona na wartość true.



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

Powiązane elementy interfejsu API

bottomScrollV

właściwość 
bottomScrollV:int  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Liczba całkowita oznaczająca indeks ostatniego (na samym dole) z wierszy widocznych w polu tekstowym, liczona od 1. Pole tekstowe można traktować jak okno na fragment tekstu. Właściwość scrollV to indeks (którego zbiór wartości zaczyna się liczbą 1) pierwszego widocznego wiersza znajdującego się górnej części okna,

Cały tekst, który znajduje się między wierszami określonymi za pomocą właściwości scrollV i bottomScrollV jest aktualnie widoczny w polu tekstowym.



Implementacja
    public function get bottomScrollV():int

Powiązane elementy interfejsu API

caretIndex

właściwość 
caretIndex:int  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Indeks położenia punktu wstawiania (karetki). Jeśli punkt wstawiania nie jest wyświetlany, wartość określa położenie punktu wstawiania, które zaistniałoby w przypadku przywrócenia polu aktywności (zwykle ostatnie położenie punktu wstawiania lub wartość 0, jeśli pole nie było aktywne).

Wartości dla indeksów zakresu zaznaczenia zaczynają się od wartości 0 (na przykład wartości pierwszej pozycji to 0, drugiej to 1, itd.).



Implementacja
    public function get caretIndex():int

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Ten przykład przedstawia utworzenie instancji TextField i zapełnienie jej tekstem. Przypisany zostaje detektor zdarzeń, za pomocą którego wywoływana jest metoda printCursorPosition w momencie kliknięcia pola tekstowego TextField. W takim przypadku wartości wynikowe właściwości caretIndex, selectionBeginIndex oraz selectionEndIndex stanowią wartości wyjściowe.

Należy wykonać czynności przedstawione w przykładzie i spróbować kliknąć obszar w polu tekstowym w celu zaznaczenia tekstu. Następnie należy kliknąć pole, nie zaznaczając tekstu. Podczas klikania tekstu bez zaznaczenia właściwość caretIndex wskazuje punkt wstawiania, a właściwości selectionBeginIndex oraz selectionEndIndex są równe wartości właściwości 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

właściwość 
condenseWhite:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Wartość typu Boolean, która określa czy z pola tekstowego HTML mają być usuwane pewne puste elementy (np. spacje i znaki podziału). Wartością domyślną jest false. Właściwość condenseWhite dotyczy tylko tekstu z ustawieniem właściwości htmlText, a nie właściwości text. Użycie tekstu z właściwością text spowoduje zignorowanie właściwości condenseWhite.

Jeśli dla właściwości condenseWhite ustawiona jest wartość true, w celu umieszczenia odstępów w polu tekstowym należy użyć standardowych poleceń HTML, takich jak <BR> i <P>.

Zanim właściwość htmlText zostanie ustawiona należy ustawić właściwość condenseWhite.



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

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje różnicę między ustawieniem właściwości condenseWhite na wartość false, a następnie na wartość true:
package {
    import flash.display.Sprite;
    import flash.text.TextField;

    public class TextField_condenseWhite extends Sprite {
        public function TextField_condenseWhite() {
            var tf1:TextField = createCustomTextField(0, 0, 200, 50);
            tf1.condenseWhite = false;
            tf1.htmlText = "keep    on\n\ttruckin'";
            
            var tf2:TextField = createCustomTextField(0, 120, 200, 50);
            tf2.condenseWhite = true;
            tf2.htmlText = "keep    on\n\ttruckin'";
        }

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

defaultTextFormat

właściwość 
defaultTextFormat:flash.text:TextFormat

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Określa format wstawianego tekstu, np. tekstu wprowadzanego przez użytkownika lub wstawianego za pomocą metody replaceSelectedText().

Uwaga: W przypadku zaznaczania znaków do zastąpienia przy użyciu metod setSelection() i replaceSelectedText() format defaultTextFormat zostanie zastosowany wyłącznie wtedy, gdy tekst został zaznaczony do ostatniego znaku włącznie. Oto przykład:

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

Podczas korzystania z właściwości defaultTextFormat, wszystkie wartości w zwróconym obiekcie TextFormat są zdefiniowane. Żadna z właściwości nie ma wartości null

Uwaga: Nie można ustawić tej właściwości, jeśli do pola tekstowego zastosowano arkusz stylów.



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

Zgłasza
Error — Tej metody nie można stosować dla pola tekstowego zawierającego arkusz stylów.

Powiązane elementy interfejsu API

displayAsPassword

właściwość 
displayAsPassword:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Wskazuje, czy pole tekstowe jest polem hasła. Wartość true tej właściwości oznacza, że pole tekstowe jest traktowane jak pole hasła i ukrywa wpisywane znaki, wyświetlając w ich miejscu znaki gwiazdki. Wartość false oznacza, że pole tekstowe nie jest traktowane jak pole hasła. Włączony tryb hasła uniemożliwia korzystanie z poleceń Wytnij i Kopiuj, a odpowiadające im skróty klawiaturowe nie będą aktywne. Ten mechanizm zabezpieczający uniemożliwia nieuprawnionemu użytkownikowi korzystanie ze skrótów w celu odkrycia hasła do komputera pozostawionego bez nadzoru.

Wartością domyślną jest false.



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

embedFonts

właściwość 
embedFonts:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Określa, czy mają być stosowane osadzone kontury czcionek. Jeśli wartością jest false, program Flash Player renderuje pole tekstowe za pomocą czcionek urządzenia.

Ustawienie właściwości embedFonts dla pola tekstowego na wartość true wymaga określenia czcionki dla tego tekstu za pomocą właściwości font obiektu TextFormat, który został zastosowany do pola tekstowego. Jeśli określona czcionka nie jest osadzona w pliku SWF, tekst nie jest wyświetlany.

Wartością domyślną jest false.



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

Powiązane elementy interfejsu API

gridFitType

właściwość 
gridFitType:String

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9

Typ dopasowywania do siatki w tym polu tekstowym. Ta właściwość ma zastosowanie tylko w przypadku, gdy właściwość flash.text.AntiAliasType pola tekstowego jest ustawiona na wartość flash.text.AntiAliasType.ADVANCED.

Zastosowany typ dopasowania siatki określa, czy w programie Flash Player główne pionowe i poziome linie siatki mają zostać dopasowane do siatki subpikseli.

Dla właściwości flash.text.GridFitType dostępne są następujące wartości ciągów znaków:

Wartość ciągu znakówOpis
flash.text.GridFitType.NONEOkreśla brak dopasowania siatki. Linie poziome i pionowe w glifach nie są przyciągane do siatki pikselowej. To ustawienie jest zalecane w przypadku animacji lub tekstu o dużym rozmiarze czcionki.
flash.text.GridFitType.PIXELOkreśla dopasowanie poziomych i pionowych głównych linii siatki do siatki pikseli. To ustawienie sprawdza się tylko dla pól tekstowych o wyrównaniu do lewej. Korzystanie z tej właściwości wymaga ustawienia właściwości flash.dispaly.AntiAliasType pola tekstowego na wartość flash.text.AntiAliasType.ADVANCED. To ustawienie udostępnia najlepszą czytelność dla tekstu wyrównanego do lewej.
flash.text.GridFitType.SUBPIXELOkreśla dopasowanie poziomych i pionowych głównych linii siatki do siatki subpikseli w monitorach LCD. Korzystanie z tego ustawienia wymaga ustawienia właściwości flash.text.AntiAliasType pola tekstowego na wartość flash.text.AntiAliasType.ADVANCED. Ustawienie flash.text.GridFitType.SUBPIXEL często sprawdza się dla dynamicznego tekstu wyrównanego do prawej lub do środka jak również w przypadku, gdy jakość tekstu jest ważniejsza od jakości animacji.

Wartością domyślną jest pixel.



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

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład przedstawia trzy pola tekstowe różniące się ustawieniami właściwości gridFitType. W przypadku korzystania z tego przykładu należy zwrócić uwagę na czytelność pierwszych dwu wierszy. Należy również zwrócić uwagę na optymalne wykorzystanie właściwości GridFitType.PIXEL w przypadku tekstu wyrównywanego do lewej oraz GridFitType.SUBPIXEL w przypadku tekstu wyrównywanego do prawej.
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

właściwość 
htmlText:String

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zawiera reprezentację zawartości pola tekstowego w formacie HTML.

Program Flash Player obsługuje następujące znaczniki HTML:

Znacznik Opis
Znacznik zakotwiczenia Znacznik <a> służy do tworzenia łącza hipertekstowego i obsługuje następujące atrybuty:
  • target: Określa nazwę okna docelowego dla wczytania strony. Opcje zawierają wartości: _self, _blank, _parent oraz_top. Opcja _self określa bieżącą ramkę w bieżącym oknie; opcja_blank określa nowe okno; opcja _parent określa element macierzysty bieżącej ramki; a opcja _top określa ramkę najwyższego poziomu w bieżącym oknie.
  • href: określa adres URL lub zdarzenie link w języku ActionScript. Adres URL może być zarówno bezwzględny jak i względny w stosunku do lokalizacji pliku SWF, który wczytuje się na stronę. Przykład bezwzględnego odwołania do adresu URL to http://www.adobe.com; przykład względnego odwołania do adresu /index.html. Bezwzględne adresy URL muszą zostać poprzedzone przedrostkiem http://; w przeciwnym razie program Flash Player lub środowisko AIR potraktuje je jako względne adresy URL. Zdarzenie link umożliwia wywołanie funkcji ActionScript w pliku SWF za pomocą łącza bez konieczności odwoływania się do adresu URL. Aby określić zdarzenie link, w atrybucie href zamiast schematu http należy użyć schematu zdarzenia. Przykładem może być zdarzenie href="event:myText" (nie zdarzenie href="http://myURL"). Kliknięcie łącza hipertekstowego zawierającego schemat zdarzenia w polu tekstowym, powoduje wywołanie połączenia TextEvent za pomocą właściwości text, która została ustawiona na wartość „myText”. Można utworzyć funkcję ActionScript, która będzie uruchamiana za każdym wywołaniem połączenia TextEvent. Za pomocą arkuszy stylów można również określić style: a:link, a:hover oraz a:active dla znaczników zakotwiczenia.
Znacznik pogrubienia Znacznik <b> renderuje tekst jako pogrubiony. Użyta czcionka musi być dostępna w typie pogrubiona.
Znacznik podziału Znacznik podziału <br> wstawia znak podziału między wierszami w polu tekstowym. Ten znacznik powoduje, że pole tekstowe staje się wielowierszowe.
Znacznik czcionki Znacznik czcionki <font> określa czcionkę lub listę czcionek wyświetlanego tekstu. Znacznik czcionek obsługuje następujące atrybuty:
  • color: Tylko wartości szesnastkowe koloru są obsługiwane (#FFFFFF).
  • face: Określa nazwę użytej czcionki. Jak pokazano w poniższym przykładzie, w przypadku zdefiniowania listy nazw czcionek oddzielonych przecinkami, program Flash Player będzie wybierał pierwszą dostępną czcionkę. Jeśli dana czcionka nie jest zainstalowana na komputerze użytkownika lub nie została osadzona w pliku SWF, program Flash Player wybierze czcionkę zastępczą.
  • size: Określa rozmiar czcionki. Można używać bezwzględnych rozmiarów pikseli (np. 16 czy 18) lub względnych rozmiarów punktów (np. +2 lub -4).
Znacznik obrazu Znacznik <img> umożliwia osadzenie zewnętrznych plików obrazu (JPEG, GIF, PNG), plików SWF oraz klipów filmowych wewnątrz pól tekstowych. Tekst samoczynnie układa się wokół obrazów osadzonych w polach tekstowych. W celu zawijania tekstu wokół obrazu należy ustawić pole tekstowe jako wielowierszowe.

Znacznik <img> obsługuje następujące atrybuty:

  • src: Określa adres URL do obrazu lub pliku SWF, lub identyfikator powiązania symbolu klipu filmowego w bibliotece. Tej atrybut jest wymagany; pozostałe atrybuty są opcjonalne. Pliki zewnętrzne (JPEG, GIF, PNG oraz pliki SWF) nie są wyświetlane dopóki ich wczytywanie nie zostanie całkowicie zakończone.
  • width: Szerokość wstawionego obrazu, pliku SWF lub klipu filmowego wyrażona w pikselach.
  • height: Wysokość wstawionego obrazu, pliku SWF lub klipu filmowego wyrażona w pikselach.
  • align: Określa poziome wyrównanie osadzonego obrazu w polu tekstowym. Poprawne wartości to: left oraz right. Wartością domyślną jest wartość left.
  • hspace: Określa wielkość przestrzeni w poziomie, która otacza obraz i w której nie pojawia się tekst. Wartością domyślną jest 8.
  • vspace: Określa wielkość przestrzeni w pionie, która otacza obraz i w której nie pojawia się tekst. Wartością domyślną jest 8.
  • id: Określa nazwę instancji klipu filmowego (utworzoną w programie Flash Player) zawierającą osadzony plik obrazu, plik SWF lub klip filmowy. Takie podejście umożliwia sterowanie zawartością osadzoną za pomocą języka ActionScript.
  • checkPolicyFile: Powoduje, że program Flash Player sprawdza istnienie pliku reguł URL na serwerze skojarzonym z domeną obrazu. Jeśli plik reguł istnieje, pliki SWF znajdujące się w domenach z listy w pliku otrzymują dostęp do danych załadowanego obrazu, wywołując na przykład metodę BitmapData.draw() dla tego obrazu jako parametru source. Więcej informacji na temat zabezpieczeń zawiera odpowiedni temat w Centrum programistów programu Flash Player w kategorii Bezpieczeństwo.

Program Flash wyświetla w pełnym wymiarze nośniki osadzone w polu tekstowym. Aby zdefiniować wymiary osadzanego nośnika, należy użyć atrybutów znacznika <img>: height oraz width.

Zwykle, obraz osadzony w polu tekstowym pojawia się w wierszu następującym po znaczniku <img>. Jeśli znacznik <img> stanowi pierwszy znak pola tekstowego, obraz pojawi się w pierwszym wierszu pola tekstowego.

Dla treści aplikacji AIR w obszarze izolowanym aplikacji środowisko AIR ignoruje znaczniki img w treści HTML w obiektach ActionScript TextField. Takie ustawienie zapobiega atakom typu „phishing”.

Znacznik kursywy Znacznik kursywy <i> wyświetla oznaczony tekst w kursywie. Użyta czcionka musi być dostępna w typie kursywa.
Znacznik elementu listy Znacznik elementu listy <li> powoduje umieszczenie punktora na początku poprzedzanego tekstu. Uwaga: Ponieważ program Flash Player oraz środowisko AIR nie rozróżnia list uporządkowanych i nieuporządkowanych (<ol> i <ul>), typy znaczników nie wpływają na sposób renderowania tekstu. Wszystkie listy są nieuporządkowane, a wszystkie pozycje listy poprzedzone są punktorami.
Znacznik akapitu Znacznik paragrafu <p> umożliwia utworzenie nowego akapitu. Tego znacznika można używać w polu tekstowym ustawionym na jako wielowierszowe. Znacznik <p> obsługuje następujące atrybuty:
  • align: Określa wyrównanie tekstu akapitu; poprawne wartości to: left, right, justify oraz center.
  • class: określa klasę stylów CSS zdefiniowaną za pomocą obiektu flash.text.StyleSheet.
Znacznik zakresu Znacznika zakresu <span> można używać tylko w połączeniu ze stylami tekstu CSS. Znacznik obsługuje następujący atrybut:
  • class: Określa klasę stylów CSS zdefiniowaną za pomocą obiektu flash.text.StyleSheet.
Znacznik formatu tekstu

Znacznik formatu tekstu <textformat> umożliwia korzystanie z podzbioru właściwości klasy TextFormat służących do formatowania akapitu w polu tekstowym, za pomocą definicji odstępów między wierszami, wcięcia, marginesów oraz punktów tabulacji. Znaczniki formatu tekstu<textformat> można łączyć z wbudowanymi znacznikami HTML.

Znacznik <textformat> posiada następujące atrybuty:

  • blockindent: Określa wcięcie bloku tekstowego (w punktach); odpowiada właściwości TextFormat.blockIndent.
  • indent: Określa wcięcie mierzone od lewego marginesu do pierwszego znaku akapitu; odpowiada właściwości TextFormat.indent. Dopuszczalne są liczby dodatnie i ujemne.
  • leading: Określa wielkość odstępu (odstęp w pionie) między wierszami; odpowiada właściwości TextFormat.leading. Dopuszczalne są liczby dodatnie i ujemne.
  • leftmargin: Określa szerokość lewego marginesu akapitu, wyrażoną w punktach; odpowiada właściwości TextFormat.leftMargin.
  • rightmargin: Określa szerokość prawego marginesu akapitu, wyrażoną w punktach; odpowiada właściwości TextFormat.rightMargin.
  • tabstops: Określa niestandardowe punkty tabulacji w postaci zbioru całkowitych liczb nieujemnych; odpowiada właściwości TextFormat.tabStops.
Znacznik podkreślenia Znacznik podkreślenia <u> Ustawia podkreślenie dla tekstu oznaczonego tym znacznikiem.

Program Flash Player i środowisko AIR obsługują następujące elementy HTML:

Element Opis
&lt; < (znak mniejszości)
&gt; > (znak większości)
&amp; & (ampersand)
&quot; cudzysłów (")
&apos; apostrof (')

Program Flash Player oraz środowisko AIR obsługują również jawne kody znaków, jak np. &#38; (ampersand w kodzie ASCII) czy &#x20AC; (symbol € w kodzie Unicode).



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

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje tworzenie pola tekstowego TextField o nazwie tf1 i przypisanie sformatowenego ciągu znaków HTML do jego właściwości text. Wynikiem śledzenia tej właściwości htmlText jest sformatowany ciąg znaków HTML z dodatkowymi znacznikami (jak np. <P> i <FONT>) automatycznie dodawanymi w programie Flash Player. Wynikiem śledzenia właściwości text jest niesformatowany ciąg znaków bez znaczników HTML.

W celu porównania, wykonano te same czynności na kolejnym obiekcie TextField o nazwie tf2, z tą różnicą, że do właściwości styleSheet obiektu tf2 przypisano obiekt StyleSheet, zanim właściwość htmlText została ustawiona. W takim przypadku, śledzenie właściwości htmlText obejmuje jedynie sam tekst HTML, który został pierwotnie przypisany do właściwości htmlText i wykazuje, że program Flash Player nie dodał żadnych znaczników.

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

właściwość 
length:int  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Liczba znaków w polu tekstowym. Znaczniki (\t) są liczone jako pojedyncze znaki.



Implementacja
    public function get length():int

maxChars

właściwość 
maxChars:int

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Maksymalna liczba znaków, które użytkownik może wprowadzić w polu tekstowym. Za pomocą skryptu można wstawić więcej tekstu niż pozwala właściwość maxChars; właściwość maxChars oznacza maksymalną ilości tekstu wpisanego przez użytkownika. Jeśli wartość tej właściwości wynosi 0, użytkownik może wpisać nieograniczoną ilość tekstu.

Wartością domyślną jest 0.



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

maxScrollH

właściwość 
maxScrollH:int  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Maksymalna wartość właściwości scrollH.



Implementacja
    public function get maxScrollH():int

Powiązane elementy interfejsu API

maxScrollV

właściwość 
maxScrollV:int  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Maksymalna wartość właściwości scrollV.



Implementacja
    public function get maxScrollV():int

Powiązane elementy interfejsu API

mouseWheelEnabled

właściwość 
mouseWheelEnabled:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9

Wartość typu Boolean określająca, czy program Flash Player powinien automatycznie przewijać wielowierszowe pole tekstowe, gdy użytkownik kliknie na nie i poruszy pokrętłem myszy. Wartością domyślna jest wartość true. Za pomocą tej właściwości można zablokować przewijanie tekstu za pomocą pokrętła myszy w polu tekstowym lub zaimplementować własny sposób przewijania tekstu w polu tekstowym.



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

multiline

właściwość 
multiline:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Określa, czy pole tekstowe jest polem wielowierszowym. Wartość true wskazuje, że pole tekstowe jest polem wielowierszowym; wartość false wskazuje, że pole tekstowe jest polem jednowierszowym. W przypadku pola typu TextFieldType.INPUT wartość multiline określa, czy naciśnięcie klawisza Enter powoduje utworzenie nowego wiersza (false powoduje, że naciśnięcie klawisza Enter jest ignorowane). Jeśli tekst zostanie wklejony do pola TextField z wartością multiline równą false, nowe wiersze znajdują się poza tekstem.

Wartością domyślną jest false.



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

Powiązane elementy interfejsu API

numLines

właściwość 
numLines:int  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Określa liczbę wierszy w wielowierszowym polu tekstowym. Jeśli właściwość wordWrap jest ustawiona na wartość true, podczas zawijania tekstu liczba wierszy zwiększa się.



Implementacja
    public function get numLines():int

Powiązane elementy interfejsu API

restrict

właściwość 
restrict:String

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Oznacza zestaw znaków, które użytkownik może wprowadzać w polu tekstowym. Jeśli wartością właściwości restrict jest wartość null, użytkownik może wprowadzić dowolny znak. Jeśli wartością właściwości restrict jest pusty ciąg znaków, użytkownik nie może wprowadzić żadnego znaku. Jeśli wartością właściwości restrict jest ciąg znaków, użytkownik może wprowadzić do pola tekstowego tylko znaki z tego ciągu. Ciąg znaków jest przeszukiwany od lewej do prawej. Zakres można zdefiniować za pomocą znaku myślnika (-). Ograniczone są tylko interakcje użytkownika; skrypt może umieścić w polu tekstowym dowolny tekst. Tej właściwości nie można zsynchronizować z opcjami osadzania czcionki w inspektorze właściwości.

Jeśli ciąg znaków rozpoczyna się od znaku karetki (^), wszystkie znaki są początkowo akceptowane, a następujące po nich znaki w ciągu są wykluczane ze zbioru znaków akceptowanych. Jeśli ciąg znaków nie rozpoczyna się od znaku karetki (^), żadne znaki nie są początkowo akceptowane, a następujące po nich znaki w ciągu zostają zawarte w zbiorze znaków akceptowanych.

W poniższym przykładzie do pola tekstowego można wprowadzić tylko znaki dużej litery, spacje oraz liczby.

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

Poniższy przykład ilustruje włączenie wszystkich znaków z wyjątkiem tych pisanych małą literą:

     my_txt.restrict = "^a-z";
     

Aby wprowadzić znaczenie znaku karetki (^) lub kreski (-) można użyć ukośnika odwrotnego. Akceptowalne sekwencje zawierające ukośnik odwrotny to: \-, \^ lub \\. Ukośnik odwrotny musi stanowić rzeczywisty znak w ciągu znaków, dlatego w języku ActionScript należy użyć podwójnego znaku ukośnika odwrotnego. Na przykład poniższy kod zawiera tylko znak kreski (-) i karetki z (^):

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

Znaku ^ można użyć w dowolnym miejscu ciągu znaków — umożliwia włączanie i wykluczanie znaków. Poniższy kod włącza tylko znaki dużych liter, ale wyłącza literę Q:

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

Za pomocą sekwencji zmiany znaczenia \u można budować zastrzeżone ciągi znaków. Poniższy kod zawiera tylko znaki ASCII od numeru 32 (spacja) do 126 (tylda).

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

Wartością domyślną jest null.



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

scrollH

właściwość 
scrollH:int

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Bieżące położenie podczas przewijania poziomego. Wartość 0 właściwości scrollH oznacza, że tekst nie może być przewijany w poziomie. Wartość tej właściwości stanowi liczba całkowita, która reprezentuje położenie w poziomie wyrażone w pikselach.

Jednostką dla przewijania w poziomie są piksele, a dla przewijania w pionie — wiersze. Przewijanie w poziomie jest mierzone w pikselach, ponieważ większość zazwyczaj używanych czcionek jest równomiernie rozłożona, co oznacza, że znaki mogą mieć różną szerokość. Przewijanie w pionie w programie Flash Player odbywa się według wierszy, ponieważ użytkownicy zazwyczaj wolą wyświetlić pełny, a nie częściowy wiersz tekstowy. Nawet w przypadku, gdy w wierszu znajdują się różne czcionki, wysokość wiersza jest dostosowywana do największej z nich.

Uwaga: Zbiór liczb dla właściwości scrollH rozpoczyna się od liczby 0, a nie liczby 1, jak dla właściwości przewijania w pionie scrollV.



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

Powiązane elementy interfejsu API

scrollV

właściwość 
scrollV:int

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Pionowe położenie tekstu w polu tekstowym. Właściwość scrollV pomaga nawigować do konkretnego akapitu w długim ustępie lub tworzyć przewijane pola tekstowe.

Jednostką dla przewijania w pionie są wiersze, a dla przewijania w poziomie — piksele. Jeśli pierwszy wyświetlany wiersz to pierwszy wiersz pola tekstowego, właściwość scrollV przyjmuje wartość 1 (nie 0). Przewijanie w poziomie jest mierzone w pikselach ponieważ większość czcionek jest równomiernie rozłożona, co oznacza, że znaki mogą mieć różną szerokość. Przewijanie w pionie w programie Flash Player odbywa się według wierszy, ponieważ użytkownicy zazwyczaj chcą wyświetlić pełny, a nie częściowy wiersz tekstowy. Nawet w przypadku, gdy w wierszu znajdują się różne czcionki, wysokość wiersza jest dostosowywana do największej z nich.



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

Powiązane elementy interfejsu API

selectable

właściwość 
selectable:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Wartość typu Boolean wskazująca, czy dane pole tekstowe można zaznaczać. Wartość true oznacza, że tekst można zaznaczać. Właściwość selectable udostępnia sterowanie możliwością zaznaczenia, a nie edycji pola tekstowego. Dynamiczne pole tekstowe można zaznaczać nawet, gdy nie można go wyedytować. Jeśli dynamiczne pole tekstowe nie ma możliwości zaznaczenia, użytkownik nie może zaznaczyć w nim tekstu.

Jeśli właściwość selectable jest ustawiona na wartość false, tekst w polu tekstowym nie będzie reagował na polecenia zaznaczenia lub ich skróty klawiszowe i nie będzie go można skopiować za pomocą polecenia Kopiuj. Jeśli właściwość selectable jest ustawiona na wartość true, tekst w polu tekstowym można zaznaczyć za pomocą myszy lub klawiszy klawiatury i skopiować za pomocą polecenia Kopiuj. W ten sposób można zaznaczyć tekst, nawet jeśli pole tekstowe to dynamiczne, a nie wejściowe pole tekstowe.

Wartością domyślną jest true.



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

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje tworzenie dwóch dynamicznych pól tekstowych: w jednym polu tekstowym właściwość selectable ustawiono na wartość true, a w drugim właściwość selectable ma wartość false. W przypadku korzystania z tego przykładu należy spróbować zaznaczyć tekst w tych polach za pomocą myszy lub klawiatury.
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

właściwość 
selectionBeginIndex:int  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Indeks pierwszego znaku w bieżącym zaznaczeniu, liczony od 0. Na przykład, liczba dla pierwszego znaku to 0, dla drugiego to 1, itd. W przypadku braku zaznaczenia, ta właściwości przyjmuje wartość właściwości caretIndex.



Implementacja
    public function get selectionBeginIndex():int

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Ten przykład przedstawia utworzenie instancji TextField i zapełnienie jej tekstem. Przypisany zostaje detektor zdarzeń, za pomocą którego wywoływana jest metoda printCursorPosition w momencie kliknięcia pola tekstowego TextField. W takim przypadku wartości wynikowe właściwości caretIndex, selectionBeginIndex oraz selectionEndIndex stanowią wartości wyjściowe.

Należy wykonać czynności przedstawione w przykładzie i spróbować kliknąć obszar w polu tekstowym w celu zaznaczenia tekstu. Następnie należy kliknąć pole, nie zaznaczając tekstu. Podczas klikania tekstu bez zaznaczenia właściwość caretIndex wskazuje punkt wstawiania, a właściwości selectionBeginIndex oraz selectionEndIndex są równe wartości właściwości 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

właściwość 
selectionEndIndex:int  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Indeks ostatniego znaku w bieżącym zaznaczeniu, liczony od 0. Na przykład, liczba dla pierwszego znaku to 0, dla drugiego to 1, itd. W przypadku braku zaznaczenia, ta właściwości przyjmuje wartość właściwości caretIndex.



Implementacja
    public function get selectionEndIndex():int

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Ten przykład przedstawia utworzenie instancji TextField i zapełnienie jej tekstem. Przypisany zostaje detektor zdarzeń, za pomocą którego wywoływana jest metoda printCursorPosition w momencie kliknięcia pola tekstowego TextField. W takim przypadku wartości wynikowe właściwości caretIndex, selectionBeginIndex oraz selectionEndIndex stanowią wartości wyjściowe.

Należy wykonać czynności przedstawione w przykładzie i spróbować kliknąć obszar w polu tekstowym w celu zaznaczenia tekstu. Następnie należy kliknąć pole, nie zaznaczając tekstu. Podczas klikania tekstu bez zaznaczenia właściwość caretIndex wskazuje punkt wstawiania, a właściwości selectionBeginIndex oraz selectionEndIndex są równe wartości właściwości 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

właściwość 
sharpness:Number

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9

Ostrość krawędzi glifów w polu tekstowym. Ta właściwość ma zastosowanie tylko w przypadku, gdy właściwość flash.text.AntiAliasType pola tekstowego jest ustawiona na wartość flash.text.AntiAliasType.ADVANCED. Zakres wartości dla właściwości sharpness stanowi zbiór liczb od -400 do 400. W przypadku próby ustawienia dla właściwości sharpness wartości spoza tego zakresu, wartość dla tej właściwości w programie Flash zostanie ustawiona na najbliższą możliwą wartość zakresu (albo -400 albo 400).

Wartością domyślną jest 0.



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

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje efekt zmiany właściwości sharpness na obiekt TextField. Konieczne jest osadzenie czcionki oraz ustawienie właściwości antiAliasType na wartość ADVANCED.
package
{
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.text.AntiAliasType;
    import flash.text.GridFitType;
    import flash.text.TextFormat;

    public class sharpnessExample extends Sprite
    {
        public function sharpnessExample()
        {
    var format1:TextFormat = new TextFormat();
    format1.font="Arial";
    format1.size=24;
    var lTxt:String = "The quick brown fox";

    var tf1:TextField=createCustomTextField(0,lTxt,format1,-400);
    var tf2:TextField=createCustomTextField(30,lTxt,format1,0);
    var tf3:TextField=createCustomTextField(60,lTxt,format1,400);
        }

        private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldSharpness:Number):TextField 
       {
            var result:TextField = new TextField();
            result.y=y;
            result.text=fldTxt;
            result.embedFonts=true;
            result.autoSize=TextFieldAutoSize.LEFT;
            result.antiAliasType=AntiAliasType.ADVANCED;
            result.gridFitType=GridFitType.PIXEL;
            result.sharpness=fldSharpness;
            result..setTextFormat(format);
            addChild(result);
            return result;
        }
    }
}

styleSheet

właściwość 
styleSheet:StyleSheet

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Dołącza do pola tekstowego arkusz stylu. Więcej informacji na temat tworzenia arkuszy stylów, zawiera opis klasy StyleSheet oraz publikacja ActionScript 3.0 — Podręcznik dla programistów.

Zmiany arkuszy stylów powiązanych z danym polem tekstowym można dokonać w dowolnym momencie. Jeśli arkusz stylów, który jest w użyciu zostanie zmieniony, pole tekstowe zostaje ponownie narysowane z użyciem nowego arkusza stylów. Aby usunąć arkusz stylów, należy ustawić jego wartość na null lub undefined. Jeśli używany arkusz stylów zostanie usunięty, pole tekstowe zostaje ponownie narysowane bez arkusza stylów.

Uwaga: Jeśli arkusz stylów zostanie usunięty, zawartości obydwu właściwości TextField.text i TextField.htmlText zostanie przywrócone formatowanie zastosowane przy użyciu wcześniejszego arkusza stylów. Aby zachować pierwotną zawartość właściwości TextField.htmlText bez formatowania, przed usunięciem arkusza stylów należy zapisać wartość w zmiennej.



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

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Na poniższym przykładzie przedstawiono prosty obiekt StyleSheet oraz jego przypisanie do pola tekstowego z treścią HTML. Ustaw właściwość stylesheet przed określeniem zawartości.
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

właściwość 
text:String

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Ciąg znaków odpowiadający bieżącemu tekstowi w polu tekstowym. Wiersze są rozdzielone za pomocą znaku powrotu karetki ('\r', ASCII 13). Ta właściwość określa niesformatowany tekst w polu tekstowym, bez znaczników HTML.

Aby pobrać tekst w formacie HTML, należy użyć właściwości htmlText.

Uwaga: Jeśli do pola tekstowego zostanie zastosowany arkusz stylów, zawartość właściwości text zostanie potraktowana jak kod HTML.



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

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje tworzenie pola tekstowego TextField o nazwie tf1 i przypisanie sformatowenego ciągu znaków HTML do jego właściwości text. Wynikiem śledzenia tej właściwości htmlText jest sformatowany ciąg znaków HTML z dodatkowymi znacznikami (jak np. <P> i <FONT>) automatycznie dodawanymi w programie Flash Player. Wynikiem śledzenia właściwości text jest niesformatowany ciąg znaków bez znaczników HTML.

W celu porównania, wykonano te same czynności na kolejnym obiekcie TextField o nazwie tf2, z tą różnicą, że do właściwości styleSheet obiektu tf2 przypisano obiekt StyleSheet, zanim właściwość htmlText została ustawiona. W takim przypadku, śledzenie właściwości htmlText obejmuje jedynie sam tekst HTML, który został pierwotnie przypisany do właściwości htmlText i wykazuje, że program Flash Player nie dodał żadnych znaczników.

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

właściwość 
textColor:uint

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Kolor tekstu w polu tekstowym (w formacie szesnastkowym). W szesnastkowym systemie kolorów wartości kolorów są reprezentowane za pomocą sześciu cyfr. Dla każdej cyfry istnieje szesnaście możliwych wartości lub znaków. Zakres znaków obejmuje cyfry od 0 do 9, a następnie litery od A do F. Na przykład reprezentacja koloru czarnego 0x000000, a białego to 0xFFFFFF.

Wartością domyślną jest 0 (0x000000).



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

Przykład  ( Sposób korzystania z tego przykładu )
Za pomocą następującego kodu ActionScript tworzony jest obiekt TextField, a jego właściwość textColor zostaje zmieniona na kolor czerwony (0xFF0000).
package {
    import flash.display.Sprite;
    import flash.text.TextField;

    public class TextField_textColor extends Sprite {
        public function TextField_textColor() {
            var tf:TextField = createCustomTextField(10, 10, 100, 300);
            tf.text = "This will be red text";
            tf.textColor = 0xFF0000;            
        }

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

textHeight

właściwość 
textHeight:Number  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Wysokość tekstu w pikselach.



Implementacja
    public function get textHeight():Number

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje tworzenie obiektu TextField i przypisanie do niego tekstu. Za pomocą instrukcji trace wyświetlane są wartości dla właściwości textWidth i textHeight. W celu porównania wyświetlane są również właściwości width oraz height. (Należy pamiętać, że wartości wyświetlane dla właściwości textHeight i textWidth mogą być różne w zależności od czcionki wykorzystywanej na danym komputerze).
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

właściwość 
textInteractionMode:String  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 11, Flash Lite 4

Właściwość trybu interakcji, której wartością domyślną jest TextInteractionMode.NORMAL. Na platformach (urządzeniach) przenośnych tryb normalny sugeruje, że tekst można przewijać, ale nie można go zaznaczać. Tryb zaznaczania można uaktywniać za pośrednictwem wbudowanego menu kontekstowego w polu tekstowym. Na komputerze stacjonarnym tryb normalny sugeruje, że tekst można przewijać, a także zaznaczać.



Implementacja
    public function get textInteractionMode():String

textWidth

właściwość 
textWidth:Number  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Szerokość tekstu w pikselach.



Implementacja
    public function get textWidth():Number

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje tworzenie obiektu TextField i przypisanie do niego tekstu. Za pomocą instrukcji trace wyświetlane są wartości dla właściwości textWidth i textHeight. W celu porównania wyświetlane są również właściwości width oraz height. (Należy pamiętać, że wartości wyświetlane dla właściwości textHeight i textWidth mogą być różne w zależności od czcionki wykorzystywanej na danym komputerze).
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

właściwość 
thickness:Number

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9

Grubość krawędzi glifów w polu tekstowym. Ta właściwość ma zastosowanie tylko wówczas, gdy właściwość flash.text.AntiAliasType jest ustawiona na wartość flash.text.AntiAliasType.ADVANCED.

Zakres wartości dla właściwości thickness stanowi zbiór liczb od -200 do 200. W przypadku próby ustawienia dla właściwości thickness wartości spoza tego zakresu, wartość dla tej właściwości zostanie ustawiona na najbliższą możliwą wartość zakresu (albo -200 albo 200).

Wartością domyślną jest 0.



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

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje efekt zmiany właściwości thickness na obiekt TextField. Konieczne jest osadzenie czcionki oraz ustawienie właściwości antiAliasType na wartość ADVANCED.
package
{
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.text.AntiAliasType;
    import flash.text.GridFitType;
    import flash.text.TextFormat;

    public class thicknessExample extends Sprite
    {
        public function thicknessExample()
        {
    var format1:TextFormat = new TextFormat();
    format1.font="Arial";
    format1.size=24;
    var lTxt:String = "The quick brown fox";

    var tf1:TextField=createCustomTextField(0,lTxt,format1,-200);
    var tf2:TextField=createCustomTextField(30,lTxt,format1,0);
    var tf3:TextField=createCustomTextField(60,lTxt,format1,200);
        }

        private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldThickness:Number):TextField 
       {
            var result:TextField = new TextField();
            result.y=y;
            result.text=fldTxt;
            result.embedFonts=true;
            result.autoSize=TextFieldAutoSize.LEFT;
            result.antiAliasType=AntiAliasType.ADVANCED;
            result.gridFitType=GridFitType.PIXEL;
            result.thickness=fldThickness;
            result.setTextFormat(format);
            addChild(result);
            return result;
        }
    }
}

type

właściwość 
type:String

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Typ pola tekstowego. Jedna z dwóch następujących stałych TextFieldType: TextFieldType.DYNAMIC określająca dynamiczne pole tekstowe, którego użytkownik nie może edytować lub TextFieldType.INPUT określająca wejściowe pole tekstowe, które użytkownik może edytować.

Wartością domyślną jest dynamic.



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

Zgłasza
ArgumentError — Określona właściwość type nie należy do typu flash.text.TextFieldType.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje tworzenie dwóch pól tekstowych: tfDynamic oraz tfInput. Tekst zostaje wprowadzony do obydwu pól tekstowych. Jednakże, właściwość type pola tekstowego tfDynamic została ustawiona na wartość TextFieldType.DYNAMIC, a właściwość type pola tekstowego tfInput została ustawiona na wartość TextFieldType.INPUT. W ten oto sposób tekst w polu tfInput można modyfikować, ale tekst w polu tfDynamic można tylko wyświetlić.
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

właściwość 
useRichTextClipboard:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9

Określa, czy razem z tekstem można kopiować i wklejać jego format. W przypadku ustawienia wartości true program Flash Player kopiuje i wkleja formatowanie (takie jak wyrównanie, pogrubienie lub kursywa) podczas kopiowania i wklejania między polami tekstowymi. W celu przeprowadzenia procedury kopiuj i wklej, obydwa pola tekstowe (źródłowe i docelowe) powinny dla właściwości useRichTextClipboard mieć ustawioną wartość true. Wartością domyślną jest false.



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

Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje tworzenie pola tekstowego wprowadzania (tf1) oraz dwóch dynamicznych pól tekstowych (tf2 i tf3). Kod ten przypisuje każdemu dynamicznemu polu tekstowemu obiekt TextFormat (czcionka Courier Bold). Tekst tf2 ma właściwość useRichTextClipboard ustawioną na wartość false. Tekst tf3 ma właściwość useRichTextClipboard ustawioną na wartość true. W przypadku skopiowania tekstu z pola tekstowego tf2 i wklejenia go do pola tf1 formatowanie wklejanego tekstu jest zachowywane. W przypadku kopiowania tekstu z pola tekstowego tf3 (którego właściwość useRichTextClipboard jest ustawiona na wartość true) oraz wklejania go do pola tekstowego tf1 formatowanie wklejanego tekstu jest zachowywane.
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

właściwość 
wordWrap:Boolean

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Wartość typu Boolean wskazująca, że tekst w polu tekstowym może być zawijany. Dla wartości true właściwości wordWrap tekst w polu tekstowym będzie zawijany; dla wartości false, tekst w polu tekstowym nie będzie zawijany. Wartością domyślną jest false.



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

Przykład  ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje różnicę między ustawieniem właściwości wordWrap na wartość true, a jej ustawieniem na wartość false. Utworzone zostały dwie instancje TextField, których zawartość jest za duża dla ich szerokości. Właściwość wordWrap dla pierwszego obiektu (o nazwie tfWrap) została ustawiona na wartość true; dla drugiego obiektu (tfNoWrap) właściwość została ustawiona na wartość 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;
        }
    }
}
Konstruktor Szczegół

TextField

()Konstruktor
public function TextField()

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Tworzy nową instancję klasy TextField. Po utworzeniu instancji TextField, należy wywołać metodę addChild() lub addChildAt() obiektu nadrzędnego DisplayObjectContainer, w celu dodania instancji TextField do listy wyświetlania.

Domyślna wielkość pola tekstowego wynosi 100 x 100 pikseli.


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład przedstawia, w jaki sposób można dynamicznie tworzyć wejściowy obiekt TextField w języku ActionScript 3.0 poprzez ustawienie właściwości typu obiektu pola tekstowego na stałą TextFieldType.INPUT. Przykład pochodzi z witryny 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);
Szczegół metody

appendText

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Dołącza ciąg wskazany w parametrze newText na końcu tekstu w polu tekstowym. Ta metoda jest bardziej wydajna niż przypisanie dołączenia (+=) we właściwości text (takiej jak someTextField.text += moreText), zwłaszcza w przypadku pola tekstowego, które zawiera znaczną ilość tekstu.

Parametry

newText:String — Ciąg znaków, który dołącza się do istniejącego tekstu.


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład przedstawia wyświetlanie czasu w dni, które nie należą do weekendu oraz wyświetlanie tekstu „It's weekend” w dni, które przypadają w weekend. Metoda ta zlicza również ilość znaków do pewnego miejsca oraz ilość linii w polu tekstowym.

Ustawienie pola tekstowego outputText powoduje automatycznie dopasowanie tekstu i jego wyrównanie do lewej strony za pomocą właściwości autoSize. Za pomocą właściwości outputText.text zostaje zapisany pierwszy wiersz zawartości, a reszta zawartości zostaje dołączona przy użyciu metody appendText(). (Rozpoczęcie od właściwości text nie jest konieczne. Za pomocą metody appendText() można również od razu dołączyć tekst). Powtórne ustawienie właściwości text spowoduje nadpisanie pierwotnego tekstu. Aby dołączyć zawartość we właściwości text, należy użyć operatora +=.

Wyrażenie if sprawdza czy dana data to sobota (6) czy niedziela (0). W przeciwnym przypadku metoda toLocaleTimeString() zwraca czas lokalny, który zostaje dołączony do zawartości pola tekstowego.

Za pomocą właściwości length pola tekstowego można odczytać liczbę znaków bezpośrednio przed wywołaniem funkcji, a za pomocą właściwości numLines można policzyć liczbę linii w polu tekstowym. Należy pamiętać, że liczba linii zawiera również linie puste, a wartość długości zawartości zawiera również puste znaki oraz linie podziału.

  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

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca prostokąt będący obwiednią znaku.

Parametry

charIndex:int — Indeks znaku liczony od 0 (na przykład pierwsza pozycja to 0, druga to 1, itd.).

Zwraca
Rectangle — Prostokąt z minimalnymi i maksymalnymi wartościami x oraz y definiujący obwiednię znaku.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

W poniższym przykładzie przedstawiono użycie metody getCharBoundaries() do oznaczania (podświetlenia) znaku zaznaczonego przez użytkownika.

Klasa definiuje obiekt Shape o nazwie spotlight, który zostanie wykorzystany do narysowania prostokąta wokół każdego zaznaczonego znaku. Kliknięcie pola tekstowego myTextField wywołuje metodę clickHandler().

W metodzie clickHandler() metoda getCharIndexAtPoint() pobiera indeks klikniętego znaku w oparciu o współrzędne localX i localY miejsca kliknięcia myszą, określane względem ikonki Sprite. Metoda getCharIndexAtPoint() zwraca wartość -1, jeśli punkt (kliknięcia myszą) nie był poza znakiem. Ponieważ pole tekstowe może być większe niż sam tekst, zwrócona liczba całkowita (index) informuje czy użytkownik kliknął znak. Metoda getCharBoundaries() również wykorzystuje liczbę całkowitą index do pobrania obiektu Rectangle, który określa granice znaku. Za pomocą metody clear() można wyczyścić wcześniej wyświetlony obiekt Shape spotlight. W miejscu znaku zostaje wygenerowany nowy prostokąt o granicznej długości i szerokości znaku (przesunięcie w stosunku do współrzędnych: 10, 10) za pomocą zwróconych współrzędnych x i y prostokąta frame. Aby podświetlić znak, obiekt Shape spotlight zostaje wypełniony żółtym kolorem, a wartość krycia zostaje ustawiona na 35 procent, tak aby znak był również widoczny. Należy pamiętać, że spacje są również traktowane jako znaki.

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

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca indeks znaku liczony od 0 w punkcie określonym parametrami x i y.

Parametry

x:Number — Współrzędna x znaku.
 
y:Number — Współrzędna y znaku.

Zwraca
int — Indeks znaku liczony od 0 (na przykład pierwsza pozycja to 0, druga to 1, itd.). Zwraca wartość -1, jeśli punkt nie należy do żadnego znaku.

Przykład  ( Sposób korzystania z tego przykładu )

W poniższym przykładzie pokazano sytuację, w której kliknięcie znaku powoduje jego odwzorowanie w innym polu tekstowym powyżej tekstu.

Pierwsze pole tekstowe zawiera tekst, który użytkownik zamierza zaznaczyć. Aby spowodować kliknięcie, ale nie zaznaczenie tekstu, należy ustawić właściwość selectable na wartość fałsz. Kliknięcie pola tekstowego firstTextField powoduje wywołanie metody clickHandler().

W metodzie clickHandler(), metoda getCharIndexAtPoint() zwraca indeks znaku w oparciu o współrzędne localX oraz localY punktu kliknięcia myszą. Ponieważ pole tekstowe może zawierać więcej znaków niż zawiera tekst, zwrócona liczba całkowita (index) jest sprawdzana w celu upewnienia się, czy użytkownik kliknął znak. (Metoda getCharIndexAtPoint() zwraca wartość -1, jeśli (punkt kliknięcia myszą) (mouse click) nie był poza znakiem). Współrzędne myszy służą do ustalenia współrzędnych nowego pola tekstowego, w którym pojawi się odwzorowanie znaku. Kolor znaku w drugim polu tekstowym to kolor czerwony. Na końcu, tekst w drugim polu tekstowym jest ustawiany na zaznaczony znak, który został pobrany za pomocą metody charAt(). Należy pamiętać, że korzystanie z właściwości text zamiast metody appendText() spowoduje, że znak w drugim polu zostanie nadpisany, a nie dołączony.

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

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Po otrzymaniu indeksu znaku zwraca indeks pierwszego znaku w tym samym akapicie.

Parametry

charIndex:int — Indeks znaku liczony od 0 (na przykład pierwszy znak to 0, drugi to 1, itd.).

Zwraca
int — Indeks pierwszego znaku w tym samym akapicie, liczony od 0.

Zgłasza
RangeError — Określony indeks znaków jest poza zakresem.

Przykład  ( Sposób korzystania z tego przykładu )

W poniższym przykładzie formatowanie akapitu zastosowano do zawartości pola tekstowego. Kliknięcie akapitu spowoduje, że tekst akapitu zostanie wyrównany do prawej strony. Po ponownym kliknięciu akapitu powróci on do pierwotnego (domyślnego) formatowania (z wyrównaniem do lewej strony).

Konstruktor w polu tekstowym myTextField został ustawiony na zawijanie tekstu. Metoda getTextFormat zwraca pierwotne formatowanie pierwszego znaku zawartości pola tekstowego, które znajduje się w obiekcie TextFormat pod nazwą originalFormat. Zdefiniowany zostaje również nowy obiekt TextFormat (newFormat), a jego właściwość align zostaje przypisana wartość wyrównania do prawej. Kliknięcie na pole tekstowe wywołuje metodę clickHandler().

W metodzie clickHandler(), metoda getCharIndexAtPoint() zwraca indeks znaku w oparciu o współrzędne localX oraz localY punktu kliknięcia myszą. Pierwsza instrukcja if sprawdza, czy został kliknięty znak. Na podstawie liczby całkowitej clickIndex zwróconej przez metodę getCharIndexAtPoint() metoda getFirstCharInParagraph() zwraca indeks pierwszego znaku klikniętego akapitu. Indeks ostatniego znaku akapitu zostaje określony poprzez dodanie wartości długości akapitu (za pomocą metody getParagraphLength()) do indeksu pierwszego znaku akapitu i odjęcie ostatniego znaku (\n). Druga instrukcja warunkowa if sprawdza format pierwszego znaku akapitu. Jeśli jego wartość jest taka sama, jak wartość pierwotnego formatowania (wyrównanie do lewej), wówczas do wszystkich znaków w akapicie zostaje dodany nowy format. W przeciwnym razie format akapitu zostaje ustawiony na format pierwotny. Wyrównanie, wraz z formatowaniem takim jak wcięcie, wypunktowanie, punkty tabulacji, prawy i lewy margines stanowią elementy formatowania przeznaczonymi dla akapitu. Należy pamiętać, że ustawienie zawijania tekstu czy linii podziału wiersza będzie miało zastosowanie tylko do pierwszego wiersza akapitu, jeśli dla metody setTextFormat() nie zostanie zdefiniowany argument endIndex.

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

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca odwołanie do obiektu DisplayObject o podanym identyfikatorze id. Operacja dotyczy obrazu lub pliku SWF, które dodano do sformatowanego pola tekstowego HTML za pomocą znacznika <img>. Znacznik <img> jest w następującym formacie:

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

Parametry

id:String — Identyfikator id, który ma być zgodny (w atrybucie id znacznika <img>).

Zwraca
DisplayObject — Obiekt wyświetlany, który odpowiada obrazowi lub plikowi SWF o atrybucie id podanym w znaczniku <img> pola tekstowego. Ten obiekt to obiekt Loader ładujący multimedia z zewnętrznego źródła, który po załadowaniu staje się obiektem podrzędnym obiektu ładującego Loader. Dla multimediów osadzonych w pliku SWF jest to obiekt załadowany. Jeśli nie istnieje żaden znacznik <img> ze zgodną wartością id, metoda zwraca null.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje, jak poprzez kliknięcie pola tekstowego wartość krycia obrazu w polu zostaje ustawiona na 25%, a sam obraz jest obracany o 90 stopni od położenia pierwotnego. Każde kolejne kliknięcie obrazu spowoduje dalszy jego obrót.

Obraz (image.jpg) jest włączany za pośrednictwem kodu HTML. (Zakłada się, że plik obrazu znajduje się w tym samym katalogu co plik SWF). Aby uzyskać dostęp do obrazu za pomocą metody getImageReference(), należy zdefiniować atrybut id dla znacznika img. Właściwość htmlText wykorzystuje się do włączenia zawartości ciągu znaków sformatowanych za pomocą języka HTML. Kliknięcie pola tekstowego myTextField wywołuje metodę clickHandler().

W metodzie clickHandler() metoda getImageReference() zwraca odwołanie do obrazu w formie obiektu DisplayObject. Za pomocą tego odwołania można sterować obrazem, w taki sam sposób, jak dowolnym obiektem DisplayObject. Tutaj można ustawić właściwości alpha (przezroczystość) oraz rotation. Dzięki właściwości transform można uzyskać dostęp do matrycy obiektu wyświetlanego, uzyskać dostęp do transformacji koloru oraz obwiedni w pikselach. Należy pamiętać o konieczności zaimportowania obiektu flash.display.DisplayObject.

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

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

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

getLineIndexAtPoint

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca liczony od 0 indeks wiersza o podanym położeniu określonym przez parametry x i y.

Parametry

x:Number — Współrzędna x wiersza.
 
y:Number — Współrzędna y wiersza.

Zwraca
int — Indeks wiersza liczony od 0 (na przykład wartość pierwszego wiersza to 0, drugiego to 1, itd.). Zwraca wartość -1, jeśli punkt nie znajduje się ponad wierszem.

Przykład  ( Sposób korzystania z tego przykładu )

W poniższym przykładzie pokazano sytuację, w której użytkownik zaznaczając werset z sonetu Shakespeare'a kopiuje (załącza) go do nowego pola tekstowego.

W konstruktorze pole tekstowe poem nie jest ustawione na zawijanie (ponieważ jest to wiersz). Wykorzystano tu również właściwość autoSize do automatycznego dopasowania i wyrównania tekstu do lewej strony. Pole tekstowe poemCopy zostaje umieszczone za polem tekstowym poem. Kliknięcie dowolnego wersu wiersza spowoduje wywołanie metody clickHandler().

W metodzie clickHandler() metoda getLineIndexAtPoint() zwraca indeks klikniętego wiersza na podstawie wartości współrzędnych localX i localY punktu kliknięcia myszą. (Ponieważ pierwotny wiersz pasuje do rozmiarów aktualnego pola tekstowego, nie ma potrzeby sprawdzania, czy nie wystąpił błąd położenia poza obszarem (RangeError), który zostałby zwrócony za pomocą metody getCharIndexAtPoint()). Następnie indeks wiersza używany jest do pobrania zawartości wiersza jako ciągu znaków za pomocą metody getLineText(), a ciąg ten jest potem dołączany do zawartości pola tekstowego poemCopy. Kopiowanie może trwać nadal, ale po osiągnięciu pewnej granicy, tekst znajdzie się poza widocznym obszarem pola tekstowego 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

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca liczony od 0 indeks wiersza zawierającego znak określony przez parametr charIndex.

Parametry

charIndex:int — Indeks znaku liczony od 0 (na przykład pierwszy znak to 0, drugi to 1 itd.).

Zwraca
int — Indeks wiersza liczony od 0.

Zgłasza
RangeError — Określony indeks znaków jest poza zakresem.

Przykład  ( Sposób korzystania z tego przykładu )

W poniższym przykładzie metoda getLineIndexOfChar() zwraca numer wiersza dla 100 i 500 znaku w polu tekstowym.

Dla pola tekstowego myTextField określono ustawienia zawijania i wyrównania tekstu do lewej strony. Metoda getLineIndexOfChar() zwraca indeks wiersza dla określonych indeksów znaków (100 i 500). Następnie ta informacje zostaje dołączona na końcu akapitu. Indeks wiersza zaczyna się od wartości 0, dlatego indeks wiersza (index) zostanie powiększony o 1 w celu uzyskania numeru wiersza. Jeśli wielkość wyświetlanego tekstu legnie zmianie, zmienić się może również numer wiersza. Jednakże dołączona informacja pozostanie taka sama, ponieważ metoda jest wywoływana tylko raz.

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

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca liczbę znaków w określonym wierszu tekstowym.

Parametry

lineIndex:int — Numer wiersza, dla którego długość użytkownik zamierza określić.

Zwraca
int — Liczba znaków w wierszu.

Zgłasza
RangeError — Numer określonego wiersza znajduje się poza obszarem.

Przykład  ( Sposób korzystania z tego przykładu )

W poniższym przykładzie po zaznaczeniu wiersza przez użytkownika, w osobnym polu zostaje wyświetlona długość wiersza (liczba znaków).

W celu zilustrowania przykładu pole tekstowe myTextField wyświetlające tekst, który będzie zliczany, zostaje ustawione na wartość INPUT, co oznacza, że użytkownicy mogą zmieniać wiersze, dodawać kolejne wiersze między nimi lub na końcu istniejących wierszy. (Za pomocą znaku podziału (\n) umieszczonego na końcu ostatniego wiersza został utworzony nowy pusty wiersz). Pole tekstowe countLines, które wyświetla wynik zliczania długości wiersza znajduje się poniżej pola tekstowegomyTextField, a jego tekstu nie można zaznaczyć. Kliknięcie na wiersz w polu tekstowym myTextField spowoduje wywołanie metody clickHandler().

W metodzie clickHandler() metoda getLineIndexAtPoint() zwraca indeks klikniętego wiersza za pomocą współrzędnych localX i localY punktu kliknięcia myszą. Instrukcja warunkowa if sprawdza, czy użytkownik kliknął znak. Jeśli tak, metoda getLineLength() zwraca wartość liczby znaków w wierszu w oparciu o indeks wiersza. Należy pamiętać, że puste wiersze pomiędzy wierszami zawierają drugi znak podziału (\n), a liczba znaków w wierszu to 1, podczas gdy liczba znaków dla wiersza znajdującego się po ostatnim wierszu wynosi 0. Spacje są również liczone jako jeden znak. Jeśli użytkownik napisze nowy wiersz lub zmieni dowolny wiersz, klikając go może wyświetlić liczbę znaków w wierszu. Jeśli zawijanie tekstu jest włączone, a wielkość ekranu zmieniana, indeks wiersza może ulec zmianie.

 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

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca informacje o wymiarach danego wiersza tekstu.

Parametry

lineIndex:int — Numer wiersza, którego informacje o wymiarach użytkownik chce uzyskać.

Zwraca
flash.text:TextLineMetrics — Obiekt TextLineMetrics.

Zgłasza
RangeError — Numer określonego wiersza znajduje się poza obszarem.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniżej zostały pokazane przykładowe wartości wielkości dla dwóch wierszy tekstu o różnym formatowaniu.

Dołączony tekst stanowią dwa wersety utworu Song of Myself Walta Whitmana. Format drugiego wiersza ustawiony zostaje za pomocą nowego obiektu TextFormat (newFormat). Pierwszy wiersz zachowuje format domyślny. Metoda getLineMetrics() zwraca obiekt TextLineMetrics dla konkretnego wiersza. (Indeks wiersza zaczyna się od wartości 0). Za pomocą obiektów TextLineMetrics: metrics1 oraz metrics2 odpowiednio dla pierwszego i drugiego wiersza pobierane oraz wyświetlane są wartości następujących ustawień: wydłużenie górne, wydłużenie dolne, wysokość oraz grubość. Liczby wynikowe są konwertowane na ciągi znaków ale bez zaokrąglenia. Należy pamiętać, że te wartości odnoszą się do wiersza, a nie do konkretnego znaku. Odnoszą się do zakresu znaków w danym wierszu. Jeśli na przykład w wierszu znajdują się znaki o różnych wielkościach, wartość wysokości zostanie określona przez najwyższy znak. Oznacza to również, że jeśli format dowolnego znaku zostanie zmieniony, zmianie mogą ulec również wartości wielkości.

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

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca indeks pierwszego znaku w wierszu określonego przez parametr lineIndex.

Parametry

lineIndex:int — Indeks wiersza liczony od 0 (na przykład wartość pierwszego wiersza to 0, drugiego to 1 itd.).

Zwraca
int — Indeks pierwszego znaku wiersza, liczony od 0.

Zgłasza
RangeError — Numer określonego wiersza znajduje się poza obszarem.

Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje sytuację, w której wartość dla pierwszego znaku w wierszu o indeksie 4 ulegnie zmianie, jeśli wielkość ekranu (i pola tekstowego) zostanie zmieniona.

Pole tekstowe myTextField jest konfigurowane do zawijania tekstu. Pole tekstowe countField wyświetli pierwszy znak wiersza o indeksie 4. Kliknięcie pola tekstowego myTextField wywołuje metodę clickHandler().

W metodzie clickHandler(), metoda getLineOffset() zwraca indeks pierwszego znaku o wartości indeksu wiersza 3, który należy do czwartego wiersza tekstu. (Wartość indeksu pierwszego wiersza to 0). Za pomocą metody charAt() można pobrać znak przy użyciu indeksu pierwszego znaku czwartego wiersza. Do zawartości pola tekstowego countField zostaje dodana ta informacja za pomocą właściwości text pola tekstowego countField. Korzystanie z właściwości countField.text oznacza, że po każdym kliknięciu zawartości pola tekstowego countField zostanie ono nadpisane. Jeśli użytkownik dokona zmiany wielkości wyświetlanego tekstu, zawartość będzie zawijana, a pierwszy znak czwartego wiersza może się zmienić. Po ponownym kliknięciu pola myTextField, zawartość pola tekstowego countField zostaje zaktualizowana i obejmuje nowy pierwszy znak czwartego wiersza.

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

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca wiersz tekstowy określony przez parametr lineIndex.

Parametry

lineIndex:int — Indeks wiersza liczony od 0 (na przykład wartość pierwszego wiersza to 0, drugiego to 1, itd.).

Zwraca
String — Ciąg znaków zawarty w określonym wierszu.

Zgłasza
RangeError — Numer określonego wiersza znajduje się poza obszarem.

Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje szukanie i wyświetlanie numerów wierszy dla wszystkich instancji słowa „love”, jakie pojawiają się w sonecie Shakespeare'a.

Dla pola tekstowego poem zastosowano ustawienia automatycznego dopasowania oraz wyrównania tekstu do lewej strony. Ponieważ właściwość wordWrap jest ustawiona na wartość false, dlatego wersety wiersza nie będą zawijane, choć w standardowym zastosowaniu właściwości autoSize nie byłoby to problemem. Pętla for jest iterowana przez wersety sonetu za pomocą właściwości numLines pola tekstowego. MetodagetLineText() zwraca zawartość wiersza w formie ciągu znaków. (Należy pamiętać, że właściwość numLines zwraca numer wiersza zaczynając od wartości 1, podczas gdy dla metody getLineText() numer początkowego wiersza to 0). Przy użyciu wzorca regularnego wyrażenia (/love/i) instrukcja warunkowa if przeszukuje każdy ciąg cząstkowy wyrazu niezależnie od wielkości liter. Jeśli wzorzec zostanie znaleziony, metoda search zwraca indeks pierwszego pasującego ciągu cząstkowego, a w sytuacji przeciwnej — zwraca wartość -1 (jeśli nie znajdzie zgodnego ciągu). Numer wiersza, w którym znaleziono słowo „love” ((i + 1)) zostaje umieszczony w ciągu znaków lineResult. Metoda ciągu znaków konwertuje argument numeru ((i + 1)) na ciąg znaków, o ile istnieje inny argument będący ciągiem znaków („ ”). Wynik szukania wiersza będzie obejmował wiersze zawierające słowo „loved” czy „Love's”. Jeśli ciąg znaków „Love was found in lines:” zostanie umieszczony przed pętlą for, słowo „Love” w tym wierszu również zostanie ujęte.

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

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Po podaniu indeksu znaku zwraca wartość długości akapitu zawierający dany znak. Długość jest obliczana w odniesieniu do pierwszego znaku w akapicie (zwróconego przez metodę getFirstCharInParagraph()), a nie znaku, którego indeks został podany.

Parametry

charIndex:int — Indeks znaku liczony od 0 (na przykład pierwszy znak to 0, drugi to 1, itd.).

Zwraca
int — Zwraca liczbę znaków w akapicie.

Zgłasza
RangeError — Określony indeks znaków jest poza zakresem.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje, jak po zaznaczeniu akapitu, wartości dla długości akapitu oraz liczby znaków „s” w akapicie zostają wyświetlone w oddzielnym polu.

Pole tekstowe myTextField wyświetla akapity, które zaznaczy użytkownik. Kliknięcie na pole tekstowe wywoła zdarzenie MouseEvent.CLICK i wywoła metodę clickHandler(). Wartości dla długości akapitu oraz liczby wystąpień znaku „s” pojawią się w polu tekstowym countField, które znajduje się poniżej pola tekstowego myTextField.

W metodzie clickHandler(), metoda getCharIndexAtPoint() zwraca indeks znaku w oparciu o współrzędne localX oraz localY punktu kliknięcia myszą. Pierwsza instrukcja if sprawdza, czy został kliknięty znak. Na podstawie tego indeksu metoda getFirstCharInParagraph() zwraca indeks pierwszego znaku w tym samym akapicie. Wartość długości akapitu zwrócona przez metodę getParagraphLength() wraz z indeksem pierwszego znaku w akapicie służy do określenia indeksu końca akapitu. Pętla for jest iterowana przez akapit w poszukiwaniu liczby znaków „s”.

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

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

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

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

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

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

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

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

getTextFormat

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca obiekt TextFormat zawierający informacje o formatowaniu dla zakresu tekstu określonego przez parametry beginIndex oraz endIndex. Tylko właściwości wspólne dla całego danego tekstu zostają zawarte w wynikowym obiekcie TextFormat. Dowolna właściwość, która jest mieszana (co oznacza że przyjmuje różne wartości dla różnych punktów tekstu) ma wartość null.

Jeśli wartości dla tych parametrów nie zostaną określone, ta metoda zostanie zastosowana do całego tekstu w polu tekstowym.

Poniższa tabela przedstawia trzy możliwe zastosowania:

ZastosowanieOpis
my_textField.getTextFormat()Zwraca obiekt TextFormat zawierający informacje o formatowaniu dla całego tekstu z polu tekstowym. W wynikowym obiekcie TextFormat ustawiane są tyko te właściwości, które są wspólne dla całego tekstu w polu tekstowym. Dowolna właściwość, która jest mieszana (co oznacza, że przyjmuje różne wartości dla różnych punktów tekstu) ma wartość null.
my_textField.getTextFormat(beginIndex:Number)Zwraca obiekt zawierający kopię formatu tekstowego znaku znajdującego się w pozycji beginIndex.
my_textField.getTextFormat(beginIndex:Number,endIndex:Number)Zwraca obiekt TextFormat zawierający informacje o formatowaniu dla zakresu formatowania tekstowego od wartościbeginIndex do endIndex-1. W wynikowym obiekcie TextFormat ustawiane są tylko te właściwości, które są wspólne dla całego tekstu w określonym zakresie. Dowolna właściwość, która jest mieszana (co oznacza, że przyjmuje różne wartości dla różnych punktów zakresu) ma wartość null.

Parametry

beginIndex:int (default = -1) — Opcjonalnie; liczba całkowita określająca początek zakresu tekstu w polu tekstowym.
 
endIndex:int (default = -1) — Opcjonalnie; liczba całkowita określająca położenie pierwszego znaku po żądanym zakresie tekstu. Zgodnie oczekiwaniami określenie wartości beginIndex i endIndex powoduje odczytanie tekstu z zakresu od beginIndex do endIndex-1.

Zwraca
flash.text:TextFormat — Obiekt TextFormat, który reprezentuje właściwości formatowania danego tekstu.

Zgłasza
RangeError — Podany parametr beginIndex lub endIndex znajduje się poza zakresem.

Powiązane elementy interfejsu API


Przykład
Sposób korzystania z tego przykładu
Sposób wykorzystania metody getTextFormat() ilustrują przykłady dla metod getFirstCharInParagraph() oraz setTextFormat().

isFontCompatible

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 10, AIR 1.5, Flash Lite 4

Zwraca wartość true, jeśli osadzona czcionka jest dostępna z określonymi parametrami fontName i fontStyle, gdzie Font.fontType ma wartość flash.text.FontType.EMBEDDED. Począwszy od wersji Flash Player 10 w plikach SWF mogą być stosowane dwa rodzaje osadzonych czcionek. Normalne czcionki osadzone są używane tylko z obiektami TextField. Osadzone czcionki CFF są używane tylko z klasami flash.text.engine. Te dwa typy odróżnia właściwość fontType klasy Font, jaka jest zwracana przez funkcję enumerateFonts().

Obiekt TextField nie może korzystać z czcionki typu EMBEDDED_CFF. Jeśli dla parametru embedFonts ustawiona jest wartość true, a jedyna czcionka o określonej nazwie i stylu, jaka jest dostępna w środowisku wykonawczym, jest typu EMBEDDED_CFF, program Flash Player nie przeprowadzi renderowania tekstu — tak, jakby żadna osadzona czcionka nie była dostępna z określoną nazwą i stylem.

Jeśli czcionki EMBEDDED i EMBEDDED_CFF są dostępne (o takiej samej nazwie i stylu), zostaje wybrana czcionka EMBEDDED i wówczas tekst jest renderowany z czcionką EMBEDDED.

Parametry

fontName:String — Nazwa osadzonej czcionki do sprawdzenia.
 
fontStyle:String — Określa styl czcionki do sprawdzenia. Należy użyć flash.text.FontStyle

Zwraca
Booleantrue, jeśli dostępna jest zgodna czcionka osadzona, w przeciwnym wypadku false.

Zgłasza
ArgumentError — Określony obiekt fontStyle nie jest elementem flash.text.FontStyle.

Powiązane elementy interfejsu API

replaceSelectedText

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zastępuje bieżące zaznaczenie zawartością parametru value. Tekst zostaje wstawiony w miejscu bieżącego zaznaczenia wraz z domyślnym formatem znaków i akapitu. Tekst nie jest traktowany jako tekst HTML.

Metodę replaceSelectedText() można użyć do stawiania lub i usuwania tekstu, nie powodując zmian w formatowaniu znaków i akapitu w pozostałej części tekstu.

Uwaga: jeśli do pola tekstowego zastosowano arkusz stylów, ta metoda nie będzie działać.

Parametry

value:String — Ciąg znaków, który zastępuje aktualnie zaznaczony tekst.


Zgłasza
Error — Tej metody nie można stosować do pola tekstowego zawierającego arkusz stylów.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje sytuację, w której użytkownik, zaznaczając fragment tekstu usuwa go z pierwszego pola tekstowego oraz zastępuje zaznaczony tekst w drugim polu tekstowym ciągiem znaków „NEW TEXT”.

Dla zdarzeń MouseEvent.MOUSE_UP tworzone są dwa różne obiekty TextField oraz dodawane detektory zdarzeń. Zdarzenie Mouse up zostaje wywołane w momencie, gdy użytkownik zwalnia przycisk myszy (zdarzenie, które zwykle ma miejsce po zaznaczeniu fragmentu tekstu). Należy pamiętać o wybraniu domyślnych ustawień dla tekstu w polu tekstowym.

Zwolnienie przycisku myszy w polu tekstowym myTextField1, przy zastosowaniu metody mouseHandler1(), powoduje wymazanie tekstu i zastąpienie go pustym ciągiem znaków. W ten sposób można wymazać cały tekst. Zaznaczenie fragmentu tekstu w polu tekstowym myTextField2, przy użyciu metody mouseHandler2(), powoduje sprawdzenie właściwości selectionBeginIndex oraz selectionEndIndex pod kątem zaznaczenia znaku. (Właściwości selectionBeginIndex oraz selectionEndIndex nie będą posiadały tych samych wartości, jeśli dowolny fragment tekstu został zaznaczony). Zaznaczony tekst zostaje następnie zastąpiony ciągiem znaków „NEW TEXT”. W ten sposób można zastąpić cały pierwotny tekst drugiego pola tekstowego ciągiem znaków „NEW TEXT”.

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

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

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

replaceText

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zastępuje zakres znaków określonych przez parametry beginIndex oraz endIndex zawartością parametru newText. Zgodnie z planem został zastąpiony tekst z zakresu od beginIndex do endIndex-1.

Uwaga: Jeśli do pola tekstowego zastosowano arkusz stylów, ta metoda nie będzie działać.

Parametry

beginIndex:int — Liczony od 0 indeks pozycji wyjściowej zakresu zamiennego.
 
endIndex:int — Liczony od 0 indeks pozycji pierwszego znaku po żądanym zakresie tekstu.
 
newText:String — Tekst, który zastąpi określony zakres znaków.


Zgłasza
Error — Tej metody nie można stosować do pola tekstowego zawierającego arkusz stylów.

Przykład  ( Sposób korzystania z tego przykładu )

W poniższym przykładzie pokazano zastosowanie metody replaceText() do usuwania, zastępowania oraz umieszczania fragmentów tekstu w polu tekstowym.

Ustawienie pola tekstowego outputText powoduje automatyczne dopasowanie tekstu i jego wyrównanie do lewej strony. Pierwsze wywołanie metody replaceText() powoduje zastąpienie pierwszego wiersza („This is the wrong heading”) tekstem „THIS IS THE HEADING FOR EVERYONE”. Drugie wywołanie metody powoduje umieszczenie tekstu „CORRECT” między wyrazami „THE” i „HEADING”. Wywołanie metody po raz trzeci spowoduje usunięcie wyrazów „FOR EVERYONE”. Dla każdego wywołania metody appendText() wartości bieżącego indeksu początku i końca tekstu zmieniają się. Tutaj zostanie wyświetlona ostateczna wersja tekstu (po dokonaniu wszystkich zmian).

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

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zaznacza tekst określony wartościami indeksu pierwszego i ostatniego znaku, podanymi w parametrach beginIndex oraz endIndex. Jeśli wartości tych dwóch parametrów są takie same, za pomocą tej metody wyznacza się punkt wstawiania w taki sposób, jakby właściwość caretIndex została ustawiona.

Parametry

beginIndex:int — Indeks pierwszego znaku w zaznaczonym fragmencie, liczony od 0 (na przykład pierwszy znak określa wartości 0, drugi wartość 1, itd.).
 
endIndex:int — Indeks ostatniego znaku zaznaczenia, liczony od 0.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje sytuację, w której kliknięcie w dowolnym miejscu pola tekstowego spowoduje zaznaczenie predefiniowanego zakresu tekstu (wraz z podświetleniem wyrazów „TEXT IN ALL CAPS”.

Zdarzenia spowodowane kliknięciem myszą lub zwolnieniem przycisku myszy zostaną odnotowane przez dwa detektory zdarzeń pola tekstowego myTextField. Zdarzenie Mouse up zostanie wywołane, gdy użytkownik zwolni przycisk myszy (zdarzenie, które zwykle ma miejsce po zaznaczeniu fragmentu tekstu. Należy pamiętać o wybraniu domyślnego ustawienia dla tekstu w polu tekstowym. Kliknięcie fragmentu tekstu spowoduje wywołanie metody clickHandler(). Metoda mouseUpHandler() zostaje wywołana po zaznaczeniu tekstu i zwolnieniu przycisku myszy.

Dla obydwu metod clickHandler() i mouseUpHandler() metoda setSelection() określa tylko znaki między indeksami 54 a 70 (TEXT IN ALL CAPS), które powinny być zaznaczone.

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

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Stosuje formatowanie tekstowe określone przez parametr format do danego tekstu w polu tekstowym. Wartością parametru format musi być obiekt TextFormat, który określa żądane zmiany formatowania tekstowego. Tylko właściwości format różne od wartości null są stosowane do pola tekstowego. Żadna właściwość format ustawiona na wartość null nie jest stosowana. Wszystkie właściwości nowo utworzonego obiektu TextFormat są domyślnie ustawione na wartość null.

Uwaga: jeśli do pola tekstowego zastosowano arkusz stylów, ta metoda nie będzie działać.

Za pomocą metody setTextFormat() można zmienić formatowanie tekstowe zastosowane do zakresu znaków lub całego tekstu w polu tekstowym. Aby zastosować właściwości formatu do całego tekstu w polu tekstowym, nie należy określać wartości dla parametrów beginIndex oraz endIndex. Aby zastosować właściwości formatu do zakresu tekstu, należy określić wartości dla parametrów beginIndex i endIndex. Właściwość length umożliwia zdefiniowanie wartości indeksów.

Dwa rodzaje informacji znajdujących się w obiekcie TextFormat to poziom formatowania znaków oraz poziom formatowania akapitu. Każdy znak w polu tekstowym może posiadać indywidualne ustawienia formatowania, takie jak nazwa czcionki, jej rozmiar, pogrubienie oraz kursywa.

W przypadku akapitów pierwszy znak akapitu jest analizowany pod kątem ustawień formatowania akapitu dla całego akapitu. Przykłady ustawień formatowania akapitu stanowią: lewy margines, prawy margines oraz wcięcie.

Dowolny fragment tekstu wstawiony przez użytkownika lub zastąpiony przy użyciu metody replaceSelectedText() zostanie poddany domyślnemu formatowaniu pola tekstowego dla nowego tekstu, a nie formatowaniu ustawionemu dla miejsca wstawienia tekstu. Aby ustawić domyślne formatowanie pola tekstowego dla nowego tekstu, należy użyć właściwości defaultTextFormat.

Parametry

format:flash.text:TextFormat — Obiekt TextFormat zawierający informacje o formatowaniu znaków i akapitu.
 
beginIndex:int (default = -1) — Opcjonalnie; liczba całkowita, która definiuje pozycję indeksu określającą pierwszy znak lub żądany zakres tekstu.
 
endIndex:int (default = -1) — Opcjonalnie; liczba całkowita, która określa pierwszy znak po żądanym zakresie tekstu. Zgodnie z planem określenie wartości beginIndex oraz endIndex spowoduje aktualizację tekstu z zakresu od beginIndex do endIndex-1.

ZastosowanieOpis
my_textField.setTextFormat(textFormat:TextFormat)Stosuje właściwości parametru textFormat do całego tekstu w polu tekstowym.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int)Stosuje właściwości parametru textFormat do tekstu zaczynającego się w miejscu określonym przez wartość beginIndex.
my_textField.setTextFormat(textFormat:TextFormat, beginIndex:int, endIndex:int)Stosuje właściwości parametru textFormat do zakresu tekstu rozpoczynającego się w miejscu określonym przez wartość beginIndex do miejsca o wartości endIndex-1.

Należy pamiętać, że dowolny fragment tekstu wstawiony przez użytkownika lub zastąpiony przy użyciu metody replaceSelectedText() zostanie poddany domyślnemu formatowaniu pola tekstowego dla nowego tekstu, a nie formatowaniu ustawionemu dla miejsca wstawienia tekstu. Aby ustawić domyślne formatowanie pola tekstowego dla nowego tekstu, należy użyć właściwości defaultTextFormat.


Zgłasza
Error — Tej metody nie można stosować do pola tekstowego zawierającego arkusz stylów.
 
RangeError — Podany parametr beginIndex lub endIndex znajduje się poza zakresem.

Powiązane elementy interfejsu API


Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje sytuację, w której kliknięcie tekstu powoduje zmianę formatu określonego zakresu tekstu „TEXT IN ALL CAPS” z formatu domyślnego na nowy format.

Dla pola tekstowego myTextField zostaje dodany detektor zdarzeń, który na kliknięcia myszą będzie reagował wywołaniem metody clickHandler(). W metodzie clickHandler() metoda getTextFormat() zwraca bieżący format znaku (indeks 55) z danego zakresu tekstu, który zostaje następnie umieszczany we właściwości currentTextFormat obiektu TextFormat. Instrukcja warunkowa if sprawdza czy we właściwość currentTextFormat została zastosowana jako nowy format do znaku z zakresu (wielkość czcionki ustawiona na 18 punktów). Jeśli nie, nowy format zmienia rozmiar czcionki na 18 punktów, kolor na czerwony, dodaje podkreślenie oraz kursywę do zakresu tekstu między wartościami 54-70 („TEXT IN ALL CAPS”). Jeśli znak z zakresu jest w nowym formacie, format zakresu zostaje z powrotem ustawiony na domyślny (pierwotny) format pola tekstowego.

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);
            }    
        }    
    }
}
Szczegół zdarzenia

change

Zdarzenie
Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.CHANGE

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Wywoływane po zmodyfikowaniu wartości kontrolnej — inaczej niż zdarzenie textInput, które jest wywoływane przed modyfikacją wartości. Inaczej niż w wersji zdarzenia change obowiązującej w modelu W3C DOM Event Model, gdzie zdarzenie wywoływane jest wyłącznie po utracie aktywności przez element sterujący, w języku ActionScript 3.0 zdarzenie change jest wywoływane po każdej zmianie elementu sterującego. Na przykład, jeśli użytkownik wpisuje tekst do pola tekstowego, zdarzenie change zostaje wywołane za każdym uderzeniem klawisza.

Stała Event.CHANGE definiuje wartość właściwości type obiektu zdarzenia change.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblestrue
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetWartość obiektu została zmodyfikowana. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie.

Przykład  ( Sposób korzystania z tego przykładu )

W poniższym przykładzie, tekst wprowadzany przez użytkownika (dane wprowadzone przez użytkownika) jest od razu kopiowany („echo”) do innego pola tekstowego w innym formacie tekstowym.

Tworzone są dwa pola tekstowe: jedno dla danych wprowadzanych przez użytkownika oraz drugie (headingTextField) dla kopiowania tych danych. Utworzony również zostaje obiekt TextFormat, a do pola tekstowego headingTextField zostaje przypisany domyślny format tekstowy. Zmiana zawartości pola tekstowego wywołuje metodę changeHandler(), która przypisuje tekst w polu tekstowym inputTextField do pola tekstowego headingTextField. (Jeśli metoda zostałaby wywołana dla zdarzenia TextEvent.TEXT_INPUT zamiast Event.CHANGE, zawartość danych wpisanych przez użytkownika zostałaby skopiowana dopiero podczas wprowadzenia kolejnego fragmentu tekstu przez użytkownika).

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

Zdarzenie  
Typ obiektu zdarzenia: flash.events.TextEvent
właściwość TextEvent.type = flash.events.TextEvent.LINK

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Wywoływane, gdy użytkownik klika hiperłącze w polu tekstowym HTML, którego adres URL zaczyna się od ciągu „event:”. Pozostały fragment adresu URL znajdujący się po fragmencie „event:” zostanie umieszczony we właściwościach tekstu zdarzenia LINK.

Uwaga: Domyślne zachowanie, dodawanie tekstu do pola tekstu, następuje wówczas, gdy program Flash Player wywoła zdarzenie, które w tym przypadku ma miejsce w momencie, gdy użytkownik próbuje wprowadzić tekst. Nie można dodać tekstu do pola tekstowego za pomocą zdarzenia textInput.

Definiuje wartość właściwości type obiektu zdarzenia link.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblestrue
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetPole tekstowe zawierające kliknięte hiperłącze. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie.
textPozostała część adresu URL po ciągu "event:".

Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje definiowanie funkcji playMP3(). Utworzony zostaje obiekt TextField o nazwie list, zapełniany następnie tekstem HTML. Tekst "Track 1" i "Track 2" stanowi łącza wewnątrz pola tekstowego. Kliknięcie któregokolwiek z nich wywołuje funkcję playMP3(). Nazwa pliku MP3, która następuje po ciągu znaków „zdarzenie:" w atrybucie href znacznika HTML zostaje przekazana do metody linkHandler() jako właściwość text obiektu zdarzenia link.
package {
    import flash.display.Sprite;
    import flash.errors.IOError;
    import flash.events.IOErrorEvent;
    import flash.events.TextEvent;
    import flash.media.Sound;
    import flash.media.SoundChannel;
    import flash.net.URLRequest;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class TextField_event_link extends Sprite
    {
        private var myMP3:Sound;
        public function TextField_event_link() {
            myMP3 = new Sound();
            var list:TextField = new TextField();
            list.autoSize = TextFieldAutoSize.LEFT;
            list.multiline = true;
            list.htmlText = "<a href=\"event:track1.mp3\">Track 1</a><br>";
            list.htmlText += "<a href=\"event:track2.mp3\">Track 2</a><br>";
            addEventListener(TextEvent.LINK, linkHandler);
            addChild(list);
        }
        
        private function playMP3(mp3:String):void {
            try {    
                myMP3.load(new URLRequest(mp3));
                myMP3.play();
            }
            catch(err:Error) {
                trace(err.message);
            }
            myMP3.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
        }
        
        private function linkHandler(linkEvent:TextEvent):void {
            playMP3(linkEvent.text);
        }
        
        private function errorHandler(errorEvent:IOErrorEvent):void {
            trace(errorEvent.text);
        }
    }
}

scroll

Zdarzenie  
Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.SCROLL

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Wywoływane przez obiekt TextField po tym jak użytkownik przewinął tekst.

Stała Event.SCROLL definiuje wartość właściwości type obiektu zdarzeniascroll.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt TextField, który został przewinięty. Właściwość target nie zawsze jest obiektem na liście wyświetlania, który zarejestrował detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie.

Przykład  ( Sposób korzystania z tego przykładu )

W poniższym przykładzie zdefiniowano dwa obiekty TextField. Pierwszemu obiektowi TextField przypisano dwa moduły obsługi zdarzeń. Kliknięcie myszą w pierwszym polu tekstowym powoduje wywołanie zdarzenia mouseDown oraz skojarzonego z nim modułu obsługi zdarzeń mouseDownScroll. Moduł obsługi zdarzeń mouseDownScroll() powoduje przewinięcie pola. Następnie wywoływane jest zdarzenie scroll, a skojarzony z nim moduł scrollHandler() aktualizuje drugie pole tekstowe tak, aby wyświetlana w nim był obecny status przewijania.
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

Zdarzenie  
Typ obiektu zdarzenia: flash.events.TextEvent
właściwość TextEvent.type = flash.events.TextEvent.TEXT_INPUT

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Program Flash Player wywołuje zdarzenie textInput, kiedy użytkownik wprowadzi co najmniej jeden znak. To zdarzenie można wygenerować przy użyciu wielu różnych metod wprowadzania tekstu, w tym za pomocą standardowych klawiatur, edytora IME, systemów rozpoznawania głosu i mowy, a nawet poprzez wklejenie zwykłego tekstu, który nie będzie zawierał żadnych danych dotyczących formatowania czy stylu.

Definiuje wartość właściwości type obiektu zdarzenia textInput.

Uwaga: To zdarzenie nie jest wywoływane dla klawiszy Delete ani Backspace.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblestrue
cancelabletrue; w celu anulowania zachowania domyślnego należy wywołać metodę preventDefault().
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetPole tekstowe, do którego wprowadzane są znaki. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie.
textZnak lub sekwencja znaków wprowadzonych przez użytkownika.

Przykład  ( Sposób korzystania z tego przykładu )

W poniższym przykładzie zdefiniowano dwa obiekty TextField: pierwszy obiekt TextField jest polem tekstowym wprowadzania, a drugi obiekt TextField jest polem tekstowym dynamicznym. W miarę wprowadzania znaków tekstu w pierwszym polu tekstowym wywoływane jest zdarzenie textInput, a następnie moduł obsługi zdarzeń textInputHandler() i znaki zostają wyświetlone w drugim polu tekstowym. W przypadku wklejania bloku tekstowego do pola wprowadzania moduł obsługi zdarzeń kopiuje cały blok do drugiego z pól.
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

Zdarzenie  
Typ obiektu zdarzenia: flash.events.Event

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 11, Flash Lite 4

Program Flash Player wywołuje zdarzenie textInteractionModeChange, gdy użytkownik zmienia tryb interakcji pola tekstowego. W systemie Android można na przykład przełączać między trybem NORMAL (normalny) a trybem SELECTION (zaznaczanie) za pomocą opcji menu kontekstowego.

TextFieldExample.as

Poniższy przykład ilustruje sposób wyświetlenia komunikatu tekstowego przy użyciu klasy TextFieldExample. Należy wykonać następujące czynności:
  1. Utworzona zostaje właściwość label typu TextField.
  2. Konstruktor klasy wywołuje funkcję configureLabel().
  3. Metoda configureLabel() tworzy najpierw nowy obiekt TextField i przypisuje go do właściwości label, a następnie ustawia jego właściwości w następujący sposób:
    • Wyrównaj pole tekstowe do lewej.
    • Włącz wypełnianie tła.
    • Włącz obramowanie.
  4. Metoda configureLabel() tworzy zmienną format i przypisuje są do nowej instancji TextFormat wraz z parametrami ustawionymi w następujący sposób:
    • Typ czcionki = Verdana
    • Kolor czcionki = czerwony kryjący
    • Rozmiar czcionki = 10
    • Podkreślenie = true
  5. Właściwość defaultTextFormat pola tekstowego label jest również ustawiona wg formatu, a instancja label zostaje dodana do listy wyświetlania, która na stole montażowym wyświetla początkowo pole tekstowe bez tekstu.
  6. Konstruktor zmienia tekst pola tekstowego label na „Hello world and welcome to the show”. przez wywołanie metody setLabel().
package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.text.TextFormat;


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

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

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

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

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

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




[ X ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.