物件
滑鼠事件
Published 2023年11月7日
Mouse Event 行為會監聽外接硬體滑鼠或觸控式軌跡板的事件,並在收到事件後觸發行為。
⚠️ 警告:此功能僅在 iOS 14.0 及以上版本獲得完整支援。
| 事件類型 | 說明 |
| 按下左鍵時 |
按下左鍵時觸發事件。預設是在按下時觸發,但可以改為在放開時觸發。 |
| 按下右鍵時 |
按下右鍵時觸發事件。 在 Apple 支援的觸控式軌跡板上以兩指按下,會視為按下右鍵。預設是在按下時觸發,但可以改為在放開時觸發。 |
| 移動時 |
滑鼠移動時觸發事件。此事件會輸出滑鼠位置,以及滑鼠在x 軸和y 軸上移動的原始量。 |
| 連線時 |
連接硬體滑鼠或觸控式軌跡板時觸發事件。 |
| 中斷連線時 |
硬體滑鼠或觸控式軌跡板中斷連線時觸發事件。 |
| 輸出欄位 | 說明 |
| x |
收到事件時,滑鼠在螢幕座標空間中的目前水平位置。單位為公尺。 |
| y |
收到事件時,滑鼠在螢幕座標空間中的目前垂直位置。 單位為公尺。 |
| dx |
滑鼠在水平方向移動的原始量。 |
| dy |
滑鼠在垂直方向移動的原始量。 |
| vendor |
外接滑鼠或觸控式軌跡板的廠商名稱。 例如:"Magic Keyboard"。 |
範例:成功連線
成功註冊滑鼠後,變更物件的顏色並顯示滑鼠資訊,讓使用者知道滑鼠已連線。
範例:滑鼠指標
每當滑鼠移動時,物件就會移動到滑鼠所在的位置,呈現滑鼠正在控制該物件的效果。

