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