class_inputeventaction.rst 3.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the InputEventAction.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_InputEventAction:
  6. InputEventAction
  7. ================
  8. **Inherits:** :ref:`InputEvent<class_InputEvent>` **<** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
  9. Input event type for actions.
  10. Description
  11. -----------
  12. Contains a generic action which can be targeted from several types of inputs. Actions can be created from the **Input Map** tab in the **Project > Project Settings** menu. See :ref:`Node._input<class_Node_method__input>`.
  13. Tutorials
  14. ---------
  15. - `#actions <../tutorials/inputs/inputevent.html#actions>`_ in :doc:`../tutorials/inputs/inputevent`
  16. Properties
  17. ----------
  18. +-----------------------------+-----------------------------------------------------------+-----------+
  19. | :ref:`String<class_String>` | :ref:`action<class_InputEventAction_property_action>` | ``""`` |
  20. +-----------------------------+-----------------------------------------------------------+-----------+
  21. | :ref:`bool<class_bool>` | :ref:`pressed<class_InputEventAction_property_pressed>` | ``false`` |
  22. +-----------------------------+-----------------------------------------------------------+-----------+
  23. | :ref:`float<class_float>` | :ref:`strength<class_InputEventAction_property_strength>` | ``1.0`` |
  24. +-----------------------------+-----------------------------------------------------------+-----------+
  25. Property Descriptions
  26. ---------------------
  27. .. _class_InputEventAction_property_action:
  28. - :ref:`String<class_String>` **action**
  29. +-----------+-------------------+
  30. | *Default* | ``""`` |
  31. +-----------+-------------------+
  32. | *Setter* | set_action(value) |
  33. +-----------+-------------------+
  34. | *Getter* | get_action() |
  35. +-----------+-------------------+
  36. The action's name. Actions are accessed via this :ref:`String<class_String>`.
  37. ----
  38. .. _class_InputEventAction_property_pressed:
  39. - :ref:`bool<class_bool>` **pressed**
  40. +-----------+--------------------+
  41. | *Default* | ``false`` |
  42. +-----------+--------------------+
  43. | *Setter* | set_pressed(value) |
  44. +-----------+--------------------+
  45. | *Getter* | is_pressed() |
  46. +-----------+--------------------+
  47. If ``true``, the action's state is pressed. If ``false``, the action's state is released.
  48. ----
  49. .. _class_InputEventAction_property_strength:
  50. - :ref:`float<class_float>` **strength**
  51. +-----------+---------------------+
  52. | *Default* | ``1.0`` |
  53. +-----------+---------------------+
  54. | *Setter* | set_strength(value) |
  55. +-----------+---------------------+
  56. | *Getter* | get_strength() |
  57. +-----------+---------------------+
  58. The action's strength between 0 and 1. This value is considered as equal to 0 if pressed is ``false``. The event strength allows faking analog joypad motion events, by precising how strongly is the joypad axis bent or pressed.
  59. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  60. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  61. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`