RubyGems - gdk3 - Versions diffs - 1.2.0-x86-mingw32 - Mend

gdk3 1.2.0-x86-mingw32

Files changed (1337) hide show

data/vendor/local/share/gtk-doc/html/gtk3/GtkMenuToolButton.html ADDED Viewed

@@ -0,0 +1,387 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GtkMenuToolButton</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
+<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
+<link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
+<link rel="prev" href="GtkToolButton.html" title="GtkToolButton">
+<link rel="next" href="GtkToggleToolButton.html" title="GtkToggleToolButton">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
+<tr valign="middle">
+<td><a accesskey="p" href="GtkToolButton.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="MenusAndCombos.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GTK+ 3 Reference Manual</th>
+<td><a accesskey="n" href="GtkToggleToolButton.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#GtkMenuToolButton.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#GtkMenuToolButton.description" class="shortcut">Description</a>
+                   |
+                  <a href="#GtkMenuToolButton.object-hierarchy" class="shortcut">Object Hierarchy</a>
+                   |
+                  <a href="#GtkMenuToolButton.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
+                   |
+                  <a href="#GtkMenuToolButton.properties" class="shortcut">Properties</a>
+                   |
+                  <a href="#GtkMenuToolButton.signals" class="shortcut">Signals</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="GtkMenuToolButton"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="GtkMenuToolButton.top_of_page"></a>GtkMenuToolButton</span></h2>
+<p>GtkMenuToolButton — A GtkToolItem containing a button with an additional dropdown menu</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="GtkMenuToolButton.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">
+#include &lt;gtk/gtk.h&gt;
+struct              <a class="link" href="GtkMenuToolButton.html#GtkMenuToolButton-struct" title="struct GtkMenuToolButton">GtkMenuToolButton</a>;
+<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-new" title="gtk_menu_tool_button_new ()">gtk_menu_tool_button_new</a>            (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon_widget</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);
+<a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-new-from-stock" title="gtk_menu_tool_button_new_from_stock ()">gtk_menu_tool_button_new_from_stock</a> (<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-set-menu" title="gtk_menu_tool_button_set_menu ()">gtk_menu_tool_button_set_menu</a>       (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *menu</code></em>);
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-get-menu" title="gtk_menu_tool_button_get_menu ()">gtk_menu_tool_button_get_menu</a>       (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-set-arrow-tooltip-text" title="gtk_menu_tool_button_set_arrow_tooltip_text ()">gtk_menu_tool_button_set_arrow_tooltip_text</a>
+                                                        (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-set-arrow-tooltip-markup" title="gtk_menu_tool_button_set_arrow_tooltip_markup ()">gtk_menu_tool_button_set_arrow_tooltip_markup</a>
+                                                        (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *markup</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMenuToolButton.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="synopsis">
+  GObject
+   +----GInitiallyUnowned
+         +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
+               +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
+                     +----<a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
+                           +----<a class="link" href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>
+                                 +----<a class="link" href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a>
+                                       +----GtkMenuToolButton
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMenuToolButton.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
+<p>
+GtkMenuToolButton implements
+ AtkImplementorIface,  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>,  <a class="link" href="GtkActivatable.html" title="GtkActivatable">GtkActivatable</a> and  <a class="link" href="GtkActionable.html" title="GtkActionable">GtkActionable</a>.</p>
+</div>
+<div class="refsect1">
+<a name="GtkMenuToolButton.properties"></a><h2>Properties</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkMenuToolButton.html#GtkMenuToolButton--menu" title='The "menu" property'>menu</a>"                     <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>*              : Read / Write
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMenuToolButton.signals"></a><h2>Signals</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkMenuToolButton.html#GtkMenuToolButton-show-menu" title='The "show-menu" signal'>show-menu</a>"                                      : <code class="literal">Run First</code>
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMenuToolButton.description"></a><h2>Description</h2>
+<p>
+A <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> is a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> that contains a button and
+a small additional button with an arrow. When clicked, the arrow
+button pops up a dropdown menu.
+</p>
+<p>
+Use <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-new" title="gtk_menu_tool_button_new ()"><code class="function">gtk_menu_tool_button_new()</code></a> to create a new
+<a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>. Use <a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-new-from-stock" title="gtk_menu_tool_button_new_from_stock ()"><code class="function">gtk_menu_tool_button_new_from_stock()</code></a> to
+create a new <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> containing a stock item.
+</p>
+<p>
+</p>
+<div class="refsect2">
+<a name="GtkMenuToolButton-BUILDER-UI"></a><h3>GtkMenuToolButton as GtkBuildable</h3>
+<p>
+The GtkMenuToolButton implementation of the GtkBuildable interface
+supports adding a menu by specifying "menu" as the "type"
+attribute of a &lt;child&gt; element.
+</p>
+<p>
+</p>
+<div class="example">
+<a name="idm140520348141264"></a><p class="title"><b>Example 80. A UI definition fragment with menus</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkMenuToolButton"</span><span class="symbol">&gt;</span>
+<span class="normal">  </span><span class="symbol">&lt;</span><span class="usertype">child</span><span class="normal"> type</span><span class="symbol">=</span><span class="string">"menu"</span><span class="symbol">&gt;</span>
+<span class="normal">    </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkMenu"</span><span class="symbol">/&gt;</span>
+<span class="normal">  </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
+<span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+</p>
+</div>
+<p>
+</p>
+</div>
+<div class="refsect1">
+<a name="GtkMenuToolButton.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="GtkMenuToolButton-struct"></a><h3>struct GtkMenuToolButton</h3>
+<pre class="programlisting">struct GtkMenuToolButton;</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-tool-button-new"></a><h3>gtk_menu_tool_button_new ()</h3>
+<pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       gtk_menu_tool_button_new            (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *icon_widget</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
+<p>
+Creates a new <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> using <em class="parameter"><code>icon_widget</code></em> as icon and
+<em class="parameter"><code>label</code></em> as label.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>icon_widget</code></em> :</span></p></td>
+<td>a widget that will be used as icon widget, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
+<td>a string that will be used as label, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the new <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.6</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-tool-button-new-from-stock"></a><h3>gtk_menu_tool_button_new_from_stock ()</h3>
+<pre class="programlisting"><a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="returnvalue">GtkToolItem</span></a> *       gtk_menu_tool_button_new_from_stock (<em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
+<p>
+Creates a new <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>.
+The new <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> will contain an icon and label from
+the stock item indicated by <em class="parameter"><code>stock_id</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>stock_id</code></em> :</span></p></td>
+<td>the name of a stock item</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the new <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.6</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-tool-button-set-menu"></a><h3>gtk_menu_tool_button_set_menu ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_tool_button_set_menu       (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *menu</code></em>);</pre>
+<p>
+Sets the <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> that is popped up when the user clicks on the arrow.
+If <em class="parameter"><code>menu</code></em> is NULL, the arrow button becomes insensitive.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>the <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> associated with <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.6</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-tool-button-get-menu"></a><h3>gtk_menu_tool_button_get_menu ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_menu_tool_button_get_menu       (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>);</pre>
+<p>
+Gets the <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> associated with <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> associated
+with <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.6</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-tool-button-set-arrow-tooltip-text"></a><h3>gtk_menu_tool_button_set_arrow_tooltip_text ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_tool_button_set_arrow_tooltip_text
+                                                        (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
+<p>
+Sets the tooltip text to be used as tooltip for the arrow button which
+pops up the menu.  See <a class="link" href="GtkToolItem.html#gtk-tool-item-set-tooltip-text" title="gtk_tool_item_set_tooltip_text ()"><code class="function">gtk_tool_item_set_tooltip_text()</code></a> for setting a tooltip
+on the whole <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
+<td>text to be used as tooltip text for button's arrow button</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.12</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-menu-tool-button-set-arrow-tooltip-markup"></a><h3>gtk_menu_tool_button_set_arrow_tooltip_markup ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_tool_button_set_arrow_tooltip_markup
+                                                        (<em class="parameter"><code><a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *markup</code></em>);</pre>
+<p>
+Sets the tooltip markup text to be used as tooltip for the arrow button
+which pops up the menu.  See <a class="link" href="GtkToolItem.html#gtk-tool-item-set-tooltip-text" title="gtk_tool_item_set_tooltip_text ()"><code class="function">gtk_tool_item_set_tooltip_text()</code></a> for setting a
+tooltip on the whole <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>markup</code></em> :</span></p></td>
+<td>markup text to be used as tooltip text for button's arrow button</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.12</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkMenuToolButton.property-details"></a><h2>Property Details</h2>
+<div class="refsect2">
+<a name="GtkMenuToolButton--menu"></a><h3>The <code class="literal">"menu"</code> property</h3>
+<pre class="programlisting">  "menu"                     <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>*              : Read / Write</pre>
+<p>The dropdown menu.</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkMenuToolButton.signal-details"></a><h2>Signal Details</h2>
+<div class="refsect2">
+<a name="GtkMenuToolButton-show-menu"></a><h3>The <code class="literal">"show-menu"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> *button,
+                                                        <span class="type">gpointer</span>           user_data)      : <code class="literal">Run First</code></pre>
+<p>
+The ::show-menu signal is emitted before the menu is shown.
+</p>
+<p>
+It can be used to populate the menu on demand, using
+<a class="link" href="GtkMenuToolButton.html#gtk-menu-tool-button-set-menu" title="gtk_menu_tool_button_set_menu ()"><code class="function">gtk_menu_tool_button_set_menu()</code></a>.
+</p>
+<p>
+Note that even if you populate the menu dynamically in this way,
+you must set an empty menu on the <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a> beforehand,
+since the arrow is made insensitive if the menu is not set.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
+<td>the object on which the signal is emitted</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkMenuToolButton.see-also"></a><h2>See Also</h2>
+<a class="link" href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>, <a class="link" href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.18.1</div>
+</body>
+</html>

data/vendor/local/share/gtk-doc/html/gtk3/GtkMessageDialog.html ADDED Viewed

@@ -0,0 +1,814 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GtkMessageDialog</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
+<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
+<link rel="up" href="WindowWidgets.html" title="Windows">
+<link rel="prev" href="GtkInvisible.html" title="GtkInvisible">
+<link rel="next" href="GtkWindow.html" title="GtkWindow">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
+<tr valign="middle">
+<td><a accesskey="p" href="GtkInvisible.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="WindowWidgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GTK+ 3 Reference Manual</th>
+<td><a accesskey="n" href="GtkWindow.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#GtkMessageDialog.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#GtkMessageDialog.description" class="shortcut">Description</a>
+                   |
+                  <a href="#GtkMessageDialog.object-hierarchy" class="shortcut">Object Hierarchy</a>
+                   |
+                  <a href="#GtkMessageDialog.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
+                   |
+                  <a href="#GtkMessageDialog.properties" class="shortcut">Properties</a>
+                   |
+                  <a href="#GtkMessageDialog.style-properties" class="shortcut">Style Properties</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="GtkMessageDialog"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="GtkMessageDialog.top_of_page"></a>GtkMessageDialog</span></h2>
+<p>GtkMessageDialog — A convenient message window</p>
+</td>
+<td valign="top" align="right"><img src="messagedialog.png"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="GtkMessageDialog.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">
+#include &lt;gtk/gtk.h&gt;
+struct              <a class="link" href="GtkMessageDialog.html#GtkMessageDialog-struct" title="struct GtkMessageDialog">GtkMessageDialog</a>;
+enum                <a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType">GtkMessageType</a>;
+enum                <a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType">GtkButtonsType</a>;
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-new" title="gtk_message_dialog_new ()">gtk_message_dialog_new</a>              (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags"><span class="type">GtkDialogFlags</span></a> flags</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a> type</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType"><span class="type">GtkButtonsType</span></a> buttons</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *message_format</code></em>,
+                                                         <em class="parameter"><code>...</code></em>);
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-new-with-markup" title="gtk_message_dialog_new_with_markup ()">gtk_message_dialog_new_with_markup</a>  (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags"><span class="type">GtkDialogFlags</span></a> flags</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a> type</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType"><span class="type">GtkButtonsType</span></a> buttons</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *message_format</code></em>,
+                                                         <em class="parameter"><code>...</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-set-markup" title="gtk_message_dialog_set_markup ()">gtk_message_dialog_set_markup</a>       (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *message_dialog</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-set-image" title="gtk_message_dialog_set_image ()">gtk_message_dialog_set_image</a>        (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *dialog</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *image</code></em>);
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-get-image" title="gtk_message_dialog_get_image ()">gtk_message_dialog_get_image</a>        (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *dialog</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-format-secondary-text" title="gtk_message_dialog_format_secondary_text ()">gtk_message_dialog_format_secondary_text</a>
+                                                        (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *message_dialog</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *message_format</code></em>,
+                                                         <em class="parameter"><code>...</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-format-secondary-markup" title="gtk_message_dialog_format_secondary_markup ()">gtk_message_dialog_format_secondary_markup</a>
+                                                        (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *message_dialog</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *message_format</code></em>,
+                                                         <em class="parameter"><code>...</code></em>);
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-get-message-area" title="gtk_message_dialog_get_message_area ()">gtk_message_dialog_get_message_area</a> (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *message_dialog</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMessageDialog.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="synopsis">
+  GObject
+   +----GInitiallyUnowned
+         +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
+               +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
+                     +----<a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
+                           +----<a class="link" href="GtkWindow.html" title="GtkWindow">GtkWindow</a>
+                                 +----<a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a>
+                                       +----GtkMessageDialog
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMessageDialog.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
+<p>
+GtkMessageDialog implements
+ AtkImplementorIface and  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
+</div>
+<div class="refsect1">
+<a name="GtkMessageDialog.properties"></a><h2>Properties</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--buttons" title='The "buttons" property'>buttons</a>"                  <a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType"><span class="type">GtkButtonsType</span></a>        : Write / Construct Only
+  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--image" title='The "image" property'>image</a>"                    <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write
+  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--message-area" title='The "message-area" property'>message-area</a>"             <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read
+  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--message-type" title='The "message-type" property'>message-type</a>"             <a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a>        : Read / Write / Construct
+  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--secondary-text" title='The "secondary-text" property'>secondary-text</a>"           <span class="type">gchar</span>*                : Read / Write
+  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--secondary-use-markup" title='The "secondary-use-markup" property'>secondary-use-markup</a>"     <span class="type">gboolean</span>              : Read / Write
+  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--text" title='The "text" property'>text</a>"                     <span class="type">gchar</span>*                : Read / Write
+  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--use-markup" title='The "use-markup" property'>use-markup</a>"               <span class="type">gboolean</span>              : Read / Write
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMessageDialog.style-properties"></a><h2>Style Properties</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--s-message-border" title='The "message-border" style property'>message-border</a>"           <span class="type">gint</span>                  : Read
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkMessageDialog.description"></a><h2>Description</h2>
+<p>
+<a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> presents a dialog with an image representing the type of
+message (Error, Question, etc.) alongside some message text. It's simply a
+convenience widget; you could construct the equivalent of <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>
+from <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> without too much effort, but <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> saves typing.
+</p>
+<p>
+One difference from <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> is that <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> sets the
+<a class="link" href="GtkWindow.html#GtkWindow--skip-taskbar-hint" title='The "skip-taskbar-hint" property'><span class="type">"skip-taskbar-hint"</span></a> property to <code class="literal">TRUE</code>, so that the dialog is hidden
+from the taskbar by default.
+</p>
+<p>
+The easiest way to do a modal message dialog is to use <a class="link" href="GtkDialog.html#gtk-dialog-run" title="gtk_dialog_run ()"><code class="function">gtk_dialog_run()</code></a>, though
+you can also pass in the <a class="link" href="GtkDialog.html#GTK-DIALOG-MODAL:CAPS"><code class="literal">GTK_DIALOG_MODAL</code></a> flag, <a class="link" href="GtkDialog.html#gtk-dialog-run" title="gtk_dialog_run ()"><code class="function">gtk_dialog_run()</code></a> automatically
+makes the dialog modal and waits for the user to respond to it. <a class="link" href="GtkDialog.html#gtk-dialog-run" title="gtk_dialog_run ()"><code class="function">gtk_dialog_run()</code></a>
+returns when any dialog button is clicked.
+</p>
+<div class="example">
+<a name="idm140520398200720"></a><p class="title"><b>Example 46. A modal dialog.</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="normal">dialog </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkMessageDialog.html#gtk-message-dialog-new">gtk_message_dialog_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">main_application_window</span><span class="symbol">,</span>
+<span class="normal">                                 <a href="GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS">GTK_DIALOG_DESTROY_WITH_PARENT</a></span><span class="symbol">,</span>
+<span class="normal">                                 <a href="GtkMessageDialog.html#GTK-MESSAGE-ERROR:CAPS">GTK_MESSAGE_ERROR</a></span><span class="symbol">,</span>
+<span class="normal">                                 <a href="GtkMessageDialog.html#GTK-BUTTONS-CLOSE:CAPS">GTK_BUTTONS_CLOSE</a></span><span class="symbol">,</span>
+<span class="normal">                                 </span><span class="string">"Error loading file '%s': %s"</span><span class="symbol">,</span>
+<span class="normal">                                 filename</span><span class="symbol">,</span><span class="normal"> </span><span class="function">g_strerror</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">errno</span><span class="symbol">));</span>
+<span class="function"><a href="GtkDialog.html#gtk-dialog-run">gtk_dialog_run</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_DIALOG</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dialog</span><span class="symbol">));</span>
+<span class="function"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dialog</span><span class="symbol">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+You might do a non-modal <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> as follows:
+</p>
+<div class="example">
+<a name="idm140520398197744"></a><p class="title"><b>Example 47. A non-modal dialog.</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="normal">dialog </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkMessageDialog.html#gtk-message-dialog-new">gtk_message_dialog_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">main_application_window</span><span class="symbol">,</span>
+<span class="normal">                                 <a href="GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS">GTK_DIALOG_DESTROY_WITH_PARENT</a></span><span class="symbol">,</span>
+<span class="normal">                                 <a href="GtkMessageDialog.html#GTK-MESSAGE-ERROR:CAPS">GTK_MESSAGE_ERROR</a></span><span class="symbol">,</span>
+<span class="normal">                                 <a href="GtkMessageDialog.html#GTK-BUTTONS-CLOSE:CAPS">GTK_BUTTONS_CLOSE</a></span><span class="symbol">,</span>
+<span class="normal">                                 </span><span class="string">"Error loading file '%s': %s"</span><span class="symbol">,</span>
+<span class="normal">                                 filename</span><span class="symbol">,</span><span class="normal"> </span><span class="function">g_strerror</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">errno</span><span class="symbol">));</span>
+<span class="comment">/* Destroy the dialog when the user responds to it (e.g. clicks a button) */</span>
+<span class="function">g_signal_connect_swapped</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dialog</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"response"</span><span class="symbol">,</span>
+<span class="normal">                          </span><span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="symbol">),</span>
+<span class="normal">                          dialog</span><span class="symbol">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+</p>
+<p>
+</p>
+<div class="refsect2">
+<a name="GtkMessageDialog-BUILDER-UI"></a><h3>GtkMessageDialog as GtkBuildable</h3>
+<p>
+The GtkMessageDialog implementation of the GtkBuildable interface exposes
+the message area as an internal child with the name "message_area".
+</p>
+</div>
+<p>
+</p>
+</div>
+<div class="refsect1">
+<a name="GtkMessageDialog.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="GtkMessageDialog-struct"></a><h3>struct GtkMessageDialog</h3>
+<pre class="programlisting">struct GtkMessageDialog;</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMessageType"></a><h3>enum GtkMessageType</h3>
+<pre class="programlisting">typedef enum {
+  GTK_MESSAGE_INFO,
+  GTK_MESSAGE_WARNING,
+  GTK_MESSAGE_QUESTION,
+  GTK_MESSAGE_ERROR,
+  GTK_MESSAGE_OTHER
+} GtkMessageType;
+</pre>
+<p>
+The type of message being displayed in the dialog.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><a name="GTK-MESSAGE-INFO:CAPS"></a><span class="term"><code class="literal">GTK_MESSAGE_INFO</code></span></p></td>
+<td>Informational message
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-MESSAGE-WARNING:CAPS"></a><span class="term"><code class="literal">GTK_MESSAGE_WARNING</code></span></p></td>
+<td>Nonfatal warning message
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-MESSAGE-QUESTION:CAPS"></a><span class="term"><code class="literal">GTK_MESSAGE_QUESTION</code></span></p></td>
+<td>Question requiring a choice
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-MESSAGE-ERROR:CAPS"></a><span class="term"><code class="literal">GTK_MESSAGE_ERROR</code></span></p></td>
+<td>Fatal error message
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-MESSAGE-OTHER:CAPS"></a><span class="term"><code class="literal">GTK_MESSAGE_OTHER</code></span></p></td>
+<td>None of the above, doesn't get an icon
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkButtonsType"></a><h3>enum GtkButtonsType</h3>
+<pre class="programlisting">typedef enum {
+  GTK_BUTTONS_NONE,
+  GTK_BUTTONS_OK,
+  GTK_BUTTONS_CLOSE,
+  GTK_BUTTONS_CANCEL,
+  GTK_BUTTONS_YES_NO,
+  GTK_BUTTONS_OK_CANCEL
+} GtkButtonsType;
+</pre>
+<p>
+Prebuilt sets of buttons for the dialog. If
+none of these choices are appropriate, simply use <a class="link" href="GtkMessageDialog.html#GTK-BUTTONS-NONE:CAPS"><code class="literal">GTK_BUTTONS_NONE</code></a>
+then call <a class="link" href="GtkDialog.html#gtk-dialog-add-buttons" title="gtk_dialog_add_buttons ()"><code class="function">gtk_dialog_add_buttons()</code></a>.
+</p>
+<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Note</h3>
+ Please note that <a class="link" href="GtkMessageDialog.html#GTK-BUTTONS-OK:CAPS"><code class="literal">GTK_BUTTONS_OK</code></a>, <a class="link" href="GtkMessageDialog.html#GTK-BUTTONS-YES-NO:CAPS"><code class="literal">GTK_BUTTONS_YES_NO</code></a>
+ and <a class="link" href="GtkMessageDialog.html#GTK-BUTTONS-OK-CANCEL:CAPS"><code class="literal">GTK_BUTTONS_OK_CANCEL</code></a> are discouraged by the
+ <a class="ulink" href="http://library.gnome.org/devel/hig-book/stable/" target="_top">GNOME HIG</a>.
+</div>
+<p>
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><a name="GTK-BUTTONS-NONE:CAPS"></a><span class="term"><code class="literal">GTK_BUTTONS_NONE</code></span></p></td>
+<td>no buttons at all
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-BUTTONS-OK:CAPS"></a><span class="term"><code class="literal">GTK_BUTTONS_OK</code></span></p></td>
+<td>an OK button
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-BUTTONS-CLOSE:CAPS"></a><span class="term"><code class="literal">GTK_BUTTONS_CLOSE</code></span></p></td>
+<td>a Close button
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-BUTTONS-CANCEL:CAPS"></a><span class="term"><code class="literal">GTK_BUTTONS_CANCEL</code></span></p></td>
+<td>a Cancel button
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-BUTTONS-YES-NO:CAPS"></a><span class="term"><code class="literal">GTK_BUTTONS_YES_NO</code></span></p></td>
+<td>Yes and No buttons
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-BUTTONS-OK-CANCEL:CAPS"></a><span class="term"><code class="literal">GTK_BUTTONS_OK_CANCEL</code></span></p></td>
+<td>OK and Cancel buttons
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-message-dialog-new"></a><h3>gtk_message_dialog_new ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_message_dialog_new              (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags"><span class="type">GtkDialogFlags</span></a> flags</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a> type</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType"><span class="type">GtkButtonsType</span></a> buttons</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *message_format</code></em>,
+                                                         <em class="parameter"><code>...</code></em>);</pre>
+<p>
+Creates a new message dialog, which is a simple dialog with an icon
+indicating the dialog type (error, warning, etc.) and some text the
+user may want to see. When the user clicks a button a "response"
+signal is emitted with response IDs from <a class="link" href="GtkDialog.html#GtkResponseType" title="enum GtkResponseType"><span class="type">GtkResponseType</span></a>. See
+<a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> for more details.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
+<td>transient parent, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for none. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
+<td>flags</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
+<td>type of message</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>buttons</code></em> :</span></p></td>
+<td>set of buttons to use</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>message_format</code></em> :</span></p></td>
+<td>
+<code class="function">printf()</code>-style format string, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
+<td>arguments for <em class="parameter"><code>message_format</code></em>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-message-dialog-new-with-markup"></a><h3>gtk_message_dialog_new_with_markup ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_message_dialog_new_with_markup  (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags"><span class="type">GtkDialogFlags</span></a> flags</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a> type</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType"><span class="type">GtkButtonsType</span></a> buttons</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *message_format</code></em>,
+                                                         <em class="parameter"><code>...</code></em>);</pre>
+<p>
+Creates a new message dialog, which is a simple dialog with an icon
+indicating the dialog type (error, warning, etc.) and some text which
+is marked up with the Pango text markup language.
+When the user clicks a button a "response" signal is emitted with
+response IDs from <a class="link" href="GtkDialog.html#GtkResponseType" title="enum GtkResponseType"><span class="type">GtkResponseType</span></a>. See <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> for more details.
+</p>
+<p>
+Special XML characters in the <code class="function">printf()</code> arguments passed to this
+function will automatically be escaped as necessary.
+(See <code class="function">g_markup_printf_escaped()</code> 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 <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-set-markup" title="gtk_message_dialog_set_markup ()"><code class="function">gtk_message_dialog_set_markup()</code></a>
+instead, since you can't pass the markup string either
+as the format (it might contain '%' characters) or as a string
+argument.
+</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">dialog</span><span class="symbol">;</span>
+<span class="normal">dialog </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkMessageDialog.html#gtk-message-dialog-new">gtk_message_dialog_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">main_application_window</span><span class="symbol">,</span>
+<span class="normal">                                 <a href="GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS">GTK_DIALOG_DESTROY_WITH_PARENT</a></span><span class="symbol">,</span>
+<span class="normal">                                 <a href="GtkMessageDialog.html#GTK-MESSAGE-ERROR:CAPS">GTK_MESSAGE_ERROR</a></span><span class="symbol">,</span>
+<span class="normal">                                 <a href="GtkMessageDialog.html#GTK-BUTTONS-CLOSE:CAPS">GTK_BUTTONS_CLOSE</a></span><span class="symbol">,</span>
+<span class="normal">                                 <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a></span><span class="symbol">);</span>
+<span class="function"><a href="GtkMessageDialog.html#gtk-message-dialog-set-markup">gtk_message_dialog_set_markup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_MESSAGE_DIALOG</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dialog</span><span class="symbol">),</span>
+<span class="normal">                               markup</span><span class="symbol">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
+<td>transient parent, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for none. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
+<td>flags</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
+<td>type of message</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>buttons</code></em> :</span></p></td>
+<td>set of buttons to use</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>message_format</code></em> :</span></p></td>
+<td>
+<code class="function">printf()</code>-style format string, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
+<td>arguments for <em class="parameter"><code>message_format</code></em>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a new <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.4</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-message-dialog-set-markup"></a><h3>gtk_message_dialog_set_markup ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_message_dialog_set_markup       (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *message_dialog</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);</pre>
+<p>
+Sets the text of the message dialog to be <em class="parameter"><code>str</code></em>, which is marked
+up with the <GTKDOCLINK HREF="PangoMarkupFormat">Pango text markup
+language</GTKDOCLINK>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>message_dialog</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
+<td>markup string (see Pango markup format)</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.4</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-message-dialog-set-image"></a><h3>gtk_message_dialog_set_image ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_message_dialog_set_image        (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *dialog</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *image</code></em>);</pre>
+<p>
+Sets the dialog's image to <em class="parameter"><code>image</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>dialog</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>image</code></em> :</span></p></td>
+<td>the image</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-message-dialog-get-image"></a><h3>gtk_message_dialog_get_image ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_message_dialog_get_image        (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *dialog</code></em>);</pre>
+<p>
+Gets the dialog's image.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>dialog</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the dialog's image. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.14</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-message-dialog-format-secondary-text"></a><h3>gtk_message_dialog_format_secondary_text ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_message_dialog_format_secondary_text
+                                                        (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *message_dialog</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *message_format</code></em>,
+                                                         <em class="parameter"><code>...</code></em>);</pre>
+<p>
+Sets the secondary text of the message dialog to be <em class="parameter"><code>message_format</code></em>
+(with <code class="function">printf()</code>-style).
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>message_dialog</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>message_format</code></em> :</span></p></td>
+<td>
+<code class="function">printf()</code>-style format string, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
+<td>arguments for <em class="parameter"><code>message_format</code></em>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.6</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-message-dialog-format-secondary-markup"></a><h3>gtk_message_dialog_format_secondary_markup ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_message_dialog_format_secondary_markup
+                                                        (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *message_dialog</code></em>,
+                                                         <em class="parameter"><code>const <span class="type">gchar</span> *message_format</code></em>,
+                                                         <em class="parameter"><code>...</code></em>);</pre>
+<p>
+Sets the secondary text of the message dialog to be <em class="parameter"><code>message_format</code></em> (with
+<code class="function">printf()</code>-style), which is marked up with the
+Pango text markup language.
+</p>
+<p>
+Due to an oversight, this function does not escape special XML characters
+like <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-new-with-markup" title="gtk_message_dialog_new_with_markup ()"><code class="function">gtk_message_dialog_new_with_markup()</code></a> does. Thus, if the arguments
+may contain special XML characters, you should use <code class="function">g_markup_printf_escaped()</code>
+to escape it.
+</p>
+<p>
+</p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">msg</span><span class="symbol">;</span>
+<span class="normal">msg </span><span class="symbol">=</span><span class="normal"> </span><span class="function">g_markup_printf_escaped</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">message_format</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">...);</span>
+<span class="function"><a href="GtkMessageDialog.html#gtk-message-dialog-format-secondary-markup">gtk_message_dialog_format_secondary_markup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">message_dialog</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"%s"</span><span class="symbol">,</span><span class="normal"> msg</span><span class="symbol">);</span>
+<span class="function">g_free</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">msg</span><span class="symbol">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>message_dialog</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>message_format</code></em> :</span></p></td>
+<td>printf()-style markup string (see
+Pango markup format), or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
+<td>arguments for <em class="parameter"><code>message_format</code></em>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.6</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-message-dialog-get-message-area"></a><h3>gtk_message_dialog_get_message_area ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_message_dialog_get_message_area (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *message_dialog</code></em>);</pre>
+<p>
+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,
+on the right side of the dialog's image (or on the left for right-to-left
+languages).  See <a class="link" href="GtkDialog.html#gtk-dialog-get-content-area" title="gtk_dialog_get_content_area ()"><code class="function">gtk_dialog_get_content_area()</code></a> for the corresponding
+function in the parent <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>message_dialog</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>A <a class="link" href="GtkVBox.html" title="GtkVBox"><span class="type">GtkVBox</span></a> corresponding to the
+"message area" in the <em class="parameter"><code>message_dialog</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.22</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkMessageDialog.property-details"></a><h2>Property Details</h2>
+<div class="refsect2">
+<a name="GtkMessageDialog--buttons"></a><h3>The <code class="literal">"buttons"</code> property</h3>
+<pre class="programlisting">  "buttons"                  <a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType"><span class="type">GtkButtonsType</span></a>        : Write / Construct Only</pre>
+<p>The buttons shown in the message dialog.</p>
+<p>Default value: GTK_BUTTONS_NONE</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMessageDialog--image"></a><h3>The <code class="literal">"image"</code> property</h3>
+<pre class="programlisting">  "image"                    <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write</pre>
+<p>
+The image for this dialog.
+</p>
+<p class="since">Since 2.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMessageDialog--message-area"></a><h3>The <code class="literal">"message-area"</code> property</h3>
+<pre class="programlisting">  "message-area"             <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read</pre>
+<p>
+The <a class="link" href="GtkVBox.html" title="GtkVBox"><span class="type">GtkVBox</span></a> that corresponds to the message area of this dialog.  See
+<a class="link" href="GtkMessageDialog.html#gtk-message-dialog-get-message-area" title="gtk_message_dialog_get_message_area ()"><code class="function">gtk_message_dialog_get_message_area()</code></a> for a detailed description of this
+area.
+</p>
+<p class="since">Since 2.22</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMessageDialog--message-type"></a><h3>The <code class="literal">"message-type"</code> property</h3>
+<pre class="programlisting">  "message-type"             <a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a>        : Read / Write / Construct</pre>
+<p>
+The type of the message. The type is used to determine
+the image that is shown in the dialog, unless the image is
+explicitly set by the ::image property.
+</p>
+<p>Default value: GTK_MESSAGE_INFO</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMessageDialog--secondary-text"></a><h3>The <code class="literal">"secondary-text"</code> property</h3>
+<pre class="programlisting">  "secondary-text"           <span class="type">gchar</span>*                : Read / Write</pre>
+<p>
+The secondary text of the message dialog.
+</p>
+<p>Default value: NULL</p>
+<p class="since">Since 2.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMessageDialog--secondary-use-markup"></a><h3>The <code class="literal">"secondary-use-markup"</code> property</h3>
+<pre class="programlisting">  "secondary-use-markup"     <span class="type">gboolean</span>              : Read / Write</pre>
+<p>
+<code class="literal">TRUE</code> if the secondary text of the dialog includes Pango markup.
+See <code class="function">pango_parse_markup()</code>.
+</p>
+<p>Default value: FALSE</p>
+<p class="since">Since 2.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMessageDialog--text"></a><h3>The <code class="literal">"text"</code> property</h3>
+<pre class="programlisting">  "text"                     <span class="type">gchar</span>*                : Read / Write</pre>
+<p>
+The primary text of the message dialog. If the dialog has
+a secondary text, this will appear as the title.
+</p>
+<p>Default value: ""</p>
+<p class="since">Since 2.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkMessageDialog--use-markup"></a><h3>The <code class="literal">"use-markup"</code> property</h3>
+<pre class="programlisting">  "use-markup"               <span class="type">gboolean</span>              : Read / Write</pre>
+<p>
+<code class="literal">TRUE</code> if the primary text of the dialog includes Pango markup.
+See <code class="function">pango_parse_markup()</code>.
+</p>
+<p>Default value: FALSE</p>
+<p class="since">Since 2.10</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkMessageDialog.style-property-details"></a><h2>Style Property Details</h2>
+<div class="refsect2">
+<a name="GtkMessageDialog--s-message-border"></a><h3>The <code class="literal">"message-border"</code> style property</h3>
+<pre class="programlisting">  "message-border"           <span class="type">gint</span>                  : Read</pre>
+<p>Width of border around the label and image in the message dialog.</p>
+<p>Allowed values: &gt;= 0</p>
+<p>Default value: 12</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkMessageDialog.see-also"></a><h2>See Also</h2>
+<a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.18.1</div>
+</body>
+</html>