| GTK+ Reference Manual | |||
|---|---|---|---|
| <<< Previous Page | Home | Up | Next Page >>> | 
| #include <gtk/gtk.h> struct GtkFontSelection; GtkWidget* gtk_font_selection_new (void); GdkFont* gtk_font_selection_get_font (GtkFontSelection *fontsel); gchar* gtk_font_selection_get_font_name (GtkFontSelection *fontsel); gboolean gtk_font_selection_set_font_name (GtkFontSelection *fontsel, const gchar *fontname); G_CONST_RETURN gchar* gtk_font_selection_get_preview_text (GtkFontSelection *fontsel); void gtk_font_selection_set_preview_text (GtkFontSelection *fontsel, const gchar *text); | 
| GObject +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkVBox +----GtkFontSelection | 
| "font" GdkFont : Read "font-name" gchararray : Read / Write "preview-text" gchararray : Read / Write | 
The GtkFontSelection widget lists the available fonts, styles and sizes, allowing the user to select a font. It is used in the GtkFontSelectionDialog widget to provide a dialog box for selecting fonts.
To set the font which is initially selected, use gtk_font_selection_set_font_name().
To get the selected font use gtk_font_selection_get_font() or gtk_font_selection_get_font_name().
To change the text which is shown in the preview area, use gtk_font_selection_set_preview_text().
Filters can be used to limit the fonts shown. There are 2 filters in the GtkFontSelection - 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 widget.
| struct GtkFontSelection; | 
The GtkFontSelection struct contains private data only, and should only be accessed using the functions below.
| GtkWidget* gtk_font_selection_new (void); | 
Creates a new GtkFontSelection.
| Returns : | a new GtkFontSelection. | 
| GdkFont* gtk_font_selection_get_font (GtkFontSelection *fontsel); | 
| Warning | 
| gtk_font_selection_get_font is deprecated and should not be used in newly-written code. | 
Gets the currently-selected font.
| fontsel : | |
| Returns : | the currently-selected font, or NULL if no font is selected. | 
| gchar* gtk_font_selection_get_font_name (GtkFontSelection *fontsel); | 
Gets the currently-selected font name.
| fontsel : | |
| Returns : | 
 | 
| gboolean gtk_font_selection_set_font_name (GtkFontSelection *fontsel, const gchar *fontname); | 
Sets the currently-selected font.
| fontsel : | |
| fontname : | a fontname. | 
| Returns : | TRUE if the font was found. | 
| G_CONST_RETURN gchar* gtk_font_selection_get_preview_text (GtkFontSelection *fontsel); | 
Gets the text displayed in the preview area.
| fontsel : | |
| Returns : | the text displayed in the preview area. | 
| void        gtk_font_selection_set_preview_text
                                            (GtkFontSelection *fontsel,
                                             const gchar *text); | 
Sets the text displayed in the preview area.
| fontsel : | |
| text : | the text to display in the preview area. | 
| "font" (GdkFont : Read) | The GdkFont that is currently selected. | 
| "font-name" (gchararray : Read / Write) | The X string that represents this font. | 
| "preview-text" (gchararray : Read / Write) | The text to display in order to demonstrate the selected font. |