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

TextureButton

Eredita: BaseButton < Control < CanvasItem < Node < Object

Un pulsante visualizzato con una texture. Supporta gli stati Premuto, Passante, Disabilitato e Focalizzato.

Descrizione

TextureButton ha la stessa funzionalità di Button, eccetto che usa gli sprite invece della risorsa Theme di Godot. È più veloce da creare, ma non supporta la localizzazione come i Control più complessi.

Vedi anche BaseButton che contiene le proprietà e i metodi comuni associati a questo nodo.

Nota: Si consiglia di impostare una texture per lo stato "normale" (texture_normal). Se texture_normal non è impostato, TextureButton riceverà comunque eventi di input e sarà cliccabile, ma l'utente non sarà in grado di vederlo a meno che non attivi un altro dei suoi stati con una texture assegnata (ad esempio, passandoci sopra il mouse per visualizzare texture_hover).

Tutorial

Demo di voxel 3D

Proprietà

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

Enumerazioni

enum StretchMode: 🔗

StretchMode STRETCH_SCALE = 0

Ridimensiona la texture per adattarla al rettangolo di delimitazione del nodo.

StretchMode STRETCH_TILE = 1

Ripeti all'interno del rettangolo di delimitazione del nodo.

StretchMode STRETCH_KEEP = 2

La texture mantiene le sue dimensioni originali e rimane nell'angolo in alto a sinistra del rettangolo di delimitazione.

StretchMode STRETCH_KEEP_CENTERED = 3

La texture mantiene le sue dimensioni originali e centrata nel rettangolo di delimitazione del nodo.

StretchMode STRETCH_KEEP_ASPECT = 4

Ridimensiona la texture per adattarla al rettangolo di delimitazione del nodo, ma mantiene le proporzioni della texture.

StretchMode STRETCH_KEEP_ASPECT_CENTERED = 5

Ridimensiona la texture per adattarla al rettangolo di delimitazione del nodo, la centra, e mantiene le proporzioni della texture.

StretchMode STRETCH_KEEP_ASPECT_COVERED = 6

Ridimensiona la texture in modo che il lato più corto si adatti al rettangolo di delimitazione. L'altro lato si adatta ai limiti del nodo.

Descrizioni delle proprietà

bool flip_h = false 🔗

void set_flip_h(value: bool)
bool is_flipped_h()

Se true, la texture è capovolta orizzontalmente.

bool flip_v = false 🔗

void set_flip_v(value: bool)
bool is_flipped_v()

Se true, la texture è capovolta verticalmente.

bool ignore_texture_size = false 🔗

void set_ignore_texture_size(value: bool)
bool get_ignore_texture_size()

Se true, la dimensione della texture non sarà considerata per il calcolo della dimensione minima, quindi il TextureButton può essere ridotto oltre la dimensione della texture.

StretchMode stretch_mode = 2 🔗

void set_stretch_mode(value: StretchMode)
StretchMode get_stretch_mode()

Controlla il comportamento della texture quando si ridimensiona il rettangolo di delimitazione del nodo. Vedi le costanti di StretchMode per le opzioni disponibili.

BitMap texture_click_mask 🔗

void set_click_mask(value: BitMap)
BitMap get_click_mask()

Immagine BitMap in puro bianco e nero da usare per il rilevamento dei clic. Sulla maschera, i pixel bianchi rappresentano l'area cliccabile del pulsante. Usalo per creare pulsanti con forme curve.

Texture2D texture_disabled 🔗

void set_texture_disabled(value: Texture2D)
Texture2D get_texture_disabled()

La texture da visualizzare quando il nodo è disabilitato. Vedi BaseButton.disabled. Se non assegnato, il TextureButton visualizza invece texture_normal.

Texture2D texture_focused 🔗

void set_texture_focused(value: Texture2D)
Texture2D get_texture_focused()

La texture da sovrapporre alla texture di base quando il nodo ha il focus del mouse o della tastiera. Poiché texture_focused viene visualizzato sopra la texture di base, si dovrebbe usare una texture parzialmente trasparente per garantire che la texture di base resti visibile. Una texture che rappresenta un contorno o una sottolineatura funziona bene per questo scopo. Per disabilitare l'effetto visivo del focus, assegna una texture totalmente trasparente di qualunque dimensione. Tieni presente che disattivare l'effetto visivo di focus ridurrà l'usabilità della navigazione tramite tastiera o controller, perciò non è consigliato per motivi di accessibilità.

Texture2D texture_hover 🔗

void set_texture_hover(value: Texture2D)
Texture2D get_texture_hover()

Texture da visualizzare quando il mouse passa sopra il nodo. Se non assegnato, TextureButton visualizza invece texture_normal quando ci si passa sopra.

Texture2D texture_normal 🔗

void set_texture_normal(value: Texture2D)
Texture2D get_texture_normal()

La texture predefinita da visualizzare, quando il nodo non è in stato disabilitato, passante o premuto. Questa texture è ancora visualizzata nello stato focalizzato, con texture_focused disegnata sopra.

Texture2D texture_pressed 🔗

void set_texture_pressed(value: Texture2D)
Texture2D get_texture_pressed()

La texture da visualizzare quando si passa il mouse sul nodo, se il nodo ha il focus sulla tastiera e l'utente preme il tasto Invio oppure se l'utente preme il tasto BaseButton.shortcut. Se non assegnato, il TextureButton visualizza invece texture_normal.