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

New upstream version 3.22.28

Browse Source
This commit is contained in:
Jeremy Bicha
2018-02-15 04:41:25 -05:00
parent d4022898c0 463ee95136
commit 55d2e9a013
652 changed files with 498643 additions and 49781 deletions
Download Patch File Download Diff File Expand all files Collapse all files

144
docs/reference/gtk/html/GtkMessageDialog.html
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.25.1 (XML mode)">
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -143,23 +143,23 @@
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkMessageDialog.html#GtkMessageDialog--secondary-text" title="The “secondary-text” property">secondary-text</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkMessageDialog.html#GtkMessageDialog--secondary-use-markup" title="The “secondary-use-markup” property">secondary-use-markup</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkMessageDialog.html#GtkMessageDialog--text" title="The “text” property">text</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkMessageDialog.html#GtkMessageDialog--use-markup" title="The “use-markup” property">use-markup</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -175,7 +175,7 @@
<col width="200px" class="style_properties_flags">
</colgroup>
<tbody><tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_type"><span class="type">gint</span></td>
<td class="property_name"><a class="link" href="GtkMessageDialog.html#GtkMessageDialog--s-message-border" title="The “message-border” style property">message-border</a></td>
<td class="property_flags">Read</td>
</tr></tbody>
@ -206,8 +206,8 @@
</div>
<div class="refsect1">
<a name="GtkMessageDialog.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GInitiallyUnowned
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
<span class="lineart">╰──</span> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
<span class="lineart">╰──</span> <a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
@ -233,7 +233,7 @@ GtkMessageDialog implements
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 <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, so that the dialog is hidden
<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
@ -254,16 +254,16 @@ returns when any dialog button is clicked.</p>
8
9
10</pre></td>
<td class="listing_code"><pre class="programlisting">GtkDialogFlags flags <span class="gtkdoc opt">=</span> GTK_DIALOG_DESTROY_WITH_PARENT<span class="gtkdoc opt">;</span>
dialog <span class="gtkdoc opt">=</span> <span class="function"><a href="GtkMessageDialog.html#gtk-message-dialog-new">gtk_message_dialog_new</a></span> <span class="gtkdoc opt">(</span>parent_window<span class="gtkdoc opt">,</span>
flags<span class="gtkdoc opt">,</span>
GTK_MESSAGE_ERROR<span class="gtkdoc opt">,</span>
GTK_BUTTONS_CLOSE<span class="gtkdoc opt">,</span>
<span class="string">&quot;Error reading “%s”: %s&quot;</span><span class="gtkdoc opt">,</span>
filename<span class="gtkdoc opt">,</span>
<span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strerror">g_strerror</a></span> <span class="gtkdoc opt">(</span>errno<span class="gtkdoc opt">));</span>
<span class="function"><a href="GtkDialog.html#gtk-dialog-run">gtk_dialog_run</a></span> <span class="gtkdoc opt">(</span><span class="function">GTK_DIALOG</span> <span class="gtkdoc opt">(</span>dialog<span class="gtkdoc opt">));</span>
<span class="function"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span> <span class="gtkdoc opt">(</span>dialog<span class="gtkdoc opt">);</span></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>
</tr>
</tbody>
</table>
@ -291,21 +291,21 @@ dialog <span class="gtkdoc opt">=</span> <span class="function"><a href="GtkMess
13
14
15</pre></td>
<td class="listing_code"><pre class="programlisting">GtkDialogFlags flags <span class="gtkdoc opt">=</span> GTK_DIALOG_DESTROY_WITH_PARENT<span class="gtkdoc opt">;</span>
dialog <span class="gtkdoc opt">=</span> <span class="function"><a href="GtkMessageDialog.html#gtk-message-dialog-new">gtk_message_dialog_new</a></span> <span class="gtkdoc opt">(</span>parent_window<span class="gtkdoc opt">,</span>
flags<span class="gtkdoc opt">,</span>
GTK_MESSAGE_ERROR<span class="gtkdoc opt">,</span>
GTK_BUTTONS_CLOSE<span class="gtkdoc opt">,</span>
<span class="string">&quot;Error reading “%s”: %s&quot;</span><span class="gtkdoc opt">,</span>
filename<span class="gtkdoc opt">,</span>
<span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strerror">g_strerror</a></span> <span class="gtkdoc opt">(</span>errno<span class="gtkdoc opt">));</span>
<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="gtkdoc slc">// Destroy the dialog when the user responds to it</span>
<span class="gtkdoc slc">// (e.g. clicks a button)</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="function"><a href="../gobject/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></span> <span class="gtkdoc opt">(</span>dialog<span class="gtkdoc opt">,</span> <span class="string">&quot;response&quot;</span><span class="gtkdoc opt">,</span>
<span class="function"><a href="../gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span> <span class="gtkdoc opt">(</span>gtk_widget_destroy<span class="gtkdoc opt">),</span>
dialog<span class="gtkdoc opt">);</span></pre></td>
<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>
@ -327,7 +327,7 @@ gtk_message_dialog_new (<em class="parameter"><code><a class="link" href="GtkWin
<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 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</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”
@ -344,7 +344,7 @@ signal is emitted with response IDs from <a class="link" href="GtkDialog.html#Gt
<tbody>
<tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p> transient parent, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for none. </p></td>
<td class="parameter_description"><p>transient parent, or <code class="literal">NULL</code> for none. </p></td>
<td class="parameter_annotations"><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>
@ -364,7 +364,7 @@ signal is emitted with response IDs from <a class="link" href="GtkDialog.html#Gt
</tr>
<tr>
<td class="parameter_name"><p>message_format</p></td>
<td class="parameter_description"><p> <code class="function">printf()</code>-style format string, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>printf()-style format string, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><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>
@ -378,7 +378,7 @@ signal is emitted with response IDs from <a class="link" href="GtkDialog.html#Gt
</div>
<div class="refsect3">
<a name="gtk-message-dialog-new.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>. </p>
<p>a new <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@ -390,7 +390,7 @@ gtk_message_dialog_new_with_markup (<em class="parameter"><code><a class="link"
<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 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</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.
@ -398,7 +398,7 @@ 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 <a href="../glib/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped"><code class="function">g_markup_printf_escaped()</code></a> for how this is implemented.)
(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>
@ -418,15 +418,15 @@ argument.</p>
7
8
9</pre></td>
<td class="listing_code"><pre class="programlisting">GtkWidget <span class="gtkdoc opt">*</span>dialog<span class="gtkdoc opt">;</span>
GtkDialogFlags flags <span class="gtkdoc opt">=</span> GTK_DIALOG_DESTROY_WITH_PARENT<span class="gtkdoc opt">;</span>
dialog <span class="gtkdoc opt">=</span> <span class="function"><a href="GtkMessageDialog.html#gtk-message-dialog-new">gtk_message_dialog_new</a></span> <span class="gtkdoc opt">(</span>parent_window<span class="gtkdoc opt">,</span>
flags<span class="gtkdoc opt">,</span>
GTK_MESSAGE_ERROR<span class="gtkdoc opt">,</span>
GTK_BUTTONS_CLOSE<span class="gtkdoc opt">,</span>
NULL<span class="gtkdoc opt">);</span>
<span class="function"><a href="GtkMessageDialog.html#gtk-message-dialog-set-markup">gtk_message_dialog_set_markup</a></span> <span class="gtkdoc opt">(</span><span class="function">GTK_MESSAGE_DIALOG</span> <span class="gtkdoc opt">(</span>dialog<span class="gtkdoc opt">),</span>
markup<span class="gtkdoc opt">);</span></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>
</tr>
</tbody>
</table>
@ -444,7 +444,7 @@ dialog <span class="gtkdoc opt">=</span> <span class="function"><a href="GtkMess
<tbody>
<tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p> transient parent, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for none. </p></td>
<td class="parameter_description"><p>transient parent, or <code class="literal">NULL</code> for none. </p></td>
<td class="parameter_annotations"><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>
@ -464,7 +464,7 @@ dialog <span class="gtkdoc opt">=</span> <span class="function"><a href="GtkMess
</tr>
<tr>
<td class="parameter_name"><p>message_format</p></td>
<td class="parameter_description"><p> <code class="function">printf()</code>-style format string, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>printf()-style format string, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><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>
@ -487,7 +487,7 @@ dialog <span class="gtkdoc opt">=</span> <span class="function"><a href="GtkMess
<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 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
<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 Pango text markup language.</p>
@ -578,7 +578,7 @@ gtk_message_dialog_get_image (<em class="parameter"><code><a class="link" href="
</div>
<div class="refsect3">
<a name="gtk-message-dialog-get-image.returns"></a><h4>Returns</h4>
<p> the dialog’s image. </p>
<p>the dialog’s image. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.14</p>
@ -589,7 +589,7 @@ gtk_message_dialog_get_image (<em class="parameter"><code><a class="link" href="
<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 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</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>
@ -610,7 +610,7 @@ gtk_message_dialog_format_secondary_text
</tr>
<tr>
<td class="parameter_name"><p>message_format</p></td>
<td class="parameter_description"><p> <code class="function">printf()</code>-style format string, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>printf()-style format string, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><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>
@ -630,7 +630,7 @@ gtk_message_dialog_format_secondary_text
<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 <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</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
@ -638,7 +638,7 @@ gtk_message_dialog_format_secondary_markup
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 <a href="../glib/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped"><code class="function">g_markup_printf_escaped()</code></a>
may contain special XML characters, you should use <code class="function">g_markup_printf_escaped()</code>
to escape it.</p>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@ -650,12 +650,12 @@ to escape it.</p>
4
5
6</pre></td>
<td class="listing_code"><pre class="programlisting">gchar <span class="gtkdoc opt">*</span>msg<span class="gtkdoc opt">;</span>
<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>
msg <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped">g_markup_printf_escaped</a></span> <span class="gtkdoc opt">(</span>message_format<span class="gtkdoc opt">, ...);</span>
<span class="function"><a href="GtkMessageDialog.html#gtk-message-dialog-format-secondary-markup">gtk_message_dialog_format_secondary_markup</a></span> <span class="gtkdoc opt">(</span>message_dialog<span class="gtkdoc opt">,</span>
<span class="string">&quot;%s&quot;</span><span class="gtkdoc opt">,</span> msg<span class="gtkdoc opt">);</span>
<span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span> <span class="gtkdoc opt">(</span>msg<span class="gtkdoc opt">);</span></pre></td>
<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>
@ -679,7 +679,7 @@ msg <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib/gl
<tr>
<td class="parameter_name"><p>message_format</p></td>
<td class="parameter_description"><p>printf()-style markup string (see
Pango markup format), or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
Pango markup format), or <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -720,7 +720,7 @@ function in the parent <a class="link" href="GtkDialog.html" title="GtkDialog"><
</div>
<div class="refsect3">
<a name="gtk-message-dialog-get-message-area.returns"></a><h4>Returns</h4>
<p> A <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> corresponding to the
<p>A <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> corresponding to the
“message area” in the <em class="parameter"><code>message_dialog</code></em>
. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
@ -893,7 +893,7 @@ area.</p>
<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” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “secondary-text” <span class="type">gchar</span> *</pre>
<p>The secondary text of the message dialog.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@ -902,10 +902,10 @@ area.</p>
<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” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the secondary text of the dialog includes Pango markup.
<pre class="programlisting"> “secondary-use-markup” <span class="type">gboolean</span></pre>
<p><code class="literal">TRUE</code> if the secondary text of the dialog includes Pango markup.
See <a href="../pango/pango-Text-Attributes.html#pango-parse-markup"><code class="function">pango_parse_markup()</code></a>.</p>
See <code class="function">pango_parse_markup()</code>.</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.10</p>
@ -913,7 +913,7 @@ See <a href="../pango/pango-Text-Attributes.html#pango-parse-markup"><code class
<hr>
<div class="refsect2">
<a name="GtkMessageDialog--text"></a><h3>The <code class="literal">“text”</code> property</h3>
<pre class="programlisting"> “text” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “text” <span class="type">gchar</span> *</pre>
<p>The primary text of the message dialog. If the dialog has
a secondary text, this will appear as the title.</p>
@ -924,10 +924,10 @@ a secondary text, this will appear as the title.</p>
<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” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the primary text of the dialog includes Pango markup.
<pre class="programlisting"> “use-markup” <span class="type">gboolean</span></pre>
<p><code class="literal">TRUE</code> if the primary text of the dialog includes Pango markup.
See <a href="../pango/pango-Text-Attributes.html#pango-parse-markup"><code class="function">pango_parse_markup()</code></a>.</p>
See <code class="function">pango_parse_markup()</code>.</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.10</p>
@ -937,7 +937,7 @@ See <a href="../pango/pango-Text-Attributes.html#pango-parse-markup"><code class
<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” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<pre class="programlisting"> “message-border” <span class="type">gint</span></pre>
<p>Width of border around the label in the message dialog.</p>
<p>Flags: Read</p>
<p>Allowed values: &gt;= 0</p>
@ -950,6 +950,6 @@ See <a href="../pango/pango-Text-Attributes.html#pango-parse-markup"><code class
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25.1</div>
<hr>Generated by GTK-Doc V1.27</div>
</body>
</html>