mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
152 lines
6.7 KiB
ReStructuredText
152 lines
6.7 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. meta::
|
||
:keywords: click, press
|
||
|
||
.. _class_InputEventMouseButton:
|
||
|
||
InputEventMouseButton
|
||
=====================
|
||
|
||
**继承：** :ref:`InputEventMouse<class_InputEventMouse>` **<** :ref:`InputEventWithModifiers<class_InputEventWithModifiers>` **<** :ref:`InputEventFromWindow<class_InputEventFromWindow>` **<** :ref:`InputEvent<class_InputEvent>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
||
|
||
代表某个鼠标按键被按下或松开。
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
描述
|
||
----
|
||
|
||
存储与鼠标点击事件相关的信息。见 :ref:`Node._input()<class_Node_private_method__input>`\ 。
|
||
|
||
\ **注意：**\ 在 Wear OS 设备上，旋钮输入会被映射到 :ref:`@GlobalScope.MOUSE_BUTTON_WHEEL_UP<class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_UP>` 和 :ref:`@GlobalScope.MOUSE_BUTTON_WHEEL_DOWN<class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_DOWN>`\ 。可以使用 :ref:`ProjectSettings.input_devices/pointing/android/rotary_input_scroll_axis<class_ProjectSettings_property_input_devices/pointing/android/rotary_input_scroll_axis>` 设置将其修改为 :ref:`@GlobalScope.MOUSE_BUTTON_WHEEL_LEFT<class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_LEFT>` 和 :ref:`@GlobalScope.MOUSE_BUTTON_WHEEL_RIGHT<class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_RIGHT>`\ 。
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
教程
|
||
----
|
||
|
||
- :doc:`使用 InputEvent <../tutorials/inputs/inputevent>`
|
||
|
||
- :doc:`鼠标和输入坐标 <../tutorials/inputs/mouse_and_input_coordinates>`
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
属性
|
||
----
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+---------------------------------------------------+------------------------------------------------------------------------+-----------+
|
||
| :ref:`MouseButton<enum_@GlobalScope_MouseButton>` | :ref:`button_index<class_InputEventMouseButton_property_button_index>` | ``0`` |
|
||
+---------------------------------------------------+------------------------------------------------------------------------+-----------+
|
||
| :ref:`bool<class_bool>` | :ref:`canceled<class_InputEventMouseButton_property_canceled>` | ``false`` |
|
||
+---------------------------------------------------+------------------------------------------------------------------------+-----------+
|
||
| :ref:`bool<class_bool>` | :ref:`double_click<class_InputEventMouseButton_property_double_click>` | ``false`` |
|
||
+---------------------------------------------------+------------------------------------------------------------------------+-----------+
|
||
| :ref:`float<class_float>` | :ref:`factor<class_InputEventMouseButton_property_factor>` | ``1.0`` |
|
||
+---------------------------------------------------+------------------------------------------------------------------------+-----------+
|
||
| :ref:`bool<class_bool>` | :ref:`pressed<class_InputEventMouseButton_property_pressed>` | ``false`` |
|
||
+---------------------------------------------------+------------------------------------------------------------------------+-----------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
属性说明
|
||
--------
|
||
|
||
.. _class_InputEventMouseButton_property_button_index:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`MouseButton<enum_@GlobalScope_MouseButton>` **button_index** = ``0`` :ref:`🔗<class_InputEventMouseButton_property_button_index>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_button_index**\ (\ value\: :ref:`MouseButton<enum_@GlobalScope_MouseButton>`\ )
|
||
- :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **get_button_index**\ (\ )
|
||
|
||
鼠标按键标识符，\ :ref:`MouseButton<enum_@GlobalScope_MouseButton>` 按钮或按钮滚轮常量。
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_InputEventMouseButton_property_canceled:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **canceled** = ``false`` :ref:`🔗<class_InputEventMouseButton_property_canceled>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_canceled**\ (\ value\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **is_canceled**\ (\ )
|
||
|
||
如果为 ``true``\ ，则鼠标按键事件被取消。
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_InputEventMouseButton_property_double_click:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **double_click** = ``false`` :ref:`🔗<class_InputEventMouseButton_property_double_click>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_double_click**\ (\ value\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **is_double_click**\ (\ )
|
||
|
||
如果为 ``true``\ ，则鼠标按键的状态是双击。
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_InputEventMouseButton_property_factor:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **factor** = ``1.0`` :ref:`🔗<class_InputEventMouseButton_property_factor>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_factor**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_factor**\ (\ )
|
||
|
||
事件的数量（或 delta）。当用于高精度滚动事件时，这表示滚动量（垂直或水平）。这只在一些平台上被支持；报告的灵敏度因平台不同而不同。如果不支持，可能是\ ``0``\ 。
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_InputEventMouseButton_property_pressed:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **pressed** = ``false`` :ref:`🔗<class_InputEventMouseButton_property_pressed>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_pressed**\ (\ value\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **is_pressed**\ (\ )
|
||
|
||
如果为 ``true``\ ，鼠标按键的状态为按下。如果为 ``false``\ ，鼠标按钮的状态被释放。
|
||
|
||
.. |virtual| replace:: :abbr:`virtual (本方法通常需要用户覆盖才能生效。)`
|
||
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
|
||
.. |const| replace:: :abbr:`const (本方法无副作用，不会修改该实例的任何成员变量。)`
|
||
.. |vararg| replace:: :abbr:`vararg (本方法除了能接受在此处描述的参数外，还能够继续接受任意数量的参数。)`
|
||
.. |constructor| replace:: :abbr:`constructor (本方法用于构造某个类型。)`
|
||
.. |static| replace:: :abbr:`static (调用本方法无需实例，可直接使用类名进行调用。)`
|
||
.. |operator| replace:: :abbr:`operator (本方法描述的是使用本类型作为左操作数的有效运算符。)`
|
||
.. |bitfield| replace:: :abbr:`BitField (这个值是由下列位标志构成位掩码的整数。)`
|
||
.. |void| replace:: :abbr:`void (无返回值。)`
|