object.isHitTestMasked

概述

将触控事件限制为对象的遮罩部分。该属性可以读取或设置。

默认情况下，该属性为 true，这意味着对象上的触控事件只发生在对象的遮罩部分。将该属性设置为 false 会在触控发生在对象上的任意部分时生成触控事件。

目前，对于由 graphics.newMask() 创建的图片遮罩，触摸敏感区域对应于图片边界，即无论图片内容如何，它都是矩形的。

示例

-- Create and position image to be masked
local image = display.newImageRect( "image.png", 768, 1024 )
image:translate( display.contentCenterX, display.contentCenterY )
 
-- Create mask and apply to image
local mask = graphics.newMask( "circlemask.png" )
image:setMask( mask )
 
-- Touch events on the image will be masked to the mask bounds
-- (always rectangular for an image, regardless of the image contents)
image.isHitTestMasked = true
 
-- Transform mask
image.maskScaleX, image.maskScaleY = 2,2