1 <!-- ##### SECTION Title ##### -->
4 <!-- ##### SECTION Short_Description ##### -->
5 a widget for selecting fonts.
7 <!-- ##### SECTION Long_Description ##### -->
9 The #GtkFontSelection widget lists the available fonts, styles and sizes,
10 allowing the user to select a font.
11 It is used in the #GtkFontSelectionDialog widget to provide a dialog box for
15 To set the font which is initially selected, use
16 gtk_font_selection_set_font_name().
19 To get the selected font use gtk_font_selection_get_font()
20 or gtk_font_selection_get_font_name().
23 To change the text which is shown in the preview area, use
24 gtk_font_selection_set_preview_text().
27 <!-- ##### SECTION See_Also ##### -->
32 <term>#GtkFontSelectionDialog</term>
33 <listitem><para>a dialog box which uses #GtkFontSelection.</para></listitem>
39 <!-- ##### STRUCT GtkFontSelection ##### -->
41 The #GtkFontSelection struct contains private data only, and should
42 only be accessed using the functions below.
46 <!-- ##### FUNCTION gtk_font_selection_new ##### -->
48 Creates a new #GtkFontSelection.
51 @Returns: a new #GtkFontSelection.
54 <!-- ##### FUNCTION gtk_font_selection_get_font ##### -->
56 Gets the currently-selected font.
59 @fontsel: a #GtkFontSelection.
60 @Returns: the currently-selected font, or NULL if no font is selected.
63 <!-- ##### FUNCTION gtk_font_selection_get_font_name ##### -->
65 Gets the currently-selected font name.
68 @fontsel: a #GtkFontSelection.
72 <!-- ##### FUNCTION gtk_font_selection_set_font_name ##### -->
74 Sets the currently-selected font.
77 @fontsel: a #GtkFontSelection.
78 @fontname: a fontname.
79 @Returns: %TRUE if the font was found.
82 <!-- ##### FUNCTION gtk_font_selection_get_preview_text ##### -->
84 Gets the text displayed in the preview area.
87 @fontsel: a #GtkFontSelection.
88 @Returns: the text displayed in the preview area. This string is
89 owned by the widget and should not be modified or freed.
92 <!-- ##### FUNCTION gtk_font_selection_set_preview_text ##### -->
94 Sets the text displayed in the preview area.
97 @fontsel: a #GtkFontSelection.
98 @text: the text to display in the preview area.
101 <!-- ##### ARG GtkFontSelection:font ##### -->
106 <!-- ##### ARG GtkFontSelection:font-name ##### -->
111 <!-- ##### ARG GtkFontSelection:preview-text ##### -->