Basics

Guides

API Reference

Menu

Basics

Guides

API Reference

class: PangoFontFamilyMeta

[196:14] static extends: object

Generated metadata helpers for FontFamily class surfaces.

Methods

  • properties ()

    Returns property metadata for FontFamily.

    • @r A list.

class: PangoFontFamily

[14:7] extends: object

A PangoFontFamily is used to represent a family of related font faces. The font faces in a family share a common design, but differ in slant, weight, width or other aspects.

Members

  • handleObj
  • lib
  • retainedCallbacks
  • signalHandlerNames
  • signalSetterHandlers

Methods

  • PangoFontFamily (Handle = null)

    Creates a new FontFamily by wrapping a native handle or another wrapper.

    • @p Handle is the native handle or another wrapper whose handle to adopt.
  • toNativeHandle (Source)

    Normalizes a constructor argument into a raw pointer carrier. Accepts a raw NativeHandle, a raw NativeBuffer returned from fn.call(...), another generated wrapper exposing handle(), or null. Returns null when the argument carries no pointer.

    • @p Source is the raw handle, raw buffer, wrapper, or null.
    • @r A raw pointer carrier or null when no pointer is present.
  • getLib ()

    Returns the opened native library for this generated wrapper.

    • @r The opened native library.
  • handle ()

    Returns the wrapped NativeHandle.

    • @r The wrapped NativeHandle.
  • isNull ()

    Returns true when the wrapped handle is null.

    • @r A bool.
  • describe ()

    Returns a small string for debugging generated wrappers.

    • @r A string.
  • asObject ()

    Wraps this handle as GObject.

    • @r A GObject object.
  • asListModel ()

    Wraps this handle as GListModel.

    • @r A GListModel object.
  • get_face (string name)

    Gets the PangoFontFace of @family with the given name.

    • @p name is the name of a face. If the name is %NULL, the family's default face (fontconfig calls it "Regular") will be returned..
    • @r the PangoFontFace, or %NULL if no face with the given name exists..
  • get_name ()

    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.

    • @r the name of the family. This string is owned by the family object and must not be modified or freed..
  • is_monospace ()

    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. g_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.

    • @r %TRUE if the family is monospace..
  • is_variable ()

    A variable font is a font which has axes that can be modified to produce different faces. Such axes are also known as variations; see [method@Pango.FontDescription.set_variations] for more information.

    • @r %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. Note that the returned faces are not in any particular order, and multiple faces may have the same name or characteristics. PangoFontFamily also implemented the [iface@Gio.ListModel] interface for enumerating faces.

    • @p faces is location to store an array of pointers to PangoFontFace objects, or %NULL. This array should be freed with g_free() when it is no longer needed..
    • @p n_faces is location to store number of elements in @faces..
    • @r None.