[cocos2dx_Lua]quick中的触摸事件

显示层级

触摸区域

单点触摸事件

-- 允许 node 接受触摸事件
node:setTouchEnabled(true)

-- 注册触摸事件
node:addNodeEventListener(cc.NODE_TOUCH_EVENT,function(event)
    -- event.name 是触摸事件的状态：began,moved,ended,cancelled
    -- event.x,event.y 是触摸点当前位置
    -- event.prevX,event.prevY 是触摸点之前的位置
    printf("sprite: %s x,y: %0.2f,%0.2f",event.name,event.x,event.y)

    -- 在 began 状态时，如果要让 Node 继续接收该触摸事件的状态变化
    -- 则必须返回 true
    if event.name == "began" then
        return true
    end
-- 在began和ended事件中,event.prevX == event.x,event.prevY == event.y,而在moved事件中至少有一组不相等

end)

-- 触摸事件的 event.name 指示了事件的状态：
--     began: 手指开始触摸屏幕。在began状态时，如果要继续接收该触摸事件的状态变化，事件处理函数必须返回 true。
--     moved: 手指在屏幕上移动。
--     ended: 手指离开屏幕。
--     cancelled: 因为其他原因取消触摸操作。

多点触摸

-- 允许 node 接受触摸事件
node:setTouchEnabled(true)

-- 设置触摸模式
node:setTouchMode(cc.TOUCH_MODE_ALL_AT_ONCE) -- 多点
-- node:setTouchMode(cc.TOUCH_MODE_ONE_BY_ONE) -- 单点（默认模式）

-- 注册触摸事件
node:addNodeEventListener(cc.NODE_TOUCH_EVENT,cancelled
    -- 多点触摸增加了 added 和 removed 状态
    -- event.points 包含所有触摸点
    
    -- "mode"   = 0
    -- "name"   = "moved"
    -- "phase"  = "targeting"
    -- "points" = {
        -- "0" = {
            -- "id"    = "0"
            -- "prevX" = 519.43664550781
            -- "prevY" = 668.25
            -- "x"     = 519.43664550781
            -- "y"     = 668.25
        -- }
        -- "2" = { -- 表明至少有3只手触摸
            -- "id"    = "2"
            -- "prevX" = 306.47888183594
            -- "prevY" = 720
            -- "x"     = 306.47888183594
            -- "y"     = 720
        -- }
    -- }

    if event.name == "began" then
        return true
    end
end)

• began: 手指开始触摸屏幕。用户可能同时用多个手指接触屏幕，但因为硬件响应速度极快的原因，began 状态时，event.points 中可能仍然只有一个触摸点的数据，其他触摸点数据会通过 added 状态提供。
• added: 开始触摸后，如果有更多触摸点出现，则出现 added 状态。此时 event.points 中包含新加入的触摸点数据。
• removed: 如果触摸结束前有触摸点消失（接触屏幕的部分手指离开了屏幕），则出现 removed 状态。此时 event.points 中包含删除的触摸点数据。
• ended: 如果所有触摸点都消失（所有手指都离开了屏幕），则出现 ended 状态。此时 event.points 中包含删除的触摸点数据。
• moved: 由于多点触摸时，可能只有部分触摸点移动。所以此时 event.points 中只包含有变化的触摸点数据。

触摸事件吞噬

• setTouchSwallowEnabled() 是否允许 Node 吞噬触摸，默认为 true。如果设置为 false，则 Node 响应触摸事件后，仍然会将事件继续传递给父对象。
• isTouchSwallowEnabled() 检查 Node 是否允许吞噬触摸。

禁用触摸

• setTouchEnabled() 是否允许 Node 响应触摸，默认为 false。
• isTouchEnabled() 检查 Node 是否允许触摸。

• setTouchCaptureEnabled() 是否允许 Node 捕获触摸，默认为true。当设置为false时，该Node及其所有子 Node 都无法得到触摸事件。
• isTouchCaptureEnabled() 检查 Node 是否允许捕获触摸。

触摸事件的三个阶段

当用户的一根手指触摸到屏幕时，将产生一个触摸事件：

capturing捕获阶段

1. 遍历所有响应触摸的 Node，找出显示层级最高，并且其触摸区域包含触摸位置的那个 Node。这个 Node 被称为 TargetNode（目标 Node）。
2. 检查 TargetNode 的 isTouchCaptureEnabled() 结果，如果返回 false，则重复 1
3. 从 TargetNode 的根 Node（通常是 Scene）开始，检查 cc.NODE_TOUCH_CAPTURE_EVENT 事件的返回结果。任何一个 Node 返回 false 都会阻止事件在 TargetNode 上触发。并从步骤 1 开始查找其他符合条件的 Node。

targeting触发阶段

bubbling冒泡阶段

-- 在 capturing 阶段就捕获事件
node:addNodeEventListener(cc.NODE_TOUCH_CAPTURE_EVENT,function(event)
    if event.name == "began" then
        -- 在 began 状态返回 false，将阻止事件
        return false
    end
end)

API参考

• addNodeEventListener() 为Node的特定事件设置处理函数，返回一个id表示注册成功。
• removeNodeEventListener() 从Node上移除指定类型的事件处理函数，需要提供addNodeEventListener() 返回的注册id。
• setTouchEnabled() 是否允许 Node 响应触摸，默认为 false。
• isTouchEnabled() 检查 Node 是否允许触摸。
• setTouchMode() 设置触摸模式，默认为 cc.TOUCH_MODE_ONE_BY_ONE。
• getTouchMode() 返回 Node 当前的触摸模式。
• setTouchCaptureEnabled() 是否允许 Node 捕获触摸，默认为 true。
• isTouchCaptureEnabled() 检查 Node 是否允许捕获触摸。
• setTouchSwallowEnabled() 是否允许 Node 吞噬触摸，默认为 true。
• isTouchSwallowEnabled() 检查 Node 是否允许吞噬触摸。