FontButton

Deprecated since version 4.10: Use FontDialogButton instead

class FontButton(**properties: Any)

Superclasses: Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Buildable, ConstraintTarget, FontChooser

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

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

CSS nodes

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

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

Constructors

class FontButton

classmethod new() → Widget

Creates a new font picker widget.

Deprecated since version 4.10: Use FontDialogButton instead

classmethod new_with_font(fontname: str) → Widget

Creates a new font picker widget showing the given font.

Deprecated since version 4.10: Use FontDialogButton instead

Parameters:

fontname – Name of font to display in font chooser dialog

Methods

class FontButton

get_modal() → bool

Gets whether the dialog is modal.

Deprecated since version 4.10: Use FontDialogButton instead

get_title() → str

Retrieves the title of the font chooser dialog.

Deprecated since version 4.10: Use FontDialogButton instead

get_use_font() → bool

Returns whether the selected font is used in the label.

Deprecated since version 4.10: Use FontDialogButton instead

get_use_size() → bool

Returns whether the selected size is used in the label.

Deprecated since version 4.10: Use FontDialogButton instead

set_modal(modal: bool) → None

Sets whether the dialog should be modal.

Deprecated since version 4.10: Use FontDialogButton instead

Parameters:

modal – True to make the dialog modal

set_title(title: str) → None

Sets the title for the font chooser dialog.

Deprecated since version 4.10: Use FontDialogButton instead

Parameters:

title – a string containing the font chooser dialog title

set_use_font(use_font: bool) → None

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

Deprecated since version 4.10: Use FontDialogButton instead

Parameters:

use_font – If True, font name will be written using font chosen.

set_use_size(use_size: bool) → None

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

Deprecated since version 4.10: Use FontDialogButton instead

Parameters:

use_size – If True, font name will be written using the selected size.

Properties

class FontButton

props.modal: bool

Whether the font chooser dialog should be modal.

props.title: str

The title of the font chooser dialog.

props.use_font: bool

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

props.use_size: bool

Whether the buttons label will use the selected font size.

Signals

class FontButton.signals

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.

Added in version 4.4.

font_set() → None

Emitted when the user selects a font.

When handling this signal, use 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.