New upstream version 3.24.14

This commit is contained in:
Simon McVittie
2020-02-29 14:17:40 +00:00
543 changed files with 330694 additions and 808714 deletions

View File

@ -8,7 +8,7 @@
<link rel="up" href="WindowWidgets.html" title="Windows">
<link rel="prev" href="GtkDialog.html" title="GtkDialog">
<link rel="next" href="GtkAboutDialog.html" title="GtkAboutDialog">
<meta name="generator" content="GTK-Doc V1.29 (XML mode)">
<meta name="generator" content="GTK-Doc V1.32.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -39,8 +39,8 @@
<a name="GtkMessageDialog.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
@ -120,9 +120,9 @@
</colgroup>
<tbody>
<tr>
<td class="property_type"><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType"><span class="type">GtkButtonsType</span></a></td>
<td class="property_type"><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkButtonsType"><span class="type">GtkButtonsType</span></a></td>
<td class="property_name"><a class="link" href="GtkMessageDialog.html#GtkMessageDialog--buttons" title="The “buttons” property">buttons</a></td>
<td class="property_flags">Write / Construct Only</td>
<td class="property_flags">Write / Construct Only</td>
</tr>
<tr>
<td class="property_type">
@ -137,7 +137,7 @@
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a></td>
<td class="property_type"><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkMessageType"><span class="type">GtkMessageType</span></a></td>
<td class="property_name"><a class="link" href="GtkMessageDialog.html#GtkMessageDialog--message-type" title="The “message-type” property">message-type</a></td>
<td class="property_flags">Read / Write / Construct</td>
</tr>
@ -185,21 +185,21 @@
<a name="GtkMessageDialog.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
<col width="150px" class="other_proto_type">
<col class="other_proto_name">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkMessageDialog.html#GtkMessageDialog-struct" title="struct GtkMessageDialog">GtkMessageDialog</a></td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkMessageDialog-struct">GtkMessageDialog</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType">GtkMessageType</a></td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkMessageType">GtkMessageType</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType">GtkButtonsType</a></td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkButtonsType">GtkButtonsType</a></td>
</tr>
</tbody>
</table></div>
@ -236,7 +236,7 @@ from <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">
<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
you can also pass in the <a href="https://developer.gnome.org/gtk4/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>
<p>An example for using a modal dialog:</p>
@ -254,16 +254,16 @@ returns when any dialog button is clicked.</p>
8
9
10</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="usertype">GtkDialogFlags</span><span class="normal"> flags </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">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">parent_window</span><span class="symbol">,</span>
<span class="normal"> flags</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 reading “%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>
<td class="listing_code"><pre class="programlisting"><span class="n">GtkDialogFlags</span> <span class="n">flags</span> <span class="o">=</span> <span class="n">GTK_DIALOG_DESTROY_WITH_PARENT</span><span class="p">;</span>
<span class="n">dialog</span> <span class="o">=</span> <span class="n">gtk_message_dialog_new</span> <span class="p">(</span><span class="n">parent_window</span><span class="p">,</span>
<span class="n">flags</span><span class="p">,</span>
<span class="n">GTK_MESSAGE_ERROR</span><span class="p">,</span>
<span class="n">GTK_BUTTONS_CLOSE</span><span class="p">,</span>
<span class="s">&quot;Error reading “%s”: %s&quot;</span><span class="p">,</span>
<span class="n">filename</span><span class="p">,</span>
<span class="n">g_strerror</span> <span class="p">(</span><span class="n">errno</span><span class="p">));</span>
<span class="n">gtk_dialog_run</span> <span class="p">(</span><span class="n">GTK_DIALOG</span> <span class="p">(</span><span class="n">dialog</span><span class="p">));</span>
<span class="n">gtk_widget_destroy</span> <span class="p">(</span><span class="n">dialog</span><span class="p">);</span></pre></td>
</tr>
</tbody>
</table>
@ -291,21 +291,21 @@ returns when any dialog button is clicked.</p>
13
14
15</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="usertype">GtkDialogFlags</span><span class="normal"> flags </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">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">parent_window</span><span class="symbol">,</span>
<span class="normal"> flags</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 reading “%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>
<td class="listing_code"><pre class="programlisting"><span class="n">GtkDialogFlags</span> <span class="n">flags</span> <span class="o">=</span> <span class="n">GTK_DIALOG_DESTROY_WITH_PARENT</span><span class="p">;</span>
<span class="n">dialog</span> <span class="o">=</span> <span class="n">gtk_message_dialog_new</span> <span class="p">(</span><span class="n">parent_window</span><span class="p">,</span>
<span class="n">flags</span><span class="p">,</span>
<span class="n">GTK_MESSAGE_ERROR</span><span class="p">,</span>
<span class="n">GTK_BUTTONS_CLOSE</span><span class="p">,</span>
<span class="s">&quot;Error reading “%s”: %s&quot;</span><span class="p">,</span>
<span class="n">filename</span><span class="p">,</span>
<span class="n">g_strerror</span> <span class="p">(</span><span class="n">errno</span><span class="p">));</span>
<span class="comment">// Destroy the dialog when the user responds to it</span>
<span class="comment">// (e.g. clicks a button)</span>
<span class="c1">// Destroy the dialog when the user responds to it</span>
<span class="c1">// (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>
<span class="n">g_signal_connect_swapped</span> <span class="p">(</span><span class="n">dialog</span><span class="p">,</span> <span class="s">&quot;response&quot;</span><span class="p">,</span>
<span class="n">G_CALLBACK</span> <span class="p">(</span><span class="n">gtk_widget_destroy</span><span class="p">),</span>
<span class="n">dialog</span><span class="p">);</span></pre></td>
</tr>
</tbody>
</table>
@ -324,14 +324,14 @@ the message area as an internal child with the name “message_area”.</p>
<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><a href="https://developer.gnome.org/gtk4/GtkDialog.html#GtkDialogFlags"><span class="type">GtkDialogFlags</span></a> flags</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkMessageType"><span class="type">GtkMessageType</span></a> type</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#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 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
signal is emitted with response IDs from <a href="https://developer.gnome.org/gtk4/GtkDialog.html#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="refsect3">
<a name="gtk-message-dialog-new.parameters"></a><h4>Parameters</h4>
@ -387,15 +387,15 @@ signal is emitted with response IDs from <a class="link" href="GtkDialog.html#Gt
<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><a href="https://developer.gnome.org/gtk4/GtkDialog.html#GtkDialogFlags"><span class="type">GtkDialogFlags</span></a> flags</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkMessageType"><span class="type">GtkMessageType</span></a> type</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#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 some text that
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>
response IDs from <a href="https://developer.gnome.org/gtk4/GtkDialog.html#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.)
@ -418,15 +418,15 @@ argument.</p>
7
8
9</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="usertype">GtkDialogFlags</span><span class="normal"> flags </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">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">parent_window</span><span class="symbol">,</span>
<span class="normal"> flags</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"> NULL</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>
<td class="listing_code"><pre class="programlisting"><span class="n">GtkWidget</span> <span class="o">*</span><span class="n">dialog</span><span class="p">;</span>
<span class="n">GtkDialogFlags</span> <span class="n">flags</span> <span class="o">=</span> <span class="n">GTK_DIALOG_DESTROY_WITH_PARENT</span><span class="p">;</span>
<span class="n">dialog</span> <span class="o">=</span> <span class="n">gtk_message_dialog_new</span> <span class="p">(</span><span class="n">parent_window</span><span class="p">,</span>
<span class="n">flags</span><span class="p">,</span>
<span class="n">GTK_MESSAGE_ERROR</span><span class="p">,</span>
<span class="n">GTK_BUTTONS_CLOSE</span><span class="p">,</span>
<span class="nb">NULL</span><span class="p">);</span>
<span class="n">gtk_message_dialog_set_markup</span> <span class="p">(</span><span class="n">GTK_MESSAGE_DIALOG</span> <span class="p">(</span><span class="n">dialog</span><span class="p">),</span>
<span class="n">markup</span><span class="p">);</span></pre></td>
</tr>
</tbody>
</table>
@ -650,12 +650,12 @@ to escape it.</p>
4
5
6</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>
<td class="listing_code"><pre class="programlisting"><span class="n">gchar</span> <span class="o">*</span><span class="n">msg</span><span class="p">;</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>
<span class="n">msg</span> <span class="o">=</span> <span class="n">g_markup_printf_escaped</span> <span class="p">(</span><span class="n">message_format</span><span class="p">,</span> <span class="p">...);</span>
<span class="n">gtk_message_dialog_format_secondary_markup</span> <span class="p">(</span><span class="n">message_dialog</span><span class="p">,</span>
<span class="s">&quot;%s&quot;</span><span class="p">,</span> <span class="n">msg</span><span class="p">);</span>
<span class="n">g_free</span> <span class="p">(</span><span class="n">msg</span><span class="p">);</span></pre></td>
</tr>
</tbody>
</table>
@ -729,135 +729,13 @@ function in the parent <a class="link" href="GtkDialog.html" title="GtkDialog"><
</div>
</div>
<div class="refsect1">
<a name="GtkMessageDialog.other_details"></a><h2>Types and Values</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>
<p>The type of message being displayed in the dialog.</p>
<div class="refsect3">
<a name="GtkMessageType.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GTK-MESSAGE-INFO:CAPS"></a>GTK_MESSAGE_INFO</p></td>
<td class="enum_member_description">
<p>Informational message</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-MESSAGE-WARNING:CAPS"></a>GTK_MESSAGE_WARNING</p></td>
<td class="enum_member_description">
<p>Non-fatal warning message</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-MESSAGE-QUESTION:CAPS"></a>GTK_MESSAGE_QUESTION</p></td>
<td class="enum_member_description">
<p>Question requiring a choice</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-MESSAGE-ERROR:CAPS"></a>GTK_MESSAGE_ERROR</p></td>
<td class="enum_member_description">
<p>Fatal error message</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-MESSAGE-OTHER:CAPS"></a>GTK_MESSAGE_OTHER</p></td>
<td class="enum_member_description">
<p>None of the above</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="GtkButtonsType"></a><h3>enum GtkButtonsType</h3>
<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="blockquote"><blockquote class="blockquote"><p>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 Human Interface Guidelines</a>.</p></blockquote></div>
<div class="refsect3">
<a name="GtkButtonsType.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GTK-BUTTONS-NONE:CAPS"></a>GTK_BUTTONS_NONE</p></td>
<td class="enum_member_description">
<p>no buttons at all</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-BUTTONS-OK:CAPS"></a>GTK_BUTTONS_OK</p></td>
<td class="enum_member_description">
<p>an OK button</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-BUTTONS-CLOSE:CAPS"></a>GTK_BUTTONS_CLOSE</p></td>
<td class="enum_member_description">
<p>a Close button</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-BUTTONS-CANCEL:CAPS"></a>GTK_BUTTONS_CANCEL</p></td>
<td class="enum_member_description">
<p>a Cancel button</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-BUTTONS-YES-NO:CAPS"></a>GTK_BUTTONS_YES_NO</p></td>
<td class="enum_member_description">
<p>Yes and No buttons</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-BUTTONS-OK-CANCEL:CAPS"></a>GTK_BUTTONS_OK_CANCEL</p></td>
<td class="enum_member_description">
<p>OK and Cancel buttons</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</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></pre>
<pre class="programlisting"> “buttons” <a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkButtonsType"><span class="type">GtkButtonsType</span></a></pre>
<p>The buttons shown in the message dialog.</p>
<p>Flags: Write / Construct Only</p>
<p>Owner: GtkMessageDialog</p>
<p>Flags: Write / Construct Only</p>
<p>Default value: GTK_BUTTONS_NONE</p>
</div>
<hr>
@ -869,6 +747,7 @@ and <a class="link" href="GtkMessageDialog.html#GTK-BUTTONS-OK-CANCEL:CAPS"><cod
<p><code class="literal">GtkMessageDialog:image</code> has been deprecated since version 3.12 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> to create dialogs with images</p>
</div>
<p>Owner: GtkMessageDialog</p>
<p>Flags: Read / Write</p>
<p class="since">Since: 2.10</p>
</div>
@ -879,14 +758,16 @@ and <a class="link" href="GtkMessageDialog.html#GTK-BUTTONS-OK-CANCEL:CAPS"><cod
<p>The <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</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>Owner: GtkMessageDialog</p>
<p>Flags: Read</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></pre>
<pre class="programlisting"> “message-type” <a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkMessageType"><span class="type">GtkMessageType</span></a></pre>
<p>The type of the message.</p>
<p>Owner: GtkMessageDialog</p>
<p>Flags: Read / Write / Construct</p>
<p>Default value: GTK_MESSAGE_INFO</p>
</div>
@ -895,6 +776,7 @@ area.</p>
<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> *</pre>
<p>The secondary text of the message dialog.</p>
<p>Owner: GtkMessageDialog</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.10</p>
@ -906,6 +788,7 @@ area.</p>
<p><code class="literal">TRUE</code> if the secondary text of the dialog includes Pango markup.
See <a href="https://developer.gnome.org/pango/pango-Markup.html#pango-parse-markup"><code class="function">pango_parse_markup()</code></a>.</p>
<p>Owner: GtkMessageDialog</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.10</p>
@ -917,6 +800,7 @@ See <a href="https://developer.gnome.org/pango/pango-Markup.html#pango-parse-mar
<p>The primary text of the message dialog. If the dialog has
a secondary text, this will appear as the title.</p>
<p>Owner: GtkMessageDialog</p>
<p>Flags: Read / Write</p>
<p>Default value: ""</p>
<p class="since">Since: 2.10</p>
@ -928,6 +812,7 @@ a secondary text, this will appear as the title.</p>
<p><code class="literal">TRUE</code> if the primary text of the dialog includes Pango markup.
See <a href="https://developer.gnome.org/pango/pango-Markup.html#pango-parse-markup"><code class="function">pango_parse_markup()</code></a>.</p>
<p>Owner: GtkMessageDialog</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.10</p>
@ -939,6 +824,7 @@ See <a href="https://developer.gnome.org/pango/pango-Markup.html#pango-parse-mar
<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></pre>
<p>Width of border around the label in the message dialog.</p>
<p>Owner: GtkMessageDialog</p>
<p>Flags: Read</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 12</p>
@ -950,6 +836,6 @@ See <a href="https://developer.gnome.org/pango/pango-Markup.html#pango-parse-mar
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.29</div>
<hr>Generated by GTK-Doc V1.32.1</div>
</body>
</html>