class_button.rst 5.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
  3. .. _class_Button:
  4. Button
  5. ======
  6. **Inherits:** :ref:`BaseButton<class_basebutton>` **<** :ref:`Control<class_control>` **<** :ref:`CanvasItem<class_canvasitem>` **<** :ref:`Node<class_node>` **<** :ref:`Object<class_object>`
  7. **Inherited By:** :ref:`OptionButton<class_optionbutton>`, :ref:`ColorPickerButton<class_colorpickerbutton>`, :ref:`CheckButton<class_checkbutton>`, :ref:`MenuButton<class_menubutton>`, :ref:`ToolButton<class_toolbutton>`, :ref:`CheckBox<class_checkbox>`
  8. **Category:** Core
  9. Brief Description
  10. -----------------
  11. Standard themed Button.
  12. Member Functions
  13. ----------------
  14. +--------------------------------+----------------------------------------------------------------------------------------------------------+
  15. | void | :ref:`set_text<class_Button_set_text>` **(** :ref:`String<class_string>` text **)** |
  16. +--------------------------------+----------------------------------------------------------------------------------------------------------+
  17. | :ref:`String<class_string>` | :ref:`get_text<class_Button_get_text>` **(** **)** const |
  18. +--------------------------------+----------------------------------------------------------------------------------------------------------+
  19. | void | :ref:`set_button_icon<class_Button_set_button_icon>` **(** :ref:`Texture<class_texture>` texture **)** |
  20. +--------------------------------+----------------------------------------------------------------------------------------------------------+
  21. | :ref:`Texture<class_texture>` | :ref:`get_button_icon<class_Button_get_button_icon>` **(** **)** const |
  22. +--------------------------------+----------------------------------------------------------------------------------------------------------+
  23. | void | :ref:`set_flat<class_Button_set_flat>` **(** :ref:`bool<class_bool>` enabled **)** |
  24. +--------------------------------+----------------------------------------------------------------------------------------------------------+
  25. | void | :ref:`set_clip_text<class_Button_set_clip_text>` **(** :ref:`bool<class_bool>` enabled **)** |
  26. +--------------------------------+----------------------------------------------------------------------------------------------------------+
  27. | :ref:`bool<class_bool>` | :ref:`get_clip_text<class_Button_get_clip_text>` **(** **)** const |
  28. +--------------------------------+----------------------------------------------------------------------------------------------------------+
  29. | void | :ref:`set_text_align<class_Button_set_text_align>` **(** :ref:`int<class_int>` align **)** |
  30. +--------------------------------+----------------------------------------------------------------------------------------------------------+
  31. | :ref:`int<class_int>` | :ref:`get_text_align<class_Button_get_text_align>` **(** **)** const |
  32. +--------------------------------+----------------------------------------------------------------------------------------------------------+
  33. | :ref:`bool<class_bool>` | :ref:`is_flat<class_Button_is_flat>` **(** **)** const |
  34. +--------------------------------+----------------------------------------------------------------------------------------------------------+
  35. Numeric Constants
  36. -----------------
  37. - **ALIGN_LEFT** = **0** --- Align the text to the left.
  38. - **ALIGN_CENTER** = **1** --- Center the text.
  39. - **ALIGN_RIGHT** = **2** --- Align the text to the right.
  40. Description
  41. -----------
  42. Button is the standard themed button. It can contain text and an icon, and will display them according to the current :ref:`Theme<class_theme>`.
  43. Member Function Description
  44. ---------------------------
  45. .. _class_Button_set_text:
  46. - void **set_text** **(** :ref:`String<class_string>` text **)**
  47. Set the button text, which will be displayed inside the button area.
  48. .. _class_Button_get_text:
  49. - :ref:`String<class_string>` **get_text** **(** **)** const
  50. Return the button text.
  51. .. _class_Button_set_button_icon:
  52. - void **set_button_icon** **(** :ref:`Texture<class_texture>` texture **)**
  53. Set the icon that will be displayed next to the text inside the button area.
  54. .. _class_Button_get_button_icon:
  55. - :ref:`Texture<class_texture>` **get_button_icon** **(** **)** const
  56. Return the button icon.
  57. .. _class_Button_set_flat:
  58. - void **set_flat** **(** :ref:`bool<class_bool>` enabled **)**
  59. Set the *flat* property of a Button. Flat buttons don't display decoration unless hovered or pressed.
  60. .. _class_Button_set_clip_text:
  61. - void **set_clip_text** **(** :ref:`bool<class_bool>` enabled **)**
  62. Set the *clip_text* property of a Button. When this property is enabled, text that is too large to fit the button is clipped, when disabled (default) the Button will always be wide enough to hold the text.
  63. .. _class_Button_get_clip_text:
  64. - :ref:`bool<class_bool>` **get_clip_text** **(** **)** const
  65. Return the state of the *clip_text* property (see :ref:`set_clip_text<class_Button_set_clip_text>`)
  66. .. _class_Button_set_text_align:
  67. - void **set_text_align** **(** :ref:`int<class_int>` align **)**
  68. Set the text alignment policy, using one of the ALIGN\_\* constants.
  69. .. _class_Button_get_text_align:
  70. - :ref:`int<class_int>` **get_text_align** **(** **)** const
  71. Return the text alignment policy.
  72. .. _class_Button_is_flat:
  73. - :ref:`bool<class_bool>` **is_flat** **(** **)** const
  74. Return the state of the *flat* property (see :ref:`set_flat<class_Button_set_flat>`).