A Pango::FontFamily is used to represent a family of related font faces.
More...
#include <pangomm/fontfamily.h>
Inherits Glib::Object, and Gio::ListModel.
|
| 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...
|
|
std::vector< 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 PangoFontFace of family with the given name. More...
|
|
Glib::RefPtr< const FontFace > | get_face (const Glib::ustring& name={}) const |
| Gets the PangoFontFace of family with the given name. More...
|
|
|
static GType | get_type () |
| Get the GType for this class, for use with the underlying GObject type system. More...
|
|
|
(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.
◆ FontFamily()
◆ ~FontFamily()
Pango::FontFamily::~FontFamily |
( |
| ) |
|
|
overridenoexcept |
◆ get_face() [1/2]
Glib::RefPtr< FontFace > Pango::FontFamily::get_face |
( |
const Glib::ustring & |
name = {} | ) |
|
Gets the PangoFontFace
of family with the given name.
- Since pangomm 1.46:
- Parameters
-
name | The name of a face. If the name is nullptr , the family's default face (fontconfig calls it "Regular") will be returned. |
- Returns
- The
PangoFontFace
, or nullptr
if no face with the given name exists.
◆ get_face() [2/2]
Glib::RefPtr< const FontFace > Pango::FontFamily::get_face |
( |
const Glib::ustring & |
name = {} | ) |
const |
Gets the PangoFontFace
of family with the given name.
- Since pangomm 1.46:
- Parameters
-
name | The name of a face. If the name is nullptr , the family's default face (fontconfig calls it "Regular") will be returned. |
- Returns
- The
PangoFontFace
, or nullptr
if no face with the given name exists.
◆ get_name()
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 PangoFontDescription
to specify that a face from this family is desired.
- Returns
- The name of the family. This string is owned by the family object and must not be modified or freed.
◆ get_type()
static GType Pango::FontFamily::get_type |
( |
| ) |
|
|
static |
Get the GType for this class, for use with the underlying GObject type system.
◆ gobj() [1/2]
PangoFontFamily * Pango::FontFamily::gobj |
( |
| ) |
|
|
inline |
Provides access to the underlying C GObject.
◆ gobj() [2/2]
const PangoFontFamily * Pango::FontFamily::gobj |
( |
| ) |
const |
|
inline |
Provides access to the underlying C GObject.
◆ gobj_copy()
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.
◆ is_monospace()
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 [method Pango.FontMetrics.get_approximate_digit_width], since the results of [method Pango.FontMetrics.get_approximate_char_width] may be affected by double-width characters.
- Since pangomm 1.4:
- Returns
true
if the family is monospace.
◆ is_variable()
bool Pango::FontFamily::is_variable |
( |
| ) |
const |
A variable font is a font which has axes that can be modified to produce different faces.
- Since pangomm 1.44:
- Returns
true
if the family is variable.
◆ list_faces()
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.
- Returns
- an array of pointers to Pango::FontFace objects.
◆ operator=()
◆ wrap()
Glib::RefPtr< Pango::FontFamily > wrap |
( |
PangoFontFamily * |
object, |
|
|
bool |
take_copy = false |
|
) |
| |
|
related |
A Glib::wrap() method for this object.
- Parameters
-
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. |
- Returns
- A C++ instance that wraps this C instance.