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

InteractiveObject  - 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.display
類別public class InteractiveObject
繼承InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
子類別 DisplayObjectContainer, SimpleButton, TextField

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

InteractiveObject 類別是使用者可以使用滑鼠、鍵盤或其他使用者輸入裝置,與其進行互動之所有顯示物件的抽象基底類別。

您無法直接將 InteractiveObject 類別實體化。 呼叫 new InteractiveObject() 建構函式會擲出 ArgumentError 例外。

InteractiveObject 類別本身並不包含任何用來在螢幕上呈現內容的 API。 若要建立 InteractiveObject 類別的子類別,可以擴充其中一個有 API 的子類別,用於在螢幕上演算內容,例如 Sprite、SimpleButton、TextField 或 MovieClip 類別。

檢視範例



公用屬性
 屬性定義自
  accessibilityImplementation : AccessibilityImplementation
對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
此顯示物件的目前輔助功能選項。
DisplayObject
 Inheritedalpha : Number
指出所指定物件的 Alpha 透明度值。
DisplayObject
 InheritedblendMode : String
來自 BlendMode 類別的值,會指定要使用何種混合模式。
DisplayObject
 InheritedblendShader : Shader
[唯寫] 設定用來混合前景和背景的著色器。
DisplayObject
 InheritedcacheAsBitmap : Boolean
如果設定為 true,Flash 執行階段會快取顯示物件的內部點陣圖表示法。
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
如果為非 null,當 cacheAsBitmap 設定為 true 時,這個 Matrix 物件會定義顯示物件的顯示方法。
DisplayObject
 Inheritedconstructor : Object
類別物件的參照或是特定物件實體的建構函數。
Object
  contextMenu : NativeMenu
指定與此物件有關聯的快顯選單。
InteractiveObject
  doubleClickEnabled : Boolean
會指定物件是否會收到 doubleClick 事件。
InteractiveObject
 Inheritedfilters : Array
索引的陣列,其中包含目前和顯示物件相關的每個濾鏡物件。
DisplayObject
  focusRect : Object
會指定這個物件是否會顯示焦點矩形。
InteractiveObject
 Inheritedheight : Number
會指出顯示物件的高度,以像素為單位。
DisplayObject
 InheritedloaderInfo : LoaderInfo
[唯讀] 會傳回 LoaderInfo 物件,其中包含關於載入此顯示物件所屬之檔案的資訊。
DisplayObject
 Inheritedmask : DisplayObject
呼叫之顯示物件會以指定的 mask 物件遮蓋。
DisplayObject
 InheritedmetaData : Object
如果中繼資料是透過 PlaceObject4 標籤與 SWF 檔案中的這個 DisplayObject 實體一同儲存,則會取得 DisplayObject 實體的中繼資料物件。
DisplayObject
  mouseEnabled : Boolean
指定此物件是否接收滑鼠或其他使用者輸入及訊息。
InteractiveObject
 InheritedmouseX : Number
[唯讀] 指出滑鼠或使用者輸入裝置位置的 x 座標,以像素為單位。
DisplayObject
 InheritedmouseY : Number
[唯讀] 指出滑鼠或使用者輸入裝置位置的 y 座標,以像素為單位。
DisplayObject
 Inheritedname : String
指出 DisplayObject 的實體名稱。
DisplayObject
  needsSoftKeyboard : Boolean
指定虛擬鍵盤 (螢幕上的軟體鍵盤) 是否應在此 InteractiveObject 實體接收到焦點時顯示。
InteractiveObject
 InheritedopaqueBackground : Object
會指定顯示物件是否不透明,並具有特定背景顏色。
DisplayObject
 Inheritedparent : DisplayObjectContainer
[唯讀] 指出包含此顯示物件的 DisplayObjectContainer 物件。
DisplayObject
 Inheritedroot : DisplayObject
[唯讀] 對載入之 SWF 檔案的顯示物件而言,root 屬性就是該 SWF 檔案所呈現之顯示清單樹狀結構部分的最上層顯示物件。
DisplayObject
 Inheritedrotation : Number
指出 DisplayObject 實體的旋轉度數 (從該物件原本方向算起)。
DisplayObject
 InheritedrotationX : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 x 軸旋轉 (以度數為單位)。
DisplayObject
 InheritedrotationY : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 y 軸旋轉 (以度數為單位)。
DisplayObject
 InheritedrotationZ : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 z 軸旋轉 (以度數為單位)。
DisplayObject
 Inheritedscale9Grid : Rectangle
目前產生效用的縮放格線。
DisplayObject
 InheritedscaleX : Number
指出從註冊點套用的物件水平縮放 (百分比)。
DisplayObject
 InheritedscaleY : Number
指出從物件註冊點套用的物件垂直縮放 (百分比)。
DisplayObject
 InheritedscaleZ : Number
指出從物件註冊點套用的物件深度縮放 (百分比)。
DisplayObject
 InheritedscrollRect : Rectangle
顯示物件的捲動矩形範圍。
DisplayObject
      softKeyboard : String
控制軟體鍵盤的外觀。
InteractiveObject
  softKeyboardInputAreaOfInterest : Rectangle
定義顯示軟體鍵盤時,應保留於螢幕上的區域 (iOS 未提供)。
InteractiveObject
 Inheritedstage : Stage
[唯讀] 顯示物件的「舞台」。
DisplayObject
  tabEnabled : Boolean
會指定這個物件是否在停駐點順序中。
InteractiveObject
  tabIndex : int
會指定 SWF 檔中的物件停駐點順序。
InteractiveObject
 Inheritedtransform : flash.geom:Transform
這是一個物件,具有和顯示物件的矩陣、顏色轉換和像素邊界有關的屬性。
DisplayObject
 Inheritedvisible : Boolean
不管是否看得見顯示物件。
DisplayObject
 Inheritedwidth : Number
會指出顯示物件的寬度,以像素為單位。
DisplayObject
 Inheritedx : Number
指出 DisplayObject 實體相對於父輩 DisplayObjectContainer 之區域座標的 x 座標。
DisplayObject
 Inheritedy : Number
指出 DisplayObject 實體相對於父輩 DisplayObjectContainer 之區域座標的 y 座標。
DisplayObject
 Inheritedz : Number
表示 DisplayObject 實體相對於 3D 父輩容器的 z 座標位置 (沿著 z 軸)。
DisplayObject
公用方法
 方法定義自
  
呼叫 new InteractiveObject() 建構函式會擲回 ArgumentError 例外。
InteractiveObject
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式,以便讓偵聽程式收到事件的通知。
EventDispatcher
 Inherited
會將事件傳送到事件流程。
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
傳回可定義顯示物件區域 (相對於 targetCoordinateSpace 物件的座標系統) 的矩形。
DisplayObject
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
根據 targetCoordinateSpace 參數所定義的座標系統,並排除形狀上的任何筆畫,傳回可定義顯示物件邊界的矩形。
DisplayObject
 Inherited
將 point 物件從「舞台」(全域) 座標轉換成顯示物件的 (區域) 座標。
DisplayObject
 Inherited
將二維點從「舞台」(全域) 座標轉換為三維顯示物件的 (區域) 座標。
DisplayObject
 Inherited
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。
EventDispatcher
 Inherited
指出物件是否有已定義的指定屬性。
Object
 Inherited
評估顯示物件的範圍框,看它是否與 obj 顯示物件的範圍框重疊或相交。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
評估顯示物件,看它是否與 x 和 y 參數所指定的點重疊或相交。
DisplayObject
 Inherited
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。
Object
 Inherited
將三維顯示物件的 (區域) 座標的三維點轉換為「舞台」(全域) 座標中的二維點。
DisplayObject
 Inherited
將 point 物件從顯示物件的 (區域) 座標轉換成「舞台」(全域) 座標。
DisplayObject
 Inherited
指出指定的屬性是否存在,以及是否可列舉。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
會從 EventDispatcher 物件移除偵聽程式。
EventDispatcher
  
升起顯示虛擬鍵盤。
InteractiveObject
 Inherited
為迴圈作業設定動態屬性的可用性。
Object
 Inherited
傳回代表此物件的字串,根據地區特定慣例進行格式化。
Object
 Inherited
會傳回指定之物件的字串形式。
Object
 Inherited
會傳回指定之物件的基本值。
Object
 Inherited
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式,或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。
EventDispatcher
事件
 事件 摘要 定義自
 Inherited[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。EventDispatcher
 Inherited當顯示物件加入顯示清單中時傳送。DisplayObject
 Inherited會在顯示物件加入舞台上的顯示清單時,以直接或是透過加入包含該顯示物件之子樹狀結構的方式傳送。DisplayObject
  當使用者從文字快顯選單中選取「清除」(或「刪除」) 時傳送。InteractiveObject
  會當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置主按鈕時傳送。InteractiveObject
  
    contextMenu
當使用者手勢在 AIR 應用程式中觸發與此互動式物件相關聯的快顯選單時傳送。InteractiveObject
  當使用者針對複製作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「複製」時傳送。InteractiveObject
  當使用者針對剪下作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「剪下」時傳送。InteractiveObject
 Inherited[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。EventDispatcher
  在 InteractiveObject 物件的 doubleClickEnabled 旗標設為 true 的情況下,當使用者在相同的物件上方連續兩次快速按下並放開指標裝置主要按鈕時傳送。InteractiveObject
 Inherited[廣播事件] 當播放磁頭進入新影格時傳送。DisplayObject
 Inherited[廣播事件] 當播放磁頭結束目前影格時傳送。DisplayObject
  當顯示物件取得焦點之後傳送。InteractiveObject
  當顯示物件失去焦點時傳送。InteractiveObject
 Inherited[廣播事件] 在影格顯示物件的建構函式執行之後,且影格指令碼執行之前傳送。DisplayObject
  當使用者沿著觸控面與 InteractiveObject 實體建立接觸點 (例如沿著 Apple TV 的 Siri Remote 觸控面點選),某些裝置可能也會將此接觸解譯為數個觸控事件的組合。InteractiveObject
  當使用在觸控裝置上的同一個 InteractiveObject 實體上按下兩個接觸點後送出 (例如在行動電話或平板電腦觸控螢幕的顯示物件上方,以兩支手指按下後鬆開)。InteractiveObject
  當使用者在觸控裝置上,將接觸點移動到 InteractiveObject 實體上方後傳送 (例如,在行動電話或平板電腦觸控螢幕的顯示物件上,由左向右移動手指)。InteractiveObject
  當使用者在 InteractiveObject 實體的接觸點上做出旋轉手勢後傳送 (例如兩指觸摸行動電話或平板電腦的觸控螢幕,然後手指在顯示物件上旋轉)。InteractiveObject
  當使用者在與 InteractiveObject 實體的某個接觸點上做出揮動手勢後傳送 (例如,三指併在一起觸碰行動電話或平板電腦的觸控螢幕,然後在顯示物件上快速平行移動手指)。InteractiveObject
  當使用者與 InteractiveObject 實體建立接觸點,然後在觸控裝置上點一下後送出 (例如,將多根手指放到行動電話或平板電腦觸控螢幕的顯示物件上以開啟選單,然後其中一根手點一下,選取選單項目)。InteractiveObject
  當使用者在 InteractiveObject 實體的某個接觸點上做出放大縮小手勢後傳送 (例如兩指併在一起觸摸行動電話或平板電腦的觸控螢幕,然後手指在顯示物件上快速張開)。InteractiveObject
  這個事件會送出至任何支援 IME 內嵌輸入的用戶端應用程式。InteractiveObject
  會當使用者按下按鍵時傳送。InteractiveObject
  當使用者嘗試使用鍵盤瀏覽變更焦點時傳送。InteractiveObject
  會當使用者放開按鍵時傳送。InteractiveObject
  當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置中間按鈕時傳送。InteractiveObject
  當使用者將指向裝置的中間按鈕移至 InteractiveObject 實體上方按下時傳送。InteractiveObject
  當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。InteractiveObject
  當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。InteractiveObject
  會當使用者嘗試使用指向裝置變更焦點時傳送。InteractiveObject
  會當指向裝置停在 InteractiveObject 上方的情況下使用者將其移動時傳送。InteractiveObject
  會當使用者將指向裝置移開 InteractiveObject 實體時傳送。InteractiveObject
  會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。InteractiveObject
  當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。InteractiveObject
  當滑鼠滾輪在 InteractiveObject 實體上方轉動時傳送。InteractiveObject
  當使用者釋放手勢時,由拖曳初始程式 InteractiveObject 傳送。InteractiveObject
  已在目標 InteractiveObject 上放下拖曳的物件,而且已呼叫 DragManager.acceptDragDrop() 接受該放開的資料時,由此目標 InteractiveObject 傳送。InteractiveObject
  當手勢進入 InteractiveObject 的邊界時,由此 InteractiveObject 傳送。InteractiveObject
  當手勢離開 InteractiveObject 的邊界時,由此 InteractiveObject 傳送。InteractiveObject
  當拖曳手勢還留在 InteractiveObject 的邊界內,由此 InteractiveObject 持續傳送。InteractiveObject
  在呼叫 DragManager.doDrag() 進行拖曳作業初期,由指定做為拖曳初始程式的 InteractiveObject 傳送。InteractiveObject
  在呼叫 DragManager.doDrag() 進行拖曳作業期間,由指定做為拖曳初始程式的 InteractiveObject 傳送。InteractiveObject
  當使用者針對貼上作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「貼上」時傳送。InteractiveObject
  在使用者將作用中觸控筆往下移至超過螢幕鄰近偵測邊框時傳送。InteractiveObject
  
    proximityEnd
在使用者將作用中觸控筆提到螢幕鄰近偵測邊框時傳送。InteractiveObject
  在使用者將作用中觸控筆移到螢幕上方,而其餘仍在鄰近偵測邊框內時傳送。InteractiveObject
  
    proximityOut
在使用者將作用中觸控筆移出這個 InteractiveObject 之外,而其餘仍在螢幕的鄰近偵測邊框內時傳送。InteractiveObject
  在使用者直接將作用中觸控筆移到這個 InteractiveObject 上方,而其餘仍在螢幕的鄰近偵測邊框內時傳送。InteractiveObject
  在使用者將作用中觸控筆移出這個 InteractiveObject 及其任一子系之外,而其餘仍在螢幕的鄰近偵測邊框內時傳送。InteractiveObject
  在使用者透過這個 InteractiveObject,從顯示清單中後代的物件樹狀結構之外移動作用中觸控筆時傳送 (而其餘仍在螢幕的鄰近偵測邊框內)。InteractiveObject
  當使用者第一次按下 InteractiveObject 實體上方的按鈕,然後將指向裝置滑出 InteractiveObject 實體之後即放開指向裝置上的按鈕時傳送。InteractiveObject
 Inherited會當顯示物件將要從顯示清單移除時傳送。DisplayObject
 Inherited會在顯示物件即將從顯示清單移除時,以直接或是透過移除包含該顯示物件之子樹狀結構的方式傳送。DisplayObject
 Inherited[廣播事件] 當顯示清單將要更新和顯示時傳送。DisplayObject
  當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置右邊按鈕時傳送。InteractiveObject
  當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。InteractiveObject
  當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。InteractiveObject
  會當使用者將指向裝置移開 InteractiveObject 實體時傳送。InteractiveObject
  會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。InteractiveObject
  當使用者針對全選作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「全選」時傳送。InteractiveObject
  升起顯示軟體鍵盤之後立即傳送。InteractiveObject
  升起顯示軟體鍵盤前立即傳送。InteractiveObject
  降下隱藏軟體鍵盤之後立即傳送。InteractiveObject
  在物件的 tabChildren 旗標值變更時傳送。InteractiveObject
  在物件的 tabEnabled 旗標變更時傳送。InteractiveObject
  在物件的 tabIndex 屬性值變更時傳送。InteractiveObject
  當使用者輸入一或多文字的字元時送出。InteractiveObject
  當使用者在第一次接觸觸控裝置後傳送 (例如手指觸摸行動電話或平板電腦的觸控螢幕)。InteractiveObject
  當使用者在觸控裝置上移除接觸點後傳送 (例如在行動電話或平板電腦觸控螢幕上移開手指)。InteractiveObject
  當使用者觸控裝置時傳送,並且連續不斷地傳送,直到接觸點移除為止。InteractiveObject
  當使用者在觸控裝置中,將接觸點移出 InteractiveObject 實體後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件移至另一個顯示物件)。InteractiveObject
  當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件外面的某一點,往顯示物件上方拖曳)。InteractiveObject
  當使用者在觸控裝置上,將接觸點從 InteractiveObject 實體移出後送出 (例如,在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件上方拖曳到顯示物件以外)。InteractiveObject
  當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件外面的某一點,往顯示物件上方拖曳)。InteractiveObject
  當使用者在觸控裝置的同一個 InteractiveObject 實體上,在原先開始接觸點放開後送出 (例如在行動電話或平板電腦觸控螢幕上的顯示物件上方,以手指按下某個點後又鬆開)。InteractiveObject
屬性詳細資訊

accessibilityImplementation

屬性
accessibilityImplementation:AccessibilityImplementation

語言版本: ActionScript 3.0

對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。



實作
    public function get accessibilityImplementation():AccessibilityImplementation
    public function set accessibilityImplementation(value:AccessibilityImplementation):void

相關 API 元素

contextMenu

屬性 
contextMenu:NativeMenu

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

指定與此物件有關聯的快顯選單。

對於在 Flash Player 中執行的內容,此屬性為 ContextMenu 物件。在 AIR 執行階段中,ContextMenu 類別會擴充 NativeMenu 類別,不過 Flash Player 只支援 ContextMenu 類別而非 NativeMenu 類別。

注意:TextField 物件紿終在快顯選單中包含剪貼簿選單。剪貼簿選單包含「剪下」、「複製」、「貼上」、「清除」以及「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件,選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clearcopycutpasteselectAll 事件。



實作
    public function get contextMenu():NativeMenu
    public function set contextMenu(value:NativeMenu):void

範例  ( 如何使用本範例 )
以下範例會顯示如何將 Sprite 的 contextMenu 屬性設定至 ContextMenu 物件,以便將自訂快顯選單項目加到 Sprite 物件。範例由 ActionScriptExamples.com 提供。
var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
 
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
 
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
 
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
    spr.graphics.clear();
    spr.graphics.beginFill(0xFF0000);
    spr.graphics.drawRect(0, 0, 120, 90);
    spr.graphics.endFill();
}

doubleClickEnabled

屬性 
doubleClickEnabled:Boolean

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

指定物件是否接收 doubleClick 事件。 預設值為 false,也就是說,InteractiveObject 依預設無法接收 doubleClick 事件。 如果將 doubleClickEnabled 屬性設為 true,則實體會接收到其範圍內的 doubleClick 事件。 InteractiveObject 實體的 mouseEnabled 屬性必須同時設為 true,這樣物件才能接收 doubleClick 事件。

設定這個屬性不會傳送任何事件。 您必須使用 addEventListener() 方法來加入 doubleClick 事件所需的事件偵聽程式。



實作
    public function get doubleClickEnabled():Boolean
    public function set doubleClickEnabled(value:Boolean):void

相關 API 元素

focusRect

屬性 
focusRect:Object

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

會指定這個物件是否會顯示焦點矩形。 它可以接受下列三個值中的其中一個:truefalsenulltruefalse 值會如預期方式運作,指定是否顯示焦點矩形。null 值表示此物件會遵循舞台的 stageFocusRect 屬性。



實作
    public function get focusRect():Object
    public function set focusRect(value:Object):void

mouseEnabled

屬性 
mouseEnabled:Boolean

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

指定此物件是否接收滑鼠或其他使用者輸入及訊息。預設值為 true,也就是說,任何位於顯示清單上的 InteractiveObject 實體,依預設都會接收滑鼠事件或其他使用者輸入事件。如果 mouseEnabled 設定成 false,則此實體不會接收任何滑鼠事件 (或其他使用者輸入事件,例如鍵盤事件)。在顯示清單上,此實體的任何子系都不會受到影響。 若要變更顯示清單上某個物件的所有子系之 mouseEnabled 行為指令,請使用 flash.display.DisplayObjectContainer.mouseChildren

設定這個屬性不會傳送任何事件。 您必須使用 addEventListener() 方法來建立互動式功能。



實作
    public function get mouseEnabled():Boolean
    public function set mouseEnabled(value:Boolean):void

相關 API 元素

needsSoftKeyboard

屬性 
needsSoftKeyboard:Boolean

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10.2, AIR 2.6

指定虛擬鍵盤 (螢幕上的軟體鍵盤) 是否應在此 InteractiveObject 實體接收到焦點時顯示。

根據預設,此值為 false,而將焦點放在 InteractiveObject 實體上並不會升起軟體鍵盤。如果將 needsSoftKeyboard 屬性設定為 true,則當 InteractiveObject 實體準備好接受使用者輸入時,執行階段便會升起軟體鍵盤。InteractiveObject 實體會在以程式設計方式呼叫以設定 Stage focus 屬性或使用者互動 (例如「輕點」) 之後準備好接受使用者輸入。如果用戶端系統可以使用硬體鍵盤,或者不支援虛擬鍵盤,則不會升起軟體鍵盤。

在升起和降下隱藏軟體鍵盤時,InteractiveObject 實體會傳送 softKeyboardActivatingsoftKeyboardActivatesoftKeyboardDeactivate 事件。

注意:iOS 上的 AIR 應用程式中不支援此屬性。



實作
    public function get needsSoftKeyboard():Boolean
    public function set needsSoftKeyboard(value:Boolean):void

相關 API 元素

    

softKeyboard

屬性 
softKeyboard:String

語言版本: ActionScript 3.0
執行階段版本: AIR 21.0

控制軟體鍵盤的外觀。

具備軟體鍵盤的裝置可以自訂鍵盤按鍵,以符合所需的輸入類型。例如,如果需要數值輸入,裝置可以使用 SoftKeyboardType.NUMBER,只顯示軟體鍵盤上的數字。有效值定義為 SoftKeyboardType 類別的常數:

  • "default"
  • "punctuation"
  • "url"
  • "number"
  • "contact"
  • "email"
  • "phone"
  • "decimalpad"

這些值都是提示,可協助裝置顯示目前操作適用的最佳鍵盤。

預設值為 SoftKeyboardType.DEFAULT。



實作
    public function get softKeyboard():String
    public function set softKeyboard(value:String):void

擲回值
ArgumentError — 如果設為不屬於 SoftKeyboardType 成員的任何一個值

相關 API 元素

softKeyboardInputAreaOfInterest

屬性 
softKeyboardInputAreaOfInterest:Rectangle

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10.2, AIR 2.6

定義顯示軟體鍵盤時,應保留於螢幕上的區域 (iOS 未提供)。

如果此 InteractiveObject 的 needsSoftKeyboard 屬性為 true,則執行階段會視需要調整顯示,讓使用者在輸入資料時仍看得到物件。執行階段通常會使用從 DisplayObject.getBounds() 方法取得的物件邊界。您可以使用此 softKeyboardInputAreaOfInterest 屬性來指定不同的區域。

在舞台座標中指定 softKeyboardInputAreaOfInterest

注意:在 Android 中,softKeyboardInputAreaOfInterest 不適用於橫向模式。

注意:iOS 不支援 softKeyboardInputAreaOfInterest



實作
    public function get softKeyboardInputAreaOfInterest():Rectangle
    public function set softKeyboardInputAreaOfInterest(value:Rectangle):void

相關 API 元素

tabEnabled

屬性 
tabEnabled:Boolean

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

會指定這個物件是否在停駐點順序中。 如果此物件在定位停駐點順序中,則其數值為 true,否則為 false。 根據預設,除了下列情況以外,這個值都為 false

  • 對於 SimpleButton 物件,這個值為 true
  • 對於具有 type = "input" 的 TextField 物件,這個值為 true
  • 對於 Sprite 物件或具有 buttonMode = true 的 MovieClip 物件,這個值為 true



實作
    public function get tabEnabled():Boolean
    public function set tabEnabled(value:Boolean):void

tabIndex

屬性 
tabIndex:int

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

會指定 SWF 檔中的物件停駐點順序。 tabIndex 屬性預設為 -1,也就是說該物件沒有設定任何定位停駐點索引。

如果目前該 SWF 檔所顯示的任何物件含有 tabIndex 屬性,自動定位停駐點順序便會停用,而定位停駐點的順序會從物件在 SWF 檔中的 tabIndex 屬性開始計算。 自訂定位停駐點順序只會包含具有 tabIndex 屬性的物件。

tabIndex 屬性可以是非負值的整數。 物件是根據它們的 tabIndex 屬性,依遞增順序排列。 tabIndex 值為 1 的物件會排在 tabIndex 值為 2 的物件前面。 請勿對多個物件使用相同的 tabIndex 值。

tabIndex 屬性所定義的自訂定位停駐點順序是「平面」。 也就是說,SWF 檔中物件的階層架構關係是被忽略的。 該 SWF 檔中具有 tabIndex 屬性的所有物件都是依照定位停駐點順序放置的;這個定位停駐點順序是由 tabIndex 值的順序來決定。

注意:若要為 TLFTextField 實體設定停駐點順序,請將 TLFTextField 的顯示物件子系轉換為 InteractiveObject,然後設定 tabIndex 屬性。例如:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 
若要從 TLFTextField 物件之三個實體的預設值反轉停駐點順序 (tlfInstance1tlfInstance2tlfInstance3),請使用:
	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 



實作
    public function get tabIndex():int
    public function set tabIndex(value:int):void
建構函式詳細資料

InteractiveObject

()建構函式
public function InteractiveObject()

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

呼叫 new InteractiveObject() 建構函式會擲出 ArgumentError 例外。 然而,您可以呼叫下列 InteractiveObject 子類別的建構函式:

  • new SimpleButton()
  • new TextField()
  • new Loader()
  • new Sprite()
  • new MovieClip()

方法詳細資訊

requestSoftKeyboard

()方法
public function requestSoftKeyboard():Boolean

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10.2, AIR 2.6

升起顯示虛擬鍵盤。

呼叫此方法,會將焦點放在 InteractiveObject 實體上,並視需要升起軟體鍵盤。needsSoftKeyboard 也必須為 true。如果可以使用硬體鍵盤,或者用戶端系統不支援虛擬鍵盤,則不會升起鍵盤。

注意:iOS 上的 AIR 應用程式中不支援此方法。

傳回值
Booleantrue 值表示已取得軟體鍵盤要求的權限,false 表示未升起軟體鍵盤。

相關 API 元素

事件詳細資訊

clear

事件
事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.CLEAR

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

當使用者從文字快顯選單中選取「清除」(或「刪除」) 時傳送。此事件會傳送至目前成為焦點的物件。如果目前成為焦點的物件是 TextField,此事件的預設行為指令就是刪除該文字欄位中目前選取的任何文字。

Event.CLEAR 常數會定義 clear 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblesfalse
cancelablefalse;沒有要取消的預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
target具有為 clear 事件註冊之偵聽程式的任何 InteractiveObject 實體。

注意:TextField 物件不會傳送 clearcopycutpasteselectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件,選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clearcopycutpasteselectAll 事件。不過,其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件),將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

click

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.CLICK

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

會當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置主按鈕時傳送。 若要讓按下事件發生,該事件必須永遠按照此事件系列的發生順序: mouseDown 事件,然後才是 mouseUp。 這兩個事件的目標物件必須是完全相同的,否則就不會發生 click 事件。 不管何時,任何數量的其它滑鼠事件都可以在 mouseDownmouseUp 事件之間發生;而 click 事件則是不管何時都會發生。

定義 type 屬性值 (click 事件物件)。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDownclick 事件的這個值一律為 false
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
    

contextMenu

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.CONTEXT_MENU

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

當使用者手勢在 AIR 應用程式中觸發與此互動式物件相關聯的快顯選單時傳送。

MouseEvent.CONTEXT_MENU 常數會定義 contextMenu 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDown如果按下滑鼠右鍵,則為 true;否則為 false
cancelablefalse;無法取消預設的行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
clickCount按下滑鼠的次數,表示此事件是否為多次按下動作序列的一部分。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

相關 API 元素

copy

事件  
事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.COPY

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當使用者針對複製作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「複製」時傳送。此事件會傳送至目前成為焦點的物件。如果目前成為焦點的物件是 TextField,此事件的預設行為指令就是將該文字欄位中目前選取的任何文字複製到剪貼簿中。

定義 copy 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblesfalse
cancelablefalse;沒有要取消的預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
target具有為 copy 事件註冊之偵聽程式的任何 InteractiveObject 實體。

注意:TextField 物件不會傳送 clearcopycutpasteselectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件,選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clearcopycutpasteselectAll 事件。不過,其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件),將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

cut

事件  
事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.CUT

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當使用者針對剪下作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「剪下」時傳送。此事件會傳送至目前成為焦點的物件。如果目前成為焦點的物件是 TextField,此事件的預設行為指令就是剪下該文字欄位中目前選取的任何文字並貼入剪貼簿。

定義 cut 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblesfalse
cancelablefalse;沒有要取消的預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
target具有為 cut 事件註冊之偵聽程式的任何 InteractiveObject 實體。

注意:TextField 物件不會傳送 clearcopycutpasteselectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件,選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clearcopycutpasteselectAll 事件。不過,其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件),將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

doubleClick

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.DOUBLE_CLICK

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

在 InteractiveObject 物件的 doubleClickEnabled 旗標設為 true 的情況下,當使用者在相同的物件上方連續兩次快速按下並放開指標裝置主要按鈕時傳送。 若要讓 doubleClick 事件發生,該事件必須緊跟著下列事件系列:mouseDown , mouseUp , click , mouseDown , mouseUp。所有這些事件都必須與 doubleClick 事件共用相同目標。 第二次的按下動作 (由第二個 mouseDownmouseUp 事件所代表),必須在 click 事件之後的某段特定時間內發生。 此段特定時間的可允許長度會依作業系統不同而改變,您也可以常常加以設定改變。 如果目標是可選取的文字欄位,則在預設的行為指令下會選取指標下的文字。 如果目標 InteractiveObject 沒有將自己的 doubleClickEnabled 旗標設為 true,就會接收兩個 click 事件。

doubleClickEnabled 屬性預設為 false

TextField 物件之按兩下按鍵的文字選取行為與 doubleClick 事件不相關。 請使用 TextField.doubleClickEnabled 來控制 TextField 選取範圍。

定義 doubleClick 事件物件的 type 屬性值。doubleClickEnabled 屬性必須為 true,才能讓物件產生 doubleClick 事件。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDowndoubleclick 事件的這個值一律為 false
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

相關 API 元素

focusIn

事件  
事件物件類型: flash.events.FocusEvent
屬性 FocusEvent.type = flash.events.FocusEvent.FOCUS_IN

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

當顯示物件取得焦點「之後」傳送。 當使用者以指向裝置或鍵盤瀏覽來反白標示物件時,就會發生這個情況。 成為此類焦點的接收端物件我們稱為此事件的目標物件,而因為此變更而失去焦點的相對應 InteractiveObject 實體我們稱為相關物件。 對相關物件的參照會儲存在接收端物件的 relatedObject 屬性中。 shiftKey 屬性未被使用。 此事件會在先前物件的 focusOut 事件傳送之前發生。

定義 focusIn 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
keyCode0;僅套用至 keyFocusChange 事件。
relatedObject受到焦點變更影響的互補 InteractiveObject 實體。
shiftKeyfalse;僅適用於 keyFocusChange 事件。
target剛成為焦點的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
direction焦點的指派來源方向。此屬性會報告舞台之 assignFocus() 方法的 direction 參數值。如果是透過其他方式變更焦點,此值將固定為 FocusDirection.NONE。僅適用於 focusIn 事件。對於其他所有焦點事件,此值將固定為 FocusDirection.NONE

focusOut

事件  
事件物件類型: flash.events.FocusEvent
屬性 FocusEvent.type = flash.events.FocusEvent.FOCUS_OUT

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

當顯示物件失去焦點「之後」傳送。 當使用者以指向裝置或鍵盤瀏覽來反白標示不同物件時,就會發生這個情況。 失去焦點的物件我們稱為此事件的目標物件,而成為焦點的相對應 InteractiveObject 實體我們稱為相關物件。 對相關物件的參照會儲存在目標物件的 relatedObject 屬性中。 shiftKey 屬性未被使用。 此事件會在相關物件傳送 focusIn 事件之前發生。

定義 focusOut 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
keyCode0;僅套用至 keyFocusChange 事件。
relatedObject受到焦點變更影響的互補 InteractiveObject 實體。
shiftKeyfalse;僅適用於 keyFocusChange 事件。
target剛失去焦點的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

gestureDirectionalTap

事件  
事件物件類型: flash.events.TransformGestureEvent
屬性 TransformGestureEvent.type = flash.events.TransformGestureEvent.GESTURE_DIRECTIONAL_TAP

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

當使用者沿著觸控面與 InteractiveObject 實體建立接觸點 (例如沿著 Apple TV 的 Siri Remote 觸控面點選),某些裝置可能也會將此接觸解譯為數個觸控事件的組合。

特別是,如果使用者用一個手指觸碰 InteractiveObject 上方,然後移開多個手指,則 InteractiveObject 實體可以傳送 touchBegin 事件和 touchEnd 事件 (在其他事件之中),以及 gestureDirectionalTap 事件,或者如果目前環境支援,則傳送全部事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 touchBegin 事件,則相同的事件處理常式會在觸控裝置上執行。不過,如果您選擇處理 gestureDirectionalTap 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於觸控事件的回應給手勢事件。但是 flash.ui.Multitouch 類別會決定觸控事件或手勢事件是否會觸發。

處理事件物件的屬性時,請注意,localXlocalY 屬性會設定成主要的接觸點 (以 Apple TV 為例,則為螢幕中央)。offsetXoffsetY 屬性會對應至手勢的方向。

注意:這個 API 僅支援單指方向點選。

定義 GESTURE_DIRECTIONAL_TAP 觸控事件物件的 type 屬性值。

傳送的 TransformGestureEvent 物件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
phase事件流程中的目前階段。 對於揮動手勢,這個值永遠都是 all,會在傳送事件後,對應至值 GesturePhase.ALL
localX相對於包含的 Sprite,事件發生的水平座標。以方向點選手勢而言,這個值為螢幕中央。
localY相對於包含的 Sprite,事件發生的垂直座標。以方向點選手勢而言,這個值為螢幕中央。
scaleX顯示物件的水平縮放。對於方向點選手勢,這個值為 1
scaleY顯示物件的垂直縮放。對於方向點選手勢,這個值為 1
rotation顯示物件沿著 Z 軸的目前旋轉角度 (以度數為單位)。對於方向點選手勢,這個值為 0
offsetX指出水平方向;1 表示右,而 -1 則表示左。
offsetY指出垂直方向:1 表示下,而 -1 表示上。
velocity表示揮動手勢的速度,以每秒像素數計算 (僅限 AIR)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

相關 API 元素

gestureLongPress

事件  
事件物件類型: flash.events.TapGestureEvent
屬性 TapGestureEvent.type = flash.events.GestureEvent.GESTURE_LONG_PRESS

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

當使用在觸控裝置上的同一個 InteractiveObject 實體上按下兩個接觸點後送出 (例如在行動電話或平板電腦觸控螢幕的顯示物件上方,以兩支手指按下後鬆開)。某些裝置可能會將這種接觸解譯為 doubleClick 事件。

特別是,如果使用者在 InteractiveObject 上方用兩根手指點一下,則 InteractiveObject 實體可以傳送 doubleClick 事件或 gestureTwoFingerTap 事件,或者如果目前環境支援,則傳送所有事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 doubleClick 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 gestureTwoFingerTap 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

相關 API 元素

gesturePan

事件  
事件物件類型: flash.events.TransformGestureEvent
屬性 TransformGestureEvent.type = flash.events.TransformGestureEvent.GESTURE_PAN

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

當使用者在觸控裝置上,將接觸點移動到 InteractiveObject 實體上方後傳送 (例如,在行動電話或平板電腦觸控螢幕的顯示物件上,由左向右移動手指)。某些裝置可能會將這種接觸解譯為 mouseOver 事件和 touchOver 事件。

特別是,如果使用者將手指移至 InteractiveObject 上方,則 InteractiveObject 實體會傳送 mouseOver 事件、 touchOver 事件或 gesturePan 事件,或者如果目前環境支援,則傳送所有事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 mouseOver 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 gesturePan 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 GESTURE_PAN 觸控事件物件的 type 屬性值。

傳送的 TransformGestureEvent 物件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
phase事件流程中的目前階段;來自 GesturePhase 類別的值。
localX相對於包含的顯示物件,事件發生的水平座標。
localY相對於包含的顯示物件,事件發生的垂直座標。
scaleX自從前次手勢事件之後顯示物件的水平縮放。對於平移手勢,這個值為 1
scaleY自從前次手勢事件之後顯示物件的垂直縮放。對於平移手勢,這個值為 1
rotation自從前次手勢事件之後,顯示物件沿著 Z 軸的目前旋轉角度 (以度數為單位)。對於平移手勢,這個值為 0
offsetX顯示物件與其前次手勢事件之原始位置的水平轉移差異。
offsetY顯示物件與其前次手勢事件之原始位置的垂直轉移差異。
velocity手勢事件的速度,以每秒像素數計算 (僅限 AIR)。對於平移手勢,這個值為 0
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

範例  ( 如何使用本範例 )

以下範例顯示 GESTURE_PAN 事件的事件處理。當使用者在觸控裝置上執行平移手勢時,myTextField 會填入目前階段。
Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onPan(evt:TransformGestureEvent):void {

    evt.target.localX++;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

相關 API 元素

gestureRotate

事件  
事件物件類型: flash.events.TransformGestureEvent
屬性 TransformGestureEvent.type = flash.events.TransformGestureEvent.GESTURE_ROTATE

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

當使用者在 InteractiveObject 實體的接觸點上做出旋轉手勢後傳送 (例如兩指觸摸行動電話或平板電腦的觸控螢幕,然後手指在顯示物件上旋轉)。兩根手指轉動是常用的旋轉手勢,不過每一個裝置和作業系統各自有表示旋轉的規定。某些裝置可能也會將這種接觸解譯成多個滑鼠事件的組合。

特別是,如果使用者將手指移至 InteractiveObject 上方,則除了 gestureRotate 事件外,InteractiveObject 實體可以傳送一個 mouseOver 事件以及一個 click 事件 (在其他事件之中),或者如果目前環境支援,則傳送全部事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 mouseOver 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 gestureRotate 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

處理事件物件的屬性時,請注意 localXlocalY 屬性會設定成主要的接觸點。offsetXoffsetY 屬性是完成旋轉手勢地點與接觸點的距離。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 GESTURE_ROTATE 觸控事件物件的 type 屬性值。

在這個事件期間,rotation 屬性會包含旋轉角度。旋轉值如下所示:

  • 0 到 180 度代表順時針方向
  • - 180 到 0 度代表逆時針方向

傳送的 TransformGestureEvent 物件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
phase事件流程中的目前階段;來自 GesturePhase 類別的值。
localX相對於包含的顯示物件,事件發生的水平座標。
localY相對於包含的顯示物件,事件發生的垂直座標。
scaleX自從前次手勢事件之後顯示物件的水平縮放。
scaleY自從前次手勢事件之後顯示物件的垂直縮放。
rotation自從前次手勢事件之後,顯示物件沿著 Z 軸的目前旋轉角度 (以度數為單位)。
offsetX顯示物件與其前次手勢事件之原始位置的水平轉移差異。
offsetY顯示物件與其前次手勢事件之原始位置的垂直轉移差異。
velocity手勢事件的速度,以每秒像素數計算 (僅限 AIR)。對於旋轉手勢,這個值為 0
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

範例  ( 如何使用本範例 )

以下範例顯示 GESTURE_ROTATE 事件的事件處理。當使用者在觸控裝置上執行旋轉手勢時,mySprite 會旋轉而 myTextField 會填入目前階段。
Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onRotate(evt:TransformGestureEvent):void {

    evt.target.rotation -= 45;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

相關 API 元素

gestureSwipe

事件  
事件物件類型: flash.events.TransformGestureEvent
屬性 TransformGestureEvent.type = flash.events.TransformGestureEvent.GESTURE_SWIPE

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

當使用者在與 InteractiveObject 實體的某個接觸點上做出揮動手勢後傳送 (例如,三指併在一起觸碰行動電話或平板電腦的觸控螢幕,然後在顯示物件上快速平行移動手指)。平行移動多個手指是常見的揮動手勢,不過每一個裝置和作業系統對於揮動這個動作有自己的規定。某些裝置可能也會將這種接觸解譯成多個滑鼠事件的組合。

特別是,如果使用者將一個手指移至 InteractiveObject 上方,然後同時移動多個手指,則除了 gestureSwipe 事件外,InteractiveObject 實體可以傳送一個 rollOver 事件以及一個 rollOut 事件 (在其他事件之中),或者如果目前環境支援,則傳送全部事件。選擇想要使用的使用者互動處理方式。如果您選擇處理 rollOver 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 gestureSwipe 事件,就可以設計自己的事件處理常式,藉此回應觸控環境的特殊需求,並提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

處理事件物件的屬性時,請注意 localXlocalY 屬性會設定成主要的接觸點。offsetXoffsetY 屬性是完成揮動手勢之地點與接觸點之間的距離。

注意:雖然部分使用 Mac OS 作業系統的裝置可以解譯四指揮動,但這個 API 只支援三指揮動。

定義 GESTURE_SWIPE 觸控事件物件的 type 屬性值。

傳送的 TransformGestureEvent 物件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
phase事件流程中的目前階段。 對於揮動手勢,這個值永遠都是 all,會在傳送事件後,對應至值 GesturePhase.ALL
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
scaleX顯示物件的水平縮放。對於揮動手勢,這個值為 1
scaleY顯示物件的垂直縮放。對於揮動手勢,這個值為 1
rotation顯示物件沿著 Z 軸的目前旋轉角度 (以度數為單位)。對於揮動手勢,這個值為 0
offsetX指出水平方向;1 表示右,而 -1 則表示左。
offsetY指出垂直方向:1 表示下,而 -1 表示上。
velocity表示揮動手勢的速度,以每秒像素數計算 (僅限 AIR)。對於靜止,這個值為 0
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

範例  ( 如何使用本範例 )

以下範例顯示 GESTURE_SWIPE 事件的事件處理。當使用者在觸控裝置上執行揮動手勢時,myTextField 會填入階段 all,這是揮動事件唯一的階段。
Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onSwipe(evt:TransformGestureEvent):void {

    if (evt.offsetX == 1 ) {
    myTextField.text = "right";
    }
    if (evt.offsetY == -1) {
    myTextField.text = "up";
    }
    myTextField.text = evt.phase;

}

相關 API 元素

gestureTap

事件  
事件物件類型: flash.events.TapGestureEvent
屬性 TapGestureEvent.type = flash.events.PressAndTapGestureEvent.GESTURE_TAP

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

當使用者與 InteractiveObject 實體建立接觸點,然後在觸控裝置上點一下後送出 (例如,將多根手指放到行動電話或平板電腦觸控螢幕的顯示物件上以開啟選單,然後其中一根手點一下,選取選單項目)。某些裝置可能也會將這種接觸解譯成多個滑鼠事件的組合。

特別是,如果使用者將手指移至 InteractiveObject 上方,然後再點一下,則除了 gesturePressAndTap 事件外,InteractiveObject 實體可以傳送一個 mouseOver 事件以及一個 click 事件 (在其他事件之中),或者如果目前環境支援,則傳送全部事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 mouseOver 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 gesturePressAndTap 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

處理事件物件的屬性時,請注意,localXlocalY 屬性會設定成主要的接觸點 (「推」的動作)。offsetXoffsetY 屬性是與第二個接觸點 (「點一下」) 的距離。

相關 API 元素

gestureZoom

事件  
事件物件類型: flash.events.TransformGestureEvent
屬性 TransformGestureEvent.type = flash.events.TransformGestureEvent.GESTURE_ZOOM

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

當使用者在 InteractiveObject 實體的某個接觸點上做出放大縮小手勢後傳送 (例如兩指併在一起觸摸行動電話或平板電腦的觸控螢幕,然後手指在顯示物件上快速張開)。手指分開是常用的縮放手勢,不過每一個裝置和作業系統各有自己表示縮放的規定。某些裝置可能也會將這種接觸解譯成多個滑鼠事件的組合。

特別是,如果使用者將手指移至 InteractiveObject 上方,然後分開手指,則除了 gestureZoom 事件外,InteractiveObject 實體可以傳送一個 mouseOver 事件以及一個 click 事件 (在其他事件之中),或者如果目前環境支援,則傳送全部事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 mouseOver 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 gestureZoom 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

處理事件物件的屬性時,請注意 localXlocalY 屬性會設定成主要的接觸點。offsetXoffsetY 屬性是完成縮放手勢地點與接觸點的距離。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 GESTURE_ZOOM 觸控事件物件的 type 屬性值。

傳送的 TransformGestureEvent 物件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
phase事件流程中的目前階段;來自 GesturePhase 類別的值。
localX相對於包含的顯示物件,事件發生的水平座標。
localY相對於包含的顯示物件,事件發生的垂直座標。
scaleX自從前次手勢事件之後顯示物件的水平縮放。
scaleY自從前次手勢事件之後顯示物件的垂直縮放。
rotation自從前次手勢事件之後,顯示物件沿著 Z 軸的目前旋轉角度 (以度數為單位)。
offsetX顯示物件與其前次手勢事件之原始位置的水平轉移差異。
offsetY顯示物件與其前次手勢事件之原始位置的垂直轉移差異。
velocity手勢事件的速度,以每秒像素數計算 (僅限 AIR)。對於縮放手勢,這個值為 0
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

範例  ( 如何使用本範例 )

以下範例顯示 GESTURE_ZOOM 事件的事件處理。當使用者在觸控裝置上執行縮放手勢時,myTextField 會填入目前階段。
Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onZoom(evt:TransformGestureEvent):void {

    evt.target.scaleX++;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

相關 API 元素

imeStartComposition

事件  
事件物件類型: flash.events.IMEEvent

執行階段版本: Flash Lite 4

這個事件會送出至任何支援 IME 內嵌輸入的用戶端應用程式。

keyDown

事件  
事件物件類型: flash.events.KeyboardEvent
屬性 KeyboardEvent.type = flash.events.KeyboardEvent.KEY_DOWN

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

會當使用者按下按鍵時傳送。 按鍵與特殊字元之間的對應會依裝置與作業系統的不同而改變。 此事件類型會在發生此類對應後,但在輸入法編輯器 (IME) 處理階段前產生。 由於標準的 QWERTY 鍵盤在按鍵配置上不利於類似中文表意文字的輸入,人們便使用 IME 來克服這項限制。 此事件會在 keyUp 事件之前發生。

在 AIR 中,取消此事件會禁止在文字欄位中輸入字元。

KeyboardEvent.KEY_DOWN 常數會定義 keyDown 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblestrue
cancelable在 AIR 中為 true,在 Flash Player 中為 false;在 AIR 中,取消這個事件可以阻止字元被輸入到文字欄位。
charCode按下或放開之按鍵的字元碼值。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;否則為 false
controlKey在 Windows 和 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Control 鍵為作用中,則為 true;否則為 false
ctrlKey在 Windows 和 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
keyCode按下或放開之按鍵的按鍵碼值。
keyLocation鍵盤上的按鍵位置。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
target成為焦點的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

keyFocusChange

事件  
事件物件類型: flash.events.FocusEvent
屬性 FocusEvent.type = flash.events.FocusEvent.KEY_FOCUS_CHANGE

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

當使用者嘗試使用鍵盤瀏覽變更焦點時傳送。 此事件的預設行為指令就是變更焦點並傳送相對應的 focusInfocusOut 事件。

此事件會傳送至目前成為焦點的物件。此事件的相關物件就是接收焦點的 InteractiveObject 實體 (如果您沒有改變預設行為指令的話)。 您可以呼叫已經正確註冊為目標物件之事件偵聽程式的 preventDefault() 方法來預防此項變更。 根據預設,焦點會變更,而且會傳送 focusInfocusOut 事件。

定義 keyFocusChange 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblestrue
cancelabletrue;呼叫 preventDefault() 方法來取消預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
keyCode按下按鍵即會觸發 keyFocusChange 事件的按鍵碼值。
relatedObject受到焦點變更影響的互補 InteractiveObject 實體。
shiftKeytrue,如果啟動了 Shift 輔助按鍵;否則為 false
target目前成為焦點的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

keyUp

事件  
事件物件類型: flash.events.KeyboardEvent
屬性 KeyboardEvent.type = flash.events.KeyboardEvent.KEY_UP

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

會當使用者放開按鍵時傳送。 按鍵與特殊字元之間的對應會依裝置與作業系統的不同而改變。 此事件類型會在發生此類對應後,但在輸入法編輯器 (IME) 處理階段前產生。 由於標準的 QWERTY 鍵盤在按鍵配置上不利於類似中文表意文字的輸入,人們便使用 IME 來克服這項限制。 此事件會在 keyDown 事件後發生,並且具有下列特徵:

KeyboardEvent.KEY_UP 常數會定義 keyUp 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
charCode包含按下或放開之按鍵的字元碼值。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;否則為 false
controlKey在 Windows 和 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Control 鍵為作用中,則為 true;否則為 false
ctrlKey在 Windows 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
keyCode按下或放開之按鍵的按鍵碼值。
keyLocation鍵盤上的按鍵位置。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
target成為焦點的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

middleClick

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.MIDDLE_CLICK

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

當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置中間按鈕時傳送。若要讓 middleClick 事件發生,該事件必須永遠按照此事件系列的發生順序:middleMouseDown 事件,然後才是 middleMouseUp。這兩個事件的目標物件必須完全相同,否則就不會發生 middleClick 事件。不管何時,任何數量的其它滑鼠事件都可以在 middleMouseDownmiddleMouseUp 事件之間發生;而 middleClick 事件則是不管何時都會發生。

定義 middleClick 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDownmiddleClick 事件的這個值一律為 false
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

middleMouseDown

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.MIDDLE_MOUSE_DOWN

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

當使用者將指向裝置的中間按鈕移至 InteractiveObject 實體上方按下時傳送。

定義 middleMouseDown 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDown如果按下滑鼠中間按鍵,則為 true;否則為 false
cancelablefalse;無法取消預設的行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
clickCount按下滑鼠的次數,表示此事件是否為多次按下動作序列的一部分。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

middleMouseUp

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.MIDDLE_MOUSE_UP

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

當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。

定義 middleMouseUp 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDown如果按下滑鼠中間按鍵,則為 true;否則為 false
cancelablefalse;無法取消預設的行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
clickCount按下滑鼠的次數,表示此事件是否為多次按下動作序列的一部分。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

mouseDown

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.MOUSE_DOWN

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

當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。如果目標是 SimpleButton 實體,則 SimpleButton 實體會在預設的行為指令下顯示 downState 顯示物件。 如果目標是可選取的文字欄位,則文字欄位會在預設的行為指令下開始選取範圍。

定義 mouseDown 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDown如果按下主要滑鼠按鍵,則為 true;否則為 false
cancelablefalse;無法取消預設的行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 和 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
clickCount按下滑鼠的次數,表示此事件是否為多次按下動作序列的一部分。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

mouseFocusChange

事件  
事件物件類型: flash.events.FocusEvent
屬性 FocusEvent.type = flash.events.FocusEvent.MOUSE_FOCUS_CHANGE

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

會當使用者嘗試使用指向裝置變更焦點時傳送。 此事件的預設行為指令就是變更焦點並傳送相對應的 focusInfocusOut 事件。

此事件會傳送至目前成為焦點的物件。此事件的相關物件就是接收焦點的 InteractiveObject 實體 (如果您沒有改變預設行為指令的話)。 您可以呼叫已經正確註冊為目標物件之事件偵聽程式的 preventDefault() 來預防此項變更。 shiftKey 屬性未被使用。 根據預設,焦點會變更,而且會傳送 focusInfocusOut 事件。

定義 mouseFocusChange 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblestrue
cancelabletrue;呼叫 preventDefault() 方法來取消預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
keyCode0;僅套用至 keyFocusChange 事件。
relatedObject受到焦點變更影響的互補 InteractiveObject 實體。
shiftKeyfalse;僅適用於 keyFocusChange 事件。
target目前成為焦點的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

mouseMove

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.MOUSE_MOVE

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

會當指向裝置停在 InteractiveObject 上方的情況下使用者將其移動時傳送。 如果目標是使用者正在選取的文字欄位,在預設的行為指令下會更新選取範圍。

定義 mouseMove 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDown如果按下主要滑鼠按鍵,則為 true;否則為 false
cancelablefalse;無法取消預設的行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

mouseOut

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.MOUSE_OUT

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

會當使用者將指向裝置移開 InteractiveObject 實體時傳送。 事件目標指的是先前位於指向裝置下方的物件。 relatedObject 指的是指標裝置的移動目標物件。 如果目標是 SimpleButton 實體,則按鈕會在預設的行為指令下顯示 upState 顯示物件。

每當滑鼠離開顯示物件容器的任何子物件區域時,都會傳送 mouseOut 事件,即使滑鼠仍然位於顯示物件容器的另一個子物件上方。 這樣的行為與 rollOut 事件的用途不同,後者是要為有子系的顯示物件容器簡化滑入行為的程式碼編寫工作。 當滑鼠離開顯示物件的區域或任何子系的區域,以移到其非子系物件時,顯示物件會傳送 rollOut 事件。rollOut 事件會沿著物件的上層鏈連續往上傳送,以物件為開頭,並以既不是 relatedObject 的根,也不是其祖系的最上層為結尾。

定義 type 屬性值 (mouseOut 事件物件)。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDown如果按下主要滑鼠按鍵,則為 true;否則為 false
cancelablefalse;無法取消預設的行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
relatedObject指標裝置正指向的顯示清單物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

mouseOver

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.MOUSE_OVER

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

會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。 relatedObject 是先前位於指標裝置下方的物件。 如果目標是 SimpleButton 實體,則物件會依據滑鼠按鈕是否按下來決定要顯示 overStateupState 顯示物件 (預設的行為指令)。

每當滑鼠進入顯示物件容器的任何子物件區域時,都會傳送 mouseOver 事件,即使滑鼠已經移到顯示物件容器的另一個子物件上方。 這樣的行為與 rollOver 事件的用途不同,後者是要為有子系的顯示物件容器簡化滑開行為的程式碼編寫工作。 當滑鼠進入顯示物件的區域,或從其非子系物件進入其任何子系區域時,顯示物件會傳送 rollOver 事件。 rollOver 事件會連續傳送至物件之上層鏈下方,以不屬於 relatedObject 的根或祖系的最上層為開頭,並以物件做為結尾。

定義 type 屬性值 (mouseOver 事件物件)。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDown如果按下主要滑鼠按鍵,則為 true;否則為 false
cancelablefalse;無法取消預設的行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
relatedObject指標裝置指向的顯示清單物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

mouseUp

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.MOUSE_UP

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

當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。如果目標是 SimpleButton 實體,則物件會顯示 upState 顯示物件。 如果目標是可選取的文字欄位,則文字欄位會在預設的行為指令下結束選取範圍。

定義 type 屬性值 (mouseUp 事件物件)。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDown如果按下主要滑鼠按鍵,則為 true;否則為 false
cancelablefalse;無法取消預設的行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
clickCount按下滑鼠的次數,表示此事件是否為多次按下動作序列的一部分。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

mouseWheel

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.MOUSE_WHEEL

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

當滑鼠滾輪在 InteractiveObject 實體上方轉動時傳送。如果目標是文字欄位,則文字會在預設的行為指令下捲動。只有 Microsoft Windows 作業系統才可使用。

定義 type 屬性值 (mouseWheel 事件物件)。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDown如果按下主要滑鼠按鍵,則為 true;否則為 false
cancelablefalse;無法取消預設的行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
delta每次轉動滑鼠滾輪一格時所代表行數。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

nativeDragComplete

事件  
事件物件類型: flash.events.NativeDragEvent
屬性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_COMPLETE

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

當使用者釋放手勢時,由拖曳初始程式 InteractiveObject 傳送。

此事件的 dropAction 屬性表示拖曳目標物件所設定的動作。值為「無」(DragActions.NONE) 表示已取消或不使用放下動作。

例如,若要透過從清單中移除項目 (在「移動」拖曳動作上) 或變更視覺屬性的方式,更新初始顯示物件的狀態,使用 nativeDragComplete 事件處理常式是非常便利的方式。

NativeDragEvent.NATIVE_DRAG_COMPLETE 會定義 nativeDragComplete 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
allowedActionsNativeDragOptions 物件,指定與此拖曳作業相關的動作。
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
clipboardClipboard 物件,包含拖曳的資料。
dropAction放下目標所選擇的動作 (如果沒有設定任何動作,則為 none)。

nativeDragDrop

事件  
事件物件類型: flash.events.NativeDragEvent
屬性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_DROP

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

已在目標 InteractiveObject 上放下拖曳的物件,而且已呼叫 DragManager.acceptDragDrop() 接受該放開的資料時,由此目標 InteractiveObject 傳送。

您可以使用事件物件的 clipboard 屬性存取已放下的資料。

此事件的處理常式應該設定 DragManager.dropAction 屬性以提供回應給初始程式物件,告知要採取哪種拖曳動作。如果沒有設定任何值,DragManager 將會從允許的動作清單中選取預設值。

NativeDragEvent.NATIVE_DRAG_DROP 會定義 nativeDragDrop 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
allowedActionsNativeDragOptions 物件,指定與此拖曳作業相關的動作。
bubblestrue
cancelabletrue;取消此事件將取消拖曳作業。
clipboardClipboard 物件,包含拖曳的資料。即使傳送此事件之物件所在的安全性網域與初始程式不同,也能讀取此 clipboard。
dropAction放下目標所選擇的動作 (如果沒有設定任何動作,則為 none)。

nativeDragEnter

事件  
事件物件類型: flash.events.NativeDragEvent
屬性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_ENTER

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

當手勢進入 InteractiveObject 的邊界時,由此 InteractiveObject 傳送。

您可以處理 nativeDragEnternativeDragOver 事件,允許顯示物件成為放下時的目標。

若要判斷所傳送的顯示物件是否能接受該放下的資料,請檢查此事件物件之 clipboard 屬性中資料是否適當,以及 allowedActions 屬性中所允許的拖曳動作。

NativeDragEvent.NATIVE_DRAG_ENTER 會定義 nativeDragEnter 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
allowedActionsNativeDragOptions 物件,指定與此拖曳作業相關的動作。
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
clipboardClipboard 物件,包含拖曳的資料。只有在傳送此事件的物件與初始程式位於相同的安全性網域中,才能讀取此剪貼簿。
dropAction放下目標所選擇的動作 (如果沒有設定任何動作,則為 none)。

nativeDragExit

事件  
事件物件類型: flash.events.NativeDragEvent
屬性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_EXIT

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

當手勢離開 InteractiveObject 的邊界時,由此 InteractiveObject 傳送。

NativeDragEvent.NATIVE_DRAG_EXIT 會定義 nativeDragExit 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
allowedActionsNativeDragOptions 物件,指定與此拖曳作業相關的動作。
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
clipboardClipboard 物件,包含拖曳的資料。只有在傳送此事件的物件與初始程式位於相同的安全性網域中,才能讀取此剪貼簿。
dropAction放下目標所選擇的動作 (如果沒有設定任何動作,則為 none)。

nativeDragOver

事件  
事件物件類型: flash.events.NativeDragEvent
屬性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_OVER

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

當拖曳手勢還留在 InteractiveObject 的邊界內,由此 InteractiveObject 持續傳送。

只要移動滑鼠就會傳送 nativeDragOver 事件。在 Windows 和 Mac 上即使沒有移動滑鼠,若計時器間隔較短還是會傳送這些事件。

您可以處理 nativeDragOvernativeDragEnter 事件,允許顯示物件成為放下時的目標。

若要判斷所傳送的顯示物件是否能接受該放下的資料,請檢查此事件物件之 clipboard 屬性中資料是否適當,以及 allowedActions 屬性中所允許的拖曳動作。

NativeDragEvent.NATIVE_DRAG_OVER 會定義 nativeDragOver 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
allowedActionsNativeDragOptions 物件,指定與此拖曳作業相關的動作。
bubblestrue
cancelabletrue;取消此事件將取消拖曳作業。
clipboardClipboard 物件,包含拖曳的資料。只有在傳送此事件的物件與初始程式位於相同的安全性網域中,才能讀取此剪貼簿。
dropAction放下目標所選擇的動作 (如果沒有設定任何動作,則為 none)。

nativeDragStart

事件  
事件物件類型: flash.events.NativeDragEvent
屬性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_START

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

在呼叫 DragManager.doDrag() 進行拖曳作業初期,由指定做為拖曳初始程式的 InteractiveObject 傳送。

NativeDragEvent.NATIVE_DRAG_START 會定義 nativeDragStart 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
allowedActionsNativeDragOptions 物件,指定與此拖曳作業相關的動作。
bubblestrue
cancelabletrue;取消此事件將取消拖曳作業。
clipboardClipboard 物件,包含拖曳的資料。
dropAction放下目標所選擇的動作 (如果沒有設定任何動作,則為 none)。

nativeDragUpdate

事件  
事件物件類型: flash.events.NativeDragEvent
屬性 NativeDragEvent.type = flash.events.NativeDragEvent.NATIVE_DRAG_UPDATE

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

在呼叫 DragManager.doDrag() 進行拖曳作業期間,由指定做為拖曳初始程式的 InteractiveObject 傳送。

在 Linux 上不會傳送 nativeDragUpdate 事件。

NativeDragEvent.NATIVE_DRAG_UPDATE 會定義 nativeDragUpdate 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
allowedActionsNativeDragOptions 物件,指定與此拖曳作業相關的動作。
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
clipboardClipboard 物件,包含拖曳的資料。
dropAction放下目標所選擇的動作 (如果沒有設定任何動作,則為 none)。

paste

事件  
事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.PASTE

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當使用者針對貼上作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「貼上」時傳送。此事件會傳送至目前成為焦點的物件。如果目前成為焦點的物件是 TextField,此事件的預設行為指令就是將剪貼簿的內容貼入該文字欄位的目前插入點,並取代該文字欄位中目前選取的任何文字。

Event.PASTE 常數會定義 paste 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblestrue (AIR 執行階段則為 false)。
cancelablefalse;沒有要取消的預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
target具有為 paste 事件註冊之偵聽程式的任何 InteractiveObject 實體。

注意:TextField 物件不會傳送 clearcopycutpasteselectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件,選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clearcopycutpasteselectAll 事件。不過,其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件),將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

    

proximityBegin

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.PROXIMITY_BEGIN

語言版本: ActionScript 3.0
執行階段版本: AIR 3

在使用者將作用中觸控筆往下移至超過螢幕鄰近偵測邊框時傳送。

在使用者將觸控筆往下移至螢幕,在螢幕上到處移動,接著移開觸控筆時發生的一般事件序列為:

  • proximityBegin
  • proximityMove
  • touchBegin
  • touchMove
  • touchEnd
  • proximityMove
  • proximityEnd

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 PROXIMITY_BEGIN 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。
timestamp(僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。
touchIntent(僅限 AIR) TouchEventIntent 類別的值。
isTouchPointCanceled(僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true

相關 API 元素

    

proximityEnd

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.PROXIMITY_END

語言版本: ActionScript 3.0
執行階段版本: AIR 3

在使用者將作用中觸控筆提到螢幕鄰近偵測邊框時傳送。

當觸控筆觸碰螢幕時,不會傳送 proximityEnd 事件。

在使用者將觸控筆往下移至螢幕,在螢幕上到處移動,接著移開觸控筆時發生的一般事件序列為:

  • proximityBegin
  • proximityMove
  • touchBegin
  • touchMove
  • touchEnd
  • proximityMove
  • proximityEnd

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 PROXIMITY_END 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。
timestamp(僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。
touchIntent(僅限 AIR) TouchEventIntent 類別的值。
isTouchPointCanceled(僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true

相關 API 元素

    

proximityMove

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.PROXIMITY_MOVE

語言版本: ActionScript 3.0
執行階段版本: AIR 3

在使用者將作用中觸控筆移到螢幕上方,而其餘仍在鄰近偵測邊框內時傳送。

在使用者將觸控筆往下移至螢幕,在螢幕上到處移動,接著移開觸控筆時發生的一般事件序列為:

  • proximityBegin
  • proximityMove
  • touchBegin
  • touchMove
  • touchEnd
  • proximityMove
  • proximityEnd

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 PROXIMITY_MOVE 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。
timestamp(僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。
touchIntent(僅限 AIR) TouchEventIntent 類別的值。
isTouchPointCanceled(僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true

相關 API 元素

    

proximityOut

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.PROXIMITY_OUT

語言版本: ActionScript 3.0
執行階段版本: AIR 3

在使用者將作用中觸控筆移出這個 InteractiveObject 之外,而其餘仍在螢幕的鄰近偵測邊框內時傳送。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 PROXIMITY_OUT 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。
timestamp(僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。
touchIntent(僅限 AIR) TouchEventIntent 類別的值。
isTouchPointCanceled(僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true

相關 API 元素

    

proximityOver

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.PROXIMITY_OVER

語言版本: ActionScript 3.0
執行階段版本: AIR 3

在使用者直接將作用中觸控筆移到這個 InteractiveObject 上方,而其餘仍在螢幕的鄰近偵測邊框內時傳送。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 PROXIMITY_OVER 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。
timestamp(僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。
touchIntent(僅限 AIR) TouchEventIntent 類別的值。
isTouchPointCanceled(僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true

相關 API 元素

    

proximityRollOut

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.PROXIMITY_ROLL_OUT

語言版本: ActionScript 3.0
執行階段版本: AIR 3

在使用者將作用中觸控筆移出這個 InteractiveObject 及其任一子系之外,而其餘仍在螢幕的鄰近偵測邊框內時傳送。

事件目標指的是先前位於觸控筆下方的物件,或是該物件的父輩。relatedObject 指的是由觸控筆移動上方的目標物件。proximityRollOut 事件會連續傳送至物件之上層鏈上方,以物件為開頭,並以不屬於 relatedObject 的根或祖系的最上層為結尾。

proximityRollOut 事件的目的是要針對具有子系之顯示物件容器的滑入行為,簡化其編碼程序。當觸控筆離開顯示物件區域,包括其任何子系區域,並進入非屬其任一子系的物件時,顯示物件就會傳送 proximityRollOut 事件。此種行為與 proximityOut 事件的行為表現不同,後者會在每次滑鼠離開顯示物件容器之任一子物件區域時傳送,就算滑鼠仍舊停留在顯示物件容器之另一個子物件上方亦然。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 PROXIMITY_ROLL_OUT 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。
timestamp(僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。
touchIntent(僅限 AIR) TouchEventIntent 類別的值。
isTouchPointCanceled(僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true

相關 API 元素

    

proximityRollOver

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.PROXIMITY_ROLL_OVER

語言版本: ActionScript 3.0
執行階段版本: AIR 3

在使用者透過這個 InteractiveObject,從顯示清單中後代的物件樹狀結構之外移動作用中觸控筆時傳送 (而其餘仍在螢幕的鄰近偵測邊框內)。

事件目標指的是觸控筆下方的物件,或是該物件的父輩。relatedObject 是先前位於觸控筆下方的物件。proximityRollOver 事件會連續傳送至物件之上層鏈下方,以不屬於 relatedObject 的根或祖系的最上層為開頭,並以物件做為結尾。

proximityRollOver 事件的目的是要針對具有子系之顯示物件容器的滑出行為,簡化其編碼程序。當觸控筆進入顯示物件上方的區域,或從其非子系物件進入其任何子系上方的區域時,顯示物件會傳送 proximityRollOver 事件。此種行為與 proximityOver 事件的行為表現不同,後者會在每次滑鼠進入顯示物件容器之任一子物件區域時傳送,就算滑鼠已經移動至顯示物件容器之另一個子物件上方亦然。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 PROXIMITY_ROLL_OVER 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。
timestamp(僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。
touchIntent(僅限 AIR) TouchEventIntent 類別的值。
isTouchPointCanceled(僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true

相關 API 元素

releaseOutside

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.RELEASE_OUTSIDE

語言版本: ActionScript 3.0
執行階段版本: AIR 3.3, Flash Player 11.3

當使用者第一次按下 InteractiveObject 實體上方的按鈕,然後將指向裝置滑出 InteractiveObject 實體之後即放開指向裝置上的按鈕時傳送。如果目標是 SimpleButton 實體,則物件會顯示 upState 顯示物件。 如果目標是可選取的文字欄位,則文字欄位會在預設的行為指令下結束選取範圍。

定義 releaseOutside 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDownfalse
cancelablefalse;無法取消預設的行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
clickCount按下滑鼠的次數,表示此事件是否為多次按下動作序列的一部分。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
targetInteractiveObject,表示指向裝置按鈕先前已按下並在滑出實體後放開。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

rightClick

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.RIGHT_CLICK

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

當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置右邊按鈕時傳送。若要讓 rightClick 事件發生,該事件必須永遠按照此事件系列的發生順序:rightMouseDown 事件,然後才是 rightMouseUp。這兩個事件的目標物件必須完全相同,否則就不會發生 rightClick 事件。不管何時,任何數量的其它滑鼠事件都可以在 rightMouseDownrightMouseUp 事件之間發生;而 rightClick 事件則是不管何時都會發生。

定義 rightClick 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDownrightclick 事件的這個值一律為 false
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

rightMouseDown

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.RIGHT_MOUSE_DOWN

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

當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。

定義 rightMouseDown 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDownrightclick 事件的這個值一律為 true
cancelablefalse;無法取消預設的行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
clickCount按下滑鼠的次數,表示此事件是否為多次按下動作序列的一部分。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

rightMouseUp

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.RIGHT_MOUSE_UP

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

當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。

定義 rightMouseUp 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblestrue
buttonDown如果按下滑鼠右鍵,則為 true;否則為 false
cancelablefalse;無法取消預設的行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
clickCount按下滑鼠的次數,表示此事件是否為多次按下動作序列的一部分。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

rollOut

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.ROLL_OUT

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

會當使用者將指向裝置移開 InteractiveObject 實體時傳送。 事件目標指的是先前位於指向裝置下方的物件,或是該物件的父輩。 relatedObject 指的是指標裝置的移動目標物件。 rollOut 事件會連續傳送至物件之上層鏈上方,以物件為開頭,並以不屬於 relatedObject 的根或祖系的最上層為結尾。

rollOut 事件的目的是要針對具有子系之顯示物件容器的滑入行為,簡化其編碼程序。 當滑鼠離開顯示物件區域,或其任何子系區域,並進入非屬其任一子系的物件時,顯示物件就會傳送 rollOut 事件。 此種行為與 mouseOut 事件的行為表現不同,後者會在每次滑鼠離開顯示物件容器之任一子物件區域時傳送,就算滑鼠仍舊停留在顯示物件容器之另一個子物件上方亦然。

定義 type 屬性值 (rollOut 事件物件)。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblesfalse
buttonDown如果按下主要滑鼠按鍵,則為 true;否則為 false
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
relatedObject指標裝置正指向的顯示清單物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

rollOver

事件  
事件物件類型: flash.events.MouseEvent
屬性 MouseEvent.type = flash.events.MouseEvent.ROLL_OVER

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

會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。 事件目標指的是指向裝置下方的物件,或是該物件的父輩。 relatedObject 是先前位於指標裝置下方的物件。 rollOver 事件會連續傳送至物件之上層鏈下方,以不屬於 relatedObject 的根或祖系的最上層為開頭,並以物件做為結尾。

rollOver 事件的目的是要針對具有子系之顯示物件容器的滑出行為,簡化其編碼程序。 當滑鼠進入顯示物件的區域,或從其非子系物件進入其任何子系區域時,顯示物件會傳送 rollOver 事件。 此種行為與 mouseOver 事件的行為表現不同,後者會在每次滑鼠進入顯示物件容器之任一子物件區域時傳送,就算滑鼠已經移動至顯示物件容器之另一個子物件上方亦然。

定義 type 屬性值 (rollOver 事件物件)。

這個事件具有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows),則為 true
bubblesfalse
buttonDown如果按下主要滑鼠按鍵,則為 true;否則為 false
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
relatedObject指標裝置指向的顯示清單物件。
localX相對於包含的 Sprite,事件發生的水平座標 (如果停用滑鼠鎖定)。
localY相對於包含的 Sprite,事件發生的垂直座標 (如果停用滑鼠鎖定)。
movementX自上次滑鼠事件以來滑鼠位置的水平座標變更 (如果啟用滑鼠鎖定)。
movementY自上次滑鼠事件以來滑鼠位置的垂直座標變更 (如果啟用滑鼠鎖定)。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於指標裝置下方的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

selectAll

事件  
事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.SELECT_ALL

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當使用者針對全選作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「全選」時傳送。此事件會傳送至目前成為焦點的物件。如果目前成為焦點的物件是 TextField,此事件的預設行為指令就是選取該文字欄位的所有內容。

Event.SELECT_ALL 常數會定義 selectAll 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblesfalse
cancelablefalse;沒有要取消的預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
target具有為 selectAll 事件註冊之偵聽程式的任何 InteractiveObject 實體。

注意:TextField 物件不會傳送 clearcopycutpasteselectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件,選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clearcopycutpasteselectAll 事件。不過,其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件),將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

softKeyboardActivate

事件  
事件物件類型: flash.events.SoftKeyboardEvent
屬性 SoftKeyboardEvent.type = flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10.2, AIR 2.6

升起顯示軟體鍵盤之後立即傳送。

SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE 常數會在顯示軟體鍵盤時,定義 type 屬性 SoftKeyboardEvent 物件的值。在此事件中,cancellable = false

這個事件具有下列屬性:

屬性
typeSOFT_KEYBOARD_ACTIVATE
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
relatedObjectVal與事件相關的顯示清單物件的參照。
triggerTypeVal指出 keyboard 事件由應用程式或使用者觸發。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。

相關 API 元素

softKeyboardActivating

事件  
事件物件類型: flash.events.SoftKeyboardEvent
屬性 SoftKeyboardEvent.type = flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10.2, AIR 2.6

升起顯示軟體鍵盤前立即傳送。

SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING 常數會在顯示軟體鍵盤之前,定義 type 屬性 SoftKeyboardEvent 物件的值。在此事件中,cancellable = true

這個事件具有下列屬性:

屬性
typeSOFT_KEYBOARD_ACTIVATING
bubblestrue
cancelabletrue,除非事件是由 StageText 物件所傳送。若是 StageText 物件,則事件是不可以取消的。
relatedObjectVal與事件相關的顯示清單物件的參照。
triggerTypeVal指出 keyboard 事件由應用程式或使用者觸發。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。

相關 API 元素

softKeyboardDeactivate

事件  
事件物件類型: flash.events.SoftKeyboardEvent
屬性 SoftKeyboardEvent.type = flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10.2, AIR 2.6

降下隱藏軟體鍵盤之後立即傳送。

SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE 常數會在降下隱藏或隱藏軟體鍵盤時,定義 type 屬性 SoftKeyboardEvent 物件的值。在此事件中,cancellable = false

這個事件具有下列屬性:

屬性
typeSOFT_KEYBOARD_DEACTIVATE
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
relatedObjectVal與事件相關的顯示清單物件的參照。
triggerTypeVal指出 keyboard 事件由應用程式或使用者觸發。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。

相關 API 元素

tabChildrenChange

事件  
事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.TAB_CHILDREN_CHANGE

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

當物件的 tabChildren 旗標值變更時傳送。

Event.TAB_CHILDREN_CHANGE 常數會定義 tabChildrenChange 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
target已變更 tabChildren 旗標的物件。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

tabEnabledChange

事件  
事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.TAB_ENABLED_CHANGE

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

當物件的 tabEnabled 旗標變更時傳送。

Event.TAB_ENABLED_CHANGE 常數會定義 tabEnabledChange 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
target已變更 tabEnabled 旗標的 InteractiveObject。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

tabIndexChange

事件  
事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.TAB_INDEX_CHANGE

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

當物件的 tabIndex 屬性值變更時傳送。

Event.TAB_INDEX_CHANGE 常數會定義 tabIndexChange 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
target已變更 tabIndex 的物件。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。

textInput

事件  
事件物件類型: flash.events.TextEvent
屬性 TextEvent.type = flash.events.TextEvent.TEXT_INPUT

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

當使用者輸入一或多文字的字元時送出。各種不同的文字輸入方法都會產生這個事件,其中包括標準鍵盤、輸入法編輯器 (IME)、語音辨識系統,甚至是貼上純文字 (不含格式或樣式資訊) 的動作。

定義 textInput 事件物件的 type 屬性值。

注意:Delete 或 Backspace 鍵不會傳送這個事件。

這個事件具有下列屬性:

屬性
bubblestrue
cancelabletrue;呼叫 preventDefault() 方法來取消預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
target正在其中輸入字元的文字欄位。 這個 target 並非永遠都是註冊事件偵聽程式之顯示清單中的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
text由使用者所輸入的字元或字元序列。

touchBegin

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.TOUCH_BEGIN

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

當使用者在第一次接觸觸控裝置後傳送 (例如手指觸摸行動電話或平板電腦的觸控螢幕)。某些裝置可能會將這種接觸解譯為 mouseDown 事件。

特別是,如果使用者將手指點一下觸控螢幕,則 InteractiveObject 實體可以傳送 mouseDown 事件或 touchBegin 事件,或者如果目前環境支援,則傳送所有事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 mouseDown 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 touchBegin 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 TOUCH_BEGIN 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。

範例  ( 如何使用本範例 )

以下範例會顯示 TOUCH_BEGINTOUCH_MOVE 以及 TOUCH_END 事件的事件處理。當接觸點在螢幕上移動 (onTouchMove) 時,以舞台為基準的 x 座標會記錄至輸出中。對於 onTouchBegin 函數中的 Sprite.startTouchDrag 參數,touchPointID 的值是指定給事件物件的值。邊界參數是一個矩形,定義父顯示物件的邊緣 ( bg 是一個內含 MySprite 的顯示物件)。
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;

MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);

function onTouchBegin(eBegin:TouchEvent) {
     eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
     trace("touch begin");
 
 }

function onTouchMove(eMove:TouchEvent) {
    trace(eMove.stageX);
}
 
function onTouchEnd(eEnd:TouchEvent) {
     eEnd.target.stopTouchDrag(eEnd.touchPointID);
     trace("touch end");
}

相關 API 元素

touchEnd

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.TOUCH_END

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

當使用者在觸控裝置上移除接觸點後傳送 (例如在行動電話或平板電腦觸控螢幕上移開手指)。某些裝置可能會將這種接觸解譯為 mouseUp 事件。

特別是,如果使用者將手指往觸控螢幕上方提起,則 InteractiveObject 實體可以傳送 mouseUp 事件或 touchEnd 事件,或者如果目前環境支援,則傳送所有事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 mouseUp 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 touchEnd 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 TOUCH_END 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。

範例  ( 如何使用本範例 )

以下範例會顯示 TOUCH_BEGINTOUCH_MOVE 以及 TOUCH_END 事件的事件處理。當接觸點在螢幕上移動 (onTouchMove) 時,以舞台為基準的 x 座標會記錄至輸出中。對於 onTouchBegin 函數中的 Sprite.startTouchDrag 參數,touchPointID 的值是指定給事件物件的值。邊界參數是一個矩形,定義父顯示物件的邊緣 ( bg 是一個內含 MySprite 的顯示物件)。
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;

MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);

function onTouchBegin(eBegin:TouchEvent) {
     eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
     trace("touch begin");
 
 }

function onTouchMove(eMove:TouchEvent) {
    trace(eMove.stageX);
}
 
function onTouchEnd(eEnd:TouchEvent) {
     eEnd.target.stopTouchDrag(eEnd.touchPointID);
     trace("touch end");
}

相關 API 元素

touchMove

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.TOUCH_MOVE

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

當使用者觸控裝置時傳送,並且連續不斷地傳送,直到接觸點移除為止。請注意,此事件不需要實際移動要傳送的接觸點。

某些裝置可能會將這種接觸解譯為 mouseMove 事件。特別是,如果使用者在觸控螢幕上手指一揮,則 InteractiveObject 實體可以傳送 mouseMove 事件或 touchMove 事件,或者如果目前環境支援,則傳送所有事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 mouseMove 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 touchMove 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 TOUCH_MOVE 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。

範例  ( 如何使用本範例 )

以下範例會顯示 TOUCH_BEGINTOUCH_MOVE 以及 TOUCH_END 事件的事件處理。當接觸點在螢幕上移動 (onTouchMove) 時,以舞台為基準的 x 座標會記錄至輸出中。對於 onTouchBegin 函數中的 Sprite.startTouchDrag 參數,touchPointID 的值是指定給事件物件的值。邊界參數是一個矩形,定義父顯示物件的邊緣 ( bg 是一個內含 MySprite 的顯示物件)。
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;

MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);

function onTouchBegin(eBegin:TouchEvent) {
     eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
     trace("touch begin");
 
 }

function onTouchMove(eMove:TouchEvent) {
    trace(eMove.stageX);
}
 
function onTouchEnd(eEnd:TouchEvent) {
     eEnd.target.stopTouchDrag(eEnd.touchPointID);
     trace("touch end");
}

相關 API 元素

touchOut

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.TOUCH_OUT

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

當使用者在觸控裝置中,將接觸點移出 InteractiveObject 實體後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件移至另一個顯示物件)。某些裝置可能會將這種接觸解譯為 mouseOut 事件。

特別是,如果使用者在觸控螢幕上手指一揮,則 InteractiveObject 實體可以傳送 mouseOut 事件或 touchOut 事件,或者如果目前環境支援,則傳送所有事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 mouseOut 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 touchOut 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 TOUCH_OUT 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。

相關 API 元素

touchOver

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.TOUCH_OVER

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

當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件外面的某一點,往顯示物件上方拖曳)。某些裝置可能會將這種接觸解譯為 mouseOver 事件。

特別是,如果使用者將手指移至 InteractiveObject 上方,則 InteractiveObject 實體可以傳送 mouseOver 事件或 touchOver 事件,或者如果目前環境支援,則傳送所有事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 mouseOver 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 touchOver 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 TOUCH_OVER 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。

相關 API 元素

touchRollOut

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.TOUCH_ROLL_OUT

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

當使用者在觸控裝置上,將接觸點從 InteractiveObject 實體移出後送出 (例如,在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件上方拖曳到顯示物件以外)。某些裝置可能會將這種接觸解譯為 rollOut 事件。

特別是,如果使用者將手指移至 InteractiveObject 上方,則 InteractiveObject 實體可以傳送 rollOut 事件或 touchRollOut 事件,或者如果目前環境支援,則傳送所有事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 rollOut 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 touchRollOut 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 TOUCH_ROLL_OUT 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。

相關 API 元素

touchRollOver

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.TOUCH_ROLL_OVER

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

當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件外面的某一點,往顯示物件上方拖曳)。某些裝置可能會將這種接觸解譯為 rollOver 事件。

特別是,如果使用者將手指移至 InteractiveObject 上方,則 InteractiveObject 實體可以傳送 rollOver 事件或 touchRollOver 事件,或者如果目前環境支援,則傳送所有事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 rollOver 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 touchRollOver 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 TOUCH_ROLL_OVER 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。

相關 API 元素

touchTap

事件  
事件物件類型: flash.events.TouchEvent
屬性 TouchEvent.type = flash.events.TouchEvent.TOUCH_TAP

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

當使用者在觸控裝置的同一個 InteractiveObject 實體上,在原先開始接觸點放開後送出 (例如在行動電話或平板電腦觸控螢幕上的顯示物件上方,以手指按下某個點後又鬆開)。某些裝置可能會將這種接觸解譯為 click 事件。

特別是,如果使用者在 InteractiveObject 上方用一根手指點一下,則 InteractiveObject 實體可以傳送 click 事件或 touchTap 事件,或者如果目前環境支援,則傳送所有事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理,或者停用觸控事件,這樣只會傳送滑鼠事件)。如果您選擇處理 click 事件,則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過,如果您選擇處理 touchTap 事件,就可以設計自己的事件處理常式,用於回應觸控環境的特殊需求,以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件,提供不同於滑鼠事件的回應給觸控事件。

注意:如需環境相容性資訊,請參閱 Multitouch 類別。

定義 TOUCH_TAP 觸控事件物件的 type 屬性值。

傳送的 TouchEvent 物件有下列屬性:

屬性
altKey如果 Alt 鍵為作用中 (Windows 或 Linux),則為 true
bubblestrue
cancelablefalse;沒有要取消的預設行為指令。
commandKey在 Mac 中,如果 Command 鍵為作用中,則為 true;如果已停用則為 false。在 Windows 中一定為 false
controlKey如果 Ctrl 或 Control 鍵為作用中,則為 true;如果已停用,則為 false
ctrlKey在 Windows 或 Linux 中,如果 Ctrl 鍵為作用中,則為 true;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true;否則為 false
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
eventPhase事件流程中的目前階段。
isRelatedObjectInaccessible如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true
localX相對於包含的 sprite,事件發生的水平座標。
localY相對於包含的 sprite,事件發生的垂直座標。
pressure介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
relatedObject與事件相關的顯示清單物件的參照。
shiftKey如果 Shift 鍵為作用中,則為 true;若已停用,則為 false
sizeX接觸區域寬度。
sizeY接觸區域高度。
stageX在全域舞台座標上,事件發生的水平座標。
stageY在全域舞台座標上,事件發生的垂直座標。
target位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
touchPointID指派至觸控點的唯一識別碼 (作為 int)。

範例  ( 如何使用本範例 )

以下範例會在觸控螢幕內 mySprite 中繪製的正方形被點選時顯示訊息:
Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT;

var mySprite:Sprite = new Sprite();
var myTextField:TextField = new TextField();

mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0,0,40,40);
addChild(mySprite);

mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler);

function taphandler(e:TouchEvent): void {
    myTextField.text = "I've been tapped";
    myTextField.y = 50;
    addChild(myTextField);
}

相關 API 元素

InteractiveObjectExample.as

下列範例使用 InteractiveObjectExample類別,該類別會反過來使用 ChildSprite 類別繪製矩形,並根據不同的滑鼠事件來操作此矩形。 您可以執行下列步驟來完成這項工作:
  1. InteractiveObjectExample 建構函式中建立名為 child 、類型為 Sprite 的新 ChildSprite 物件,它會呼叫 ChildSprite 建構函式方法以繪製形狀,並為此形狀加入滑鼠事件 (如下列步驟中所述)。 child 物件會加入顯示清單的最上層,座標為 x = 0, y = 0
  2. ChildSprite 類別中,宣告 sizeoverSize 屬性,稍後會在 draw() 方法和 MouseEvent 方法中用到這些屬性。
  3. 宣告將背景顏色設為橘色、將滑鼠在上方的顏色設為深黃色,以及將滑鼠在下方的顏色設為淺藍色的這些屬性。
  4. ChildSprite 建構函式中,使用來自於 Graphics 類別的方法和 draw() 方法來繪製橘色方形。
  5. 此建構函式會加入四個 MouseEvent 事件偵聽程式方法:
    • mouseOverHandler:在原始座標重新繪製較大的 60 x 60 像素方形,顏色為深黃。
    • mouseOutHandler:傳回具有原始大小與顏色的方形。
    • mouseDownHandler:在原始座標重新繪製較大的 60 x 60 像素方形,顏色為淺藍。
    • mouseUpHandler:相等於 mouseOverHandler
package {
    import flash.display.Sprite;

    public class InteractiveObjectExample extends Sprite {

        public function InteractiveObjectExample() {
            var child:Sprite = new ChildSprite();
            addChild(child);
        }
    }
}

import flash.display.Sprite;
import flash.events.MouseEvent;

class ChildSprite extends Sprite {
    private var size:uint = 50;
    private var overSize:uint = 60;
    private var backgroundColor:uint = 0xFFCC00;
    private var overColor:uint = 0xCCFF00;
    private var downColor:uint = 0x00CCFF;

    public function ChildSprite() {
        buttonMode = true;
        draw(size, size, backgroundColor);
        addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
        addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
        addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
        addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
    }

    private function draw(w:uint, h:uint, bgColor:uint):void {
        graphics.clear();
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, w, h);
        graphics.endFill();
    }

    public function mouseOverHandler(event:MouseEvent):void {
        trace("mouseOverHandler");
        draw(overSize, overSize, overColor);
    }

    public function mouseOutHandler(event:MouseEvent):void {
        trace("mouseOutHandler");
        draw(size, size, backgroundColor);
    }

    public function mouseDownHandler(event:MouseEvent):void {
        trace("mouseDownHandler");
        draw(overSize, overSize, downColor);
    }

    public function mouseUpHandler(event:MouseEvent):void {
        trace("mouseUpHandler");
        draw(overSize, overSize, overColor);
    }
}




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

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