Inherits: BaseButton < Control < CanvasItem < Node < Object
Texture-based button. Supports Pressed, Hover, Disabled and Focused states.
TextureButton
has the same functionality as Button, except it uses sprites instead of Godot's Theme resource. It is faster to create, but it doesn't support localization like more complex Controls.
The "normal" state must contain a texture (texture_normal); other textures are optional.
bool | expand | false |
StretchMode | stretch_mode | 0 |
BitMap | texture_click_mask | |
Texture | texture_disabled | |
Texture | texture_focused | |
Texture | texture_hover | |
Texture | texture_normal | |
Texture | texture_pressed |
Default | false |
Setter | set_expand(value) |
Getter | get_expand() |
If true
, the texture stretches to the edges of the node's bounding rectangle using the stretch_mode. If false
, the texture will not scale with the node.
Default | 0 |
Setter | set_stretch_mode(value) |
Getter | get_stretch_mode() |
Controls the texture's behavior when you resize the node's bounding rectangle, only if expand is true
. Set it to one of the StretchMode constants. See the constants to learn more.
Setter | set_click_mask(value) |
Getter | get_click_mask() |
Pure black and white BitMap image to use for click detection. On the mask, white pixels represent the button's clickable area. Use it to create buttons with curved shapes.
Setter | set_disabled_texture(value) |
Getter | get_disabled_texture() |
Texture to display when the node is disabled. See BaseButton.disabled.
Setter | set_focused_texture(value) |
Getter | get_focused_texture() |
Texture to display when the node has mouse or keyboard focus.
Setter | set_hover_texture(value) |
Getter | get_hover_texture() |
Texture to display when the mouse hovers the node.
Setter | set_normal_texture(value) |
Getter | get_normal_texture() |
Texture to display by default, when the node is not in the disabled, focused, hover or pressed state.
Setter | set_pressed_texture(value) |
Getter | get_pressed_texture() |
Texture to display on mouse down over the node, if the node has keyboard focus and the player presses the Enter key or if the player presses the BaseButton.shortcut key.
© 2014–2020 Juan Linietsky, Ariel Manzur, Godot Engine contributors
Licensed under the MIT License.
https://docs.godotengine.org/en/3.2/classes/class_texturebutton.html