<?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 pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkFontChooser">
<refmeta>
<refentrytitle role="top_of_page" id="GtkFontChooser.top_of_page">GtkFontChooser</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkFontChooser</refname>
<refpurpose>Interface implemented by widgets displaying fonts</refpurpose>
</refnamediv>

<refsect1 id="GtkFontChooser.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="PangoFontFamily"><returnvalue>PangoFontFamily</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-font-chooser-get-font-family">gtk_font_chooser_get_font_family</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoFontFace"><returnvalue>PangoFontFace</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-font-chooser-get-font-face">gtk_font_chooser_get_font_face</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gint"><returnvalue>gint</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-font-chooser-get-font-size">gtk_font_chooser_get_font_size</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-font-chooser-get-font">gtk_font_chooser_get_font</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-font-chooser-set-font">gtk_font_chooser_set_font</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoFontDescription"><returnvalue>PangoFontDescription</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-font-chooser-get-font-desc">gtk_font_chooser_get_font_desc</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-font-chooser-set-font-desc">gtk_font_chooser_set_font_desc</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-font-chooser-get-font-features">gtk_font_chooser_get_font_features</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-font-chooser-get-language">gtk_font_chooser_get_language</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-font-chooser-set-language">gtk_font_chooser_set_language</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-font-chooser-get-preview-text">gtk_font_chooser_get_preview_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-font-chooser-set-preview-text">gtk_font_chooser_set_preview_text</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-font-chooser-get-show-preview-entry">gtk_font_chooser_get_show_preview_entry</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-font-chooser-set-show-preview-entry">gtk_font_chooser_set_show_preview_entry</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkFontChooserLevel"><returnvalue>GtkFontChooserLevel</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-font-chooser-get-level">gtk_font_chooser_get_level</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-font-chooser-set-level">gtk_font_chooser_set_level</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><phrase role="c_punctuation">(</phrase><link linkend="GtkFontFilterFunc">*GtkFontFilterFunc</link><phrase role="c_punctuation">)</phrase>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-font-chooser-set-filter-func">gtk_font_chooser_set_filter_func</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="gtk-font-chooser-set-font-map">gtk_font_chooser_set_font_map</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="PangoFontMap"><returnvalue>PangoFontMap</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-font-chooser-get-font-map">gtk_font_chooser_get_font_map</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkFontChooser.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkFontChooser--font">font</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkFontChooser--font-desc">font-desc</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkFontChooser--font-features">font-features</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkFontChooser--language">language</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="GtkFontChooserLevel"><type>GtkFontChooserLevel</type></link></entry><entry role="property_name"><link linkend="GtkFontChooser--level">level</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkFontChooser--preview-text">preview-text</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkFontChooser--show-preview-entry">show-preview-entry</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkFontChooser.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFontChooser-font-activated">font-activated</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkFontChooser.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GtkFontChooser-struct">GtkFontChooser</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkFontChooserLevel">GtkFontChooserLevel</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkFontChooser.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GInterface">GInterface</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkFontChooser
</screen>
</refsect1>
<refsect1 id="GtkFontChooser.prerequisites" role="prerequisites">
<title role="prerequisites.title">Prerequisites</title>
<para>
GtkFontChooser requires
 <link linkend="GObject">GObject</link>.</para>

</refsect1>
<refsect1 id="GtkFontChooser.implementations" role="implementations">
<title role="implementations.title">Known Implementations</title>
<para>
GtkFontChooser is implemented by
 <link linkend="GtkFontButton">GtkFontButton</link>,  <link linkend="GtkFontChooserDialog">GtkFontChooserDialog</link> and  <link linkend="GtkFontChooserWidget">GtkFontChooserWidget</link>.</para>

</refsect1>

<refsect1 id="GtkFontChooser.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkFontChooser.description" role="desc">
<title role="desc.title">Description</title>
<para><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> is an interface that can be implemented by widgets
displaying the list of fonts. In GTK+, the main objects
that implement this interface are <link linkend="GtkFontChooserWidget"><type>GtkFontChooserWidget</type></link>,
<link linkend="GtkFontChooserDialog"><type>GtkFontChooserDialog</type></link> and <link linkend="GtkFontButton"><type>GtkFontButton</type></link>. The GtkFontChooser interface
has been introducted in GTK+ 3.2.</para>

</refsect1>
<refsect1 id="GtkFontChooser.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-font-chooser-get-font-family" role="function">
<title>gtk_font_chooser_get_font_family&#160;()</title>
<indexterm zone="gtk-font-chooser-get-font-family"><primary>gtk_font_chooser_get_font_family</primary></indexterm>
<programlisting language="C"><link linkend="PangoFontFamily"><returnvalue>PangoFontFamily</returnvalue></link>&#160;*
gtk_font_chooser_get_font_family (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>);</programlisting>
<para>Gets the <link linkend="PangoFontFamily"><type>PangoFontFamily</type></link> representing the selected font family.
Font families are a collection of font faces.</para>
<para>If the selected font is not installed, returns <link linkend="NULL:CAPS"><literal>NULL</literal></link>.</para>
<refsect3 id="gtk-font-chooser-get-font-family.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-font-chooser-get-font-family.returns" role="returns">
<title>Returns</title>
<para>A <link linkend="PangoFontFamily"><type>PangoFontFamily</type></link> representing the
selected font family, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. The returned object is owned by <parameter>fontchooser</parameter>
and must not be modified or freed. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-get-font-face" role="function">
<title>gtk_font_chooser_get_font_face&#160;()</title>
<indexterm zone="gtk-font-chooser-get-font-face"><primary>gtk_font_chooser_get_font_face</primary></indexterm>
<programlisting language="C"><link linkend="PangoFontFace"><returnvalue>PangoFontFace</returnvalue></link>&#160;*
gtk_font_chooser_get_font_face (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>);</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>If the selected font is not installed, returns <link linkend="NULL:CAPS"><literal>NULL</literal></link>.</para>
<refsect3 id="gtk-font-chooser-get-font-face.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-font-chooser-get-font-face.returns" role="returns">
<title>Returns</title>
<para>A <link linkend="PangoFontFace"><type>PangoFontFace</type></link> representing the
selected font group details, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. The returned object is owned by
<parameter>fontchooser</parameter>
and must not be modified or freed. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-get-font-size" role="function">
<title>gtk_font_chooser_get_font_size&#160;()</title>
<indexterm zone="gtk-font-chooser-get-font-size"><primary>gtk_font_chooser_get_font_size</primary></indexterm>
<programlisting language="C"><link linkend="gint"><returnvalue>gint</returnvalue></link>
gtk_font_chooser_get_font_size (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>);</programlisting>
<para>The selected font size.</para>
<refsect3 id="gtk-font-chooser-get-font-size.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-font-chooser-get-font-size.returns" role="returns">
<title>Returns</title>
<para> A n integer representing the selected font size,
or -1 if no font size is selected.</para>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-get-font" role="function">
<title>gtk_font_chooser_get_font&#160;()</title>
<indexterm zone="gtk-font-chooser-get-font"><primary>gtk_font_chooser_get_font</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_font_chooser_get_font (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>);</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-chooser-set-font"><function>gtk_font_chooser_set_font()</function></link>, as the font chooser 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”.</para>
<para>Use <link linkend="pango-font-description-equal"><function>pango_font_description_equal()</function></link> if you want to compare two
font descriptions.</para>
<refsect3 id="gtk-font-chooser-get-font.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-font-chooser-get-font.returns" role="returns">
<title>Returns</title>
<para>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>. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-set-font" role="function">
<title>gtk_font_chooser_set_font&#160;()</title>
<indexterm zone="gtk-font-chooser-set-font"><primary>gtk_font_chooser_set_font</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_font_chooser_set_font (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>,
                           <parameter>const <link linkend="gchar"><type>gchar</type></link> *fontname</parameter>);</programlisting>
<para>Sets the currently-selected font.</para>
<refsect3 id="gtk-font-chooser-set-font.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>fontname</para></entry>
<entry role="parameter_description"><para>a font name like “Helvetica 12” or “Times Bold 18”</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-get-font-desc" role="function">
<title>gtk_font_chooser_get_font_desc&#160;()</title>
<indexterm zone="gtk-font-chooser-get-font-desc"><primary>gtk_font_chooser_get_font_desc</primary></indexterm>
<programlisting language="C"><link linkend="PangoFontDescription"><returnvalue>PangoFontDescription</returnvalue></link>&#160;*
gtk_font_chooser_get_font_desc (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>);</programlisting>
<para>Gets the currently-selected font.</para>
<para>Note that this can be a different string than what you set with
<link linkend="gtk-font-chooser-set-font"><function>gtk_font_chooser_set_font()</function></link>, as the font chooser 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”.</para>
<para>Use <link linkend="pango-font-description-equal"><function>pango_font_description_equal()</function></link> if you want to compare two
font descriptions.</para>
<refsect3 id="gtk-font-chooser-get-font-desc.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-font-chooser-get-font-desc.returns" role="returns">
<title>Returns</title>
<para>A <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link> for the
current font, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if  no font is selected. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-set-font-desc" role="function">
<title>gtk_font_chooser_set_font_desc&#160;()</title>
<indexterm zone="gtk-font-chooser-set-font-desc"><primary>gtk_font_chooser_set_font_desc</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_font_chooser_set_font_desc (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>,
                                <parameter>const <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link> *font_desc</parameter>);</programlisting>
<para>Sets the currently-selected font from <parameter>font_desc</parameter>
.</para>
<refsect3 id="gtk-font-chooser-set-font-desc.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>font_desc</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-get-font-features" role="function">
<title>gtk_font_chooser_get_font_features&#160;()</title>
<indexterm zone="gtk-font-chooser-get-font-features"><primary>gtk_font_chooser_get_font_features</primary></indexterm>
<programlisting language="C"><link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
gtk_font_chooser_get_font_features (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>);</programlisting>
<para>Gets the currently-selected font features.</para>
<refsect3 id="gtk-font-chooser-get-font-features.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-font-chooser-get-font-features.returns" role="returns">
<title>Returns</title>
<para> the currently selected font features</para>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-get-language" role="function">
<title>gtk_font_chooser_get_language&#160;()</title>
<indexterm zone="gtk-font-chooser-get-language"><primary>gtk_font_chooser_get_language</primary></indexterm>
<programlisting language="C"><link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
gtk_font_chooser_get_language (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>);</programlisting>
<para>Gets the language that is used for font features.</para>
<refsect3 id="gtk-font-chooser-get-language.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-font-chooser-get-language.returns" role="returns">
<title>Returns</title>
<para> the currently selected language</para>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-set-language" role="function">
<title>gtk_font_chooser_set_language&#160;()</title>
<indexterm zone="gtk-font-chooser-set-language"><primary>gtk_font_chooser_set_language</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_font_chooser_set_language (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>,
                               <parameter>const <link linkend="char"><type>char</type></link> *language</parameter>);</programlisting>
<para>Sets the language to use for font features.</para>
<refsect3 id="gtk-font-chooser-set-language.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>language</para></entry>
<entry role="parameter_description"><para>a language</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-get-preview-text" role="function">
<title>gtk_font_chooser_get_preview_text&#160;()</title>
<indexterm zone="gtk-font-chooser-get-preview-text"><primary>gtk_font_chooser_get_preview_text</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_font_chooser_get_preview_text (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>);</programlisting>
<para>Gets the text displayed in the preview area.</para>
<refsect3 id="gtk-font-chooser-get-preview-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-font-chooser-get-preview-text.returns" role="returns">
<title>Returns</title>
<para>the text displayed in the
preview area. </para>
<para><emphasis role="annotation">[<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-set-preview-text" role="function">
<title>gtk_font_chooser_set_preview_text&#160;()</title>
<indexterm zone="gtk-font-chooser-set-preview-text"><primary>gtk_font_chooser_set_preview_text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_font_chooser_set_preview_text (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>,
                                   <parameter>const <link linkend="gchar"><type>gchar</type></link> *text</parameter>);</programlisting>
<para>Sets the text displayed in the preview area.
The <parameter>text</parameter>
 is used to show how the selected font looks.</para>
<refsect3 id="gtk-font-chooser-set-preview-text.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>text</para></entry>
<entry role="parameter_description"><para>the text to display in the preview area. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-get-show-preview-entry" role="function">
<title>gtk_font_chooser_get_show_preview_entry&#160;()</title>
<indexterm zone="gtk-font-chooser-get-show-preview-entry"><primary>gtk_font_chooser_get_show_preview_entry</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_font_chooser_get_show_preview_entry
                               (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>);</programlisting>
<para>Returns whether the preview entry is shown or not.</para>
<refsect3 id="gtk-font-chooser-get-show-preview-entry.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-font-chooser-get-show-preview-entry.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the preview entry is shown
or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> if it is hidden.</para>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-set-show-preview-entry" role="function">
<title>gtk_font_chooser_set_show_preview_entry&#160;()</title>
<indexterm zone="gtk-font-chooser-set-show-preview-entry"><primary>gtk_font_chooser_set_show_preview_entry</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_font_chooser_set_show_preview_entry
                               (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>,
                                <parameter><link linkend="gboolean"><type>gboolean</type></link> show_preview_entry</parameter>);</programlisting>
<para>Shows or hides the editable preview entry.</para>
<refsect3 id="gtk-font-chooser-set-show-preview-entry.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>show_preview_entry</para></entry>
<entry role="parameter_description"><para>whether to show the editable preview entry or not</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-get-level" role="function">
<title>gtk_font_chooser_get_level&#160;()</title>
<indexterm zone="gtk-font-chooser-get-level"><primary>gtk_font_chooser_get_level</primary></indexterm>
<programlisting language="C"><link linkend="GtkFontChooserLevel"><returnvalue>GtkFontChooserLevel</returnvalue></link>
gtk_font_chooser_get_level (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>);</programlisting>
<para>Returns the current level of granularity for selecting fonts.</para>
<refsect3 id="gtk-font-chooser-get-level.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-font-chooser-get-level.returns" role="returns">
<title>Returns</title>
<para> the current granularity level</para>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-set-level" role="function">
<title>gtk_font_chooser_set_level&#160;()</title>
<indexterm zone="gtk-font-chooser-set-level"><primary>gtk_font_chooser_set_level</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_font_chooser_set_level (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>,
                            <parameter><link linkend="GtkFontChooserLevel"><type>GtkFontChooserLevel</type></link> level</parameter>);</programlisting>
<para>Sets the desired level of granularity for selecting fonts.</para>
<refsect3 id="gtk-font-chooser-set-level.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>level</para></entry>
<entry role="parameter_description"><para>the desired level of granularity</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="GtkFontFilterFunc" role="function">
<title>GtkFontFilterFunc&#160;()</title>
<indexterm zone="GtkFontFilterFunc"><primary>GtkFontFilterFunc</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
<phrase role="c_punctuation">(</phrase>*GtkFontFilterFunc<phrase role="c_punctuation">)</phrase> (<parameter>const <link linkend="PangoFontFamily"><type>PangoFontFamily</type></link> *family</parameter>,
                      <parameter>const <link linkend="PangoFontFace"><type>PangoFontFace</type></link> *face</parameter>,
                      <parameter><link linkend="gpointer"><type>gpointer</type></link> data</parameter>);</programlisting>
<para>The type of function that is used for deciding what fonts get
shown in a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link>. See <link linkend="gtk-font-chooser-set-filter-func"><function>gtk_font_chooser_set_filter_func()</function></link>.</para>
<refsect3 id="GtkFontFilterFunc.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>family</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFontFamily"><type>PangoFontFamily</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>face</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFontFace"><type>PangoFontFace</type></link> belonging to <parameter>family</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>data</para></entry>
<entry role="parameter_description"><para>user data passed to <link linkend="gtk-font-chooser-set-filter-func"><function>gtk_font_chooser_set_filter_func()</function></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="GtkFontFilterFunc.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the font should be displayed</para>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-set-filter-func" role="function">
<title>gtk_font_chooser_set_filter_func&#160;()</title>
<indexterm zone="gtk-font-chooser-set-filter-func"><primary>gtk_font_chooser_set_filter_func</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_font_chooser_set_filter_func (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>,
                                  <parameter><link linkend="GtkFontFilterFunc"><type>GtkFontFilterFunc</type></link> filter</parameter>,
                                  <parameter><link linkend="gpointer"><type>gpointer</type></link> user_data</parameter>,
                                  <parameter><link linkend="GDestroyNotify"><type>GDestroyNotify</type></link> destroy</parameter>);</programlisting>
<para>Adds a filter function that decides which fonts to display
in the font chooser.</para>
<refsect3 id="gtk-font-chooser-set-filter-func.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>filter</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontFilterFunc"><type>GtkFontFilterFunc</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>user_data</para></entry>
<entry role="parameter_description"><para>data to pass to <parameter>filter</parameter>
. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>closure</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>destroy</para></entry>
<entry role="parameter_description"><para>function to call to free <parameter>data</parameter>
when it is no longer needed</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-set-font-map" role="function">
<title>gtk_font_chooser_set_font_map&#160;()</title>
<indexterm zone="gtk-font-chooser-set-font-map"><primary>gtk_font_chooser_set_font_map</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_font_chooser_set_font_map (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>,
                               <parameter><link linkend="PangoFontMap"><type>PangoFontMap</type></link> *fontmap</parameter>);</programlisting>
<para>Sets a custom font map to use for this font chooser widget.
A custom font map can be used to present application-specific
fonts instead of or in addition to the normal system fonts.</para>
<informalexample><programlisting role="example"><![CDATA[
FcConfig *config;
PangoFontMap *fontmap;

config = FcInitLoadConfigAndFonts ();
FcConfigAppFontAddFile (config, my_app_font_file);

fontmap = pango_cairo_font_map_new_for_font_type (CAIRO_FONT_TYPE_FT);
pango_fc_font_map_set_config (PANGO_FC_FONT_MAP (fontmap), config);

gtk_font_chooser_set_font_map (font_chooser, fontmap);
]]></programlisting></informalexample>
<para></para>
<para>Note that other GTK+ widgets will only be able to use the application-specific
font if it is present in the font map they use:</para>
<informalexample><programlisting role="example"><![CDATA[
context = gtk_widget_get_pango_context (label);
pango_context_set_font_map (context, fontmap);
]]></programlisting></informalexample>
<para></para>
<refsect3 id="gtk-font-chooser-set-font-map.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>fontmap</para></entry>
<entry role="parameter_description"><para>a <link linkend="PangoFontMap"><type>PangoFontMap</type></link>. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-font-chooser-get-font-map" role="function">
<title>gtk_font_chooser_get_font_map&#160;()</title>
<indexterm zone="gtk-font-chooser-get-font-map"><primary>gtk_font_chooser_get_font_map</primary></indexterm>
<programlisting language="C"><link linkend="PangoFontMap"><returnvalue>PangoFontMap</returnvalue></link>&#160;*
gtk_font_chooser_get_font_map (<parameter><link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *fontchooser</parameter>);</programlisting>
<para>Gets the custom font map of this font chooser widget,
or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if it does not have one.</para>
<refsect3 id="gtk-font-chooser-get-font-map.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>fontchooser</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkFontChooser"><type>GtkFontChooser</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-font-chooser-get-font-map.returns" role="returns">
<title>Returns</title>
<para>a <link linkend="PangoFontMap"><type>PangoFontMap</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>][<acronym>transfer full</acronym>]</emphasis></para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkFontChooser.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkFontChooser-struct" role="struct">
<title>GtkFontChooser</title>
<indexterm zone="GtkFontChooser-struct"><primary>GtkFontChooser</primary></indexterm>
<programlisting language="C">typedef struct _GtkFontChooser GtkFontChooser;</programlisting>
</refsect2>
<refsect2 id="GtkFontChooserLevel" role="enum">
<title>enum GtkFontChooserLevel</title>
<indexterm zone="GtkFontChooserLevel"><primary>GtkFontChooserLevel</primary></indexterm>
<para>This enumeration specifies the granularity of font selection
that is desired in a font chooser.</para>
<para>This enumeration may be extended in the future; applications should
ignore unknown values.</para>
<refsect3 id="GtkFontChooserLevel.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="GTK-FONT-CHOOSER-LEVEL-FAMILY:CAPS">GTK_FONT_CHOOSER_LEVEL_FAMILY</para></entry>
<entry role="enum_member_description"><para>Allow selecting a font family</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-FONT-CHOOSER-LEVEL-STYLE:CAPS">GTK_FONT_CHOOSER_LEVEL_STYLE</para></entry>
<entry role="enum_member_description"><para>Allow selecting a specific font face</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-FONT-CHOOSER-LEVEL-SIZE:CAPS">GTK_FONT_CHOOSER_LEVEL_SIZE</para></entry>
<entry role="enum_member_description"><para>Allow selecting a specific font size</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-FONT-CHOOSER-LEVEL-VARIATIONS:CAPS">GTK_FONT_CHOOSER_LEVEL_VARIATIONS</para></entry>
<entry role="enum_member_description"><para>Allow changing OpenType font variation axes</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-FONT-CHOOSER-LEVEL-FEATURES:CAPS">GTK_FONT_CHOOSER_LEVEL_FEATURES</para></entry>
<entry role="enum_member_description"><para>Allow selecting specific OpenType font features</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkFontChooser.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkFontChooser--font" role="property"><title>The <literal>“font”</literal> property</title>
<indexterm zone="GtkFontChooser--font"><primary>GtkFontChooser:font</primary></indexterm>
<programlisting>  “font”                     <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The font description as a string, e.g. "Sans Italic 12".</para>
<para>Owner: GtkFontChooser</para>
<para>Flags: Read / Write</para>
<para>Default value: "Sans 10"</para>
</refsect2>
<refsect2 id="GtkFontChooser--font-desc" role="property"><title>The <literal>“font-desc”</literal> property</title>
<indexterm zone="GtkFontChooser--font-desc"><primary>GtkFontChooser:font-desc</primary></indexterm>
<programlisting>  “font-desc”                <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>&#160;*</programlisting>
<para>The font description as a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>.</para>
<para>Owner: GtkFontChooser</para>
<para>Flags: Read / Write</para>
</refsect2>
<refsect2 id="GtkFontChooser--font-features" role="property"><title>The <literal>“font-features”</literal> property</title>
<indexterm zone="GtkFontChooser--font-features"><primary>GtkFontChooser:font-features</primary></indexterm>
<programlisting>  “font-features”            <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The selected font features, in a format that is compatible with
CSS and with Pango attributes.</para>
<para>Owner: GtkFontChooser</para>
<para>Flags: Read</para>
<para>Default value: ""</para>
</refsect2>
<refsect2 id="GtkFontChooser--language" role="property"><title>The <literal>“language”</literal> property</title>
<indexterm zone="GtkFontChooser--language"><primary>GtkFontChooser:language</primary></indexterm>
<programlisting>  “language”                 <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The language for which the <link linkend="GtkFontChooser--font-features"><type>“font-features”</type></link> were
selected, in a format that is compatible with CSS and with Pango
attributes.</para>
<para>Owner: GtkFontChooser</para>
<para>Flags: Read / Write</para>
<para>Default value: ""</para>
</refsect2>
<refsect2 id="GtkFontChooser--level" role="property"><title>The <literal>“level”</literal> property</title>
<indexterm zone="GtkFontChooser--level"><primary>GtkFontChooser:level</primary></indexterm>
<programlisting>  “level”                    <link linkend="GtkFontChooserLevel"><type>GtkFontChooserLevel</type></link></programlisting>
<para>The level of granularity to offer for selecting fonts.</para>
<para>Owner: GtkFontChooser</para>
<para>Flags: Read / Write</para>
<para>Default value: GTK_FONT_CHOOSER_LEVEL_STYLE | GTK_FONT_CHOOSER_LEVEL_SIZE</para>
</refsect2>
<refsect2 id="GtkFontChooser--preview-text" role="property"><title>The <literal>“preview-text”</literal> property</title>
<indexterm zone="GtkFontChooser--preview-text"><primary>GtkFontChooser:preview-text</primary></indexterm>
<programlisting>  “preview-text”             <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The string with which to preview the font.</para>
<para>Owner: GtkFontChooser</para>
<para>Flags: Read / Write</para>
<para>Default value: "The quick brown fox jumps over the lazy dog."</para>
</refsect2>
<refsect2 id="GtkFontChooser--show-preview-entry" role="property"><title>The <literal>“show-preview-entry”</literal> property</title>
<indexterm zone="GtkFontChooser--show-preview-entry"><primary>GtkFontChooser:show-preview-entry</primary></indexterm>
<programlisting>  “show-preview-entry”       <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether to show an entry to change the preview text.</para>
<para>Owner: GtkFontChooser</para>
<para>Flags: Read / Write</para>
<para>Default value: TRUE</para>
</refsect2>

</refsect1>
<refsect1 id="GtkFontChooser.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkFontChooser-font-activated" role="signal"><title>The <literal>“font-activated”</literal> signal</title>
<indexterm zone="GtkFontChooser-font-activated"><primary>GtkFontChooser::font-activated</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFontChooser"><type>GtkFontChooser</type></link> *self,
               <link linkend="gchar"><type>gchar</type></link>          *fontname,
               <link linkend="gpointer"><type>gpointer</type></link>        user_data)</programlisting>
<para>Emitted when a font is activated.
This usually happens when the user double clicks an item,
or an item is selected and the user presses one of the keys
Space, Shift+Space, Return or Enter.</para>
<refsect3 id="GtkFontChooser-font-activated.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>fontname</para></entry>
<entry role="parameter_description"><para>the font name</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-FIRST:CAPS">Run First</link></para>
</refsect2>
</refsect1>
<refsect1 id="GtkFontChooser.see-also">
<title>See Also</title>
<para><link linkend="GtkFontChooserDialog"><type>GtkFontChooserDialog</type></link>, <link linkend="GtkFontChooserWidget"><type>GtkFontChooserWidget</type></link>, <link linkend="GtkFontButton"><type>GtkFontButton</type></link></para>

</refsect1>

</refentry>
