TextureButton

Hereda: BaseButton < Control < CanvasItem < Node < Object

Botón basado en la textura. Soporta los estados de Presionado, Cursor Encima, Desactivado y Enfocado.

Descripción

TextureButton tiene la misma funcionalidad que Button, excepto que utiliza sprites en lugar del recurso Theme de Godot. Es más rápido de crear, pero no soporta la localización como los Controls más complejos.

Véase también BaseButton, que contiene propiedades y métodos comunes asociados a este nodo.

Nota: Se recomienda establecer una textura para el estado "normal" (texture_normal). Si no se establece texture_normal, TextureButton seguirá recibiendo eventos de entrada y se podrá hacer clic en él, pero el usuario no podrá verlo a menos que active otro de sus estados con una textura asignada (por ejemplo, pasar el ratón por encima para mostrar texture_hover).

Tutoriales

Demo de Vóxeles en 3D

Propiedades

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

Enumeraciones

enum StretchMode: 🔗

StretchMode STRETCH_SCALE = 0

Escala para ajustarse al rectángulo delimitador del nodo.

StretchMode STRETCH_TILE = 1

Tile dentro del rectángulo delimitador del nodo.

StretchMode STRETCH_KEEP = 2

La textura mantiene su tamaño original y se mantiene en la esquina superior izquierda del rectángulo delimitador.

StretchMode STRETCH_KEEP_CENTERED = 3

La textura mantiene su tamaño original y permanece centrado en el rectángulo delimitador del nodo.

StretchMode STRETCH_KEEP_ASPECT = 4

Escala la textura para que se ajuste al rectángulo delimitador del nodo, pero mantén la relación de aspecto de la textura.

StretchMode STRETCH_KEEP_ASPECT_CENTERED = 5

Escala la textura para que se ajuste al rectángulo delimitador del nodo, la centra y mantiene su relación de aspecto.

StretchMode STRETCH_KEEP_ASPECT_COVERED = 6

Escala la textura para que el lado más corto se ajuste al rectángulo delimitador. El otro lado se ajusta a los límites del nodo.

Descripciones de Propiedades

bool flip_h = false 🔗

void set_flip_h(value: bool)
bool is_flipped_h()

Si es true, la textura se voltea horizontalmente.

bool flip_v = false 🔗

void set_flip_v(value: bool)
bool is_flipped_v()

Si es true, la textura se voltea verticalmente.

bool ignore_texture_size = false 🔗

void set_ignore_texture_size(value: bool)
bool get_ignore_texture_size()

Si es true, el tamaño de la textura no se considerará para el cálculo del tamaño mínimo, por lo que el TextureButton puede ser reducido más allá del tamaño de la textura.

StretchMode stretch_mode = 2 🔗

void set_stretch_mode(value: StretchMode)
StretchMode get_stretch_mode()

Controla el comportamiento de la textura al redimensionar el rectángulo delimitador del nodo. Consulta las constantes StretchMode para ver las opciones disponibles.

BitMap texture_click_mask 🔗

void set_click_mask(value: BitMap)
BitMap get_click_mask()

Imagen en blanco y negro puro BitMap para usar en la detección de clics. En la máscara, los píxeles blancos representan el área donde se puede hacer clic en el botón. Úsalo para crear botones con formas curvas.

Texture2D texture_disabled 🔗

void set_texture_disabled(value: Texture2D)
Texture2D get_texture_disabled()

Textura a mostrar cuando el nodo está deshabilitado. Véase BaseButton.disabled. Si no se asigna, el TextureButton muestra texture_normal en su lugar.

Texture2D texture_focused 🔗

void set_texture_focused(value: Texture2D)
Texture2D get_texture_focused()

Textura a superponer sobre la textura base cuando el nodo tiene el foco del ratón o del teclado. Debido a que texture_focused se muestra encima de la textura base, se debe usar una textura parcialmente transparente para asegurar que la textura base permanezca visible. Una textura que represente un contorno o un subrayado funciona bien para este propósito. Para desactivar el efecto visual de foco, asigna una textura totalmente transparente de cualquier tamaño. Ten en cuenta que desactivar el efecto visual de foco perjudicará la usabilidad de la navegación con teclado/controlador, por lo que no se recomienda por razones de accesibilidad.

Texture2D texture_hover 🔗

void set_texture_hover(value: Texture2D)
Texture2D get_texture_hover()

Textura a mostrar cuando el ratón se cierne sobre el nodo. Si no se asigna, el TextureButton muestra texture_normal en su lugar cuando se cierne sobre él.

Texture2D texture_normal 🔗

void set_texture_normal(value: Texture2D)
Texture2D get_texture_normal()

Textura a mostrar por defecto, cuando el nodo no está en estado deshabilitado, cernido o presionado. Esta textura también se muestra en el estado de foco, con texture_focused dibujado encima.

Texture2D texture_pressed 🔗

void set_texture_pressed(value: Texture2D)
Texture2D get_texture_pressed()

Textura a mostrar al presionar el botón del ratón sobre el nodo, si el nodo tiene el foco del teclado y el jugador presiona la tecla Intro, o si el jugador presiona la tecla BaseButton.shortcut. Si no se asigna, el TextureButton muestra texture_hover en su lugar cuando se presiona.