<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<!--ENTITY index-Objects-Grouped SYSTEM "objects_grouped.sgml"-->
<refentry id="GtkFontSelection">
<refmeta>
<refentrytitle role="top_of_page" id="GtkFontSelection.top_of_page">GtkFontSelection</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkFontSelection</refname>
<refpurpose>A widget for selecting fonts</refpurpose>
</refnamediv>

<refsynopsisdiv id="GtkFontSelection.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;gtk/gtk.h&gt;

                    <link linkend="GtkFontSelection-struct">GtkFontSelection</link>;
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-font-selection-new">gtk_font_selection_new</link>              (void);
<link linkend="GdkFont">GdkFont</link>*            <link linkend="gtk-font-selection-get-font">gtk_font_selection_get_font</link>         (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);
<link linkend="gchar">gchar</link>*              <link linkend="gtk-font-selection-get-font-name">gtk_font_selection_get_font_name</link>    (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-font-selection-set-font-name">gtk_font_selection_set_font_name</link>    (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel,
                                                         const <link linkend="gchar">gchar</link> *fontname);
const <link linkend="gchar">gchar</link>*        <link linkend="gtk-font-selection-get-preview-text">gtk_font_selection_get_preview_text</link> (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);
<link linkend="void">void</link>                <link linkend="gtk-font-selection-set-preview-text">gtk_font_selection_set_preview_text</link> (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel,
                                                         const <link linkend="gchar">gchar</link> *text);
<link linkend="PangoFontFace">PangoFontFace</link> *     <link linkend="gtk-font-selection-get-face">gtk_font_selection_get_face</link>         (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-font-selection-get-face-list">gtk_font_selection_get_face_list</link>    (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);
<link linkend="PangoFontFamily">PangoFontFamily</link> *   <link linkend="gtk-font-selection-get-family">gtk_font_selection_get_family</link>       (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);
<link linkend="gint">gint</link>                <link linkend="gtk-font-selection-get-size">gtk_font_selection_get_size</link>         (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-font-selection-get-family-list">gtk_font_selection_get_family_list</link>  (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-font-selection-get-preview-entry">gtk_font_selection_get_preview_entry</link>
                                                        (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-font-selection-get-size-entry">gtk_font_selection_get_size_entry</link>   (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-font-selection-get-size-list">gtk_font_selection_get_size_list</link>    (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GtkFontSelection.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----<link linkend="GtkWidget">GtkWidget</link>
                     +----<link linkend="GtkContainer">GtkContainer</link>
                           +----<link linkend="GtkBox">GtkBox</link>
                                 +----<link linkend="GtkVBox">GtkVBox</link>
                                       +----GtkFontSelection
</synopsis>
</refsect1>



<refsect1 id="GtkFontSelection.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkFontSelection implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link> and  <link linkend="GtkOrientable">GtkOrientable</link>.</para>
</refsect1>


<refsect1 id="GtkFontSelection.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkFontSelection--font">font</link>&quot;                     <link linkend="GdkFont">GdkFont</link>*              : Read
  &quot;<link linkend="GtkFontSelection--font-name">font-name</link>&quot;                <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkFontSelection--preview-text">preview-text</link>&quot;             <link linkend="gchar">gchar</link>*                : Read / Write
</synopsis>
</refsect1>



<refsect1 id="GtkFontSelection.description" role="desc">
<title role="desc.title">Description</title>
<para>
The <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link> widget lists the available fonts, styles and sizes,
allowing the user to select a font.
It is used in the <link linkend="GtkFontSelectionDialog"><type>GtkFontSelectionDialog</type></link> widget to provide a dialog box for
selecting fonts.
</para>
<para>
To set the font which is initially selected, use
<link linkend="gtk-font-selection-set-font-name"><function>gtk_font_selection_set_font_name()</function></link>.
</para>
<para>
To get the selected font use <link linkend="gtk-font-selection-get-font-name"><function>gtk_font_selection_get_font_name()</function></link>.
</para>
<para>
To change the text which is shown in the preview area, use
<link linkend="gtk-font-selection-set-preview-text"><function>gtk_font_selection_set_preview_text()</function></link>.
</para>
</refsect1>

<refsect1 id="GtkFontSelection.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkFontSelection-struct" role="struct">
<title>GtkFontSelection</title>
<indexterm zone="GtkFontSelection-struct"><primary sortas="FontSelection">GtkFontSelection</primary></indexterm><programlisting>typedef struct _GtkFontSelection GtkFontSelection;</programlisting>
<para>
The <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link> struct contains private data only, and should
only be accessed using the functions below.
</para></refsect2>
<refsect2 id="gtk-font-selection-new" role="function">
<title>gtk_font_selection_new ()</title>
<indexterm zone="gtk-font-selection-new"><primary sortas="font_selection_new">gtk_font_selection_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_font_selection_new              (void);</programlisting>
<para>
Creates a new <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a n ew <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-font-selection-get-font" role="function" condition="deprecated:2.0: Use gtk_font_selection_get_font_name() instead.">
<title>gtk_font_selection_get_font ()</title>
<indexterm zone="gtk-font-selection-get-font" role="deprecated"><primary sortas="font_selection_get_font">gtk_font_selection_get_font</primary></indexterm><programlisting><link linkend="GdkFont">GdkFont</link>*            gtk_font_selection_get_font         (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);</programlisting>
<warning><para><literal>gtk_font_selection_get_font</literal> has been deprecated since version 2.0 and should not be used in newly-written code. Use <link linkend="gtk-font-selection-get-font-name"><function>gtk_font_selection_get_font_name()</function></link> instead.</para></warning>
<para>
Gets the currently-selected font.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GdkFont"><type>GdkFont</type></link>.

</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-font-selection-get-font-name" role="function">
<title>gtk_font_selection_get_font_name ()</title>
<indexterm zone="gtk-font-selection-get-font-name"><primary sortas="font_selection_get_font_name">gtk_font_selection_get_font_name</primary></indexterm><programlisting><link linkend="gchar">gchar</link>*              gtk_font_selection_get_font_name    (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);</programlisting>
<para>
Gets the currently-selected font name. 
</para>
<para>
Note that this can be a different string than what you set with 
<link linkend="gtk-font-selection-set-font-name"><function>gtk_font_selection_set_font_name()</function></link>, as the font selection widget may 
normalize font names and thus return a string with a different structure. 
For example, "Helvetica Italic Bold 12" could be normalized to 
"Helvetica Bold Italic 12". Use <link linkend="pango-font-description-equal"><function>pango_font_description_equal()</function></link>
if you want to compare two font descriptions.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A string with the name of the current font, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if 
    no font is selected. You must free this string with <link linkend="g-free"><function>g_free()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-font-selection-set-font-name" role="function">
<title>gtk_font_selection_set_font_name ()</title>
<indexterm zone="gtk-font-selection-set-font-name"><primary sortas="font_selection_set_font_name">gtk_font_selection_set_font_name</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_font_selection_set_font_name    (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel,
                                                         const <link linkend="gchar">gchar</link> *fontname);</programlisting>
<para>
Sets the currently-selected font. 
</para>
<para>
Note that the <parameter>fontsel</parameter> needs to know the screen in which it will appear 
for this to work; this can be guaranteed by simply making sure that the 
<parameter>fontsel</parameter> is inserted in a toplevel window before you call this function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>fontname</parameter>&#160;:</term>
<listitem><simpara> a font name like "Helvetica 12" or "Times Bold 18"
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the font could be set successfully; <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> if no 
    such font exists or if the <parameter>fontsel</parameter> doesn't belong to a particular 
    screen yet.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-font-selection-get-preview-text" role="function">
<title>gtk_font_selection_get_preview_text ()</title>
<indexterm zone="gtk-font-selection-get-preview-text"><primary sortas="font_selection_get_preview_text">gtk_font_selection_get_preview_text</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>*        gtk_font_selection_get_preview_text (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);</programlisting>
<para>
Gets the text displayed in the preview area.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the text displayed in the preview area. 
    This string is owned by the widget and should not be 
    modified or freed 
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-font-selection-set-preview-text" role="function">
<title>gtk_font_selection_set_preview_text ()</title>
<indexterm zone="gtk-font-selection-set-preview-text"><primary sortas="font_selection_set_preview_text">gtk_font_selection_set_preview_text</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_font_selection_set_preview_text (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel,
                                                         const <link linkend="gchar">gchar</link> *text);</programlisting>
<para>
Sets the text displayed in the preview area.
The <parameter>text</parameter> is used to show how the selected font looks.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&#160;:</term>
<listitem><simpara> the text to display in the preview area 
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-font-selection-get-face" role="function" condition="since:2.14">
<title>gtk_font_selection_get_face ()</title>
<indexterm zone="gtk-font-selection-get-face" role="2.14"><primary sortas="font_selection_get_face">gtk_font_selection_get_face</primary></indexterm><programlisting><link linkend="PangoFontFace">PangoFontFace</link> *     gtk_font_selection_get_face         (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);</programlisting>
<para>
Gets the <link linkend="PangoFontFace"><type>PangoFontFace</type></link> representing the selected font group
details (i.e. family, slant, weight, width, etc).</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="PangoFontFace"><type>PangoFontFace</type></link> representing the selected font 
    group details. The returned object is owned by <parameter>fontsel</parameter> and
    must not be modified or freed. 

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="gtk-font-selection-get-face-list" role="function" condition="since:2.14">
<title>gtk_font_selection_get_face_list ()</title>
<indexterm zone="gtk-font-selection-get-face-list" role="2.14"><primary sortas="font_selection_get_face_list">gtk_font_selection_get_face_list</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_font_selection_get_face_list    (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);</programlisting>
<para>
This returns the <link linkend="GtkTreeView"><type>GtkTreeView</type></link> which lists all styles available for
the selected font. For example, 'Regular', 'Bold', etc.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GtkWidget"><type>GtkWidget</type></link> that is part of <parameter>fontsel</parameter>

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="gtk-font-selection-get-family" role="function" condition="since:2.14">
<title>gtk_font_selection_get_family ()</title>
<indexterm zone="gtk-font-selection-get-family" role="2.14"><primary sortas="font_selection_get_family">gtk_font_selection_get_family</primary></indexterm><programlisting><link linkend="PangoFontFamily">PangoFontFamily</link> *   gtk_font_selection_get_family       (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);</programlisting>
<para>
Gets the <link linkend="PangoFontFamily"><type>PangoFontFamily</type></link> representing the selected font family.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="PangoFontFamily"><type>PangoFontFamily</type></link> representing the selected font
    family. Font families are a collection of font faces. The 
    returned object is owned by <parameter>fontsel</parameter> and must not be modified 
    or freed.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="gtk-font-selection-get-size" role="function" condition="since:2.14">
<title>gtk_font_selection_get_size ()</title>
<indexterm zone="gtk-font-selection-get-size" role="2.14"><primary sortas="font_selection_get_size">gtk_font_selection_get_size</primary></indexterm><programlisting><link linkend="gint">gint</link>                gtk_font_selection_get_size         (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);</programlisting>
<para>
The selected font size.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A n integer representing the selected font size, 
    or -1 if no font size is selected.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="gtk-font-selection-get-family-list" role="function" condition="since:2.14">
<title>gtk_font_selection_get_family_list ()</title>
<indexterm zone="gtk-font-selection-get-family-list" role="2.14"><primary sortas="font_selection_get_family_list">gtk_font_selection_get_family_list</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_font_selection_get_family_list  (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);</programlisting>
<para>
This returns the <link linkend="GtkTreeView"><type>GtkTreeView</type></link> that lists font families, for
example, 'Sans', 'Serif', etc.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GtkWidget"><type>GtkWidget</type></link> that is part of <parameter>fontsel</parameter>

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="gtk-font-selection-get-preview-entry" role="function" condition="since:2.14">
<title>gtk_font_selection_get_preview_entry ()</title>
<indexterm zone="gtk-font-selection-get-preview-entry" role="2.14"><primary sortas="font_selection_get_preview_entry">gtk_font_selection_get_preview_entry</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_font_selection_get_preview_entry
                                                        (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);</programlisting>
<para>
This returns the <link linkend="GtkEntry"><type>GtkEntry</type></link> used to display the font as a preview.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GtkWidget"><type>GtkWidget</type></link> that is part of <parameter>fontsel</parameter>

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="gtk-font-selection-get-size-entry" role="function" condition="since:2.14">
<title>gtk_font_selection_get_size_entry ()</title>
<indexterm zone="gtk-font-selection-get-size-entry" role="2.14"><primary sortas="font_selection_get_size_entry">gtk_font_selection_get_size_entry</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_font_selection_get_size_entry   (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);</programlisting>
<para>
This returns the <link linkend="GtkEntry"><type>GtkEntry</type></link> used to allow the user to edit the font
number manually instead of selecting it from the list of font sizes.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GtkWidget"><type>GtkWidget</type></link> that is part of <parameter>fontsel</parameter>

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>
<refsect2 id="gtk-font-selection-get-size-list" role="function" condition="since:2.14">
<title>gtk_font_selection_get_size_list ()</title>
<indexterm zone="gtk-font-selection-get-size-list" role="2.14"><primary sortas="font_selection_get_size_list">gtk_font_selection_get_size_list</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_font_selection_get_size_list    (<link linkend="GtkFontSelection">GtkFontSelection</link> *fontsel);</programlisting>
<para>
This returns the <link linkend="GtkTreeeView"><type>GtkTreeeView</type></link> used to list font sizes.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontsel</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A <link linkend="GtkWidget"><type>GtkWidget</type></link> that is part of <parameter>fontsel</parameter>

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.14</para></refsect2>

</refsect1>
<refsect1 id="GtkFontSelection.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkFontSelection--font" role="property"><title>The <literal>&quot;font&quot;</literal> property</title>
<indexterm zone="GtkFontSelection--font"><primary sortas="FontSelection:font">GtkFontSelection:font</primary></indexterm><programlisting>  &quot;font&quot;                     <link linkend="GdkFont">GdkFont</link>*              : Read</programlisting>
<para>The GdkFont that is currently selected.</para></refsect2>
<refsect2 id="GtkFontSelection--font-name" role="property"><title>The <literal>&quot;font-name&quot;</literal> property</title>
<indexterm zone="GtkFontSelection--font-name"><primary sortas="FontSelection:font-name">GtkFontSelection:font-name</primary></indexterm><programlisting>  &quot;font-name&quot;                <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>The string that represents this font.</para><para>Default value: "Sans 10"</para>
</refsect2>
<refsect2 id="GtkFontSelection--preview-text" role="property"><title>The <literal>&quot;preview-text&quot;</literal> property</title>
<indexterm zone="GtkFontSelection--preview-text"><primary sortas="FontSelection:preview-text">GtkFontSelection:preview-text</primary></indexterm><programlisting>  &quot;preview-text&quot;             <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>The text to display in order to demonstrate the selected font.</para><para>Default value: "abcdefghijk ABCDEFGHIJK"</para>
</refsect2>
</refsect1>



<refsect1 id="GtkFontSelection.see-also">
<title>See Also</title>
<para>
<variablelist>
<varlistentry>
<term><link linkend="GtkFontSelectionDialog"><type>GtkFontSelectionDialog</type></link></term>
<listitem><para>a dialog box which uses <link linkend="GtkFontSelection"><type>GtkFontSelection</type></link>.</para></listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

</refentry>
