callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

New upstream version 3.24.18

Browse Source
This commit is contained in:
Simon McVittie
2020-04-10 15:23:16 +01:00
parent ecf5b7f34b f9decb0cd6
commit ea8a581be2
386 changed files with 78008 additions and 6390 deletions
Download Patch File Download Diff File Expand all files Collapse all files

155
docs/reference/gtk/html/GtkMessageDialog.html
View File

@ -120,7 +120,7 @@
</colgroup>
<tbody>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkButtonsType"><span class="type">GtkButtonsType</span></a></td>
<td class="property_type"><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum 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>
</tr>
@ -137,7 +137,7 @@
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkMessageType"><span class="type">GtkMessageType</span></a></td>
<td class="property_type"><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum 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>
@ -191,15 +191,15 @@
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkMessageDialog-struct">GtkMessageDialog</a></td>
<td class="function_name"><a class="link" href="GtkMessageDialog.html#GtkMessageDialog-struct" title="struct GtkMessageDialog">GtkMessageDialog</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkMessageType">GtkMessageType</a></td>
<td class="function_name"><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType">GtkMessageType</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkButtonsType">GtkButtonsType</a></td>
<td class="function_name"><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum 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 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
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>
<p>An example for using a modal dialog:</p>
@ -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 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><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 some text
the user may want to see. When the user clicks a button a “response”
signal is emitted with response IDs from <a href="https://developer.gnome.org/gtk4/GtkDialog.html#GtkResponseType"><span class="type">GtkResponseType</span></a>. See
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="refsect3">
<a name="gtk-message-dialog-new.parameters"></a><h4>Parameters</h4>
@ -387,15 +387,15 @@ signal is emitted with response IDs from <a href="https://developer.gnome.org/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 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><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 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 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>
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.)
@ -729,10 +729,133 @@ 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 href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkButtonsType"><span class="type">GtkButtonsType</span></a></pre>
<pre class="programlisting"> “buttons” <a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType"><span class="type">GtkButtonsType</span></a></pre>
<p>The buttons shown in the message dialog.</p>
<p>Owner: GtkMessageDialog</p>
<p>Flags: Write / Construct Only</p>
@ -765,7 +888,7 @@ area.</p>
<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 href="https://developer.gnome.org/gtk4/GtkMessageDialog.html#GtkMessageType"><span class="type">GtkMessageType</span></a></pre>
<pre class="programlisting"> “message-type” <a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum 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>