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, сигнали pressed та released випромінюються щоразу, коли натиснутий палець входить у кнопку та виходить з неї, навіть якщо тиск почався поза активною зоною кнопки.

Примітка: Це режим натискання "пропуску" (не "обходу").

---

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, якщо ця кнопка в даний час натискається.