GtkFontSelectionDialog
a dialog box for selecting fonts.
The #GtkFontSelectionDialog widget is a dialog box for selecting a font.
To set the font which is initially selected, use
gtk_font_selection_dialog_set_font_name().
To get the selected font use gtk_font_selection_dialog_get_font()
or gtk_font_selection_dialog_get_font_name().
To change the text which is shown in the preview area, use
gtk_font_selection_dialog_set_preview_text().
Filters can be used to limit the fonts shown. There are 2 filters in the
#GtkFontSelectionDialog - a base filter and a user filter. The base filter
can not be changed by the user, so this can be used when the user must choose
from the restricted set of fonts (e.g. for a terminal-type application you may
want to force the user to select a fixed-width font). The user filter can be
changed or reset by the user, by using the 'Reset Filter' button or changing
the options on the 'Filter' page of the dialog.
Setting a filter to show only fixed-width fonts.
gchar *spacings[] = { "c", "m", NULL };
gtk_font_selection_dialog_set_filter (GTK_FONT_SELECTION_DIALOG (fontsel),
GTK_FONT_FILTER_BASE, GTK_FONT_ALL,
NULL, NULL, NULL, NULL, spacings, NULL);
To allow only true scalable fonts to be selected use:
Setting a filter to show only true scalable fonts.
gtk_font_selection_dialog_set_filter (GTK_FONT_SELECTION_DIALOG (fontsel),
GTK_FONT_FILTER_BASE, GTK_FONT_SCALABLE,
NULL, NULL, NULL, NULL, NULL, NULL);
#GtkFontSelection
the underlying widget for selecting fonts.
The #GtkFontSelectionDialog struct contains private data only, and should
only be accessed using the functions below.
Creates a new #GtkFontSelectionDialog.
@title: the title of the dialog box.
@Returns: a new #GtkFontSelectionDialog.
Gets the currently-selected font.
@fsd: a #GtkFontSelectionDialog.
@Returns: the currently-selected font, or %NULL if no font is selected.
Gets the currently-selected font name.
@fsd: a #GtkFontSelectionDialog.
@Returns: the currently-selected font name, or %NULL if no font is selected.
Sets the currently-selected font.
@fsd: a #GtkFontSelectionDialog.
@fontname: a fontname.
@Returns: %TRUE if the font was found.
Gets the text displayed in the preview area.
@fsd: a #GtkFontSelectionDialog.
@Returns: the text displayed in the preview area. This string is owned
by the widget and should not be modified or freed.
Sets the text displayed in the preview area.
@fsd: a #GtkFontSelectionDialog.
@text: the text to display in the preview area.