TouchScreenButton

Наследует: Node2D < CanvasItem < Node < Object

Кнопка для игрового процесса на устройствах с сенсорным экраном.

Описание

TouchScreenButton позволяет создавать экранные кнопки для сенсорных устройств. Он предназначен для использования в игровом процессе, например, в качестве юнита, которого нужно коснуться для перемещения. В отличие от Button, TouchScreenButton поддерживает мультитач из коробки. Несколько TouchScreenButton можно нажимать одновременно с помощью сенсорного ввода.

Этот узел наследуется от Node2D. В отличие от узлов Control, вы не можете устанавливать на нем якоря. Если вы хотите создать меню или пользовательские интерфейсы, вы можете вместо этого использовать узлы Button. Чтобы узлы кнопок реагировали на события касания, вы можете включить ProjectSettings.input_devices/pointing/emulate_mouse_from_touch в настройках проекта.

Вы можете настроить TouchScreenButton так, чтобы он был виден только на сенсорных устройствах, что поможет вам разрабатывать игру как для настольных компьютеров, так и для мобильных устройств.

Свойства

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

Методы

bool	is_pressed() const

---

Сигналы

pressed() 🔗

Издается при нажатии кнопки (вниз).

---

released() 🔗

Издается при отпускании кнопки (вверх).

---

Перечисления

enum VisibilityMode: 🔗

VisibilityMode VISIBILITY_ALWAYS = 0

Всегда видно.

VisibilityMode VISIBILITY_TOUCHSCREEN_ONLY = 1

Видно только на сенсорных экранах.

---

Описания свойств

String action = "" 🔗

• void set_action(value: String)

• String get_action()

Действие кнопки. Действия могут быть обработаны с помощью InputEventAction.

---

BitMap bitmask 🔗

• void set_bitmask(value: BitMap)

• BitMap get_bitmask()

Битмаска кнопки.

---

bool passby_press = false 🔗

• void set_passby_press(value: bool)

• bool is_passby_press_enabled()

Если true, сигналы press и release издаются всякий раз, когда нажатый палец входит и выходит из кнопки, даже если нажатие началось за пределами активной области кнопки.

Примечание: Это режим нажатия «pass-by» (не «bypass»).

---

Shape2D shape 🔗

• void set_shape(value: Shape2D)

• Shape2D get_shape()

Форма кнопки.

---

bool shape_centered = true 🔗

• void set_shape_centered(value: bool)

• bool is_shape_centered()

Если true, форма кнопки центрируется в предоставленной текстуре. Если текстура не используется, это свойство не имеет никакого эффекта.

---

bool shape_visible = true 🔗

• void set_shape_visible(value: bool)

• bool is_shape_visible()

Если true, форма кнопки будет видна в редакторе.

---

Texture2D texture_normal 🔗

• void set_texture_normal(value: Texture2D)

• Texture2D get_texture_normal()

Текстура кнопки для обычного состояния.

---

Texture2D texture_pressed 🔗

• void set_texture_pressed(value: Texture2D)

• Texture2D get_texture_pressed()

Текстура кнопки в нажатом состоянии.

---

VisibilityMode visibility_mode = 0 🔗

• void set_visibility_mode(value: VisibilityMode)

• VisibilityMode get_visibility_mode()

Режим видимости кнопки.

---

Описания метода

bool is_pressed() const 🔗

Возвращает true, если эта кнопка в данный момент нажата.