<?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="GtkFontButton">
<refmeta>
<refentrytitle role="top_of_page" id="GtkFontButton.top_of_page">GtkFontButton</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkFontButton</refname>
<refpurpose>A button to launch a font selection dialog</refpurpose>
</refnamediv>

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

<synopsis>

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

                    <link linkend="GtkFontButton-struct">GtkFontButton</link>;
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-font-button-new">gtk_font_button_new</link>                 (void);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-font-button-new-with-font">gtk_font_button_new_with_font</link>       (const <link linkend="gchar">gchar</link> *fontname);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-font-button-set-font-name">gtk_font_button_set_font_name</link>       (<link linkend="GtkFontButton">GtkFontButton</link> *font_button,
                                                         const <link linkend="gchar">gchar</link> *fontname);
const <link linkend="gchar">gchar</link>*        <link linkend="gtk-font-button-get-font-name">gtk_font_button_get_font_name</link>       (<link linkend="GtkFontButton">GtkFontButton</link> *font_button);
<link linkend="void">void</link>                <link linkend="gtk-font-button-set-show-style">gtk_font_button_set_show_style</link>      (<link linkend="GtkFontButton">GtkFontButton</link> *font_button,
                                                         <link linkend="gboolean">gboolean</link> show_style);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-font-button-get-show-style">gtk_font_button_get_show_style</link>      (<link linkend="GtkFontButton">GtkFontButton</link> *font_button);
<link linkend="void">void</link>                <link linkend="gtk-font-button-set-show-size">gtk_font_button_set_show_size</link>       (<link linkend="GtkFontButton">GtkFontButton</link> *font_button,
                                                         <link linkend="gboolean">gboolean</link> show_size);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-font-button-get-show-size">gtk_font_button_get_show_size</link>       (<link linkend="GtkFontButton">GtkFontButton</link> *font_button);
<link linkend="void">void</link>                <link linkend="gtk-font-button-set-use-font">gtk_font_button_set_use_font</link>        (<link linkend="GtkFontButton">GtkFontButton</link> *font_button,
                                                         <link linkend="gboolean">gboolean</link> use_font);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-font-button-get-use-font">gtk_font_button_get_use_font</link>        (<link linkend="GtkFontButton">GtkFontButton</link> *font_button);
<link linkend="void">void</link>                <link linkend="gtk-font-button-set-use-size">gtk_font_button_set_use_size</link>        (<link linkend="GtkFontButton">GtkFontButton</link> *font_button,
                                                         <link linkend="gboolean">gboolean</link> use_size);
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-font-button-get-use-size">gtk_font_button_get_use_size</link>        (<link linkend="GtkFontButton">GtkFontButton</link> *font_button);
<link linkend="void">void</link>                <link linkend="gtk-font-button-set-title">gtk_font_button_set_title</link>           (<link linkend="GtkFontButton">GtkFontButton</link> *font_button,
                                                         const <link linkend="gchar">gchar</link> *title);
const <link linkend="gchar">gchar</link> *       <link linkend="gtk-font-button-get-title">gtk_font_button_get_title</link>           (<link linkend="GtkFontButton">GtkFontButton</link> *font_button);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GtkFontButton.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="GtkBin">GtkBin</link>
                                 +----<link linkend="GtkButton">GtkButton</link>
                                       +----GtkFontButton
</synopsis>
</refsect1>



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


<refsect1 id="GtkFontButton.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkFontButton--font-name">font-name</link>&quot;                <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkFontButton--show-size">show-size</link>&quot;                <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkFontButton--show-style">show-style</link>&quot;               <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkFontButton--title">title</link>&quot;                    <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="GtkFontButton--use-font">use-font</link>&quot;                 <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="GtkFontButton--use-size">use-size</link>&quot;                 <link linkend="gboolean">gboolean</link>              : Read / Write
</synopsis>
</refsect1>

<refsect1 id="GtkFontButton.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="GtkFontButton-font-set">font-set</link>&quot;                                       : Run First
</synopsis>
</refsect1>


<refsect1 id="GtkFontButton.description" role="desc">
<title role="desc.title">Description</title>
<para>
The <link linkend="GtkFontButton"><type>GtkFontButton</type></link> is a button which displays the currently selected font an allows to open a font selection
dialog to change the font. It is suitable widget for selecting a font in a preference dialog.
</para>
</refsect1>

<refsect1 id="GtkFontButton.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkFontButton-struct" role="struct">
<title>GtkFontButton</title>
<indexterm zone="GtkFontButton-struct"><primary sortas="FontButton">GtkFontButton</primary></indexterm><programlisting>typedef struct _GtkFontButton GtkFontButton;</programlisting>
<para>
The GtkFontButton struct has only private members and should not be used
directly.
</para></refsect2>
<refsect2 id="gtk-font-button-new" role="function" condition="since:2.4">
<title>gtk_font_button_new ()</title>
<indexterm zone="gtk-font-button-new" role="2.4"><primary sortas="font_button_new">gtk_font_button_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_font_button_new                 (void);</programlisting>
<para>
Creates a new font picker widget.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new font picker widget.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-new-with-font" role="function" condition="since:2.4">
<title>gtk_font_button_new_with_font ()</title>
<indexterm zone="gtk-font-button-new-with-font" role="2.4"><primary sortas="font_button_new_with_font">gtk_font_button_new_with_font</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_font_button_new_with_font       (const <link linkend="gchar">gchar</link> *fontname);</programlisting>
<para>
Creates a new font picker widget.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>fontname</parameter>&#160;:</term>
<listitem><simpara> Name of font to display in font selection dialog
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new font picker widget.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-set-font-name" role="function" condition="since:2.4">
<title>gtk_font_button_set_font_name ()</title>
<indexterm zone="gtk-font-button-set-font-name" role="2.4"><primary sortas="font_button_set_font_name">gtk_font_button_set_font_name</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_font_button_set_font_name       (<link linkend="GtkFontButton">GtkFontButton</link> *font_button,
                                                         const <link linkend="gchar">gchar</link> *fontname);</programlisting>
<para>
Sets or updates the currently-displayed font in font picker dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font_button</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontButton"><type>GtkFontButton</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>fontname</parameter>&#160;:</term>
<listitem><simpara> Name of font to display in font selection dialog
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> Return value of <link linkend="gtk-font-selection-dialog-set-font-name"><function>gtk_font_selection_dialog_set_font_name()</function></link> if the
font selection dialog exists, otherwise <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-get-font-name" role="function" condition="since:2.4">
<title>gtk_font_button_get_font_name ()</title>
<indexterm zone="gtk-font-button-get-font-name" role="2.4"><primary sortas="font_button_get_font_name">gtk_font_button_get_font_name</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>*        gtk_font_button_get_font_name       (<link linkend="GtkFontButton">GtkFontButton</link> *font_button);</programlisting>
<para>
Retrieves the name of the currently selected font. This name includes
style and size information as well. If you want to render something
with the font, use this string with <link linkend="pango-font-description-from-string"><function>pango_font_description_from_string()</function></link> .
If you're interested in peeking certain values (family name,
style, size, weight) just query these properties from the
<link linkend="PangoFontDescription"><type>PangoFontDescription</type></link> object.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font_button</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontButton"><type>GtkFontButton</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> an internal copy of the font name which must not be freed.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-set-show-style" role="function" condition="since:2.4">
<title>gtk_font_button_set_show_style ()</title>
<indexterm zone="gtk-font-button-set-show-style" role="2.4"><primary sortas="font_button_set_show_style">gtk_font_button_set_show_style</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_font_button_set_show_style      (<link linkend="GtkFontButton">GtkFontButton</link> *font_button,
                                                         <link linkend="gboolean">gboolean</link> show_style);</programlisting>
<para>
If <parameter>show_style</parameter> is <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, the font style will be displayed along with name of the selected font.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font_button</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontButton"><type>GtkFontButton</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>show_style</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if font style should be displayed in label.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-get-show-style" role="function" condition="since:2.4">
<title>gtk_font_button_get_show_style ()</title>
<indexterm zone="gtk-font-button-get-show-style" role="2.4"><primary sortas="font_button_get_show_style">gtk_font_button_get_show_style</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_font_button_get_show_style      (<link linkend="GtkFontButton">GtkFontButton</link> *font_button);</programlisting>
<para>
Returns whether the name of the font style will be shown in the label.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font_button</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontButton"><type>GtkFontButton</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> whether the font style will be shown in the label.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-set-show-size" role="function" condition="since:2.4">
<title>gtk_font_button_set_show_size ()</title>
<indexterm zone="gtk-font-button-set-show-size" role="2.4"><primary sortas="font_button_set_show_size">gtk_font_button_set_show_size</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_font_button_set_show_size       (<link linkend="GtkFontButton">GtkFontButton</link> *font_button,
                                                         <link linkend="gboolean">gboolean</link> show_size);</programlisting>
<para>
If <parameter>show_size</parameter> is <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, the font size will be displayed along with the name of the selected font.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font_button</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontButton"><type>GtkFontButton</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>show_size</parameter>&#160;:</term>
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if font size should be displayed in dialog.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-get-show-size" role="function" condition="since:2.4">
<title>gtk_font_button_get_show_size ()</title>
<indexterm zone="gtk-font-button-get-show-size" role="2.4"><primary sortas="font_button_get_show_size">gtk_font_button_get_show_size</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_font_button_get_show_size       (<link linkend="GtkFontButton">GtkFontButton</link> *font_button);</programlisting>
<para>
Returns whether the font size will be shown in the label.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font_button</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontButton"><type>GtkFontButton</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> whether the font size will be shown in the label.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-set-use-font" role="function" condition="since:2.4">
<title>gtk_font_button_set_use_font ()</title>
<indexterm zone="gtk-font-button-set-use-font" role="2.4"><primary sortas="font_button_set_use_font">gtk_font_button_set_use_font</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_font_button_set_use_font        (<link linkend="GtkFontButton">GtkFontButton</link> *font_button,
                                                         <link linkend="gboolean">gboolean</link> use_font);</programlisting>
<para>
If <parameter>use_font</parameter> is <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, the font name will be written using the selected font.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font_button</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontButton"><type>GtkFontButton</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>use_font</parameter>&#160;:</term>
<listitem><simpara> If <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, font name will be written using font chosen.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-get-use-font" role="function" condition="since:2.4">
<title>gtk_font_button_get_use_font ()</title>
<indexterm zone="gtk-font-button-get-use-font" role="2.4"><primary sortas="font_button_get_use_font">gtk_font_button_get_use_font</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_font_button_get_use_font        (<link linkend="GtkFontButton">GtkFontButton</link> *font_button);</programlisting>
<para>
Returns whether the selected font is used in the label.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font_button</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontButton"><type>GtkFontButton</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> whether the selected font is used in the label.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-set-use-size" role="function" condition="since:2.4">
<title>gtk_font_button_set_use_size ()</title>
<indexterm zone="gtk-font-button-set-use-size" role="2.4"><primary sortas="font_button_set_use_size">gtk_font_button_set_use_size</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_font_button_set_use_size        (<link linkend="GtkFontButton">GtkFontButton</link> *font_button,
                                                         <link linkend="gboolean">gboolean</link> use_size);</programlisting>
<para>
If <parameter>use_size</parameter> is <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, the font name will be written using the selected size.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font_button</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontButton"><type>GtkFontButton</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>use_size</parameter>&#160;:</term>
<listitem><simpara> If <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, font name will be written using the selected size.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-get-use-size" role="function" condition="since:2.4">
<title>gtk_font_button_get_use_size ()</title>
<indexterm zone="gtk-font-button-get-use-size" role="2.4"><primary sortas="font_button_get_use_size">gtk_font_button_get_use_size</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_font_button_get_use_size        (<link linkend="GtkFontButton">GtkFontButton</link> *font_button);</programlisting>
<para>
Returns whether the selected size is used in the label.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font_button</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontButton"><type>GtkFontButton</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> whether the selected size is used in the label.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-set-title" role="function" condition="since:2.4">
<title>gtk_font_button_set_title ()</title>
<indexterm zone="gtk-font-button-set-title" role="2.4"><primary sortas="font_button_set_title">gtk_font_button_set_title</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_font_button_set_title           (<link linkend="GtkFontButton">GtkFontButton</link> *font_button,
                                                         const <link linkend="gchar">gchar</link> *title);</programlisting>
<para>
Sets the title for the font selection dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font_button</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontButton"><type>GtkFontButton</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>title</parameter>&#160;:</term>
<listitem><simpara> a string containing the font selection dialog title
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.4</para></refsect2>
<refsect2 id="gtk-font-button-get-title" role="function" condition="since:2.4">
<title>gtk_font_button_get_title ()</title>
<indexterm zone="gtk-font-button-get-title" role="2.4"><primary sortas="font_button_get_title">gtk_font_button_get_title</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> *       gtk_font_button_get_title           (<link linkend="GtkFontButton">GtkFontButton</link> *font_button);</programlisting>
<para>
Retrieves the title of the font selection dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>font_button</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkFontButton"><type>GtkFontButton</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> an internal copy of the title string which must not be freed.

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

</refsect1>
<refsect1 id="GtkFontButton.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkFontButton--font-name" role="property"><title>The <literal>&quot;font-name&quot;</literal> property</title>
<indexterm zone="GtkFontButton--font-name" role="2.4"><primary sortas="FontButton:font-name">GtkFontButton:font-name</primary></indexterm><programlisting>  &quot;font-name&quot;                <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
The name of the currently selected font.</para>
<para>
</para><para>Default value: "Sans 12"</para>
<para>Since 2.4</para>
</refsect2>
<refsect2 id="GtkFontButton--show-size" role="property"><title>The <literal>&quot;show-size&quot;</literal> property</title>
<indexterm zone="GtkFontButton--show-size" role="2.4"><primary sortas="FontButton:show-size">GtkFontButton:show-size</primary></indexterm><programlisting>  &quot;show-size&quot;                <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
If this property is set to <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, the selected font size will be shown
in the label. For a more WYSIWYG way to show the selected size, see the 
::use-size property.</para>
<para>
</para><para>Default value: TRUE</para>
<para>Since 2.4</para>
</refsect2>
<refsect2 id="GtkFontButton--show-style" role="property"><title>The <literal>&quot;show-style&quot;</literal> property</title>
<indexterm zone="GtkFontButton--show-style" role="2.4"><primary sortas="FontButton:show-style">GtkFontButton:show-style</primary></indexterm><programlisting>  &quot;show-style&quot;               <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
If this property is set to <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, the name of the selected font style 
will be shown in the label. For a more WYSIWYG way to show the selected 
style, see the ::use-font property.</para>
<para>
</para><para>Default value: TRUE</para>
<para>Since 2.4</para>
</refsect2>
<refsect2 id="GtkFontButton--title" role="property"><title>The <literal>&quot;title&quot;</literal> property</title>
<indexterm zone="GtkFontButton--title" role="2.4"><primary sortas="FontButton:title">GtkFontButton:title</primary></indexterm><programlisting>  &quot;title&quot;                    <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
The title of the font selection dialog.</para>
<para>
</para><para>Default value: "Pick a Font"</para>
<para>Since 2.4</para>
</refsect2>
<refsect2 id="GtkFontButton--use-font" role="property"><title>The <literal>&quot;use-font&quot;</literal> property</title>
<indexterm zone="GtkFontButton--use-font" role="2.4"><primary sortas="FontButton:use-font">GtkFontButton:use-font</primary></indexterm><programlisting>  &quot;use-font&quot;                 <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
If this property is set to <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, the label will be drawn 
in the selected font.</para>
<para>
</para><para>Default value: FALSE</para>
<para>Since 2.4</para>
</refsect2>
<refsect2 id="GtkFontButton--use-size" role="property"><title>The <literal>&quot;use-size&quot;</literal> property</title>
<indexterm zone="GtkFontButton--use-size" role="2.4"><primary sortas="FontButton:use-size">GtkFontButton:use-size</primary></indexterm><programlisting>  &quot;use-size&quot;                 <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
If this property is set to <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>, the label will be drawn 
with the selected font size.</para>
<para>
</para><para>Default value: FALSE</para>
<para>Since 2.4</para>
</refsect2>

</refsect1>

<refsect1 id="GtkFontButton.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkFontButton-font-set" role="signal"><title>The <literal>&quot;font-set&quot;</literal> signal</title>
<indexterm zone="GtkFontButton-font-set" role="2.4"><primary sortas="FontButton::font-set">GtkFontButton::font-set</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkFontButton">GtkFontButton</link> *widget,
                                                        <link linkend="gpointer">gpointer</link>       user_data)      : Run First</programlisting>
<para>
The ::font-set signal is emitted when the user selects a font.
When handling this signal, use <link linkend="gtk-font-button-get-font-name"><function>gtk_font_button_get_font_name()</function></link> 
to find out which font was just selected.
</para>
<para>
Note that this signal is only emitted when the <emphasis>user</emphasis>
changes the font. If you need to react to programmatic font changes
as well, use the notify::font-name signal.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>widget</parameter>&#160;:</term>
<listitem><simpara> the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist><para>Since 2.4</para></refsect2>
</refsect1>


<refsect1 id="GtkFontButton.see-also">
<title>See Also</title>
<para>
<link linkend="GtkFontSelectionDialog"><type>GtkFontSelectionDialog</type></link>, <link linkend="GtkColorButton"><type>GtkColorButton</type></link>.
</para>
</refsect1>

</refentry>
