Gtk.FontSelection¶

Subclasses:: None

Methods¶

Inherited:: Gtk.Box (14), Gtk.Container (35), Gtk.Widget (278), GObject.Object (37), Gtk.Buildable (10), Gtk.Orientable (2)
Structs:: Gtk.ContainerClass (5), Gtk.WidgetClass (12), GObject.ObjectClass (5)

class	`new` ()
	`get_face` ()
	`get_face_list` ()
	`get_family` ()
	`get_family_list` ()
	`get_font_name` ()
	`get_preview_entry` ()
	`get_preview_text` ()
	`get_size` ()
	`get_size_entry` ()
	`get_size_list` ()
	`set_font_name` (fontname)
	`set_preview_text` (text)

Virtual Methods¶

Inherited:: Gtk.Container (10), Gtk.Widget (82), GObject.Object (7), Gtk.Buildable (10)

Properties¶

Inherited:: Gtk.Box (3), Gtk.Container (3), Gtk.Widget (39), Gtk.Orientable (1)

Name	Type	Flags	Short Description
`font-name`	`str`	r/w	The string that represents this font
`preview-text`	`str`	r/w	The text to display in order to demonstrate the selected font

Child Properties¶

Inherited:: Gtk.Box (5)

Style Properties¶

Inherited:: Gtk.Widget (17)

Signals¶

Inherited:: Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Fields¶

Inherited:: Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Name	Type	Access	Description
parent_instance	`Gtk.Box`	r

Class Details¶

class Gtk.FontSelection(*args, **kwargs)¶

Bases:: Gtk.Box
Abstract:: No
Structure:: Gtk.FontSelectionClass

classmethod new()[source]¶

Returns:: a new Gtk.FontSelection
Return type:: Gtk.Widget

Creates a new Gtk.FontSelection.

Deprecated since version 3.2: Use Gtk.FontChooserWidget instead

get_face()[source]¶

Returns:: A Pango.FontFace representing the selected font group details. The returned object is owned by self and must not be modified or freed.
Return type:: Pango.FontFace

Gets the Pango.FontFace representing the selected font group details (i.e. family, slant, weight, width, etc).

New in version 2.14.

Deprecated since version 3.2: Use Gtk.FontChooser

get_face_list()[source]¶

Returns:: A Gtk.Widget that is part of self
Return type:: Gtk.Widget

This returns the Gtk.TreeView which lists all styles available for the selected font. For example, “Regular”, “Bold”, etc.

New in version 2.14.

Deprecated since version 3.2: Use Gtk.FontChooser

get_family()[source]¶

Returns:: A Pango.FontFamily representing the selected font family. Font families are a collection of font faces. The returned object is owned by self and must not be modified or freed.
Return type:: Pango.FontFamily

Gets the Pango.FontFamily representing the selected font family.

New in version 2.14.

Deprecated since version 3.2: Use Gtk.FontChooser

get_family_list()[source]¶

Returns:: A Gtk.Widget that is part of self
Return type:: Gtk.Widget

This returns the Gtk.TreeView that lists font families, for example, “Sans”, “Serif”, etc.

New in version 2.14.

Deprecated since version 3.2: Use Gtk.FontChooser

get_font_name()[source]¶

Returns:: A string with the name of the current font, or None if no font is selected. You must free this string with GLib.free().
Return type:: str

Gets the currently-selected font name.

Note that this can be a different string than what you set with Gtk.FontSelection.set_font_name(), as the font selection widget may normalize font names and thus return a string with a different structure. For example, “Helvetica Italic Bold 12” could be normalized to “Helvetica Bold Italic 12”. Use Pango.FontDescription.equal() if you want to compare two font descriptions.

Deprecated since version 3.2: Use Gtk.FontChooser

get_preview_entry()[source]¶

Returns:: A Gtk.Widget that is part of self
Return type:: Gtk.Widget

This returns the Gtk.Entry used to display the font as a preview.

New in version 2.14.

Deprecated since version 3.2: Use Gtk.FontChooser

get_preview_text()[source]¶

Returns:: the text displayed in the preview area. This string is owned by the widget and should not be modified or freed
Return type:: str

Gets the text displayed in the preview area.

Deprecated since version 3.2: Use Gtk.FontChooser

get_size()[source]¶

Returns:: A n integer representing the selected font size, or -1 if no font size is selected.
Return type:: int

The selected font size.

New in version 2.14.

Deprecated since version 3.2: Use Gtk.FontChooser

get_size_entry()[source]¶

Returns:: A Gtk.Widget that is part of self
Return type:: Gtk.Widget

This returns the Gtk.Entry used to allow the user to edit the font number manually instead of selecting it from the list of font sizes.

New in version 2.14.

Deprecated since version 3.2: Use Gtk.FontChooser

get_size_list()[source]¶

Returns:: A Gtk.Widget that is part of self
Return type:: Gtk.Widget

This returns the Gtk.TreeView used to list font sizes.

New in version 2.14.

Deprecated since version 3.2: Use Gtk.FontChooser

set_font_name(fontname)[source]¶

Parameters:: fontname (str) – a font name like “Helvetica 12” or “Times Bold 18”
Returns:: True if the font could be set successfully; False if no such font exists or if the self doesn’t belong to a particular screen yet.
Return type:: bool

Sets the currently-selected font.

Note that the self needs to know the screen in which it will appear for this to work; this can be guaranteed by simply making sure that the self is inserted in a toplevel window before you call this function.

Deprecated since version 3.2: Use Gtk.FontChooser

set_preview_text(text)[source]¶

Parameters:: text (str) – the text to display in the preview area

Sets the text displayed in the preview area. The text is used to show how the selected font looks.

Deprecated since version 3.2: Use Gtk.FontChooser

Property Details¶

Gtk.FontSelection.props.font_name¶

Name:: font-name
Type:: str
Default Value:: 'Sans 10'
Flags:: READABLE, WRITABLE

The string that represents this font

Gtk.FontSelection.props.preview_text¶

Name:: preview-text
Type:: str
Default Value:: 'abcdefghijk ABCDEFGHIJK'
Flags:: READABLE, WRITABLE

The text to display in order to demonstrate the selected font