<refentry id="GnomeMessageBox">
<refmeta>
<refentrytitle role="top_of_page" id="GnomeMessageBox.top_of_page">GnomeMessageBox</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>LIBGNOMEUI Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GnomeMessageBox</refname>
<refpurpose>Create standard message boxes.</refpurpose>
</refnamediv>

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

<synopsis>

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

#define             <link linkend="GNOME-MESSAGE-BOX-INFO--CAPS">GNOME_MESSAGE_BOX_INFO</link>
#define             <link linkend="GNOME-MESSAGE-BOX-WARNING--CAPS">GNOME_MESSAGE_BOX_WARNING</link>
#define             <link linkend="GNOME-MESSAGE-BOX-ERROR--CAPS">GNOME_MESSAGE_BOX_ERROR</link>
#define             <link linkend="GNOME-MESSAGE-BOX-QUESTION--CAPS">GNOME_MESSAGE_BOX_QUESTION</link>
#define             <link linkend="GNOME-MESSAGE-BOX-GENERIC--CAPS">GNOME_MESSAGE_BOX_GENERIC</link>
                    <link linkend="GnomeMessageBox-struct">GnomeMessageBox</link>;
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gnome-message-box-new">gnome_message_box_new</link>               (const <link linkend="gchar">gchar</link> *message,
                                                         const <link linkend="gchar">gchar</link> *message_box_type,
                                                         ...);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gnome-message-box-newv">gnome_message_box_newv</link>              (const <link linkend="gchar">gchar</link> *message,
                                                         const <link linkend="gchar">gchar</link> *message_box_type,
                                                         const <link linkend="gchar">gchar</link> **buttons);
<link linkend="void">void</link>                <link linkend="gnome-message-box-construct">gnome_message_box_construct</link>         (<link linkend="GnomeMessageBox">GnomeMessageBox</link> *messagebox,
                                                         const <link linkend="gchar">gchar</link> *message,
                                                         const <link linkend="gchar">gchar</link> *message_box_type,
                                                         const <link linkend="gchar">gchar</link> **buttons);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GnomeMessageBox.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----<link linkend="GtkWidget">GtkWidget</link>
                     +----<link linkend="GtkContainer">GtkContainer</link>
                           +----<link linkend="GtkBin">GtkBin</link>
                                 +----<link linkend="GtkWindow">GtkWindow</link>
                                       +----<link linkend="GnomeDialog">GnomeDialog</link>
                                             +----GnomeMessageBox
</synopsis>
</refsect1>



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





<refsect1 id="GnomeMessageBox.description" role="desc">
<title role="desc.title">Description</title>
<para>
</para>
</refsect1>

<refsect1 id="GnomeMessageBox.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GNOME-MESSAGE-BOX-INFO--CAPS" role="macro" condition="deprecated:">
<title>GNOME_MESSAGE_BOX_INFO</title>
<indexterm zone="GNOME-MESSAGE-BOX-INFO--CAPS" role="deprecated"><primary sortas="GNOME_MESSAGE_BOX_INFO">GNOME_MESSAGE_BOX_INFO</primary></indexterm><programlisting>#define GNOME_MESSAGE_BOX_INFO      "info"
</programlisting>
<warning><para><literal>GNOME_MESSAGE_BOX_INFO</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A constant that can be passed to <link linkend="gnome-message-box-new"><function>gnome_message_box_new()</function></link> to specify the type of
message box to create.
</para></refsect2>
<refsect2 id="GNOME-MESSAGE-BOX-WARNING--CAPS" role="macro" condition="deprecated:">
<title>GNOME_MESSAGE_BOX_WARNING</title>
<indexterm zone="GNOME-MESSAGE-BOX-WARNING--CAPS" role="deprecated"><primary sortas="GNOME_MESSAGE_BOX_WARNING">GNOME_MESSAGE_BOX_WARNING</primary></indexterm><programlisting>#define GNOME_MESSAGE_BOX_WARNING   "warning"
</programlisting>
<warning><para><literal>GNOME_MESSAGE_BOX_WARNING</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A constant that can be passed to <link linkend="gnome-message-box-new"><function>gnome_message_box_new()</function></link> to specify the type of
message box to create.
</para></refsect2>
<refsect2 id="GNOME-MESSAGE-BOX-ERROR--CAPS" role="macro" condition="deprecated:">
<title>GNOME_MESSAGE_BOX_ERROR</title>
<indexterm zone="GNOME-MESSAGE-BOX-ERROR--CAPS" role="deprecated"><primary sortas="GNOME_MESSAGE_BOX_ERROR">GNOME_MESSAGE_BOX_ERROR</primary></indexterm><programlisting>#define GNOME_MESSAGE_BOX_ERROR     "error"
</programlisting>
<warning><para><literal>GNOME_MESSAGE_BOX_ERROR</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A constant that can be passed to <link linkend="gnome-message-box-new"><function>gnome_message_box_new()</function></link> to specify the type of
message box to create.
</para></refsect2>
<refsect2 id="GNOME-MESSAGE-BOX-QUESTION--CAPS" role="macro" condition="deprecated:">
<title>GNOME_MESSAGE_BOX_QUESTION</title>
<indexterm zone="GNOME-MESSAGE-BOX-QUESTION--CAPS" role="deprecated"><primary sortas="GNOME_MESSAGE_BOX_QUESTION">GNOME_MESSAGE_BOX_QUESTION</primary></indexterm><programlisting>#define GNOME_MESSAGE_BOX_QUESTION  "question"
</programlisting>
<warning><para><literal>GNOME_MESSAGE_BOX_QUESTION</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A constant that can be passed to <link linkend="gnome-message-box-new"><function>gnome_message_box_new()</function></link> to specify the type of
message box to create.
</para></refsect2>
<refsect2 id="GNOME-MESSAGE-BOX-GENERIC--CAPS" role="macro" condition="deprecated:">
<title>GNOME_MESSAGE_BOX_GENERIC</title>
<indexterm zone="GNOME-MESSAGE-BOX-GENERIC--CAPS" role="deprecated"><primary sortas="GNOME_MESSAGE_BOX_GENERIC">GNOME_MESSAGE_BOX_GENERIC</primary></indexterm><programlisting>#define GNOME_MESSAGE_BOX_GENERIC   "generic"
</programlisting>
<warning><para><literal>GNOME_MESSAGE_BOX_GENERIC</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A constant that can be passed to <link linkend="gnome-message-box-new"><function>gnome_message_box_new()</function></link> to specify the type of
message box to create.
</para></refsect2>
<refsect2 id="GnomeMessageBox-struct" role="struct">
<title>GnomeMessageBox</title>
<indexterm zone="GnomeMessageBox-struct" role="deprecated"><primary sortas="GnomeMessageBox">GnomeMessageBox</primary></indexterm><programlisting>typedef struct {
  GnomeDialog dialog;
} GnomeMessageBox;
</programlisting>
<warning><para><literal>GnomeMessageBox</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
</para>
<para>
</para><variablelist role="struct">
<varlistentry>
<term><link linkend="GnomeDialog">GnomeDialog</link>&#160;<structfield>dialog</structfield>;</term>
<listitem><simpara> A <link linkend="GnomeDialog"><type>GnomeDialog</type></link> widget holding the contents of the message box.
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-message-box-new" role="function" condition="deprecated:">
<title>gnome_message_box_new ()</title>
<indexterm zone="gnome-message-box-new" role="deprecated"><primary sortas="gnome_message_box_new">gnome_message_box_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gnome_message_box_new               (const <link linkend="gchar">gchar</link> *message,
                                                         const <link linkend="gchar">gchar</link> *message_box_type,
                                                         ...);</programlisting>
<warning><para><literal>gnome_message_box_new</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Creates a dialog box of type <parameter>message_box_type</parameter> with <parameter>message</parameter>.  A number
of buttons are inserted on it.  You can use the GNOME stock identifiers
to create gnome-stock-buttons.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&#160;:</term>
<listitem><simpara> The message to be displayed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>message_box_type</parameter>&#160;:</term>
<listitem><simpara> The type of the message
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara> A NULL terminated list of strings to use in each button.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>a widget that has the dialog box.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-message-box-newv" role="function" condition="deprecated:">
<title>gnome_message_box_newv ()</title>
<indexterm zone="gnome-message-box-newv" role="deprecated"><primary sortas="gnome_message_box_newv">gnome_message_box_newv</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gnome_message_box_newv              (const <link linkend="gchar">gchar</link> *message,
                                                         const <link linkend="gchar">gchar</link> *message_box_type,
                                                         const <link linkend="gchar">gchar</link> **buttons);</programlisting>
<warning><para><literal>gnome_message_box_newv</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Creates a dialog box of type <parameter>message_box_type</parameter> with <parameter>message</parameter>.  A number
of buttons are inserted on it, the messages come from the <parameter>buttons</parameter> array.
You can use the GNOME stock identifiers to create gnome-stock-buttons.
The buttons array can be NULL if you wish to add buttons yourself later.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&#160;:</term>
<listitem><simpara> The message to be displayed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>message_box_type</parameter>&#160;:</term>
<listitem><simpara> The type of the message
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>buttons</parameter>&#160;:</term>
<listitem><simpara> a NULL terminated array with the buttons to insert.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>a widget that has the dialog box.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-message-box-construct" role="function" condition="deprecated:">
<title>gnome_message_box_construct ()</title>
<indexterm zone="gnome-message-box-construct" role="deprecated"><primary sortas="gnome_message_box_construct">gnome_message_box_construct</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_message_box_construct         (<link linkend="GnomeMessageBox">GnomeMessageBox</link> *messagebox,
                                                         const <link linkend="gchar">gchar</link> *message,
                                                         const <link linkend="gchar">gchar</link> *message_box_type,
                                                         const <link linkend="gchar">gchar</link> **buttons);</programlisting>
<warning><para><literal>gnome_message_box_construct</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
For language bindings or subclassing, from C use <link linkend="gnome-message-box-new"><type>gnome_message_box_new</type></link> or
<link linkend="gnome-message-box-newv"><type>gnome_message_box_newv</type></link></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>messagebox</parameter>&#160;:</term>
<listitem><simpara> The message box to construct
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>message</parameter>&#160;:</term>
<listitem><simpara> The message to be displayed.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>message_box_type</parameter>&#160;:</term>
<listitem><simpara> The type of the message
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>buttons</parameter>&#160;:</term>
<listitem><simpara> a NULL terminated array with the buttons to insert.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>




</refentry>
