<?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="GtkMessageDialog">
<refmeta>
<refentrytitle role="top_of_page" id="GtkMessageDialog.top_of_page">GtkMessageDialog</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkMessageDialog</refname>
<refpurpose>A convenient message window</refpurpose>
</refnamediv>

<refsect1 id="GtkMessageDialog.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-message-dialog-new">gtk_message_dialog_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-message-dialog-new-with-markup">gtk_message_dialog_new_with_markup</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-message-dialog-set-markup">gtk_message_dialog_set_markup</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-message-dialog-format-secondary-text">gtk_message_dialog_format_secondary_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-message-dialog-format-secondary-markup">gtk_message_dialog_format_secondary_markup</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-message-dialog-get-message-area">gtk_message_dialog_get_message_area</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkMessageDialog.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="GtkButtonsType"><type>GtkButtonsType</type></link></entry><entry role="property_name"><link linkend="GtkMessageDialog--buttons">buttons</link></entry><entry role="property_flags">Write / Construct&#160;Only</entry></row>
<row><entry role="property_type"><link linkend="GtkWidget"><type>GtkWidget</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkMessageDialog--message-area">message-area</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="GtkMessageType"><type>GtkMessageType</type></link></entry><entry role="property_name"><link linkend="GtkMessageDialog--message-type">message-type</link></entry><entry role="property_flags">Read / Write / Construct</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkMessageDialog--secondary-text">secondary-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="GtkMessageDialog--secondary-use-markup">secondary-use-markup</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="GtkMessageDialog--text">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="GtkMessageDialog--use-markup">use-markup</link></entry><entry role="property_flags">Read / Write</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkMessageDialog.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">struct</entry><entry role="function_name"><link linkend="GtkMessageDialog-struct">GtkMessageDialog</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkMessageType">GtkMessageType</link></entry></row>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="GtkButtonsType">GtkButtonsType</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkMessageDialog.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> <link linkend="GtkWindow">GtkWindow</link>
                <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkDialog">GtkDialog</link>
                    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkMessageDialog
</screen>
</refsect1>
<refsect1 id="GtkMessageDialog.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkMessageDialog implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link>,  <link linkend="GtkConstraintTarget">GtkConstraintTarget</link>,  <link linkend="GtkNative">GtkNative</link>,  <link linkend="GtkShortcutManager">GtkShortcutManager</link> and  <link linkend="GtkRoot">GtkRoot</link>.</para>

</refsect1>

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

<refsect1 id="GtkMessageDialog.description" role="desc">
<title role="desc.title">Description</title>
<para><link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link> presents a dialog with some message text. It’s simply a
convenience widget; you could construct the equivalent of <link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link>
from <link linkend="GtkDialog"><type>GtkDialog</type></link> without too much effort, but <link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link> saves typing.</para>
<para>The easiest way to do a modal message dialog is to use the <link linkend="GTK-DIALOG-MODAL:CAPS"><literal>GTK_DIALOG_MODAL</literal></link>
flag, which will call <link linkend="gtk-window-set-modal"><function>gtk_window_set_modal()</function></link> internally. The dialog will
prevent interaction with the parent window until it's hidden or destroyed.
You can use the <link linkend="GtkDialog-response"><type>“response”</type></link> signal to know when the user dismissed
the dialog.</para>
<para>An example for using a modal dialog:</para>
<informalexample><programlisting role="example"><![CDATA[
 GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT | GTK_DIALOG_MODAL;
 dialog = gtk_message_dialog_new (parent_window,
                                  flags,
                                  GTK_MESSAGE_ERROR,
                                  GTK_BUTTONS_CLOSE,
                                  "Error reading “%s”: %s",
                                  filename,
                                  g_strerror (errno));
 // Destroy the dialog when the user responds to it
 // (e.g. clicks a button)

 g_signal_connect (dialog, "response",
                   G_CALLBACK (gtk_window_destroy),
                   NULL);
]]></programlisting></informalexample>
<para></para>
<para>You might do a non-modal <link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link> simply by omitting the
<link linkend="GTK-DIALOG-MODAL:CAPS"><literal>GTK_DIALOG_MODAL</literal></link> flag:</para>
<informalexample><programlisting role="example"><![CDATA[
 GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT;
 dialog = gtk_message_dialog_new (parent_window,
                                  flags,
                                  GTK_MESSAGE_ERROR,
                                  GTK_BUTTONS_CLOSE,
                                  "Error reading “%s”: %s",
                                  filename,
                                  g_strerror (errno));

 // Destroy the dialog when the user responds to it
 // (e.g. clicks a button)
 g_signal_connect (dialog, "response",
                   G_CALLBACK (gtk_window_destroy),
                   NULL);
]]></programlisting></informalexample>
<para></para>
<refsect2><title>GtkMessageDialog as GtkBuildable</title><para>The GtkMessageDialog implementation of the GtkBuildable interface exposes
the message area as an internal child with the name “message_area”.</para>
</refsect2>

</refsect1>
<refsect1 id="GtkMessageDialog.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-message-dialog-new" role="function">
<title>gtk_message_dialog_new&#160;()</title>
<indexterm zone="gtk-message-dialog-new"><primary>gtk_message_dialog_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_message_dialog_new (<parameter><link linkend="GtkWindow"><type>GtkWindow</type></link> *parent</parameter>,
                        <parameter><link linkend="GtkDialogFlags"><type>GtkDialogFlags</type></link> flags</parameter>,
                        <parameter><link linkend="GtkMessageType"><type>GtkMessageType</type></link> type</parameter>,
                        <parameter><link linkend="GtkButtonsType"><type>GtkButtonsType</type></link> buttons</parameter>,
                        <parameter>const <link linkend="gchar"><type>gchar</type></link> *message_format</parameter>,
                        <parameter>...</parameter>);</programlisting>
<para>Creates a new message dialog, which is a simple dialog with some text
the user may want to see. When the user clicks a button a “response”
signal is emitted with response IDs from <link linkend="GtkResponseType"><type>GtkResponseType</type></link>. See
<link linkend="GtkDialog"><type>GtkDialog</type></link> for more details.</para>
<refsect3 id="gtk-message-dialog-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>parent</para></entry>
<entry role="parameter_description"><para>transient parent, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> for none. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>type of message</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>buttons</para></entry>
<entry role="parameter_description"><para>set of buttons to use</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>message_format</para></entry>
<entry role="parameter_description"><para>printf()-style format string, 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>...</para></entry>
<entry role="parameter_description"><para>arguments for <parameter>message_format</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-message-dialog-new.returns" role="returns">
<title>Returns</title>
<para>a new <link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link>. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>
<refsect2 id="gtk-message-dialog-new-with-markup" role="function">
<title>gtk_message_dialog_new_with_markup&#160;()</title>
<indexterm zone="gtk-message-dialog-new-with-markup"><primary>gtk_message_dialog_new_with_markup</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_message_dialog_new_with_markup (<parameter><link linkend="GtkWindow"><type>GtkWindow</type></link> *parent</parameter>,
                                    <parameter><link linkend="GtkDialogFlags"><type>GtkDialogFlags</type></link> flags</parameter>,
                                    <parameter><link linkend="GtkMessageType"><type>GtkMessageType</type></link> type</parameter>,
                                    <parameter><link linkend="GtkButtonsType"><type>GtkButtonsType</type></link> buttons</parameter>,
                                    <parameter>const <link linkend="gchar"><type>gchar</type></link> *message_format</parameter>,
                                    <parameter>...</parameter>);</programlisting>
<para>Creates a new message dialog, which is a simple dialog with some text that
is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>.
When the user clicks a button a “response” signal is emitted with
response IDs from <link linkend="GtkResponseType"><type>GtkResponseType</type></link>. See <link linkend="GtkDialog"><type>GtkDialog</type></link> for more details.</para>
<para>Special XML characters in the <link linkend="printf"><function>printf()</function></link> arguments passed to this
function will automatically be escaped as necessary.
(See <link linkend="g-markup-printf-escaped"><function>g_markup_printf_escaped()</function></link> for how this is implemented.)
Usually this is what you want, but if you have an existing
Pango markup string that you want to use literally as the
label, then you need to use <link linkend="gtk-message-dialog-set-markup"><function>gtk_message_dialog_set_markup()</function></link>
instead, since you can’t pass the markup string either
as the format (it might contain “%” characters) or as a string
argument.</para>
<informalexample><programlisting role="example"><![CDATA[
 GtkWidget *dialog;
 GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT;
 dialog = gtk_message_dialog_new (parent_window,
                                  flags,
                                  GTK_MESSAGE_ERROR,
                                  GTK_BUTTONS_CLOSE,
                                  NULL);
 gtk_message_dialog_set_markup (GTK_MESSAGE_DIALOG (dialog),
                                markup);
]]></programlisting></informalexample>
<para></para>
<refsect3 id="gtk-message-dialog-new-with-markup.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>parent</para></entry>
<entry role="parameter_description"><para>transient parent, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> for none. </para></entry>
<entry role="parameter_annotations"><emphasis role="annotation">[<acronym>allow-none</acronym>]</emphasis></entry></row>
<row><entry role="parameter_name"><para>flags</para></entry>
<entry role="parameter_description"><para>flags</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>type</para></entry>
<entry role="parameter_description"><para>type of message</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>buttons</para></entry>
<entry role="parameter_description"><para>set of buttons to use</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>message_format</para></entry>
<entry role="parameter_description"><para>printf()-style format string, 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>...</para></entry>
<entry role="parameter_description"><para>arguments for <parameter>message_format</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-message-dialog-new-with-markup.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link></para>
</refsect3></refsect2>
<refsect2 id="gtk-message-dialog-set-markup" role="function">
<title>gtk_message_dialog_set_markup&#160;()</title>
<indexterm zone="gtk-message-dialog-set-markup"><primary>gtk_message_dialog_set_markup</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_message_dialog_set_markup (<parameter><link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link> *message_dialog</parameter>,
                               <parameter>const <link linkend="gchar"><type>gchar</type></link> *str</parameter>);</programlisting>
<para>Sets the text of the message dialog to be <parameter>str</parameter>
, which is marked
up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>.</para>
<refsect3 id="gtk-message-dialog-set-markup.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>message_dialog</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>str</para></entry>
<entry role="parameter_description"><para>markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>)</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-message-dialog-format-secondary-text" role="function">
<title>gtk_message_dialog_format_secondary_text&#160;()</title>
<indexterm zone="gtk-message-dialog-format-secondary-text"><primary>gtk_message_dialog_format_secondary_text</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_message_dialog_format_secondary_text
                               (<parameter><link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link> *message_dialog</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *message_format</parameter>,
                                <parameter>...</parameter>);</programlisting>
<para>Sets the secondary text of the message dialog to be <parameter>message_format</parameter>

(with <link linkend="printf"><function>printf()</function></link>-style).</para>
<refsect3 id="gtk-message-dialog-format-secondary-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>message_dialog</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>message_format</para></entry>
<entry role="parameter_description"><para>printf()-style format string, 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>...</para></entry>
<entry role="parameter_description"><para>arguments for <parameter>message_format</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-message-dialog-format-secondary-markup" role="function">
<title>gtk_message_dialog_format_secondary_markup&#160;()</title>
<indexterm zone="gtk-message-dialog-format-secondary-markup"><primary>gtk_message_dialog_format_secondary_markup</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
gtk_message_dialog_format_secondary_markup
                               (<parameter><link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link> *message_dialog</parameter>,
                                <parameter>const <link linkend="gchar"><type>gchar</type></link> *message_format</parameter>,
                                <parameter>...</parameter>);</programlisting>
<para>Sets the secondary text of the message dialog to be <parameter>message_format</parameter>
 (with
<link linkend="printf"><function>printf()</function></link>-style), which is marked up with the
<link linkend="PangoMarkupFormat">Pango text markup language</link>.</para>
<para>Due to an oversight, this function does not escape special XML characters
like <link linkend="gtk-message-dialog-new-with-markup"><function>gtk_message_dialog_new_with_markup()</function></link> does. Thus, if the arguments
may contain special XML characters, you should use <link linkend="g-markup-printf-escaped"><function>g_markup_printf_escaped()</function></link>
to escape it.</para>
<informalexample><programlisting role="example"><![CDATA[
gchar *msg;

msg = g_markup_printf_escaped (message_format, ...);
gtk_message_dialog_format_secondary_markup (message_dialog,
                                            "%s", msg);
g_free (msg);
]]></programlisting></informalexample>
<para></para>
<refsect3 id="gtk-message-dialog-format-secondary-markup.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>message_dialog</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>message_format</para></entry>
<entry role="parameter_description"><para>printf()-style markup string (see
<link linkend="PangoMarkupFormat">Pango markup format</link>), or <link linkend="NULL:CAPS"><literal>NULL</literal></link></para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>...</para></entry>
<entry role="parameter_description"><para>arguments for <parameter>message_format</parameter>
</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="gtk-message-dialog-get-message-area" role="function">
<title>gtk_message_dialog_get_message_area&#160;()</title>
<indexterm zone="gtk-message-dialog-get-message-area"><primary>gtk_message_dialog_get_message_area</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_message_dialog_get_message_area (<parameter><link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link> *message_dialog</parameter>);</programlisting>
<para>Returns the message area of the dialog. This is the box where the
dialog’s primary and secondary labels are packed. You can add your
own extra content to that box and it will appear below those labels.
See <link linkend="gtk-dialog-get-content-area"><function>gtk_dialog_get_content_area()</function></link> for the corresponding
function in the parent <link linkend="GtkDialog"><type>GtkDialog</type></link>.</para>
<refsect3 id="gtk-message-dialog-get-message-area.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>message_dialog</para></entry>
<entry role="parameter_description"><para>a <link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link></para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-message-dialog-get-message-area.returns" role="returns">
<title>Returns</title>
<para>A <link linkend="GtkBox"><type>GtkBox</type></link> corresponding to the
“message area” in the <parameter>message_dialog</parameter>
. </para>
<para><emphasis role="annotation">[<acronym>transfer none</acronym>]</emphasis></para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkMessageDialog.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkMessageDialog-struct" role="struct">
<title>struct GtkMessageDialog</title>
<indexterm zone="GtkMessageDialog-struct"><primary>GtkMessageDialog</primary></indexterm>
<programlisting language="C">struct GtkMessageDialog;</programlisting>
</refsect2>
<refsect2 id="GtkMessageType" role="enum">
<title>enum GtkMessageType</title>
<indexterm zone="GtkMessageType"><primary>GtkMessageType</primary></indexterm>
<para>The type of message being displayed in the dialog.</para>
<refsect3 id="GtkMessageType.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-MESSAGE-INFO:CAPS">GTK_MESSAGE_INFO</para></entry>
<entry role="enum_member_description"><para>Informational message</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-MESSAGE-WARNING:CAPS">GTK_MESSAGE_WARNING</para></entry>
<entry role="enum_member_description"><para>Non-fatal warning message</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-MESSAGE-QUESTION:CAPS">GTK_MESSAGE_QUESTION</para></entry>
<entry role="enum_member_description"><para>Question requiring a choice</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-MESSAGE-ERROR:CAPS">GTK_MESSAGE_ERROR</para></entry>
<entry role="enum_member_description"><para>Fatal error message</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-MESSAGE-OTHER:CAPS">GTK_MESSAGE_OTHER</para></entry>
<entry role="enum_member_description"><para>None of the above</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="GtkButtonsType" role="enum">
<title>enum GtkButtonsType</title>
<indexterm zone="GtkButtonsType"><primary>GtkButtonsType</primary></indexterm>
<para>Prebuilt sets of buttons for the dialog. If
none of these choices are appropriate, simply use <link linkend="GTK-BUTTONS-NONE:CAPS"><literal>GTK_BUTTONS_NONE</literal></link>
then call <link linkend="gtk-dialog-add-buttons"><function>gtk_dialog_add_buttons()</function></link>.</para>
<blockquote>
<para>Please note that <link linkend="GTK-BUTTONS-OK:CAPS"><literal>GTK_BUTTONS_OK</literal></link>, <link linkend="GTK-BUTTONS-YES-NO:CAPS"><literal>GTK_BUTTONS_YES_NO</literal></link>
and <link linkend="GTK-BUTTONS-OK-CANCEL:CAPS"><literal>GTK_BUTTONS_OK_CANCEL</literal></link> are discouraged by the
<ulink url="http://library.gnome.org/devel/hig-book/stable/">GNOME Human Interface Guidelines</ulink>.</para>
</blockquote>
<refsect3 id="GtkButtonsType.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-BUTTONS-NONE:CAPS">GTK_BUTTONS_NONE</para></entry>
<entry role="enum_member_description"><para>no buttons at all</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-BUTTONS-OK:CAPS">GTK_BUTTONS_OK</para></entry>
<entry role="enum_member_description"><para>an OK button</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-BUTTONS-CLOSE:CAPS">GTK_BUTTONS_CLOSE</para></entry>
<entry role="enum_member_description"><para>a Close button</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-BUTTONS-CANCEL:CAPS">GTK_BUTTONS_CANCEL</para></entry>
<entry role="enum_member_description"><para>a Cancel button</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-BUTTONS-YES-NO:CAPS">GTK_BUTTONS_YES_NO</para></entry>
<entry role="enum_member_description"><para>Yes and No buttons</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="GTK-BUTTONS-OK-CANCEL:CAPS">GTK_BUTTONS_OK_CANCEL</para></entry>
<entry role="enum_member_description"><para>OK and Cancel buttons</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkMessageDialog.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkMessageDialog--buttons" role="property"><title>The <literal>“buttons”</literal> property</title>
<indexterm zone="GtkMessageDialog--buttons"><primary>GtkMessageDialog:buttons</primary></indexterm>
<programlisting>  “buttons”                  <link linkend="GtkButtonsType"><type>GtkButtonsType</type></link></programlisting>
<para>The buttons shown in the message dialog.</para><para>Owner: GtkMessageDialog</para>
<para>Flags: Write / Construct&#160;Only</para>
<para>Default value: GTK_BUTTONS_NONE</para>
</refsect2>
<refsect2 id="GtkMessageDialog--message-area" role="property"><title>The <literal>“message-area”</literal> property</title>
<indexterm zone="GtkMessageDialog--message-area"><primary>GtkMessageDialog:message-area</primary></indexterm>
<programlisting>  “message-area”             <link linkend="GtkWidget"><type>GtkWidget</type></link>&#160;*</programlisting>
<para>The <link linkend="GtkBox"><type>GtkBox</type></link> that corresponds to the message area of this dialog.  See
<link linkend="gtk-message-dialog-get-message-area"><function>gtk_message_dialog_get_message_area()</function></link> for a detailed description of this
area.</para>
<para>Owner: GtkMessageDialog</para>
<para>Flags: Read</para>
</refsect2>
<refsect2 id="GtkMessageDialog--message-type" role="property"><title>The <literal>“message-type”</literal> property</title>
<indexterm zone="GtkMessageDialog--message-type"><primary>GtkMessageDialog:message-type</primary></indexterm>
<programlisting>  “message-type”             <link linkend="GtkMessageType"><type>GtkMessageType</type></link></programlisting>
<para>The type of the message.</para>
<para>Owner: GtkMessageDialog</para>
<para>Flags: Read / Write / Construct</para>
<para>Default value: GTK_MESSAGE_INFO</para>
</refsect2>
<refsect2 id="GtkMessageDialog--secondary-text" role="property"><title>The <literal>“secondary-text”</literal> property</title>
<indexterm zone="GtkMessageDialog--secondary-text"><primary>GtkMessageDialog:secondary-text</primary></indexterm>
<programlisting>  “secondary-text”           <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The secondary text of the message dialog.</para>
<para>Owner: GtkMessageDialog</para>
<para>Flags: Read / Write</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="GtkMessageDialog--secondary-use-markup" role="property"><title>The <literal>“secondary-use-markup”</literal> property</title>
<indexterm zone="GtkMessageDialog--secondary-use-markup"><primary>GtkMessageDialog:secondary-use-markup</primary></indexterm>
<programlisting>  “secondary-use-markup”     <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the secondary text of the dialog includes Pango markup.

See <link linkend="pango-parse-markup"><function>pango_parse_markup()</function></link>.</para>
<para>Owner: GtkMessageDialog</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkMessageDialog--text" role="property"><title>The <literal>“text”</literal> property</title>
<indexterm zone="GtkMessageDialog--text"><primary>GtkMessageDialog:text</primary></indexterm>
<programlisting>  “text”                     <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>The primary text of the message dialog. If the dialog has

a secondary text, this will appear as the title.</para>
<para>Owner: GtkMessageDialog</para>
<para>Flags: Read / Write</para>
<para>Default value: ""</para>
</refsect2>
<refsect2 id="GtkMessageDialog--use-markup" role="property"><title>The <literal>“use-markup”</literal> property</title>
<indexterm zone="GtkMessageDialog--use-markup"><primary>GtkMessageDialog:use-markup</primary></indexterm>
<programlisting>  “use-markup”               <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para><link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the primary text of the dialog includes Pango markup.

See <link linkend="pango-parse-markup"><function>pango_parse_markup()</function></link>.</para>
<para>Owner: GtkMessageDialog</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>

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

</refsect1>

</refentry>
