<?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="GtkAppChooserButton">
<refmeta>
<refentrytitle role="top_of_page" id="GtkAppChooserButton.top_of_page">GtkAppChooserButton</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkAppChooserButton</refname>
<refpurpose>A button to launch an application chooser dialog</refpurpose>
</refnamediv>

<refsect1 id="GtkAppChooserButton.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-app-chooser-button-new">gtk_app_chooser_button_new</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-app-chooser-button-append-custom-item">gtk_app_chooser_button_append_custom_item</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-app-chooser-button-append-separator">gtk_app_chooser_button_append_separator</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-app-chooser-button-set-active-custom-item">gtk_app_chooser_button_set_active_custom_item</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-app-chooser-button-get-show-default-item">gtk_app_chooser_button_get_show_default_item</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-app-chooser-button-set-show-default-item">gtk_app_chooser_button_set_show_default_item</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-app-chooser-button-get-show-dialog-item">gtk_app_chooser_button_get_show_dialog_item</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-app-chooser-button-set-show-dialog-item">gtk_app_chooser_button_set_show_dialog_item</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-app-chooser-button-get-heading">gtk_app_chooser_button_get_heading</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-app-chooser-button-set-heading">gtk_app_chooser_button_set_heading</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-app-chooser-button-get-modal">gtk_app_chooser_button_get_modal</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-app-chooser-button-set-modal">gtk_app_chooser_button_set_modal</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkAppChooserButton.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="GtkAppChooserButton--heading">heading</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="GtkAppChooserButton--modal">modal</link></entry><entry role="property_flags">Read / Write / Construct</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkAppChooserButton--show-default-item">show-default-item</link></entry><entry role="property_flags">Read / Write / Construct</entry></row>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkAppChooserButton--show-dialog-item">show-dialog-item</link></entry><entry role="property_flags">Read / Write / Construct</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkAppChooserButton.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="GtkAppChooserButton-changed">changed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkAppChooserButton-custom-item-activated">custom-item-activated</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-DETAILED:CAPS">Has Details</link></entry></row>

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

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkAppChooserButton.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> GtkAppChooserButton
</screen>
</refsect1>
<refsect1 id="GtkAppChooserButton.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkAppChooserButton implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link>,  <link linkend="GtkConstraintTarget">GtkConstraintTarget</link> and  <link linkend="GtkAppChooser">GtkAppChooser</link>.</para>

</refsect1>

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

<refsect1 id="GtkAppChooserButton.description" role="desc">
<title role="desc.title">Description</title>
<para>The <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> is a widget that lets the user select
an application. It implements the <link linkend="GtkAppChooser"><type>GtkAppChooser</type></link> interface.</para>
<para>Initially, a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> selects the first application
in its list, which will either be the most-recently used application
or, if <link linkend="GtkAppChooserButton--show-default-item"><type>“show-default-item”</type></link> is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>, the
default application.</para>
<para>The list of applications shown in a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> includes
the recommended applications for the given content type. When
<link linkend="GtkAppChooserButton--show-default-item"><type>“show-default-item”</type></link> is set, the default application
is also included. To let the user chooser other applications,
you can set the <link linkend="GtkAppChooserButton--show-dialog-item"><type>“show-dialog-item”</type></link> property,
which allows to open a full <link linkend="GtkAppChooserDialog"><type>GtkAppChooserDialog</type></link>.</para>
<para>It is possible to add custom items to the list, using
<link linkend="gtk-app-chooser-button-append-custom-item"><function>gtk_app_chooser_button_append_custom_item()</function></link>. These items cause
the <link linkend="GtkAppChooserButton-custom-item-activated"><type>“custom-item-activated”</type></link> signal to be
emitted when they are selected.</para>
<para>To track changes in the selected application, use the
<link linkend="GtkAppChooserButton-changed"><type>“changed”</type></link> signal.</para>

</refsect1>
<refsect1 id="GtkAppChooserButton.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-app-chooser-button-new" role="function">
<title>gtk_app_chooser_button_new&#160;()</title>
<indexterm zone="gtk-app-chooser-button-new"><primary>gtk_app_chooser_button_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_app_chooser_button_new (<parameter>const <link linkend="gchar"><type>gchar</type></link> *content_type</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> for applications
that can handle content of the given type.</para>
<refsect3 id="gtk-app-chooser-button-new.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>content_type</para></entry>
<entry role="parameter_description"><para>the content type to show applications for</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-app-chooser-button-new.returns" role="returns">
<title>Returns</title>
<para> a newly created <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-app-chooser-button-append-custom-item" role="function">
<title>gtk_app_chooser_button_append_custom_item&#160;()</title>
<indexterm zone="gtk-app-chooser-button-append-custom-item"><primary>gtk_app_chooser_button_append_custom_item</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_app_chooser_button_append_custom_item
                               (<parameter><link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *self</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *label</parameter>,
                                <parameter><link linkend="GIcon"><type>GIcon</type></link> *icon</parameter>);</programlisting>
<para>Appends a custom item to the list of applications that is shown
in the popup; the item name must be unique per-widget.
Clients can use the provided name as a detail for the
<link linkend="GtkAppChooserButton-custom-item-activated"><type>“custom-item-activated”</type></link> signal, to add a
callback for the activation of a particular custom item in the list.
See also <link linkend="gtk-app-chooser-button-append-separator"><function>gtk_app_chooser_button_append_separator()</function></link>.</para>
<refsect3 id="gtk-app-chooser-button-append-custom-item.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>a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of the custom item</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>label</para></entry>
<entry role="parameter_description"><para>the label for the custom item</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>icon</para></entry>
<entry role="parameter_description"><para>the icon for the custom item</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-app-chooser-button-append-separator" role="function">
<title>gtk_app_chooser_button_append_separator&#160;()</title>
<indexterm zone="gtk-app-chooser-button-append-separator"><primary>gtk_app_chooser_button_append_separator</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_app_chooser_button_append_separator
                               (<parameter><link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *self</parameter>);</programlisting>
<para>Appends a separator to the list of applications that is shown
in the popup.</para>
<refsect3 id="gtk-app-chooser-button-append-separator.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>a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-app-chooser-button-set-active-custom-item" role="function">
<title>gtk_app_chooser_button_set_active_custom_item&#160;()</title>
<indexterm zone="gtk-app-chooser-button-set-active-custom-item"><primary>gtk_app_chooser_button_set_active_custom_item</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_app_chooser_button_set_active_custom_item
                               (<parameter><link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *self</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *name</parameter>);</programlisting>
<para>Selects a custom item previously added with
<link linkend="gtk-app-chooser-button-append-custom-item"><function>gtk_app_chooser_button_append_custom_item()</function></link>.</para>
<para>Use <link linkend="gtk-app-chooser-refresh"><function>gtk_app_chooser_refresh()</function></link> to bring the selection
to its initial state.</para>
<refsect3 id="gtk-app-chooser-button-set-active-custom-item.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>a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>name</para></entry>
<entry role="parameter_description"><para>the name of the custom item</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-app-chooser-button-get-show-default-item" role="function">
<title>gtk_app_chooser_button_get_show_default_item&#160;()</title>
<indexterm zone="gtk-app-chooser-button-get-show-default-item"><primary>gtk_app_chooser_button_get_show_default_item</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_app_chooser_button_get_show_default_item
                               (<parameter><link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *self</parameter>);</programlisting>
<para>Returns the current value of the <link linkend="GtkAppChooserButton--show-default-item"><type>“show-default-item”</type></link>
property.</para>
<refsect3 id="gtk-app-chooser-button-get-show-default-item.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>a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-app-chooser-button-get-show-default-item.returns" role="returns">
<title>Returns</title>
<para> the value of <link linkend="GtkAppChooserButton--show-default-item"><type>“show-default-item”</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-app-chooser-button-set-show-default-item" role="function">
<title>gtk_app_chooser_button_set_show_default_item&#160;()</title>
<indexterm zone="gtk-app-chooser-button-set-show-default-item"><primary>gtk_app_chooser_button_set_show_default_item</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_app_chooser_button_set_show_default_item
                               (<parameter><link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *self</parameter>,
                                <parameter><link linkend="gboolean"><type>gboolean</type></link> setting</parameter>);</programlisting>
<para>Sets whether the dropdown menu of this button should show the
default application for the given content type at top.</para>
<refsect3 id="gtk-app-chooser-button-set-show-default-item.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>a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>setting</para></entry>
<entry role="parameter_description"><para>the new value for <link linkend="GtkAppChooserButton--show-default-item"><type>“show-default-item”</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-app-chooser-button-get-show-dialog-item" role="function">
<title>gtk_app_chooser_button_get_show_dialog_item&#160;()</title>
<indexterm zone="gtk-app-chooser-button-get-show-dialog-item"><primary>gtk_app_chooser_button_get_show_dialog_item</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_app_chooser_button_get_show_dialog_item
                               (<parameter><link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *self</parameter>);</programlisting>
<para>Returns the current value of the <link linkend="GtkAppChooserButton--show-dialog-item"><type>“show-dialog-item”</type></link>
property.</para>
<refsect3 id="gtk-app-chooser-button-get-show-dialog-item.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>a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-app-chooser-button-get-show-dialog-item.returns" role="returns">
<title>Returns</title>
<para> the value of <link linkend="GtkAppChooserButton--show-dialog-item"><type>“show-dialog-item”</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-app-chooser-button-set-show-dialog-item" role="function">
<title>gtk_app_chooser_button_set_show_dialog_item&#160;()</title>
<indexterm zone="gtk-app-chooser-button-set-show-dialog-item"><primary>gtk_app_chooser_button_set_show_dialog_item</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_app_chooser_button_set_show_dialog_item
                               (<parameter><link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *self</parameter>,
                                <parameter><link linkend="gboolean"><type>gboolean</type></link> setting</parameter>);</programlisting>
<para>Sets whether the dropdown menu of this button should show an
entry to trigger a <link linkend="GtkAppChooserDialog"><type>GtkAppChooserDialog</type></link>.</para>
<refsect3 id="gtk-app-chooser-button-set-show-dialog-item.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>a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>setting</para></entry>
<entry role="parameter_description"><para>the new value for <link linkend="GtkAppChooserButton--show-dialog-item"><type>“show-dialog-item”</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-app-chooser-button-get-heading" role="function">
<title>gtk_app_chooser_button_get_heading&#160;()</title>
<indexterm zone="gtk-app-chooser-button-get-heading"><primary>gtk_app_chooser_button_get_heading</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
gtk_app_chooser_button_get_heading (<parameter><link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *self</parameter>);</programlisting>
<para>Returns the text to display at the top of the dialog.</para>
<refsect3 id="gtk-app-chooser-button-get-heading.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>a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-app-chooser-button-get-heading.returns" role="returns">
<title>Returns</title>
<para>the text to display at the top of the dialog,
or <link linkend="NULL:CAPS"><literal>NULL</literal></link>, in which case a default text is displayed. </para>
<para><emphasis role="annotation">[<acronym>nullable</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-app-chooser-button-set-heading" role="function">
<title>gtk_app_chooser_button_set_heading&#160;()</title>
<indexterm zone="gtk-app-chooser-button-set-heading"><primary>gtk_app_chooser_button_set_heading</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_app_chooser_button_set_heading (<parameter><link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *self</parameter>,
                                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *heading</parameter>);</programlisting>
<para>Sets the text to display at the top of the dialog.
If the heading is not set, the dialog displays a default text.</para>
<refsect3 id="gtk-app-chooser-button-set-heading.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>a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>heading</para></entry>
<entry role="parameter_description"><para>a string containing Pango markup</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-app-chooser-button-get-modal" role="function">
<title>gtk_app_chooser_button_get_modal&#160;()</title>
<indexterm zone="gtk-app-chooser-button-get-modal"><primary>gtk_app_chooser_button_get_modal</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
gtk_app_chooser_button_get_modal (<parameter><link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *self</parameter>);</programlisting>
<para>Gets whether the dialog is modal.</para>
<refsect3 id="gtk-app-chooser-button-get-modal.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>a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-app-chooser-button-get-modal.returns" role="returns">
<title>Returns</title>
<para> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the dialog is modal</para>
</refsect3></refsect2>
<refsect2 id="gtk-app-chooser-button-set-modal" role="function">
<title>gtk_app_chooser_button_set_modal&#160;()</title>
<indexterm zone="gtk-app-chooser-button-set-modal"><primary>gtk_app_chooser_button_set_modal</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_app_chooser_button_set_modal (<parameter><link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *self</parameter>,
                                  <parameter><link linkend="gboolean"><type>gboolean</type></link> modal</parameter>);</programlisting>
<para>Sets whether the dialog should be modal.</para>
<refsect3 id="gtk-app-chooser-button-set-modal.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>a <link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>modal</para></entry>
<entry role="parameter_description"><para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> to make the dialog modal</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

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

</refsect1>
<refsect1 id="GtkAppChooserButton.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkAppChooserButton--heading" role="property"><title>The <literal>“heading”</literal> property</title>
<indexterm zone="GtkAppChooserButton--heading"><primary>GtkAppChooserButton:heading</primary></indexterm>
<programlisting>  “heading”                  <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The text to show at the top of the dialog that can be
opened from the button. The string may contain Pango markup.</para>
<para>Owner: GtkAppChooserButton</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkAppChooserButton--modal" role="property"><title>The <literal>“modal”</literal> property</title>
<indexterm zone="GtkAppChooserButton--modal"><primary>GtkAppChooserButton:modal</primary></indexterm>
<programlisting>  “modal”                    <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Whether the dialog should be modal.</para><para>Owner: GtkAppChooserButton</para>
<para>Flags: Read / Write / Construct</para>
<para>Default value: TRUE</para>
</refsect2>
<refsect2 id="GtkAppChooserButton--show-default-item" role="property"><title>The <literal>“show-default-item”</literal> property</title>
<indexterm zone="GtkAppChooserButton--show-default-item"><primary>GtkAppChooserButton:show-default-item</primary></indexterm>
<programlisting>  “show-default-item”        <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>The <link linkend="GtkAppChooserButton--show-default-item"><type>“show-default-item”</type></link> property determines
whether the dropdown menu should show the default application
on top for the provided content type.</para>
<para>Owner: GtkAppChooserButton</para>
<para>Flags: Read / Write / Construct</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkAppChooserButton--show-dialog-item" role="property"><title>The <literal>“show-dialog-item”</literal> property</title>
<indexterm zone="GtkAppChooserButton--show-dialog-item"><primary>GtkAppChooserButton:show-dialog-item</primary></indexterm>
<programlisting>  “show-dialog-item”         <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>The <link linkend="GtkAppChooserButton--show-dialog-item"><type>“show-dialog-item”</type></link> property determines
whether the dropdown menu should show an item that triggers
a <link linkend="GtkAppChooserDialog"><type>GtkAppChooserDialog</type></link> when clicked.</para>
<para>Owner: GtkAppChooserButton</para>
<para>Flags: Read / Write / Construct</para>
<para>Default value: FALSE</para>
</refsect2>

</refsect1>
<refsect1 id="GtkAppChooserButton.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkAppChooserButton-changed" role="signal"><title>The <literal>“changed”</literal> signal</title>
<indexterm zone="GtkAppChooserButton-changed"><primary>GtkAppChooserButton::changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *appchooserbutton,
               <link linkend="gpointer"><type>gpointer</type></link>             user_data)</programlisting>
<para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2><refsect2 id="GtkAppChooserButton-custom-item-activated" role="signal"><title>The <literal>“custom-item-activated”</literal> signal</title>
<indexterm zone="GtkAppChooserButton-custom-item-activated"><primary>GtkAppChooserButton::custom-item-activated</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkAppChooserButton"><type>GtkAppChooserButton</type></link> *self,
               <link linkend="gchar"><type>gchar</type></link>               *item_name,
               <link linkend="gpointer"><type>gpointer</type></link>             user_data)</programlisting>
<para>Emitted when a custom item, previously added with
<link linkend="gtk-app-chooser-button-append-custom-item"><function>gtk_app_chooser_button_append_custom_item()</function></link>, is activated from the
dropdown menu.</para>
<refsect3 id="GtkAppChooserButton-custom-item-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>item_name</para></entry>
<entry role="parameter_description"><para>the name of the activated item</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-DETAILED:CAPS">Has Details</link></para>
</refsect2>
</refsect1>

</refentry>
