GtkFontSelectionDialog

Object Hierarchy

  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBin
                           +----GtkWindow
                                 +----GtkDialog
                                       +----GtkFontSelectionDialog

Description

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.

  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:

  gtk_font_selection_dialog_set_filter (GTK_FONT_SELECTION_DIALOG (fontsel),
				       GTK_FONT_FILTER_BASE, GTK_FONT_SCALABLE,
				       NULL, NULL, NULL, NULL, NULL, NULL);

Details

struct GtkFontSelectionDialog;

GtkWidget*  gtk_font_selection_dialog_new   (const gchar *title);

GdkFont*    gtk_font_selection_dialog_get_font
                                            (GtkFontSelectionDialog *fsd);

gchar*      gtk_font_selection_dialog_get_font_name
                                            (GtkFontSelectionDialog *fsd);

gboolean    gtk_font_selection_dialog_set_font_name
                                            (GtkFontSelectionDialog *fsd,
                                             const gchar *fontname);

G_CONST_RETURN gchar* gtk_font_selection_dialog_get_preview_text
                                            (GtkFontSelectionDialog *fsd);

void        gtk_font_selection_dialog_set_preview_text
                                            (GtkFontSelectionDialog *fsd,
                                             const gchar *text);

See Also