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_name().
22 To change the text which is shown in the preview area, use
23 gtk_font_selection_set_preview_text().
26 <!-- ##### SECTION See_Also ##### -->
31 <term>#GtkFontSelectionDialog</term>
32 <listitem><para>a dialog box which uses #GtkFontSelection.</para></listitem>
38 <!-- ##### SECTION Stability_Level ##### -->
41 <!-- ##### STRUCT GtkFontSelection ##### -->
43 The #GtkFontSelection struct contains private data only, and should
44 only be accessed using the functions below.
48 <!-- ##### ARG GtkFontSelection:font ##### -->
53 <!-- ##### ARG GtkFontSelection:font-name ##### -->
58 <!-- ##### ARG GtkFontSelection:preview-text ##### -->
63 <!-- ##### FUNCTION gtk_font_selection_new ##### -->
65 Creates a new #GtkFontSelection.
68 @Returns: a new #GtkFontSelection.
71 <!-- ##### FUNCTION gtk_font_selection_get_font ##### -->
73 Gets the currently-selected font.
76 @fontsel: a #GtkFontSelection.
77 @Returns: the currently-selected font, or NULL if no font is selected.
80 <!-- ##### FUNCTION gtk_font_selection_get_font_name ##### -->
88 <!-- ##### FUNCTION gtk_font_selection_set_font_name ##### -->
97 <!-- ##### FUNCTION gtk_font_selection_get_preview_text ##### -->
99 Gets the text displayed in the preview area.
102 @fontsel: a #GtkFontSelection.
103 @Returns: the text displayed in the preview area. This string is
104 owned by the widget and should not be modified or freed.
107 <!-- ##### FUNCTION gtk_font_selection_set_preview_text ##### -->
109 Sets the text displayed in the preview area.
112 @fontsel: a #GtkFontSelection.
113 @text: the text to display in the preview area.