Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

InputEventAction

Hérite de : InputEvent < Resource < RefCounted < Object

Un type d’évènement d’entrée pour les actions.

Description

Contient une action générique qui peut être ciblée à partir de plusieurs types d'entrées. Les actions et leurs événements peuvent être définis dans l'onglet Contrôles dans Projet > Paramètres du projet, ou avec la classe InputMap.

Note : Contrairement aux autres sous-classes InputEvent qui s'associent à des événements physiques uniques, cette classe virtuelle n'est pas émise par le moteur. Cette classe est utile pour émettre des actions manuellement avec Input.parse_input_event(), qui sont ensuite reçues dans Node._input(). Pour vérifier si un événement physique correspond à une action de l'action map, utilisez InputEvent.is_action() et InputEvent.is_action_pressed().

Tutoriels

Propriétés

StringName

action

&""

int

event_index

-1

bool

pressed

false

float

strength

1.0


Descriptions des propriétés

StringName action = &"" 🔗

Le nom de l'action. Il s'agit généralement du nom d'une action existante dans l'InputMap avec laquelle vous voulez que cet événement personnalisé corresponde.


int event_index = -1 🔗

  • void set_event_index(value: int)

  • int get_event_index()

The real event index in action this event corresponds to (from events defined for this action in the InputMap). If -1, a unique ID will be used and actions pressed with this ID will need to be released with another InputEventAction.


bool pressed = false 🔗

  • void set_pressed(value: bool)

  • bool is_pressed()

Si true, l'état de l'action est appuyé. Si false, l'état de l'action est relâché.


float strength = 1.0 🔗

  • void set_strength(value: float)

  • float get_strength()

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 specifying how strongly the joypad axis is bent or pressed.