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...

TouchScreenButton

Eredita: Node2D < CanvasItem < Node < Object

Pulsante per dispositivi touch screen per l'utilizzo nel gioco.

Descrizione

TouchScreenButton consente di creare pulsanti sullo schermo per dispositivi touch. È pensato per l'uso nel gameplay, come un'unità che bisogna toccare per muoversi. A differenza di Button, TouchScreenButton supporta il multitouch pronto all'uso. È possibile premere più TouchScreenButton allo stesso tempo con gli input di tocco.

Questo nodo eredita da Node2D. A differenza dei nodi Control, non è possibile impostare ancore su di esso. Se vuoi creare menu o interfacce utente, potresti voler usare i nodi Button. Per far reagire i nodi pulsante agli eventi di tocco, puoi abilitare ProjectSettings.input_devices/pointing/emulate_mouse_from_touch nelle Impostazioni del progetto.

Puoi configurare TouchScreenButton in modo che sia visibile solo sui dispositivi touch, aiutandoti a sviluppare il tuo gioco sia per i desktop sia per i dispositivi mobili.

Proprietà

String	action	`""`
BitMap	bitmask
bool	passby_press	`false`
Shape2D	shape
bool	shape_centered	`true`
bool	shape_visible	`true`
Texture2D	texture_normal
Texture2D	texture_pressed
VisibilityMode	visibility_mode	`0`

Metodi

bool	is_pressed() const

Segnali

pressed() 🔗

Emesso quando il pulsante viene premuto.

released() 🔗

Emesso quando il pulsante viene rilasciato.

Enumerazioni

enum VisibilityMode: 🔗

VisibilityMode VISIBILITY_ALWAYS = 0

Sempre visibile.

VisibilityMode VISIBILITY_TOUCHSCREEN_ONLY = 1

Visibile solo sui touchscreen.

Descrizioni delle proprietà

String action = "" 🔗

void set_action(value: String)
String get_action()

L'azione del pulsante. Le azioni possono essere gestite con InputEventAction.

BitMap bitmask 🔗

void set_bitmask(value: BitMap)
BitMap get_bitmask()

La maschera di bit del pulsante.

bool passby_press = false 🔗

void set_passby_press(value: bool)
bool is_passby_press_enabled()

Se true, i segnali pressed e released sono emessi ogni volta che un dito premuto entra ed esce dal pulsante, anche se la pressione è iniziata all'esterno dell'area attiva del pulsante.

Nota: Questa è una modalità di pressione "pass-by" (non "bypass").

Shape2D shape 🔗

void set_shape(value: Shape2D)
Shape2D get_shape()

La forma del pulsante.

bool shape_centered = true 🔗

void set_shape_centered(value: bool)
bool is_shape_centered()

Se true, la forma del pulsante è centrata nella texture fornita. Se nessuna texture è utilizzata, questa proprietà non ha effetto.

bool shape_visible = true 🔗

void set_shape_visible(value: bool)
bool is_shape_visible()

Se true, la forma del pulsante è visibile nell'editor.

Texture2D texture_normal 🔗

void set_texture_normal(value: Texture2D)
Texture2D get_texture_normal()

La texture del pulsante per lo stato normale.

Texture2D texture_pressed 🔗

void set_texture_pressed(value: Texture2D)
Texture2D get_texture_pressed()

La texture del pulsante per lo stato premuto.

VisibilityMode visibility_mode = 0 🔗

void set_visibility_mode(value: VisibilityMode)
VisibilityMode get_visibility_mode()

La modalità di visibilità del pulsante.

Descrizioni dei metodi

bool is_pressed() const 🔗

Restituisce true se questo pulsante è attualmente premuto.