.. Generated automatically by doc/tools/makerst.py in Godot's source tree. .. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead. .. _class_BaseButton: BaseButton ========== **Inherits:** :ref:`Control` **<** :ref:`CanvasItem` **<** :ref:`Node` **<** :ref:`Object` **Inherited By:** :ref:`TextureButton`, :ref:`Button` **Category:** Core Brief Description ----------------- Provides a base class for different kinds of buttons. Member Functions ---------------- +--------------------------+-------------------------------------------------------------------------------------------------------------+ | void | :ref:`_pressed` **(** **)** virtual | +--------------------------+-------------------------------------------------------------------------------------------------------------+ | void | :ref:`_toggled` **(** :ref:`bool` pressed **)** virtual | +--------------------------+-------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_pressed` **(** :ref:`bool` pressed **)** | +--------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_pressed` **(** **)** const | +--------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_hovered` **(** **)** const | +--------------------------+-------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_toggle_mode` **(** :ref:`bool` enabled **)** | +--------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_toggle_mode` **(** **)** const | +--------------------------+-------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_disabled` **(** :ref:`bool` disabled **)** | +--------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_disabled` **(** **)** const | +--------------------------+-------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_click_on_press` **(** :ref:`bool` enable **)** | +--------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`get_click_on_press` **(** **)** const | +--------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_draw_mode` **(** **)** const | +--------------------------+-------------------------------------------------------------------------------------------------------------+ Signals ------- - **released** **(** **)** - **toggled** **(** :ref:`bool` pressed **)** - **pressed** **(** **)** 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. 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 --------------------------- .. _class_BaseButton__pressed: - void **_pressed** **(** **)** virtual Called when button is pressed. .. _class_BaseButton__toggled: - void **_toggled** **(** :ref:`bool` pressed **)** virtual Called when button is toggled (only if toggle_mode is active). .. _class_BaseButton_set_pressed: - void **set_pressed** **(** :ref:`bool` pressed **)** Set the button to pressed state (only if toggle_mode is active). .. _class_BaseButton_is_pressed: - :ref:`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. .. _class_BaseButton_is_hovered: - :ref:`bool` **is_hovered** **(** **)** const Return true if mouse entered the button before it exit. .. _class_BaseButton_set_toggle_mode: - void **set_toggle_mode** **(** :ref:`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. .. _class_BaseButton_is_toggle_mode: - :ref:`bool` **is_toggle_mode** **(** **)** const Return the toggle_mode property (see :ref:`set_toggle_mode`). .. _class_BaseButton_set_disabled: - void **set_disabled** **(** :ref:`bool` disabled **)** Set the button into disabled state. When a button is disabled, it can't be clicked or toggled. .. _class_BaseButton_is_disabled: - :ref:`bool` **is_disabled** **(** **)** const Return whether the button is in disabled state (see :ref:`set_disabled`). .. _class_BaseButton_set_click_on_press: - void **set_click_on_press** **(** :ref:`bool` enable **)** Set the button click_on_press mode. This mode generates click events when a mouse button or key is just pressed (by default events are generated when the button/keys are released and both press and release occur in the visual area of the Button). .. _class_BaseButton_get_click_on_press: - :ref:`bool` **get_click_on_press** **(** **)** const Return the state of the click_on_press property (see :ref:`set_click_on_press`). .. _class_BaseButton_get_draw_mode: - :ref:`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.