Memory-managed wrapper type.

Type class for types which can be safely cast to FontChooser, for instance with toFontChooser.

Cast to FontChooser, for types for which this is known to be safe. For general casts, use castTo.

Gets the currently-selected font name.

Note that this can be a different string than what you set with fontChooserSetFont, as the font chooser 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 fontDescriptionEqual if you want to compare two font descriptions.

Gets the currently-selected font.

Note that this can be a different string than what you set with fontChooserSetFont, as the font chooser 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 fontDescriptionEqual if you want to compare two font descriptions.

Gets the PangoFontFace representing the selected font group details (i.e. family, slant, weight, width, etc).

If the selected font is not installed, returns Nothing.

Gets the PangoFontFamily representing the selected font family.

Font families are a collection of font faces.

If the selected font is not installed, returns Nothing.

Gets the currently-selected font features.

The format of the returned string is compatible with the CSS font-feature-settings property. It can be passed to [funcpango.AttrFontFeatures.new].

Gets the custom font map of this font chooser widget, or Nothing if it does not have one.

The selected font size.

Gets the language that is used for font features.

Returns the current level of granularity for selecting fonts.

Gets the text displayed in the preview area.

Returns whether the preview entry is shown or not.

Adds a filter function that decides which fonts to display in the font chooser.

Sets the currently-selected font.

Sets the currently-selected font from fontDesc.

Sets a custom font map to use for this font chooser widget.

A custom font map can be used to present application-specific fonts instead of or in addition to the normal system fonts.

c code

FcConfig *config;
PangoFontMap *fontmap;

config = FcInitLoadConfigAndFonts ();
FcConfigAppFontAddFile (config, my_app_font_file);

fontmap = pango_cairo_font_map_new_for_font_type (CAIRO_FONT_TYPE_FT);
pango_fc_font_map_set_config (PANGO_FC_FONT_MAP (fontmap), config);

gtk_font_chooser_set_font_map (font_chooser, fontmap);

Note that other GTK widgets will only be able to use the application-specific font if it is present in the font map they use:

c code

context = gtk_widget_get_pango_context (label);
pango_context_set_font_map (context, fontmap);

Sets the language to use for font features.

Sets the desired level of granularity for selecting fonts.

Sets the text displayed in the preview area.

The text is used to show how the selected font looks.

Shows or hides the editable preview entry.

Construct a GValueConstruct with valid value for the “font” property. This is rarely needed directly, but it is used by new.

Get the value of the “font” property. When overloading is enabled, this is equivalent to

get fontChooser #font

Set the value of the “font” property. When overloading is enabled, this is equivalent to

set fontChooser [ #font := value ]

Construct a GValueConstruct with valid value for the “font-desc” property. This is rarely needed directly, but it is used by new.

Get the value of the “font-desc” property. When overloading is enabled, this is equivalent to

get fontChooser #fontDesc

Set the value of the “font-desc” property. When overloading is enabled, this is equivalent to

set fontChooser [ #fontDesc := value ]

Get the value of the “font-features” property. When overloading is enabled, this is equivalent to

get fontChooser #fontFeatures

Construct a GValueConstruct with valid value for the “language” property. This is rarely needed directly, but it is used by new.

Get the value of the “language” property. When overloading is enabled, this is equivalent to

get fontChooser #language

Set the value of the “language” property. When overloading is enabled, this is equivalent to

set fontChooser [ #language := value ]

Construct a GValueConstruct with valid value for the “level” property. This is rarely needed directly, but it is used by new.

Get the value of the “level” property. When overloading is enabled, this is equivalent to

get fontChooser #level

Set the value of the “level” property. When overloading is enabled, this is equivalent to

set fontChooser [ #level := value ]

Construct a GValueConstruct with valid value for the “preview-text” property. This is rarely needed directly, but it is used by new.

Get the value of the “preview-text” property. When overloading is enabled, this is equivalent to

get fontChooser #previewText

Set the value of the “preview-text” property. When overloading is enabled, this is equivalent to

set fontChooser [ #previewText := value ]

Construct a GValueConstruct with valid value for the “show-preview-entry” property. This is rarely needed directly, but it is used by new.

Get the value of the “show-preview-entry” property. When overloading is enabled, this is equivalent to

get fontChooser #showPreviewEntry

Set the value of the “show-preview-entry” property. When overloading is enabled, this is equivalent to

set fontChooser [ #showPreviewEntry := value ]

Emitted when a font is activated.

This usually happens when the user double clicks an item, or an item is selected and the user presses one of the keys Space, Shift+Space, Return or Enter.

Connect a signal handler for the fontActivated signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after fontChooser #fontActivated callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

Connect a signal handler for the fontActivated signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on fontChooser #fontActivated callback