Pango.FontFace¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

	`describe` ()
	`get_face_name` ()
	`get_family` ()
	`is_synthesized` ()
	`list_sizes` ()

Virtual Methods¶

Inherited:: GObject.Object (7)

	`do_describe` ()
	`do_get_face_name` ()
	`do_get_family` ()
	`do_is_synthesized` ()
	`do_list_sizes` ()

Properties¶

None

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent_instance	`GObject.Object`	r

Class Details¶

class Pango.FontFace(**kwargs)¶

Bases:: GObject.Object
Abstract:: Yes
Structure:: Pango.FontFaceClass

A PangoFontFace is used to represent a group of fonts with the same family, slant, weight, and width, but varying sizes.

describe()[source]¶

Returns:: a newly-created PangoFontDescription structure holding the description of the face. Use [method`Pango`.FontDescription.free] to free the result.
Return type:: Pango.FontDescription

Returns a font description that matches the face.

The resulting font description will have the family, style, variant, weight and stretch of the face, but its size field will be unset.

get_face_name()[source]¶

Returns:: the face name for the face. This string is owned by the face object and must not be modified or freed.
Return type:: str

Gets a name representing the style of this face.

Note that a font family may contain multiple faces with the same name (e.g. a variable and a non-variable face for the same style).

get_family()[source]¶

Returns:: the PangoFontFamily
Return type:: Pango.FontFamily

Gets the PangoFontFamily that self belongs to.

New in version 1.46.

is_synthesized()[source]¶

Returns:: whether self is synthesized
Return type:: bool

Returns whether a PangoFontFace is synthesized.

This will be the case if the underlying font rendering engine creates this face from another face, by shearing, emboldening, lightening or modifying it in some other way.

New in version 1.18.

list_sizes()[source]¶

Returns:: location to store a pointer to an array of int. This array should be freed with GLib.free().
Return type:: sizes: [int]

List the available sizes for a font.

This is only applicable to bitmap fonts. For scalable fonts, stores None at the location pointed to by sizes and 0 at the location pointed to by n_sizes. The sizes returned are in Pango units and are sorted in ascending order.

New in version 1.4.

do_describe() virtual¶

Returns:: a newly-created PangoFontDescription structure holding the description of the face. Use [method`Pango`.FontDescription.free] to free the result.
Return type:: Pango.FontDescription

Returns a font description that matches the face.

The resulting font description will have the family, style, variant, weight and stretch of the face, but its size field will be unset.

do_get_face_name() virtual¶

Returns:: the face name for the face. This string is owned by the face object and must not be modified or freed.
Return type:: str

Gets a name representing the style of this face.

Note that a font family may contain multiple faces with the same name (e.g. a variable and a non-variable face for the same style).

do_get_family() virtual¶

Returns:: the PangoFontFamily
Return type:: Pango.FontFamily

Gets the PangoFontFamily that face belongs to.