TextureButton

Успадковує: BaseButton < Control < CanvasItem < Node < Object

Кнопка на основі тексту. Підтримує пресовані, концентровані та фокусовані стани.

Опис

TextureButton має ті самі функції, що й Button, за винятком того, що він використовує спрайти замість ресурсу Godot Theme. Його швидше створити, але він не підтримує локалізацію, як більш складні Control.

Дивіться також BaseButton, який містить загальні властивості та методи, пов’язані з цим вузлом.

Примітка: Рекомендується встановити текстуру для «нормального» стану (texture_normal). Якщо texture_normal не встановлено, TextureButton все одно отримуватиме події введення та буде доступним для натискання, але користувач не зможе побачити його, доки не активує інший із його станів із призначеною текстурою (наприклад, наведіть на нього курсор, щоб показати texture_hover).

Посібники

Демонстрація 3D вокселів

Властивості

bool	flip_h	`false`
bool	flip_v	`false`
bool	ignore_texture_size	`false`
StretchMode	stretch_mode	`2`
BitMap	texture_click_mask
Texture2D	texture_disabled
Texture2D	texture_focused
Texture2D	texture_hover
Texture2D	texture_normal
Texture2D	texture_pressed

Переліки

enum StretchMode: 🔗

StretchMode STRETCH_SCALE = 0

Ваги, щоб відповідати прямокутника вузла.

StretchMode STRETCH_TILE = 1

Підібрати всередині вузла, що межує прямокутник.

StretchMode STRETCH_KEEP = 2

Текстура зберігає свій оригінальний розмір і залишається в межі верхнього кута прямокутника.

StretchMode STRETCH_KEEP_CENTERED = 3

Текстура зберігає свій оригінальний розмір і залишається в центрі уваги вершини прямокутника.

StretchMode STRETCH_KEEP_ASPECT = 4

Ваги текстури, щоб відповідати прямокутника вершини, але підтримувати співвідношення фактури.

StretchMode STRETCH_KEEP_ASPECT_CENTERED = 5

Ваги текстури, щоб відповідати прямокутника вершини, його центр і підтримувати його співвідношення сторін.

StretchMode STRETCH_KEEP_ASPECT_COVERED = 6

Ваги текстури так, щоб коротша сторона підіймала прямокутник. З іншого боку кліпи на межі вершини.

Описи властивостей

bool flip_h = false 🔗

void set_flip_h(value: bool)
bool is_flipped_h()

Якщо true, текстура віддзеркалюється горизонтально.

bool flip_v = false 🔗

void set_flip_v(value: bool)
bool is_flipped_v()

Якщо true, текстура віддзеркалюється вертикально.

bool ignore_texture_size = false 🔗

void set_ignore_texture_size(value: bool)
bool get_ignore_texture_size()

Якщо true, розмір текстури не буде вважатися для розрахунку мінімального розміру, тому TextureButton може бути об'ємним, минулим розміром текстури.

StretchMode stretch_mode = 2 🔗

void set_stretch_mode(value: StretchMode)
StretchMode get_stretch_mode()

Керує поведінкою текстури при зміні кута нахилу вузла. Дивитися StretchMode константи для доступних варіантів.

BitMap texture_click_mask 🔗

void set_click_mask(value: BitMap)
BitMap get_click_mask()

Чистий чорний і білий BitMap зображення для використання для виявлення натискань. На масці білі пікселі представляють натискну площу кнопки. Використовуйте його для створення кнопок з вигнутими формами.

Texture2D texture_disabled 🔗

void set_texture_disabled(value: Texture2D)
Texture2D get_texture_disabled()

Текстура для відображення, коли вузол вимкнено. Див. BaseButton.disabled. Якщо не призначено, TextureButton замість цього відображає texture_normal.

Texture2D texture_focused 🔗

void set_texture_focused(value: Texture2D)
Texture2D get_texture_focused()

Текстура накладається на базову текстуру, коли вузол має фокус миші чи клавіатури. Оскільки texture_focused відображається поверх базової текстури, слід використовувати частково прозору текстуру, щоб забезпечити видимість базової текстури. Для цієї мети добре підходить текстура, яка представляє контур або підкреслення. Щоб вимкнути візуальний ефект фокусування, призначте повністю прозору текстуру будь-якого розміру. Зауважте, що вимкнення візуального ефекту фокусування зашкодить зручності навігації клавіатурою/контролером, тому це не рекомендується з міркувань доступності.

Texture2D texture_hover 🔗

void set_texture_hover(value: Texture2D)
Texture2D get_texture_hover()

Текстура для відображення, коли миша наводиться на вузол. Якщо не призначено, TextureButton замість цього відображає texture_normal при наведенні курсора.

Texture2D texture_normal 🔗

void set_texture_normal(value: Texture2D)
Texture2D get_texture_normal()

Текстура, яка відображатиметься за замовчуванням, коли вузол не вимкнено, не наведено курсор або не натиснуто. Ця текстура все ще відображається у сфокусованому стані, а зверху намальовано texture_focused.

Texture2D texture_pressed 🔗

void set_texture_pressed(value: Texture2D)
Texture2D get_texture_pressed()

Текстура для відображення при наведенні миші на вузол, якщо вузол має фокус клавіатури, а гравець натискає клавішу Enter або якщо гравець натискає клавішу BaseButton.shortcut. Якщо не призначено, TextureButton замість нього відображається texture_hover.