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.