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.
Checking the stable version of the documentation...
InputEvent
Eredita: Resource < RefCounted < Object
Ereditato da: InputEventAction, InputEventFromWindow, InputEventJoypadButton, InputEventJoypadMotion, InputEventMIDI, InputEventShortcut
Classe base astratta per gli eventi di input.
Descrizione
Classe base astratta per tutti i tipi di eventi di input. Vedi Node._input().
Tutorial
Proprietà
|
Metodi
accumulate(with_event: InputEvent) |
|
as_text() const |
|
get_action_strength(action: StringName, exact_match: bool = false) const |
|
is_action(action: StringName, exact_match: bool = false) const |
|
is_action_pressed(action: StringName, allow_echo: bool = false, exact_match: bool = false) const |
|
is_action_released(action: StringName, exact_match: bool = false) const |
|
is_action_type() const |
|
is_canceled() const |
|
is_echo() const |
|
is_match(event: InputEvent, exact_match: bool = true) const |
|
is_pressed() const |
|
is_released() const |
|
xformed_by(xform: Transform2D, local_ofs: Vector2 = Vector2(0, 0)) const |
Costanti
DEVICE_ID_EMULATION = -1 🔗
ID dispositivo utilizzato per l'input del mouse emulato da un touchscreen o per l'input touch emulato da un mouse. Può essere utilizzato per distinguere l'input del mouse emulato dall'input del mouse fisico o l'input touch emulato dall'input touch fisico.
DEVICE_ID_KEYBOARD = 16 🔗
ID di dispositivo per l'input proveniente da una tastiera. Può servire per distinguere gli eventi di input da tastiera dagli eventi di input da joypad.
DEVICE_ID_MOUSE = 32 🔗
ID di dispositivo per l'input proveniente da un mouse. Può servire per distinguere gli eventi di input da mouse dagli eventi di input da joypad.
Descrizioni delle proprietà
ID dispositivo dell'evento.
Nota: device può essere negativo per casi d'uso speciali che non fanno riferimento a dispositivi fisicamente presenti sul sistema. Vedi DEVICE_ID_EMULATION.
Descrizioni dei metodi
bool accumulate(with_event: InputEvent) 🔗
Restituisce true se l'evento di input specificato e questo evento di input possono essere sommati (solo per gli eventi di tipo InputEventMouseMotion).
La posizione, la posizione globale e la velocità dell'evento di input specificato verranno copiate. Il relative risultante è una somma di entrambi gli eventi. I modificatori di entrambi gli eventi devono essere identici.
Restituisce una rappresentazione String dell'evento.
float get_action_strength(action: StringName, exact_match: bool = false) const 🔗
Restituisce un valore compreso tra 0,0 e 1,0 a seconda dello stato delle azioni specificate. Utile per ottenere il valore degli eventi di tipo InputEventJoypadMotion.
Se exact_match è false, ignora i modificatori di input aggiuntivi per gli eventi InputEventKey e InputEventMouseButton e la direzione per gli eventi InputEventJoypadMotion.
bool is_action(action: StringName, exact_match: bool = false) const 🔗
Restituisce true se questo evento di input corrisponde a un'azione predefinita di qualsiasi tipo.
Se exact_match è false, ignora ulteriori modificatori di input per gli eventi InputEventKey e InputEventMouseButton e la direzione per gli eventi InputEventJoypadMotion.
bool is_action_pressed(action: StringName, allow_echo: bool = false, exact_match: bool = false) const 🔗
Restituisce true se l'azione specificata corrisponde a questo evento ed è premuta (e non è un evento eco per gli eventi InputEventKey, a meno che allow_echo non sia true). Non rilevante per gli eventi di tipo InputEventMouseMotion o InputEventScreenDrag.
Se exact_match è false, ignora i modificatori di input aggiuntivi per gli eventi InputEventKey e InputEventMouseButton e la direzione per gli eventi InputEventJoypadMotion.
Nota: A causa di ghosting per la tastiera, is_action_pressed() potrebbe restituire false anche se viene premuto uno dei tasti dell'azione. Per maggiori informazioni, vedi Esempi di input nella documentazione.
bool is_action_released(action: StringName, exact_match: bool = false) const 🔗
Restituisce true se l'azione specificata corrisponde a questo evento ed è rilasciata (ossia non premuta). Non rilevante per eventi di tipo InputEventMouseMotion o InputEventScreenDrag.
Se exact_match è false, ignora i modificatori di input aggiuntivi per gli eventi InputEventKey e InputEventMouseButton e la direzione per gli eventi InputEventJoypadMotion.
Restituisce true se il tipo di questo evento di input è uno che si può assegnare a un'azione di input: InputEventKey, InputEventMouseButton, InputEventJoypadButton, InputEventJoypadMotion, InputEventAction. Restituisce false per tutti gli altri tipi di evento di input.
Restituisce true se questo evento di input è stato cancellato.
Restituisce true se questo evento di input è un evento eco (solo per eventi di tipo InputEventKey). Un evento eco è un evento da un tasto ripetuto inviato quando l'utente tiene premuto il tasto. Qualsiasi altro tipo di evento restituisce false.
Nota: La frequenza con cui sono inviati gli eventi eco è in genere di circa 20 eventi al secondo (dopo aver tenuto premuto il tasto per circa mezzo secondo). Tuttavia, il ritardo/velocità di ripetizione del tasto può essere modificato dall'utente o disabilitato completamente nelle impostazioni del sistema operativo. Per garantire che il progetto funzioni correttamente su tutte le configurazioni, non dare per scontato che l'utente abbia una configurazione di ripetizione del tasto specifica nel comportamento del progetto.
bool is_match(event: InputEvent, exact_match: bool = true) const 🔗
Restituisce true se l'evento event corrisponde a questo evento. Valido solo per gli eventi d'azione, ovvero eventi da tasti (InputEventKey), pulsanti (InputEventMouseButton o InputEventJoypadButton), assi InputEventJoypadMotion o azioni (InputEventAction).
Se exact_match è false, ignora i modificatori di input aggiuntivi per gli eventi InputEventKey e InputEventMouseButton e la direzione per gli eventi InputEventJoypadMotion.
Nota: Questo metodo considera solo la configurazione dell'evento (ad esempio il tasto della tastiera o l'asse del joypad), non le informazioni sullo stato come is_pressed(), is_released(), is_echo() o is_canceled().
Restituisce true se questo evento di input è premuto. Non rilevante per eventi di tipo InputEventMouseMotion o InputEventScreenDrag.
Nota: A causa del ghosting della tastiera, is_pressed() potrebbe restituire false anche se è premuto uno dei tasti dell'azione. Per maggiori informazioni, vedi Esempi di input nella documentazione.
Restituisce true se questo evento di input è rilasciato. Non applicabile per gli eventi di tipo InputEventMouseMotion o InputEventScreenDrag.
InputEvent xformed_by(xform: Transform2D, local_ofs: Vector2 = Vector2(0, 0)) const 🔗
Restituisce una copia dell'evento di input specificato che è stato compensato da local_ofs e trasformato da xform. Applicabile per eventi di tipo InputEventMouseButton, InputEventMouseMotion, InputEventScreenTouch, InputEventScreenDrag, InputEventMagnifyGesture e InputEventPanGesture.