========
滑鼠控制
========

AutoControl 提供模擬滑鼠操作的功能，包括點擊、定位、捲動及拖曳操作。

取得滑鼠按鍵表
==============

取得所有可用的滑鼠按鍵名稱：

.. code-block:: python

   from je_auto_control import mouse_table

   print(mouse_table)

.. tip::

   完整的滑鼠按鍵列表請參考 :doc:`/API/special/mouse_keys`。

按下與釋放
==========

按住滑鼠按鍵，延遲後釋放：

.. code-block:: python

   from time import sleep
   from je_auto_control import press_mouse, release_mouse

   press_mouse("mouse_right")
   sleep(1)
   release_mouse("mouse_right")

點擊
====

按下並立即釋放滑鼠按鍵：

.. code-block:: python

   from je_auto_control import click_mouse

   # 在目前位置右鍵點擊
   click_mouse("mouse_right")

   # 在指定座標左鍵點擊
   click_mouse("mouse_left", x=500, y=300)

游標位置
========

取得及設定滑鼠游標位置：

.. code-block:: python

   from je_auto_control import get_mouse_position, set_mouse_position

   # 取得目前位置
   x, y = get_mouse_position()
   print(f"滑鼠位置: ({x}, {y})")

   # 移動滑鼠到 (100, 100)
   set_mouse_position(100, 100)

捲動
====

捲動滑鼠滾輪：

.. code-block:: python

   from je_auto_control import mouse_scroll

   # 向下捲動 5 個單位
   mouse_scroll(scroll_value=5)

.. note::

   在 Linux 上，可以使用 ``scroll_direction`` 參數指定捲動方向：
   ``"scroll_up"``、``"scroll_down"``、``"scroll_left"``、``"scroll_right"``。