Button¶
Inherits: BaseButton < Control < CanvasItem < Node < Object
Inherited By: CheckBox, CheckButton, ColorPickerButton, MenuButton, OptionButton, ToolButton
Botón temático estándar.
Descripción¶
Button is the standard themed button. It can contain text and an icon, and will display them according to the current Theme.
Example of creating a button and assigning an action when pressed by code:
func _ready():
var button = Button.new()
button.text = "Click me"
button.connect("pressed", self, "_button_pressed")
add_child(button)
func _button_pressed():
print("Hello world!")
Buttons (like all Control nodes) can also be created in the editor, but some situations may require creating them from code.
See also BaseButton which contains common properties and methods associated with this node.
Note: Buttons do not interpret touch input and therefore don't support multitouch, since mouse emulation can only press one button at a given time. Use TouchScreenButton for buttons that trigger gameplay movement or actions, as TouchScreenButton supports multitouch.
Tutoriales¶
Propiedades¶
|
||
|
||
|
||
|
||
|
Propiedades del Theme¶
|
||
|
||
|
||
|
||
|
||
|
||
Enumeraciones¶
enum TextAlign:
ALIGN_LEFT = 0 --- Alinea el texto a la izquierda.
ALIGN_CENTER = 1 --- Alinea el texto con el centro.
ALIGN_RIGHT = 2 --- Alinea el texto a la derecha.
Descripciones de Propiedades¶
TextAlign align
Default |
|
Setter |
set_text_align(value) |
Getter |
get_text_align() |
Política de alineación de texto para el texto del botón, usa una de las constantes TextAlign.
bool clip_text
Default |
|
Setter |
set_clip_text(value) |
Getter |
get_clip_text() |
Cuando esta propiedad está activada, el texto que es demasiado grande para caber en el botón se recorta, cuando está desactivada el botón siempre será lo suficientemente ancho para contener el texto.
bool expand_icon
Default |
|
Setter |
set_expand_icon(value) |
Getter |
is_expand_icon() |
Cuando se habilita, el icono del botón se expandirá o encogerá para adaptarse al tamaño del botón, manteniendo su aspecto.
bool flat
Default |
|
Setter |
set_flat(value) |
Getter |
is_flat() |
Los botones planos no muestran decoración.
Texture icon
Setter |
set_button_icon(value) |
Getter |
get_button_icon() |
Button's icon, if text is present the icon will be placed before the text.
To edit margin and spacing of the icon, use hseparation theme property of Button and content_margin_* properties of the used StyleBoxes.
String text
Default |
|
Setter |
set_text(value) |
Getter |
get_text() |
El texto del botón que se mostrará dentro del área del botón.
Theme Property Descriptions¶
Color font_color
Default |
|
Color del texto predeterminado del Button.
Color font_color_disabled
Default |
|
Color del texto utilizado cuando el Button está desactivado.
Color font_color_focus
Default |
|
Text Color used when the Button is focused. Only replaces the normal text color of the button. Disabled, hovered, and pressed states take precedence over this color.
Color font_color_hover
Default |
|
Color del texto usado cuando el Button tiene encima el cursor.
Color font_color_pressed
Default |
|
Color del texto utilizado cuando se pulsa el Button.
int hseparation
Default |
|
El espacio horizontal entre el icono y el texto de Button.
Font font
Font del texto del Button.
StyleBox disabled
StyleBox usado cuando el Button está desactivado.
StyleBox focus
StyleBox que se usa cuando el Button está enfocado. Se muestra sobre el StyleBox actual, por lo que al usar StyleBoxEmpty sólo desactivará el efecto visual de enfoque.
StyleBox hover
StyleBox que se usa cuando el Button tiene encima el cursor.
StyleBox normal
StyleBox por defecto para el Button.
StyleBox pressed
StyleBox que se usa cuando se presiona el Button.