BaseButton

Inherits: Control < CanvasItem < Node < Object

Inherited By: LinkButton, TextureButton, Button

Category: Core

Brief Description

Provides a base class for different kinds of buttons.

Member Functions

void _pressed ( ) virtual
void _toggled ( bool pressed ) virtual
int get_action_mode ( ) const
ButtonGroup get_button_group ( ) const
int get_draw_mode ( ) const
int get_enabled_focus_mode ( ) const
ShortCut get_shortcut ( ) const
bool is_disabled ( ) const
bool is_hovered ( ) const
bool is_pressed ( ) const
bool is_toggle_mode ( ) const
void set_action_mode ( int mode )
void set_button_group ( ButtonGroup button_group )
void set_disabled ( bool disabled )
void set_enabled_focus_mode ( int mode )
void set_pressed ( bool pressed )
void set_shortcut ( ShortCut shortcut )
void set_toggle_mode ( bool enabled )

Signals

  • button_down ( )

Emitted when the button starts being held down.

  • button_up ( )

Emitted when the button stops being held down.

  • pressed ( )

This signal is emitted every time the button is toggled or pressed (i.e. activated, so on button_down if “Click on press” is active and on button_up otherwise).

  • released ( )

Emitted when the button was released. This is only emitted by non-toggle buttons and if “Click on press” is active.

  • toggled ( bool pressed )

This signal is emitted when the button was just toggled between pressed and normal states (only if toggle_mode is active). The new state is contained in the pressed argument.

Numeric Constants

  • DRAW_NORMAL = 0 — The normal state (i.e. not pressed, not hovered, not toggled and enabled) of buttons.
  • DRAW_PRESSED = 1 — The state of buttons are pressed.
  • DRAW_HOVER = 2 — The state of buttons are hovered.
  • DRAW_DISABLED = 3 — The state of buttons are disabled.
  • ACTION_MODE_BUTTON_PRESS = 0 — Require just a press to consider the button clicked.
  • ACTION_MODE_BUTTON_RELEASE = 1 — Require a press and a subsequent release before considering the button clicked.

Description

BaseButton is the abstract base class for buttons, so it shouldn’t be used directly (It doesn’t display anything). Other types of buttons inherit from it.

Member Function Description

  • void _pressed ( ) virtual

Called when button is pressed.

  • void _toggled ( bool pressed ) virtual

Called when button is toggled (only if toggle_mode is active).

  • int get_action_mode ( ) const

Return the current mode of action (see set_action_mode) (one of the ACTION_MODE_* constants).

  • int get_draw_mode ( ) const

Return the visual state used to draw the button. This is useful mainly when implementing your own draw code by either overriding _draw() or connecting to “draw” signal. The visual state of the button is defined by the DRAW_* enum.

  • int get_enabled_focus_mode ( ) const

Returns focus access mode used when switching between enabled/disabled (see Control.set_focus_mode and set_disabled).

  • bool is_disabled ( ) const

Return whether the button is in disabled state (see set_disabled).

  • bool is_hovered ( ) const

Return true if mouse entered the button before it exit.

  • bool is_pressed ( ) const

If toggle_mode is active, return whether the button is toggled. If toggle_mode is not active, return whether the button is pressed down.

  • bool is_toggle_mode ( ) const

Return the toggle_mode property (see set_toggle_mode).

  • void set_action_mode ( int mode )

Set the current mode of action, determining when the button is considered clicked (see the ACTION_MODE_* constants).

  • void set_disabled ( bool disabled )

Set the button into disabled state. When a button is disabled, it can’t be clicked or toggled.

  • void set_enabled_focus_mode ( int mode )

Sets the focus access mode to use when switching between enabled/disabled (see Control.set_focus_mode and set_disabled).

  • void set_pressed ( bool pressed )

Set the button to pressed state (only if toggle_mode is active).

  • void set_shortcut ( ShortCut shortcut )
  • void set_toggle_mode ( bool enabled )

Set the button toggle_mode property. Toggle mode makes the button flip state between pressed and unpressed each time its area is clicked.