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

TouchEvent  - 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.events

介面
IEventDispatcher
 
類別
AccelerometerEvent
ActivityEvent
AsyncErrorEvent
AudioOutputChangeEvent
AVDictionaryDataEvent
AVHTTPStatusEvent
AVPauseAtPeriodEndEvent
BrowserInvokeEvent    
ContextMenuEvent
DataEvent
DatagramSocketDataEvent    
DeviceRotationEvent    
DNSResolverEvent    
DRMAuthenticateEvent    
DRMAuthenticationCompleteEvent
DRMAuthenticationErrorEvent
DRMDeviceGroupErrorEvent
DRMDeviceGroupEvent
DRMErrorEvent
DRMLicenseRequestEvent
DRMMetadataEvent
DRMReturnVoucherCompleteEvent
DRMReturnVoucherErrorEvent
DRMStatusEvent
ErrorEvent
Event
EventDispatcher
EventPhase
FileListEvent    
FocusEvent
FullScreenEvent
GameInputEvent    
GeolocationEvent
GestureEvent
GesturePhase
HTMLUncaughtScriptExceptionEvent    
HTTPStatusEvent
IMEEvent
InvokeEvent    
IOErrorEvent
KeyboardEvent
LocationChangeEvent    
MediaEvent    
MouseEvent
NativeDragEvent    
NativeProcessExitEvent    
NativeWindowBoundsEvent    
NativeWindowDisplayStateEvent    
NetDataEvent
NetMonitorEvent
NetStatusEvent
OutputProgressEvent    
PermissionEvent
PressAndTapGestureEvent
ProgressEvent
RemoteNotificationEvent    
SampleDataEvent
ScreenMouseEvent    
SecurityErrorEvent
ServerSocketConnectEvent    
ShaderEvent
SoftKeyboardEvent
SoftKeyboardTrigger
SQLErrorEvent    
SQLEvent    
SQLUpdateEvent    
StageOrientationEvent    
StageVideoAvailabilityEvent
StageVideoEvent
StatusEvent
StorageVolumeChangeEvent    
SyncEvent
TextEvent
ThrottleEvent
ThrottleType
TimerEvent
TouchEvent
TouchEventIntent    
TransformGestureEvent
UncaughtErrorEvent
UncaughtErrorEvents
VideoEvent
VideoTextureEvent
VsyncStateChangeAvailabilityEvent    
套件flash.events
類別public class TouchEvent
繼承TouchEvent Inheritance Event Inheritance Object

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

TouchEvent 類別讓您可以在偵測使用者與裝置互動的裝置上處理事件 (例如在觸控螢幕上的手指)。

當使用者與具有觸控螢幕的行動電話或平板電腦互動時,使用者通常會利用手指或是指向裝置碰觸螢幕。您可以利用 TouchEvent 類別開發回應基本觸控事件 (例如單一手指點選) 的應用程式。使用在這個類別中定義的事件類型建立事件偵聽程式。對於多點接觸的使用者互動 (例如多隻手指同時滑過觸控螢幕),您可以使用相關的 GestureEvent、PressAndTapGestureEvent 與 TransformGestureEvent 類別。然後,利用這些類別的屬性和方法建構回應使用者觸控裝置的事件處理常式。

使用 Multitouch 類別判定目前環境支援觸控互動的程度,以及管理觸控互動的支援 (若目前環境支援)。

注意:當物件在顯示清單中巢狀排列時,觸控事件會指向在顯示清單中可見的最深層巢狀物件。這個物件稱為目標節點。若要讓目標節點的祖系 (包含顯示清單中目標節點的物件) 接收觸控事件的通知,請在祖系節點上使用 EventDispatcher.addEventListener() (將 type 參數設定為您要偵測的特定觸控事件)。

在 AIR 3 及更新的版本中,您可以在具有作用中觸控筆的 Android 支援裝置上偵聽鄰近事件。在這類裝置上,proximityMovetouchMove 事件物件提供位元組陣列,其中包含路徑及自上一個移動事件以來採取過的壓力取樣。您可以使用這些樣本,在觸控事件之間建構觸控筆的路徑 (請注意,觸控筆輸入與顯示清單之間互動的感應測試,只會在路徑線段結尾進行)。

檢視範例

相關 API 元素



公用屬性
 屬性定義自
  altKey : Boolean
指出 Alt 鍵為作用中 (true) 或停用 (false)。
TouchEvent
 Inheritedbubbles : Boolean
[唯讀] 指出事件是否為反昇事件。
Event
 Inheritedcancelable : Boolean
[唯讀] 指出是否可避免與事件相關聯的行為指令。
Event
  commandKey : Boolean
指出 Command 鍵是否已啟用 (僅限 Mac)。
TouchEvent
 Inheritedconstructor : Object
類別物件的參照或是特定物件實體的建構函數。
Object
  controlKey : Boolean
指出是否已啟用 Control 鍵 (在 Mac 中) 以及是否已啟用 Ctrl 鍵 (在 Windows 或 Linux 中)。
TouchEvent
  ctrlKey : Boolean
在 Windows 或 Linux 中,指出 Ctrl 鍵為作用中 (true) 或已停用 (false)。
TouchEvent
 InheritedcurrentTarget : Object
[唯讀] 正主動使用事件偵聽程式處理 Event 物件的物件。
Event
 InheritedeventPhase : uint
[唯讀] 事件流程中的目前階段。
Event
  isPrimaryTouchPoint : Boolean
指定第一個接觸點是否對應到滑鼠事件。
TouchEvent
  isRelatedObjectInaccessible : Boolean
如果是 true,則 relatedObject 屬性會因為安全執行程序的因素而設定為 null。
TouchEvent
      isTouchPointCanceled : Boolean
報告這個觸控輸入序列已由作業系統取消。
TouchEvent
  localX : Number
相對於包含的 sprite,事件發生的水平座標。
TouchEvent
  localY : Number
相對於包含的 sprite,事件發生的垂直座標。
TouchEvent
  pressure : Number
介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。
TouchEvent
  relatedObject : InteractiveObject
與事件相關的顯示清單物件的參照。
TouchEvent
  shiftKey : Boolean
指出 Shift 鍵為作用中 (true) 或停用 (false)。
TouchEvent
  sizeX : Number
接觸區域寬度。
TouchEvent
  sizeY : Number
接觸區域高度。
TouchEvent
  stageX : Number
[唯讀] 在全域舞台座標上,事件發生的水平座標。
TouchEvent
  stageY : Number
[唯讀] 在全域舞台座標上,事件發生的垂直座標。
TouchEvent
 Inheritedtarget : Object
[唯讀] 事件目標。
Event
      timestamp : Number
報告事件的時間 (相對毫秒)。
TouchEvent
      touchIntent : String
報告觸控是否由觸控筆的主要端點或橡皮擦端點所產生。
TouchEvent
  touchPointID : int
指派至觸控點的唯一識別碼 (作為 int)。
TouchEvent
 Inheritedtype : String
[唯讀] 事件類型。
Event
公用方法
 方法定義自
  
TouchEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, touchPointID:int = 0, isPrimaryTouchPoint:Boolean = false, localX:Number = NaN, localY:Number = NaN, sizeX:Number = NaN, sizeY:Number = NaN, pressure:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, timestamp:Number = NaN, touchIntent:String, samples:ByteArray = null, isTouchPointCanceled:Boolean = false)
建立包含關於觸控事件資訊的 Event 物件。
TouchEvent
  
[覆寫] 建立 TouchEvent 物件的副本,然後設定每個屬性值以符合原始物件的屬性值。
TouchEvent
 Inherited
formatToString(className:String, ... arguments):String
公用程式函數,可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。
Event
  
    getSamples(buffer:ByteArray, append:Boolean = false):uint
請使用高頻率的資料點,為多點觸控事件更新指定的 ByteArray 物件。
TouchEvent
 Inherited
指出物件是否有已定義的指定屬性。
Object
 Inherited
檢查是否已經對事件呼叫 preventDefault() 方法。
Event
 Inherited
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。
Object
  
報告已按下位於指定之索引位置的硬體按鈕。
TouchEvent
 Inherited
如果可以取消事件的預設行為指令,則取消該行為指令。
Event
 Inherited
指出指定的屬性是否存在,以及是否可列舉。
Object
 Inherited
為迴圈作業設定動態屬性的可用性。
Object
 Inherited
避免處理事件流程中,目前節點以及任何後續節點中的任何事件偵聽程式。
Event
 Inherited
避免處理接續在事件流程中的目前節點之後,後續節點中的任何事件偵聽程式。
Event
 Inherited
傳回代表此物件的字串,根據地區特定慣例進行格式化。
Object
  
[覆寫] 傳回包含 TouchEvent 物件所有屬性的字串。
TouchEvent
  
如果已經修改顯示清單,則指示 Flash Player 或 Adobe AIR 在此事件處理完畢後再顯示。
TouchEvent
 Inherited
會傳回指定之物件的基本值。
Object
公用常數
 常數定義自
      PROXIMITY_BEGIN : String = "proximityBegin"
[靜態] 定義 PROXIMITY_BEGIN 觸控事件物件的 type 屬性值。
TouchEvent
      PROXIMITY_END : String = "proximityEnd"
[靜態] 定義 PROXIMITY_END 觸控事件物件的 type 屬性值。
TouchEvent
      PROXIMITY_MOVE : String = "proximityMove"
[靜態] 定義 PROXIMITY_MOVE 觸控事件物件的 type 屬性值。
TouchEvent
      PROXIMITY_OUT : String = "proximityOut"
[靜態] 定義 PROXIMITY_OUT 觸控事件物件的 type 屬性值。
TouchEvent
      PROXIMITY_OVER : String = "proximityOver"
[靜態] 定義 PROXIMITY_OVER 觸控事件物件的 type 屬性值。
TouchEvent
      PROXIMITY_ROLL_OUT : String = "proximityRollOut"
[靜態] 定義 PROXIMITY_ROLL_OUT 觸控事件物件的 type 屬性值。
TouchEvent
      PROXIMITY_ROLL_OVER : String = "proximityRollOver"
[靜態] 定義 PROXIMITY_ROLL_OVER 觸控事件物件的 type 屬性值。
TouchEvent
  TOUCH_BEGIN : String = "touchBegin"
[靜態] 定義 TOUCH_BEGIN 觸控事件物件的 type 屬性值。
TouchEvent
  TOUCH_END : String = "touchEnd"
[靜態] 定義 TOUCH_END 觸控事件物件的 type 屬性值。
TouchEvent
  TOUCH_MOVE : String = "touchMove"
[靜態] 定義 TOUCH_MOVE 觸控事件物件的 type 屬性值。
TouchEvent
  TOUCH_OUT : String = "touchOut"
[靜態] 定義 TOUCH_OUT 觸控事件物件的 type 屬性值。
TouchEvent
  TOUCH_OVER : String = "touchOver"
[靜態] 定義 TOUCH_OVER 觸控事件物件的 typr 屬性值。
TouchEvent
  TOUCH_ROLL_OUT : String = "touchRollOut"
[靜態] 定義 TOUCH_ROLL_OUT 觸控事件物件的 type 屬性值。
TouchEvent
  TOUCH_ROLL_OVER : String = "touchRollOver"
[靜態] 定義 TOUCH_ROLL_OVER 觸控事件物件的 type 屬性值。
TouchEvent
  TOUCH_TAP : String = "touchTap"
[靜態] 定義 TOUCH_TAP 觸控事件物件的 type 屬性值。
TouchEvent
屬性詳細資訊

altKey

屬性
altKey:Boolean

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

指出 Alt 鍵為作用中 (true) 或停用 (false)。 只支援 Windows 和 Linux 作業系統。



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

commandKey

屬性 
commandKey:Boolean

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

指出 Command 鍵是否已啟用 (僅限 Mac)。

在 Mac OS,commandKey 屬性的值與 ctrlKey 屬性的值相同。在 Windows 或 Linux 上,這個屬性永遠是 false。



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

controlKey

屬性 
controlKey:Boolean

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

指出是否已啟用 Control 鍵 (在 Mac 中) 以及是否已啟用 Ctrl 鍵 (在 Windows 或 Linux 中)。



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

ctrlKey

屬性 
ctrlKey:Boolean

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

在 Windows 或 Linux 中,指出 Ctrl 鍵為作用中 (true) 或已停用 (false)。在 Macintosh 中,指出 Control 鍵或 Command 鍵是否已啟用。



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

isPrimaryTouchPoint

屬性 
isPrimaryTouchPoint:Boolean

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

指定第一個接觸點是否對應到滑鼠事件。



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

相關 API 元素

isRelatedObjectInaccessible

屬性 
isRelatedObjectInaccessible:Boolean

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

如果是 true,則 relatedObject 屬性會因為安全執行程序的因素而設定為 null。如果 relatedObject 的名目值是另一個安全執行程序中 DisplayObject 的參考,則 relatedObject 會設定為 null,除非跨越安全執行程序邊界的兩個方向都有權限。建立權限的方法包括:從 SWF 檔呼叫 Security.allowDomain()、提供來自影像檔伺服器的原則檔案,以及於載入影像時設定 LoaderContext.checkPolicyFile 屬性。



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

相關 API 元素

    

isTouchPointCanceled

屬性 
isTouchPointCanceled:Boolean

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

報告這個觸控輸入序列已由作業系統取消。

觸控事件可能因為各種原因而取消,例如,拒絕手掌產生的觸控,因為正在使用觸控筆。isTouchPointCanceled 只有在 touchEnd 事件中才能為 true



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

localX

屬性 
localX:Number

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

相對於包含的 sprite,事件發生的水平座標。



實作
    public function get localX():Number
    public function set localX(value:Number):void

localY

屬性 
localY:Number

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

相對於包含的 sprite,事件發生的垂直座標。



實作
    public function get localY():Number
    public function set localY(value:Number):void

pressure

屬性 
pressure:Number

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

介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0



實作
    public function get pressure():Number
    public function set pressure(value:Number):void

relatedObject

屬性 
relatedObject:InteractiveObject

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

與事件相關的顯示清單物件的參照。 例如,當發生 touchOut 事件時,relatedObject 代表指向裝置現在指向的顯示清單物件。這個屬性套用到 touchOuttouchOvertouchRollOuttouchRollOver 事件。

在下列兩種情況下,這個屬性的值可能是 null:沒有相關物件,或是有相關物件但它位在您無法存取的安全執行程序中。使用 isRelatedObjectInaccessible() 屬性可判斷哪個原因適用於此情況。



實作
    public function get relatedObject():InteractiveObject
    public function set relatedObject(value:InteractiveObject):void

相關 API 元素

shiftKey

屬性 
shiftKey:Boolean

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

指出 Shift 鍵為作用中 (true) 或停用 (false)。



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

sizeX

屬性 
sizeX:Number

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

接觸區域寬度。



實作
    public function get sizeX():Number
    public function set sizeX(value:Number):void

sizeY

屬性 
sizeY:Number

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

接觸區域高度。



實作
    public function get sizeY():Number
    public function set sizeY(value:Number):void

stageX

屬性 
stageX:Number  [唯讀]

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

在全域舞台座標上,事件發生的水平座標。 每次設定 localX 屬性時,就會計算這個屬性。



實作
    public function get stageX():Number

stageY

屬性 
stageY:Number  [唯讀]

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

在全域舞台座標上,事件發生的垂直座標。 每次設定 localY 屬性時,就會計算這個屬性。



實作
    public function get stageY():Number
    

timestamp

屬性 
timestamp:Number

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

報告事件的時間 (相對毫秒)。

報告的時間是相對於應用程式開始執行的時間。對於在取樣緩衝區中傳回一連串點的事件,這個時間戳記會反映緩衝區中最後一個樣本所經過的時間。



實作
    public function get timestamp():Number
    public function set timestamp(value:Number):void

相關 API 元素

    

touchIntent

屬性 
touchIntent:String

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

報告觸控是否由觸控筆的主要端點或橡皮擦端點所產生。

如果觸控事件是由手指或其它非觸控筆輸入方法所產生,或者用於高頻率動作追蹤的觸控筆不受支援,這個屬性就會回報值:TouchEventIntent.UNKNOWN。

TouchEventIntent 類別會定義常數,做為這個屬性的可能值,其中包括:

  • TouchEventIntent.ERASER
  • TouchEventIntent.PEN
  • TouchEventIntent.UNKNOWN



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

相關 API 元素

touchPointID

屬性 
touchPointID:int

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

指派至觸控點的唯一識別碼 (作為 int)。



實作
    public function get touchPointID():int
    public function set touchPointID(value:int):void

範例  ( 如何使用本範例 )
下列範例會建立變數 touchMoveID,以測試正確的 touchPointID 值,再回應觸控移動事件。否則,其他觸控輸入也會觸發事件處理常式。請注意,移動與結束階段的偵聽程式會在舞台上,而不是在顯示物件上。萬一使用者的觸控移出顯示物件界限,舞台會偵聽移動或結束階段。
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; 

var mySprite:Sprite = new Sprite(); 
mySprite.graphics.beginFill(0x336699); 
mySprite.graphics.drawRect(0,0,40,40); 
addChild(mySprite); 

var myTextField:TextField = new TextField(); 
addChild(myTextField); 
myTextField.width = 200; 
myTextField.height = 20; 

var touchMoveID:int = 0; 
 
mySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); 
function onTouchBegin(event:TouchEvent) { 
    if(touchMoveID != 0) { 
        myTextField.text = "already moving. ignoring new touch";     
        return; 
    } 
    touchMoveID = event.touchPointID; 
 
    myTextField.text = "touch begin" + event.touchPointID; 
    stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); 
    stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); 
} 
function onTouchMove(event:TouchEvent) { 
    if(event.touchPointID != touchMoveID) { 
        myTextField.text = "ignoring unrelated touch"; 
        return; 
    } 
    mySprite.x = event.stageX; 
    mySprite.y = event.stageY; 
    myTextField.text = "touch move" + event.touchPointID; 
} 
function onTouchEnd(event:TouchEvent) { 
    if(event.touchPointID != touchMoveID) { 
        myTextField.text = "ignoring unrelated touch end"; 
        return; 
    } 
    touchMoveID = 0; 
    stage.removeEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); 
    stage.removeEventListener(TouchEvent.TOUCH_END, onTouchEnd); 
    myTextField.text = "touch end" + event.touchPointID; 
}
建構函式詳細資料

TouchEvent

()建構函式
public function TouchEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, touchPointID:int = 0, isPrimaryTouchPoint:Boolean = false, localX:Number = NaN, localY:Number = NaN, sizeX:Number = NaN, sizeY:Number = NaN, pressure:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, timestamp:Number = NaN, touchIntent:String, samples:ByteArray = null, isTouchPointCanceled:Boolean = false)

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

建立包含關於觸控事件資訊的 Event 物件。Event 物件會當做參數傳遞至事件偵聽程式。

參數
type:String — 事件類型。可能的值為:TouchEvent.PROXIMITY_BEGINTouchEvent.PROXIMITY_ENDTouchEvent.PROXIMITY_MOVETouchEvent.PROXIMITY_OUTTouchEvent.PROXIMITY_OVERTouchEvent.PROXIMITY_ROLL_OUTTouchEvent.PROXIMITY_ROLL_OVERTouchEvent.TOUCH_BEGINTouchEvent.TOUCH_ENDTouchEvent.TOUCH_MOVETouchEvent.TOUCH_OUTTouchEvent.TOUCH_OVERTouchEvent.TOUCH_ROLL_OUTTouchEvent.TOUCH_ROLL_OVERTouchEvent.TOUCH_TAP
 
bubbles:Boolean (default = true) — 判斷事件物件是否參與事件流程的反昇階段。
 
cancelable:Boolean (default = false) — 判斷是否可以取消 Event 物件。
 
touchPointID:int (default = 0) — 指派至觸控點的唯一識別碼 (作為 int)。
 
isPrimaryTouchPoint:Boolean (default = false) — 指定第一個接觸點是否對應到滑鼠事件。
 
localX:Number (default = NaN) — 相對於包含的 sprite,事件發生的水平座標。
 
localY:Number (default = NaN) — 相對於包含的 sprite,事件發生的垂直座標。
 
sizeX:Number (default = NaN) — 接觸區域寬度。
 
sizeY:Number (default = NaN) — 接觸區域高度。
 
pressure:Number (default = NaN) — 介於 0.01.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0
 
relatedObject:InteractiveObject (default = null) — 受到事件影響的互補 InteractiveObject 實體。例如,當發生 touchOut 事件時,relatedObject 代表指向裝置現在指向的顯示清單物件。
 
ctrlKey:Boolean (default = false) — 在 Windows 或 Linux 中,表示是否已啟用 Ctrl 鍵。在 Mac 中,指出已啟用 Ctrl 鍵或 Command 鍵。
 
altKey:Boolean (default = false) — 指出是否已啟用 Alt 鍵 (僅限 Windows 或 Linux)。
 
shiftKey:Boolean (default = false) — 指出是否已啟用 Shift 鍵。
 
commandKey:Boolean (default = false) — (僅限 AIR) 指出 Command 鍵是否已啟用 (僅限 Mac)。這個參數僅適用於 Adobe AIR;請勿針對 Flash Player 內容設定此參數。
 
controlKey:Boolean (default = false) — (僅限 AIR) 指出 Control 或 Ctrl 鍵是否已啟用。這個參數僅適用於 Adobe AIR;請勿針對 Flash Player 內容設定此參數。
 
timestamp:Number (default = NaN) — (僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。
 
touchIntent:String (default = NaN) — (僅限 AIR) TouchEventIntent 類別的值。
 
samples:ByteArray (default = null) — (僅限 AIR) ByteArray 物件,包含自 (按順序) 最後一個觸控或鄰近事件以來所記錄,每個中繼樣本的位置和壓力讀數。
 
isTouchPointCanceled:Boolean (default = false) — (僅限 AIR) 如果因遭拒絕的觸控類型而取消觸控事件則為 true
方法詳細資訊

clone

()方法
override public function clone():Event

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

建立 TouchEvent 物件的副本,然後設定每個屬性值以符合原始物件的屬性值。

傳回值
Event — 新 TouchEvent 物件,其屬性值符合原始物件的屬性值。

    getSamples

()方法 
public function getSamples(buffer:ByteArray, append:Boolean = false):uint

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

請使用高頻率的資料點,為多點觸控事件更新指定的 ByteArray 物件。

buffer 參數所參考的 ByteArray 物件,會以這個及上一個觸控事件之間中繼資料點的值進行更新。每個樣本都會加入三個浮點值:x 座標、y 座標及壓力值。舞台座標中已回報位置值。壓力會回報為介於 0 和 1 之間的值。每隔一段固定時間都會記錄樣本。實際的頻率取決於裝置硬體和硬體驅動程式。一般取樣頻率大約為 133 Hz。請注意,觸控事件不會按確切的間隔傳送。因此,類似事件的緩衝區可能包含一些不同的樣本。緩衝區中的最後一個樣本,具有與這個觸控事件物件的 stageXstageYpressure 屬性相同的資料。

取樣緩衝區包含在針對 proximityMovetouchMove 事件傳送的事件物件。

參數

buffer:ByteArray — 接收取樣資料的 ByteArray 物件。
 
append:Boolean (default = false) — 當 true 時,會從陣列的目前 position 屬性開始,將樣本加入 buffer 位元組陣列中。使用預設值 false 時,則會在加入樣本之前捨棄緩衝區物件中的現有資料。

傳回值
uint — uint 是指加入到緩衝區的樣本數目。每個樣本包含三個浮點數。

相關 API 元素


範例  ( 如何使用本範例 )

下列範例說明如何從 touchMove 或 proximityMove 事件擷取樣本資料:
function touchMoveHandler( event:TouchEvent ):void
{
    if( (event.type == TouchEvent.TOUCH_MOVE ||
        event.type == TouchEvent.PROXIMITY_MOVE) &&
        event.touchEventIntent != TouchEventIntent.UNKNOWN )
    {
        var samples:ByteArray = new ByteArray();
        event.getSamples( samples, true );
        samples.position = 0;     // rewind to beginning of array before reading
        
        var xCoord:Number, yCoord:Number, pressure:Number;
        
        while( samples.bytesAvailable > 0 )
        {
            xCoord = samples.readFloat();
            yCoord = samples.readFloat();
            pressure = samples.readFloat();
            //do something with the sample data
        }
    }
}

下列範例說明如何從 touchMove 或 proximityMove 事件擷取樣本資料。在此範例中,會將樣本附加至現有位元組陣列:
var samples:ByteArray = new ByteArray();

function touchMoveHandler( event:TouchEvent ):void
{
    if( (event.type == TouchEvent.TOUCH_MOVE ||
        event.type == TouchEvent.PROXIMITY_MOVE) &&
        event.touchEventIntent != TouchEventIntent.UNKNOWN )
    {
        var sampleCount:uint = event.getSamples( samples, true );         
        var xCoord:Number, yCoord:Number, pressure:Number;
        
        for( var i:int; i < sampleCount; i++ )
        {
            xCoord = samples.readFloat();
            yCoord = samples.readFloat();
            pressure = samples.readFloat();
            //do something with the sample data
        }
    }
}

    isToolButtonDown

()方法 
public function isToolButtonDown(index:int):Boolean

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

報告已按下位於指定之索引位置的硬體按鈕。

參數

index:int — 觸控筆類型的輸入裝置所支援的按鈕索引 (從零開始)。

傳回值
Boolean

toString

()方法 
override public function toString():String

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

傳回包含 TouchEvent 物件所有屬性的字串。此字串的格式如下:

[TouchEvent type=value bubbles=value cancelable=value ... ]

傳回值
String — 包含 TouchEvent 物件所有屬性的字串。

updateAfterEvent

()方法 
public function updateAfterEvent():void

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

如果已經修改顯示清單,則指示 Flash Player 或 Adobe AIR 在此事件處理完畢後再顯示。

常數詳細資訊
    

PROXIMITY_BEGIN

常數
public static const PROXIMITY_BEGIN:String = "proximityBegin"

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

定義 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 元素

    

PROXIMITY_END

常數 
public static const PROXIMITY_END:String = "proximityEnd"

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

定義 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 元素

    

PROXIMITY_MOVE

常數 
public static const PROXIMITY_MOVE:String = "proximityMove"

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

定義 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 元素

    

PROXIMITY_OUT

常數 
public static const PROXIMITY_OUT:String = "proximityOut"

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

定義 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 元素

    

PROXIMITY_OVER

常數 
public static const PROXIMITY_OVER:String = "proximityOver"

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

定義 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 元素

    

PROXIMITY_ROLL_OUT

常數 
public static const PROXIMITY_ROLL_OUT:String = "proximityRollOut"

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

定義 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 元素

    

PROXIMITY_ROLL_OVER

常數 
public static const PROXIMITY_ROLL_OVER:String = "proximityRollOver"

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

定義 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 元素

TOUCH_BEGIN

常數 
public static const TOUCH_BEGIN:String = "touchBegin"

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

定義 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)。

相關 API 元素

TOUCH_END

常數 
public static const TOUCH_END:String = "touchEnd"

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

定義 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)。

相關 API 元素

TOUCH_MOVE

常數 
public static const TOUCH_MOVE:String = "touchMove"

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

定義 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)。

相關 API 元素

TOUCH_OUT

常數 
public static const TOUCH_OUT:String = "touchOut"

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

定義 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 元素

TOUCH_OVER

常數 
public static const TOUCH_OVER:String = "touchOver"

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

定義 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 元素

TOUCH_ROLL_OUT

常數 
public static const TOUCH_ROLL_OUT:String = "touchRollOut"

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

定義 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 元素

TOUCH_ROLL_OVER

常數 
public static const TOUCH_ROLL_OVER:String = "touchRollOver"

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

定義 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 元素

TOUCH_TAP

常數 
public static const TOUCH_TAP:String = "touchTap"

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

定義 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)。

相關 API 元素


範例  ( 如何使用本範例 )

以下範例會在觸控螢幕內 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);
}
TouchEventExample.as

以下範例會顯示 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");
}
TouchExample2.as

以下範例顯示如何處理觸控事件、觸控事件階段以及 Multitouch.maxTouchPoints 和觸控事件的 touchPointID 屬性。這個範例來自 Christian Cantrell,而且在您的快速入門中提供詳細的說明:Flash 平台支援的多點觸控和手勢
 package
{
    import flash.display.Sprite;
    import flash.events.TouchEvent;
    import flash.text.AntiAliasType;
    import flash.text.TextField;
    import flash.text.TextFormat;
    import flash.ui.Multitouch;
    import flash.ui.MultitouchInputMode;

    [SWF(width=320, height=460, frameRate=24, backgroundColor=0xEB7F00)]
    public class TouchExample2 extends Sprite
    {
        private var dots:Object;
        private var labels:Object;
        private var labelFormat:TextFormat;
        private var dotCount:uint;
        private var dotsLeft:TextField;
        private static const LABEL_SPACING:uint = 15;
        
        public function TouchExample2()
        {
            super();

            this.labelFormat = new TextFormat();
            labelFormat.color = 0xACF0F2;
            labelFormat.font = "Helvetica";
            labelFormat.size = 11;
            
            this.dotCount = 0;

            this.dotsLeft = new TextField();
            this.dotsLeft.width = 300;
            this.dotsLeft.defaultTextFormat = this.labelFormat;
            this.dotsLeft.x = 3;
            this.dotsLeft.y = 0;
            this.stage.addChild(this.dotsLeft);
            this.updateDotsLeft();

            this.dots = new Object();
            this.labels = new Object();

            Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
            this.stage.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
            this.stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
            this.stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
        }

        private function onTouchBegin(e:TouchEvent):void
        {
            if (this.dotCount == Multitouch.maxTouchPoints) return;
            var dot:Sprite = this.getCircle();
            dot.x = e.stageX;
            dot.y = e.stageY;
            this.stage.addChild(dot);
            dot.startTouchDrag(e.touchPointID, true);
            this.dots[e.touchPointID] = dot;
            
            ++this.dotCount;

            var label:TextField = this.getLabel(e.stageX + ", " + e.stageY);
            label.x = 3;
            label.y = this.dotCount * LABEL_SPACING;
            this.stage.addChild(label);
            this.labels[e.touchPointID] = label;

            this.updateDotsLeft();
        }
        
        private function onTouchMove(e:TouchEvent):void
        {
            var label:TextField = this.labels[e.touchPointID];
            label.text = (e.stageX + ", " + e.stageY);
        }
        
        private function onTouchEnd(e:TouchEvent):void
        {
            var dot:Sprite = this.dots[e.touchPointID];
            var label:TextField = this.labels[e.touchPointID];
            
            this.stage.removeChild(dot);
            this.stage.removeChild(label);
            
            delete this.dots[e.touchPointID];
            delete this.labels[e.touchPointID];
            
            --this.dotCount;

            this.updateDotsLeft();
        }
        
        private function getCircle(circumference:uint = 40):Sprite
        {
            var circle:Sprite = new Sprite();
            circle.graphics.beginFill(0x1695A3);
            circle.graphics.drawCircle(0, 0, circumference);
            return circle;
        }

        private function getLabel(initialText:String):TextField
        {
            var label:TextField = new TextField();
            label.defaultTextFormat = this.labelFormat;
            label.selectable = false;
            label.antiAliasType = AntiAliasType.ADVANCED;
            label.text = initialText;
            return label;
        }
        
        private function updateDotsLeft():void
        {
            this.dotsLeft.text = "Touches Remaining: " + (Multitouch.maxTouchPoints - this.dotCount);
        }
    }
}




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

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