:right-sidebar: True

FontButton
===================================================================

.. currentmodule:: gi.repository.Gtk





.. deprecated:: 4.10

   Use :obj:`~gi.repository.Gtk.FontDialogButton` instead



.. class:: FontButton(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.Gtk.Widget`, :class:`~gi.repository.GObject.InitiallyUnowned`, :class:`~gi.repository.GObject.Object`



Implemented Interfaces: :class:`~gi.repository.Gtk.Accessible`, :class:`~gi.repository.Gtk.Buildable`, :class:`~gi.repository.Gtk.ConstraintTarget`, :class:`~gi.repository.Gtk.FontChooser`



The ``GtkFontButton`` allows to open a font chooser dialog to change
the font.


.. image:: https://docs.gtk.org/gtk4/font-button.png


It is suitable widget for selecting a font in a preference dialog.

CSS nodes
---------


.. code-block::
   :dedent:

   fontbutton
   ╰── button.font
       ╰── [content]


``GtkFontButton`` has a single CSS node with name fontbutton which
contains a button node with the .font style class.



Constructors
------------

.. rst-class:: interim-class

.. class:: FontButton
   :no-index:


   .. classmethod:: new() -> ~gi.repository.Gtk.Widget

      Creates a new font picker widget.






      .. deprecated:: 4.10

         Use :obj:`~gi.repository.Gtk.FontDialogButton` instead







   .. classmethod:: new_with_font(fontname: str) -> ~gi.repository.Gtk.Widget

      Creates a new font picker widget showing the given font.






      .. deprecated:: 4.10

         Use :obj:`~gi.repository.Gtk.FontDialogButton` instead




      :param fontname: Name of font to display in font chooser dialog









Methods
-------

.. rst-class:: interim-class

.. class:: FontButton
   :no-index:


   .. method:: get_modal() -> bool

      Gets whether the dialog is modal.






      .. deprecated:: 4.10

         Use :obj:`~gi.repository.Gtk.FontDialogButton` instead







   .. method:: get_title() -> str

      Retrieves the title of the font chooser dialog.






      .. deprecated:: 4.10

         Use :obj:`~gi.repository.Gtk.FontDialogButton` instead







   .. method:: get_use_font() -> bool

      Returns whether the selected font is used in the label.






      .. deprecated:: 4.10

         Use :obj:`~gi.repository.Gtk.FontDialogButton` instead







   .. method:: get_use_size() -> bool

      Returns whether the selected size is used in the label.






      .. deprecated:: 4.10

         Use :obj:`~gi.repository.Gtk.FontDialogButton` instead







   .. method:: set_modal(modal: bool) -> None

      Sets whether the dialog should be modal.






      .. deprecated:: 4.10

         Use :obj:`~gi.repository.Gtk.FontDialogButton` instead




      :param modal: :const:`True` to make the dialog modal





   .. method:: set_title(title: str) -> None

      Sets the title for the font chooser dialog.






      .. deprecated:: 4.10

         Use :obj:`~gi.repository.Gtk.FontDialogButton` instead




      :param title: a string containing the font chooser dialog title





   .. method:: set_use_font(use_font: bool) -> None

      If ``use_font`` is :const:`True`, the font name will be written
      using the selected font.






      .. deprecated:: 4.10

         Use :obj:`~gi.repository.Gtk.FontDialogButton` instead




      :param use_font: If :const:`True`, font name will be written using font chosen.





   .. method:: set_use_size(use_size: bool) -> None

      If ``use_size`` is :const:`True`, the font name will be written using
      the selected size.






      .. deprecated:: 4.10

         Use :obj:`~gi.repository.Gtk.FontDialogButton` instead




      :param use_size: If :const:`True`, font name will be written using the
         selected size.









Properties
----------

.. rst-class:: interim-class

.. class:: FontButton
   :no-index:
   

   .. attribute:: props.modal
      :type: bool

      Whether the font chooser dialog should be modal.







   .. attribute:: props.title
      :type: str

      The title of the font chooser dialog.







   .. attribute:: props.use_font
      :type: bool

      Whether the buttons label will be drawn in the selected font.







   .. attribute:: props.use_size
      :type: bool

      Whether the buttons label will use the selected font size.











Signals
-------

.. rst-class:: interim-class

.. class:: FontButton.signals
   :no-index:
   

   .. method:: activate() -> None

      Emitted to when the font button is activated.

      The ``::activate`` signal on ``GtkFontButton`` is an action signal and
      emitting it causes the button to present its dialog.



      .. versionadded:: 4.4








   .. method:: font_set() -> None

      Emitted when the user selects a font.

      When handling this signal, use :obj:`~gi.repository.Gtk.FontChooser.get_font`
      to find out which font was just selected.

      Note that this signal is only emitted when the user changes the font.
      If you need to react to programmatic font changes as well, use
      the notify::font signal.