<?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="GtkFontChooserWidget">
<refmeta>
<refentrytitle role="top_of_page" id="GtkFontChooserWidget.top_of_page">GtkFontChooserWidget</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkFontChooserWidget</refname>
<refpurpose>A widget for selecting fonts</refpurpose>
</refnamediv>

<refsect1 id="GtkFontChooserWidget.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="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-font-chooser-widget-new">gtk_font_chooser_widget_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkFontChooserWidget.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="GAction"><type>GAction</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkFontChooserWidget--tweak-action">tweak-action</link></entry><entry role="property_flags">Read</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkFontChooserWidget.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="GtkFontChooserWidget-struct">GtkFontChooserWidget</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkFontChooserWidget.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkWidget">GtkWidget</link>
            <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkFontChooserWidget
</screen>
</refsect1>
<refsect1 id="GtkFontChooserWidget.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkFontChooserWidget implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link>,  <link linkend="GtkConstraintTarget">GtkConstraintTarget</link> and  <link linkend="GtkFontChooser">GtkFontChooser</link>.</para>

</refsect1>

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

<refsect1 id="GtkFontChooserWidget.description" role="desc">
<title role="desc.title">Description</title>
<para>The <link linkend="GtkFontChooserWidget"><type>GtkFontChooserWidget</type></link> widget lists the available fonts,
styles and sizes, allowing the user to select a font. It is
used in the <link linkend="GtkFontChooserDialog"><type>GtkFontChooserDialog</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-chooser-set-font"><function>gtk_font_chooser_set_font()</function></link> or <link linkend="gtk-font-chooser-set-font-desc"><function>gtk_font_chooser_set_font_desc()</function></link>.</para>
<para>To get the selected font use <link linkend="gtk-font-chooser-get-font"><function>gtk_font_chooser_get_font()</function></link> or
<link linkend="gtk-font-chooser-get-font-desc"><function>gtk_font_chooser_get_font_desc()</function></link>.</para>
<para>To change the text which is shown in the preview area, use
<link linkend="gtk-font-chooser-set-preview-text"><function>gtk_font_chooser_set_preview_text()</function></link>.</para>
<refsect2><title>CSS nodes</title><para>GtkFontChooserWidget has a single CSS node with name fontchooser.</para>
</refsect2>

</refsect1>
<refsect1 id="GtkFontChooserWidget.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-font-chooser-widget-new" role="function">
<title>gtk_font_chooser_widget_new&#160;()</title>
<indexterm zone="gtk-font-chooser-widget-new"><primary>gtk_font_chooser_widget_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_font_chooser_widget_new (<parameter><type>void</type></parameter>);</programlisting>
<para>Creates a new <link linkend="GtkFontChooserWidget"><type>GtkFontChooserWidget</type></link>.</para>
<refsect3 id="gtk-font-chooser-widget-new.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkFontChooserWidget"><type>GtkFontChooserWidget</type></link></para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkFontChooserWidget.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkFontChooserWidget-struct" role="struct">
<title>GtkFontChooserWidget</title>
<indexterm zone="GtkFontChooserWidget-struct"><primary>GtkFontChooserWidget</primary></indexterm>
<programlisting language="C">typedef struct _GtkFontChooserWidget GtkFontChooserWidget;</programlisting>
</refsect2>

</refsect1>
<refsect1 id="GtkFontChooserWidget.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkFontChooserWidget--tweak-action" role="property"><title>The <literal>“tweak-action”</literal> property</title>
<indexterm zone="GtkFontChooserWidget--tweak-action"><primary>GtkFontChooserWidget:tweak-action</primary></indexterm>
<programlisting>  “tweak-action”             <link linkend="GAction"><type>GAction</type></link>&#160;*</programlisting>
<para>A toggle action that can be used to switch to the tweak page
of the font chooser widget, which lets the user tweak the
OpenType features and variation axes of the selected font.</para>
<para>The action will be enabled or disabled depending on whether
the selected font has any features or axes.</para>
<para>Owner: GtkFontChooserWidget</para>
<para>Flags: Read</para>
</refsect2>

</refsect1>
<refsect1 id="GtkFontChooserWidget.see-also">
<title>See Also</title>
<para><link linkend="GtkFontChooserDialog"><type>GtkFontChooserDialog</type></link></para>

</refsect1>

</refentry>
