跳至主要內容

模擬手指接觸螢幕 (touch.on)

聲明

觸控事件 = touch.on(橫座標, 縱座標)

參數

  • 橫座標, 縱座標
    整數型,需要接觸的點於目前旋轉座標系的座標

回傳值

  • 觸控事件
    觸控事件物件

說明

模擬手指接觸螢幕指定位置,並返回一個用於操縱本次觸控過程的觸控事件物件
目前函式座標值參數受 screen.init 函式初始化的座標系影響
注: 該函式會自動分配並佔用一個手指 id,手指 id 的數量是有限的 (大約 30 個) ,超出限制再呼叫 touch.ontouch.tap 會拋出 finger pool overflow 錯誤,注意不要同時佔用過多手指 id,及時呼叫 :off 方法釋放手指
該函式可同時使用以下方式呼叫(其中手指 ID必須是範圍在 1 ~ 29 的任意數字,這種方式要自行管理手指 id)

touch.on(手指 ID, 橫座標, 縱座標)

範例

-- 模擬一個手指於點 100, 100 的位置接觸屏幕,然後勻速滑動到點 200, 200 的位置,然後松開
touch.on(100, 100):move(200, 200):off()

touch.on(1, 100, 100) -- 模擬編號為 1 的手指於點 100, 100 的位置接觸屏幕
touch.off(1) -- 松開編號為 1 的手指