適用於 Adobe® Flash® Platform 的 ActionScript® 3.0 參考
首頁  |  隱藏套件和類別清單 |  套件  |  類別  |  新增內容  |  索引  |  附錄  |  為什麼顯示英文?
篩選: AIR 30.0 和更早版本, Flash Player 30.0 和更早版本, Flash Lite 4
Flex 4.6 和更早版本, Flash Pro CS6 和更早版本
隱藏篩選
flash.text 

TextSnapshot  - AS3

套件x

最上層
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

語言元素

全域常數
全域函數
運算子
陳述式、關鍵字和指令
特殊類型

附錄

新增內容
編譯器錯誤
編譯器警告
執行階段錯誤
移轉至 ActionScript 3
支援的字元集
僅限 MXML 標籤
移動 XML 元素
Timed Text 標籤
不建議元素清單
AccessibilityImplementation 常數
如何使用 ActionScript 範例
法律聲明
套件flash.text
類別public class TextSnapshot
繼承TextSnapshot Inheritance Object

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

您可以使用 TextSnapshot 物件,對影片片段中的靜態文字進行處理。 舉例來說,您可以使用這些物件,對文字以更高的精確度加以呈現 (相對於動態文字允許的精確度而言),但在存取文字時仍然採用唯讀方式。

請勿使用建構函式建立 TextSnapshot 物件,該物件是由 flash.display.DisplayObjectContainer.textSnapshot 屬性所傳回。

相關 API 元素



公用屬性
 屬性定義自
  charCount : int
[唯讀] TextSnapshot 物件中的字元數。
TextSnapshot
 Inheritedconstructor : Object
類別物件的參照或是特定物件實體的建構函數。
Object
公用方法
 方法定義自
  
findText(beginIndex:int, textToFind:String, caseSensitive:Boolean):int
會搜尋指定的 TextSnapshot 物件,並傳回 textToFind 第一次出現的位置 (在 beginIndex 或之後找到)。
TextSnapshot
  
getSelected(beginIndex:int, endIndex:int):Boolean
傳回一個 Boolean 值,用來指定 TextSnapshot 物件是否包含了指定範圍中的已選取文字。
TextSnapshot
  
getSelectedText(includeLineEndings:Boolean = false):String
會傳回字串,包含由對應的 setSelected() 方法指定的所有字元。
TextSnapshot
  
getText(beginIndex:int, endIndex:int, includeLineEndings:Boolean = false):String
會傳回字串,包含由 beginIndex 及 endIndex 參數所指定的所有字元。
TextSnapshot
  
getTextRunInfo(beginIndex:int, endIndex:int):Array
傳回物件的陣列,其中包含有關連續文字的資訊。
TextSnapshot
 Inherited
指出物件是否有已定義的指定屬性。
Object
  
可讓您判斷 TextSnapshot 物件中的哪一個字元位於或靠近影片片段 (包含 TextSnapshot 物件中的文字) 的指定 x, y 座標。
TextSnapshot
 Inherited
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。
Object
 Inherited
指出指定的屬性是否存在,以及是否可列舉。
Object
 Inherited
為迴圈作業設定動態屬性的可用性。
Object
  
setSelectColor(hexColor:uint = 0xFFFF00):void
會在反白標示以 setSelected() 方法選取的字元時,指定要使用的顏色。
TextSnapshot
  
setSelected(beginIndex:int, endIndex:int, select:Boolean):void
會在 TextSnapshot 物件中指定字元範圍,以選取或取消選取該範圍。
TextSnapshot
 Inherited
傳回代表此物件的字串,根據地區特定慣例進行格式化。
Object
 Inherited
會傳回指定之物件的字串形式。
Object
 Inherited
會傳回指定之物件的基本值。
Object
屬性詳細資訊

charCount

屬性
charCount:int  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

TextSnapshot 物件中的字元數。



實作
    public function get charCount():int

相關 API 元素

方法詳細資訊

findText

()方法
public function findText(beginIndex:int, textToFind:String, caseSensitive:Boolean):int

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

會搜尋指定的 TextSnapshot 物件,並傳回 textToFind 第一次出現的位置 (在 beginIndex 或之後找到)。 如果找不到 textToFind,此方法會傳回 -1

參數

beginIndex:int — 指定要搜尋指定之文字的開始點。
 
textToFind:String — 指定要搜尋的文字。 若您指定的是字串常值,而非字串型態的變數,請將該字串置於引號中。
 
caseSensitive:Boolean — 會指定文字是否必須符合 textToFind 中字串的大小寫。

傳回值
int — 指定之文字第一次出現的索引位置 (從零開始),或是 -1。

相關 API 元素

getSelected

()方法 
public function getSelected(beginIndex:int, endIndex:int):Boolean

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

傳回一個 Boolean 值,用來指定 TextSnapshot 物件是否包含了指定範圍中的已選取文字。

若要搜尋所有字元,請將 0 這個值傳遞給 start,並將 charCount (或任何非常大的數字) 傳遞給 end。 若要搜尋單一字元,請將比 start 參數大 1 的值傳遞給 end 參數。

參數

beginIndex:int — 指出要檢查之第一個字元的位置。 beginIndex 的有效值是從 0TextSnapshot.charCount - 1。 如果 beginIndex 是負值,就會使用 0
 
endIndex:int — 比要檢查之最後一個字元的索引大 1 的值。 endIndex 的有效值是從 0charCount。 索引為 endIndex 參數之字元將不會包含在擷取出來的字串之內。 如果省略此參數,便會使用 charCount。 若此值小於或等於 beginIndex 的值,則會使用 beginIndex + 1

傳回值
Boolean — Boolean 值,指出是否至少有一個字元在指定的範圍中,由對應的 setSelected() 方法所選取 (true);否則為 false

相關 API 元素

getSelectedText

()方法 
public function getSelectedText(includeLineEndings:Boolean = false):String

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9., Flash Lite 4

傳回字串,包含由對應之 setSelected() 方法指定的所有字元。 如果未使用 setSelected() 方法指定任何字元,則會傳回空字串。

如果您將 true 傳遞給 includeLineEndings,新行字元會插入到傳回字串中,且傳回字串可能會比輸入範圍長。 如果省略 includeLineEndings 或是對其傳遞 false,則此方法會傳回選取的文字,且不會新增任何字元。

參數

includeLineEndings:Boolean (default = false) — 選擇性的 Boolean 值,指定是否要將換行字元插入傳回字串的適當位置。 預設值是 false

傳回值
String — 字串,包含由對應的 setSelected() 命令指定的所有字元。

相關 API 元素

getText

()方法 
public function getText(beginIndex:int, endIndex:int, includeLineEndings:Boolean = false):String

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9., Flash Lite 4

傳回字串,包含由 beginIndexendIndex 參數指定的所有字元。 如果未選取任何字元,則會傳回空字串。

若要傳回所有字元,請將 0 這個值傳遞給 beginIndex,並將 charCount (或任何非常大的數字) 傳遞給 endIndex。 若要傳回單一字元,請將 beginIndex + 1 這個值傳遞給 endIndex

如果您將 true 這個值傳遞給 includeLineEndings,則換行字元會插入傳回字串的適當位置。 在此情況下,傳回字串的長度可能會大於輸入範圍。 若 includeLineEndingsfalse 或是遭到省略,則會傳回並未加入任何字元之已選取文字。

參數

beginIndex:int — 指出要包含在傳回字串中之第一個字元的位置。 beginIndex 的有效值是從 0charCount - 1。 如果 beginIndex 是負值,就會使用 0
 
endIndex:int — 比要檢查之最後一個字元的索引大 1 的值。 endIndex 的有效值是從 0charCount。 索引為 endIndex 參數之字元將不會包含在擷取出來的字串之內。 如果省略此參數,便會使用 charCount。 若此值小於或等於 beginIndex 的值,則會使用 beginIndex + 1
 
includeLineEndings:Boolean (default = false) — 選擇性的 Boolean 值,指定要在傳回字串中插入 (true) 或不插入 (false) 新行字元。 預設值是 false

傳回值
String — 字串,包含指定範圍中的字元,或是空字串 (如果指定範圍中找不到任何字元)。

相關 API 元素

getTextRunInfo

()方法 
public function getTextRunInfo(beginIndex:int, endIndex:int):Array

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9, Flash Lite 4

傳回物件的陣列,其中包含有關連續文字的資訊。 每個物件都對應到由兩個方法參數所指定的字元範圍中的一個字元。

注意: 使用 getTextRunInfo() 方法,即可傳回大範圍文字的大型物件。 Adobe 建議您限制由 beginIndexendIndex 參數定義的文字範圍。

參數

beginIndex:int — TextSnapshot 物件中,字元範圍內第一個字元的索引值。
 
endIndex:int — TextSnapshot 物件中,字元範圍內最後一個字元的索引值。

傳回值
Array — 物件的陣列,其中每個物件都包含字元範圍 (由 beginIndexendIndex 參數指定) 中特定字元的相關資訊。 每個物件都包含下列十一個屬性:
  • indexInRun -- 字元之從零開始的整數索引 (相對於整個字串而言,而非選取的連續文字)。
  • selected -- Boolean 值,true 表示已選取字元;否則為 false
  • font -- 字元的字體名稱。
  • color -- 字元的混合 Alpha 及顏色值。 前兩個十六進位數代表 Alpha 值,其餘的位數則代表顏色值。
  • height -- 字元的高度,以像素為單位。
  • matrix_amatrix_bmatrix_cmatrix_dmatrix_txmatrix_ty -- 矩陣的值,定義字元的幾何變形。 一般來說不管文字的高度為何,向上文字一律會有 [1 0 0 1 x y] 格式的矩陣,其中 xy 是父影片片段內字元的位置。 矩陣位於父影片片段的座標系統中,且不包含任何可在影片片段本身 (或它的父輩) 存在的變形。
  • corner0xcorner0ycorner1xcorner1ycorner2xcorner2ycorner3xcorner3y -- 字元的範圍框角落,視父影片片段的座標系統而定。 只有在字元使用的字體內嵌於 SWF 檔中,才可以使用這些值。

相關 API 元素

hitTestTextNearPos

()方法 
public function hitTestTextNearPos(x:Number, y:Number, maxDistance:Number = 0):Number

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9., Flash Lite 4

可讓您判斷 TextSnapshot 物件中的哪一個字元位於或靠近影片片段 (包含 TextSnapshot 物件中的文字) 的指定 x, y 座標。

若您省略傳遞給 maxDistance 的值,或是對其傳遞 0 的值,則 x, y 座標所指定的位置必須位於 TextSnapshot 物件的範圍框中。

只有在使用包含字元對照表資訊的字體時,這個方法才能正確運作。不過根據預設,Flash 不會在靜態文字欄位中加入這項資訊。 因此,方法可能會傳回 -1 而不是索引值。 若要確保傳回的是索引值,您可以迫使 Flash 編寫工具加入字體的字元對照表資訊。 若要執行這項作業,請增加一個使用該字體的動態文字欄位,選取該動態文字欄位的「字元選項」,然後指定至少應該要針對一個字元來嵌入字體外框。(您可以指定任何字元,即使是用於靜態文字欄位中的字元,也沒有關係)。

參數

x:Number — 數字,代表包含文字之影片片段的 x 座標。
 
y:Number — 數字,代表包含文字之影片片段的 y 座標。
 
maxDistance:Number (default = 0) — 選擇性數字,代表與可用來搜尋文字之 x, y 之間的最大距離。 這個距離是從每個字元的中心點測量。 預設值為 0

傳回值
Number — 數字,代表最靠近指定之 x, y 座標的字元索引值。 如果找不到任何字元,或者如果字體不包含字元對照表資訊,則會傳回 -1

相關 API 元素

setSelectColor

()方法 
public function setSelectColor(hexColor:uint = 0xFFFF00):void

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9., Flash Lite 4

會在反白標示以 setSelected() 方法選取的字元時,指定要使用的顏色。 這個顏色永遠是不透明的;您不能指定一個透明度值。

只有在使用包含字元對照表資訊的字體時,這個方法才能正確運作。不過根據預設,Flash 不會在靜態文字欄位中加入這項資訊。 因此,方法可能會傳回 -1 而不是索引值。若要確保傳回的是索引值,您可以迫使 Flash 編寫工具加入字體的字元對照表資訊。 若要執行這項作業,請增加一個使用該字體的動態文字欄位,選取該動態文字欄位的「字元選項」,然後指定至少應該要針對一個字元來嵌入字體外框。(您可以指定任何字元,即使是用於靜態文字欄位中的字元,也沒有關係)。

參數

hexColor:uint (default = 0xFFFF00) — 字元周圍邊框使用的顏色,這些字元是由對應的 setSelected() 命令所選取,而顏色會以十六進位格式 (0xRRGGBB) 表示。

相關 API 元素

setSelected

()方法 
public function setSelected(beginIndex:int, endIndex:int, select:Boolean):void

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 9., Flash Lite 4

會在 TextSnapshot 物件中指定字元範圍,以選取或取消選取該範圍。 已選取的字元背後會繪出一個與該字元之範圍框相符的有色矩形。 範圍框的顏色是由 setSelectColor() 定義。

若要選取或取消選取所有字元,請將 0 這個值傳遞給 beginIndex,並將 charCount (或是任何非常大的數字) 傳遞給 endIndex。 若要指定單一字元,請將 start + 1 的值傳遞給 endIndex

因為字元是分別被標示為已選取,因此您可以多次呼叫這個方法,以選取多個字元;換句話說,使用這個方法時,並不會將這個方法先前已經設定的字元取消選取。

有色矩形,指出只會顯示包含字元對照表之字體的選取範圍。根據預設,Flash 不會在靜態文字欄位加入這項資訊。 在某些情況下,這項行為表示已選取的文字不會在螢幕上顯示為已選取。若要確保所有選取的文字已確實選取,您可以迫使 Flash 編寫工具加入字體的字元對照表資訊。 若要執行這項作業,請增加一個使用該字體的動態文字欄位,選取該動態文字欄位的「字元選項」,然後指定至少應該要針對一個字元來嵌入字體外框。您可以指定任何字元,即使是用於靜態文字欄位中的字元,也沒有關係。

參數

beginIndex:int — 指出要選取之第一個字元的位置。 beginIndex 的有效值是從 0charCount - 1。 如果 beginIndex 是負值,就會使用 0
 
endIndex:int — 整數,其值為 1 + 要檢查之最後一個字元的索引。 end 的有效值是從 0charCount。 索引為 end 參數之字元將不會包含在擷取出來的字串之內。 如果略過此參數,則會使用 TextSnapshot.charCount。 若 beginIndex 的值小於或等於 endIndex 的值,則會使用 beginIndex + 1
 
select:Boolean — Boolean 值,指定應該 (true) 或不應該 (false) 選取文字。

相關 API 元素





[ X ]為什麼顯示英文?
「ActionScript 3.0 參考」的內容是以英文顯示

並非所有「ActionScript 3.0 參考」的內容都翻譯為所有語言。當語言元素未翻譯時,就會以英文顯示。例如,ga.controls.HelpBox 類別並沒有翻譯為任何語言。因此在參考的繁體中文版本中,ga.controls.HelpBox 類別就會以英文顯示。