TouchScreenButton

Hereda: Node2D < CanvasItem < Node < Object

Botón para dispositivos de pantalla táctil para uso en juegos.

Descripción

TouchScreenButton te permite crear botones en pantalla para dispositivos táctiles. Está pensado para su uso en el juego, como una unidad que tienes que tocar para mover. A diferencia de Button, TouchScreenButton soporta multi-táctil de fábrica. Se pueden pulsar varios TouchScreenButtons al mismo tiempo con la entrada táctil.

Este nodo hereda de Node2D. A diferencia de los nodos Control, no puedes fijar anclajes en él. Si quieres crear menús o interfaces de usuario, puede que quieras usar nodos Button en su lugar. Para hacer que los nodos de botón reaccionen a los eventos táctiles, puedes activar ProjectSettings.input_devices/pointing/emulate_mouse_from_touch en la Configuración del Proyecto.

Puedes configurar TouchScreenButton para que sea visible sólo en dispositivos táctiles, ayudándote a desarrollar tu juego tanto para ordenadores de escritorio como para dispositivos móviles.

Propiedades

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

Métodos

bool	is_pressed() const

---

Señales

pressed() 🔗

Emitida cuando se presiona el botón (abajo).

---

released() 🔗

Emitida cuando se suelta el botón (arriba).

---

Enumeraciones

enum VisibilityMode: 🔗

VisibilityMode VISIBILITY_ALWAYS = 0

Siempre visible.

VisibilityMode VISIBILITY_TOUCHSCREEN_ONLY = 1

Visible sólo en las pantallas táctiles.

---

Descripciones de Propiedades

String action = "" 🔗

• void set_action(value: String)

• String get_action()

La acción del botón. Las acciones se pueden manejar con InputEventAction.

---

BitMap bitmask 🔗

• void set_bitmask(value: BitMap)

• BitMap get_bitmask()

La máscara del botón.

---

bool passby_press = false 🔗

• void set_passby_press(value: bool)

• bool is_passby_press_enabled()

Si es true, las señales pressed y released se emiten cada vez que un dedo presionado entra y sale del botón, incluso si la presión comenzó fuera del área activa del botón.

Nota: Este es un modo de presión de "pasar por" (no "pasar por alto").

---

Shape2D shape 🔗

• void set_shape(value: Shape2D)

• Shape2D get_shape()

La forma del botón.

---

bool shape_centered = true 🔗

• void set_shape_centered(value: bool)

• bool is_shape_centered()

Si es true, la forma del botón se centra en la textura proporcionada. Si no se utiliza ninguna textura, esta propiedad no tiene ningún efecto.

---

bool shape_visible = true 🔗

• void set_shape_visible(value: bool)

• bool is_shape_visible()

Si es true, la forma del botón es visible en el editor.

---

Texture2D texture_normal 🔗

• void set_texture_normal(value: Texture2D)

• Texture2D get_texture_normal()

La textura del botón para el estado normal.

---

Texture2D texture_pressed 🔗

• void set_texture_pressed(value: Texture2D)

• Texture2D get_texture_pressed()

La textura del botón para el estado presionado.

---

VisibilityMode visibility_mode = 0 🔗

• void set_visibility_mode(value: VisibilityMode)

• VisibilityMode get_visibility_mode()

Modo de visibilidad del botón.

---

Descripciones de Métodos

bool is_pressed() const 🔗

Devuelve true si este botón está actualmente pulsado.