pangomm 2.46.3
|
A Pango::FontFamily is used to represent a family of related font faces. More...
#include <pangomm/fontfamily.h>
Inherits Glib::Object.
Public Member Functions | |
FontFamily (FontFamily && src) noexcept | |
FontFamily & | operator= (FontFamily && src) noexcept |
~FontFamily () noexcept override | |
PangoFontFamily * | gobj () |
Provides access to the underlying C GObject. More... | |
const PangoFontFamily * | gobj () const |
Provides access to the underlying C GObject. More... | |
PangoFontFamily * | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More... | |
Glib::ArrayHandle< Glib::RefPtr< FontFace > > | list_faces () const |
Lists the different font faces that make up family. More... | |
Glib::ustring | get_name () const |
Gets the name of the family. More... | |
bool | is_monospace () const |
A monospace font is a font designed for text display where the the characters form a regular grid. More... | |
bool | is_variable () const |
A variable font is a font which has axes that can be modified to produce different faces. More... | |
Glib::RefPtr< FontFace > | get_face (const Glib::ustring & name={}) |
Gets the Pango::FontFace of family with the given name. More... | |
Glib::RefPtr< const FontFace > | get_face (const Glib::ustring & name={}) const |
Gets the Pango::FontFace of family with the given name. More... | |
Static Public Member Functions | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. More... | |
Related Functions | |
(Note that these are not member functions.) | |
Glib::RefPtr< Pango::FontFamily > | wrap (PangoFontFamily * object, bool take_copy=false) |
A Glib::wrap() method for this object. More... | |
A Pango::FontFamily is used to represent a family of related font faces.
The faces in a family share a common design, but differ in slant, weight, width and other aspects.
|
noexcept |
|
overridenoexcept |
Glib::RefPtr< FontFace > Pango::FontFamily::get_face | ( | const Glib::ustring & | name = {} | ) |
Gets the Pango::FontFace of family with the given name.
name | The name of a face. If the name is nullptr , the family's default face (fontconfig calls it "Regular") will be returned. |
nullptr
if no face with the given name exists. Glib::RefPtr< const FontFace > Pango::FontFamily::get_face | ( | const Glib::ustring & | name = {} | ) | const |
Gets the Pango::FontFace of family with the given name.
name | The name of a face. If the name is nullptr , the family's default face (fontconfig calls it "Regular") will be returned. |
nullptr
if no face with the given name exists. Glib::ustring Pango::FontFamily::get_name | ( | ) | const |
Gets the name of the family.
The name is unique among all fonts for the font backend and can be used in a Pango::FontDescription to specify that a face from this family is desired.
|
static |
Get the GType for this class, for use with the underlying GObject type system.
|
inline |
Provides access to the underlying C GObject.
|
inline |
Provides access to the underlying C GObject.
PangoFontFamily * Pango::FontFamily::gobj_copy | ( | ) |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
bool Pango::FontFamily::is_monospace | ( | ) | const |
A monospace font is a font designed for text display where the the characters form a regular grid.
For Western languages this would mean that the advance width of all characters are the same, but this categorization also includes Asian fonts which include double-width characters: characters that occupy two grid cells. Glib::unichar_iswide() returns a result that indicates whether a character is typically double-width in a monospace font.
The best way to find out the grid-cell size is to call Pango::FontMetrics::get_approximate_digit_width(), since the results of Pango::FontMetrics::get_approximate_char_width() may be affected by double-width characters.
true
if the family is monospace. bool Pango::FontFamily::is_variable | ( | ) | const |
A variable font is a font which has axes that can be modified to produce different faces.
true
if the family is variable. Glib::ArrayHandle< Glib::RefPtr< FontFace > > Pango::FontFamily::list_faces | ( | ) | const |
Lists the different font faces that make up family.
The faces in a family share a common design, but differ in slant, weight, width and other aspects.
|
noexcept |
|
related |
A Glib::wrap() method for this object.
object | The C instance. |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |