← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkMessageDialog.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2010-06-11 12:19:30 UTC
  • mfrom: (1.11.6 upstream)
  • mto: This revision was merged to the branch mainline in revision 175.
  • Revision ID: james.westby@ubuntu.com-20100611121930-n4pklvkoqdsg12vm
Tags: 2.21.2-1
* New upstream development release:
  + debian/rules,
    debian/libgtk2.0-0.symbols:
    - Update for new API symbols.
  + debian/patches/070_mandatory-relibtoolize.patch:
    - Regenerated for the new version.
  + debian/control.in:
    - Update GLib (build-) dependency to >= 2.25.8.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkMessageDialog.html
55
55
                                                         <em class="parameter"><code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags"><span class="type">GtkDialogFlags</span></a> flags</code></em>,
56
56
                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a> type</code></em>,
57
57
                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType"><span class="type">GtkButtonsType</span></a> buttons</code></em>,
58
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
 
58
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
59
59
                                                         <em class="parameter"><code>...</code></em>);
60
60
<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>,
61
61
                                                         <em class="parameter"><code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags"><span class="type">GtkDialogFlags</span></a> flags</code></em>,
62
62
                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a> type</code></em>,
63
63
                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType"><span class="type">GtkButtonsType</span></a> buttons</code></em>,
64
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
 
64
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
65
65
                                                         <em class="parameter"><code>...</code></em>);
66
66
<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>,
67
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
 
67
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);
68
68
<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>,
69
69
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *image</code></em>);
70
70
<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>);
71
71
<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>
72
72
                                                        (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *message_dialog</code></em>,
73
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
 
73
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
74
74
                                                         <em class="parameter"><code>...</code></em>);
75
75
<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>
76
76
                                                        (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *message_dialog</code></em>,
77
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
 
77
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
78
78
                                                         <em class="parameter"><code>...</code></em>);
79
79
</pre>
80
80
</div>
81
81
<div class="refsect1" title="Object Hierarchy">
82
82
<a name="GtkMessageDialog.object-hierarchy"></a><h2>Object Hierarchy</h2>
83
83
<pre class="synopsis">
84
 
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
85
 
   +----<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 
84
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
85
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
86
86
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
87
87
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
88
88
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
104
104
  "<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
105
105
  "<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
106
106
  "<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
107
 
  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--secondary-text" title='The "secondary-text" property'>secondary-text</a>"           <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
108
 
  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--secondary-use-markup" title='The "secondary-use-markup" property'>secondary-use-markup</a>"     <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
109
 
  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--text" title='The "text" property'>text</a>"                     <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
110
 
  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--use-markup" title='The "use-markup" property'>use-markup</a>"               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
107
  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--secondary-text" title='The "secondary-text" property'>secondary-text</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
108
  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--secondary-use-markup" title='The "secondary-use-markup" property'>secondary-use-markup</a>"     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
109
  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--text" title='The "text" property'>text</a>"                     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
110
  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--use-markup" title='The "use-markup" property'>use-markup</a>"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
111
111
</pre>
112
112
</div>
113
113
<div class="refsect1" title="Style Properties">
114
114
<a name="GtkMessageDialog.style-properties"></a><h2>Style Properties</h2>
115
115
<pre class="synopsis">
116
 
  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--s-message-border" title='The "message-border" style property'>message-border</a>"           <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
117
 
  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--s-use-separator" title='The "use-separator" style property'>use-separator</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read
 
116
  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--s-message-border" title='The "message-border" style property'>message-border</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
117
  "<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--s-use-separator" title='The "use-separator" style property'>use-separator</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read
118
118
</pre>
119
119
</div>
120
120
<div class="refsect1" title="Description">
132
132
returns when any dialog button is clicked.
133
133
</p>
134
134
<div class="example">
135
 
<a name="id630568"></a><p class="title"><b>Example 8. A modal dialog.</b></p>
 
135
<a name="id548127"></a><p class="title"><b>Example 8. A modal dialog.</b></p>
136
136
<div class="example-contents">
137
137
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
138
138
    <tbody>
150
150
<span class="normal">                                 <a href="GtkMessageDialog.html#GTK-MESSAGE-ERROR:CAPS">GTK_MESSAGE_ERROR</a></span><span class="symbol">,</span>
151
151
<span class="normal">                                 <a href="GtkMessageDialog.html#GTK-BUTTONS-CLOSE:CAPS">GTK_BUTTONS_CLOSE</a></span><span class="symbol">,</span>
152
152
<span class="normal">                                 </span><span class="string">"Error loading file '%s': %s"</span><span class="symbol">,</span>
153
 
<span class="normal">                                 filename</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strerror">g_strerror</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">errno</span><span class="symbol">));</span>
 
153
<span class="normal">                                 filename</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strerror">g_strerror</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">errno</span><span class="symbol">));</span>
154
154
<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>
155
155
<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>
156
156
      </tr>
163
163
You might do a non-modal <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> as follows:
164
164
</p>
165
165
<div class="example">
166
 
<a name="id645487"></a><p class="title"><b>Example 9. A non-modal dialog.</b></p>
 
166
<a name="id505576"></a><p class="title"><b>Example 9. A non-modal dialog.</b></p>
167
167
<div class="example-contents">
168
168
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
169
169
    <tbody>
184
184
<span class="normal">                                 <a href="GtkMessageDialog.html#GTK-MESSAGE-ERROR:CAPS">GTK_MESSAGE_ERROR</a></span><span class="symbol">,</span>
185
185
<span class="normal">                                 <a href="GtkMessageDialog.html#GTK-BUTTONS-CLOSE:CAPS">GTK_BUTTONS_CLOSE</a></span><span class="symbol">,</span>
186
186
<span class="normal">                                 </span><span class="string">"Error loading file '%s': %s"</span><span class="symbol">,</span>
187
 
<span class="normal">                                 filename</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strerror">g_strerror</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">errno</span><span class="symbol">));</span>
 
187
<span class="normal">                                 filename</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strerror">g_strerror</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">errno</span><span class="symbol">));</span>
188
188
 
189
189
<span class="comment">/* Destroy the dialog when the user responds to it (e.g. clicks a button) */</span>
190
 
<span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></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>
191
 
<span class="normal">                          </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></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>
 
190
<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></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>
 
191
<span class="normal">                          </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></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>
192
192
<span class="normal">                          dialog</span><span class="symbol">);</span></pre></td>
193
193
      </tr>
194
194
    </tbody>
322
322
                                                         <em class="parameter"><code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags"><span class="type">GtkDialogFlags</span></a> flags</code></em>,
323
323
                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a> type</code></em>,
324
324
                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType"><span class="type">GtkButtonsType</span></a> buttons</code></em>,
325
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
 
325
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
326
326
                                                         <em class="parameter"><code>...</code></em>);</pre>
327
327
<p>
328
328
Creates a new message dialog, which is a simple dialog with an icon
336
336
<tbody>
337
337
<tr>
338
338
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
339
 
<td> transient parent, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.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>
 
339
<td> transient parent, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.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>
340
340
</td>
341
341
</tr>
342
342
<tr>
356
356
</tr>
357
357
<tr>
358
358
<td><p><span class="term"><em class="parameter"><code>message_format</code></em> :</span></p></td>
359
 
<td> <code class="function">printf()</code>-style format string, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.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>
 
359
<td> <code class="function">printf()</code>-style format string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.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>
360
360
</td>
361
361
</tr>
362
362
<tr>
379
379
                                                         <em class="parameter"><code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags"><span class="type">GtkDialogFlags</span></a> flags</code></em>,
380
380
                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType"><span class="type">GtkMessageType</span></a> type</code></em>,
381
381
                                                         <em class="parameter"><code><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType"><span class="type">GtkButtonsType</span></a> buttons</code></em>,
382
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
 
382
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
383
383
                                                         <em class="parameter"><code>...</code></em>);</pre>
384
384
<p>
385
385
Creates a new message dialog, which is a simple dialog with an icon
391
391
<p>
392
392
Special XML characters in the <code class="function">printf()</code> arguments passed to this
393
393
function will automatically be escaped as necessary.
394
 
(See <a href="/usr/share/gtk-doc/html/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.)
 
394
(See <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped"><code class="function">g_markup_printf_escaped()</code></a> for how this is implemented.)
395
395
Usually this is what you want, but if you have an existing
396
396
Pango markup string that you want to use literally as the
397
397
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>
411
411
6
412
412
7
413
413
8</pre></td>
414
 
        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="GtkWidget.html">GtkWidget</a> </span><span class="symbol">*</span><span class="normal">dialog</span><span class="symbol">;</span>
 
414
        <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>
415
415
<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>
416
416
<span class="normal">                                 <a href="GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS">GTK_DIALOG_DESTROY_WITH_PARENT</a></span><span class="symbol">,</span>
417
417
<span class="normal">                                 <a href="GtkMessageDialog.html#GTK-MESSAGE-ERROR:CAPS">GTK_MESSAGE_ERROR</a></span><span class="symbol">,</span>
418
418
<span class="normal">                                 <a href="GtkMessageDialog.html#GTK-BUTTONS-CLOSE:CAPS">GTK_BUTTONS_CLOSE</a></span><span class="symbol">,</span>
419
 
<span class="normal">                                 <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
419
<span class="normal">                                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
420
420
<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>
421
421
<span class="normal">                               markup</span><span class="symbol">);</span></pre></td>
422
422
      </tr>
431
431
<tbody>
432
432
<tr>
433
433
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
434
 
<td> transient parent, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.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>
 
434
<td> transient parent, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.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>
435
435
</td>
436
436
</tr>
437
437
<tr>
451
451
</tr>
452
452
<tr>
453
453
<td><p><span class="term"><em class="parameter"><code>message_format</code></em> :</span></p></td>
454
 
<td> <code class="function">printf()</code>-style format string, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.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>
 
454
<td> <code class="function">printf()</code>-style format string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.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>
455
455
</td>
456
456
</tr>
457
457
<tr>
473
473
<div class="refsect2" title="gtk_message_dialog_set_markup ()">
474
474
<a name="gtk-message-dialog-set-markup"></a><h3>gtk_message_dialog_set_markup ()</h3>
475
475
<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>,
476
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
 
476
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
477
477
<p>
478
478
Sets the text of the message dialog to be <em class="parameter"><code>str</code></em>, which is marked
479
479
up with the <GTKDOCLINK HREF="PangoMarkupFormat">Pango text markup
551
551
<a name="gtk-message-dialog-format-secondary-text"></a><h3>gtk_message_dialog_format_secondary_text ()</h3>
552
552
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_message_dialog_format_secondary_text
553
553
                                                        (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *message_dialog</code></em>,
554
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
 
554
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
555
555
                                                         <em class="parameter"><code>...</code></em>);</pre>
556
556
<p>
557
557
Sets the secondary text of the message dialog to be <em class="parameter"><code>message_format</code></em> 
571
571
</tr>
572
572
<tr>
573
573
<td><p><span class="term"><em class="parameter"><code>message_format</code></em> :</span></p></td>
574
 
<td> <code class="function">printf()</code>-style format string, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.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>
 
574
<td> <code class="function">printf()</code>-style format string, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.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>
575
575
</td>
576
576
</tr>
577
577
<tr>
588
588
<a name="gtk-message-dialog-format-secondary-markup"></a><h3>gtk_message_dialog_format_secondary_markup ()</h3>
589
589
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_message_dialog_format_secondary_markup
590
590
                                                        (<em class="parameter"><code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a> *message_dialog</code></em>,
591
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
 
591
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *message_format</code></em>,
592
592
                                                         <em class="parameter"><code>...</code></em>);</pre>
593
593
<p>
594
594
Sets the secondary text of the message dialog to be <em class="parameter"><code>message_format</code></em> (with 
602
602
<p>
603
603
Due to an oversight, this function does not escape special XML characters
604
604
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 
605
 
may contain special XML characters, you should use <a href="/usr/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped"><code class="function">g_markup_printf_escaped()</code></a>
 
605
may contain special XML characters, you should use <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped"><code class="function">g_markup_printf_escaped()</code></a>
606
606
to escape it.
607
607
</p>
608
608
<p>
616
616
3
617
617
4
618
618
5</pre></td>
619
 
        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> </span><span class="symbol">*</span><span class="normal">msg</span><span class="symbol">;</span>
 
619
        <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>
620
620
<span class="normal"> </span>
621
 
<span class="normal">msg </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped">g_markup_printf_escaped</a></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>
 
621
<span class="normal">msg </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped">g_markup_printf_escaped</a></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>
622
622
<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>
623
 
<span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">msg</span><span class="symbol">);</span></pre></td>
 
623
<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">msg</span><span class="symbol">);</span></pre></td>
624
624
      </tr>
625
625
    </tbody>
626
626
  </table>
639
639
<tr>
640
640
<td><p><span class="term"><em class="parameter"><code>message_format</code></em> :</span></p></td>
641
641
<td>printf()-style markup string (see 
642
 
     <a href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango markup format</a>), or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
642
     <a href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango markup format</a>), or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
643
643
</td>
644
644
</tr>
645
645
<tr>
683
683
<hr>
684
684
<div class="refsect2" title='The "secondary-text" property'>
685
685
<a name="GtkMessageDialog--secondary-text"></a><h3>The <code class="literal">"secondary-text"</code> property</h3>
686
 
<pre class="programlisting">  "secondary-text"           <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
686
<pre class="programlisting">  "secondary-text"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
687
687
<p>
688
688
The secondary text of the message dialog.
689
689
</p>
693
693
<hr>
694
694
<div class="refsect2" title='The "secondary-use-markup" property'>
695
695
<a name="GtkMessageDialog--secondary-use-markup"></a><h3>The <code class="literal">"secondary-use-markup"</code> property</h3>
696
 
<pre class="programlisting">  "secondary-use-markup"     <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
696
<pre class="programlisting">  "secondary-use-markup"     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
697
697
<p>
698
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the secondary text of the dialog includes Pango markup. 
 
698
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the secondary text of the dialog includes Pango markup. 
699
699
See <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#pango-parse-markup"><code class="function">pango_parse_markup()</code></a>.
700
700
</p>
701
701
<p>Default value: FALSE</p>
704
704
<hr>
705
705
<div class="refsect2" title='The "text" property'>
706
706
<a name="GtkMessageDialog--text"></a><h3>The <code class="literal">"text"</code> property</h3>
707
 
<pre class="programlisting">  "text"                     <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
707
<pre class="programlisting">  "text"                     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
708
708
<p>
709
709
The primary text of the message dialog. If the dialog has 
710
710
a secondary text, this will appear as the title.
715
715
<hr>
716
716
<div class="refsect2" title='The "use-markup" property'>
717
717
<a name="GtkMessageDialog--use-markup"></a><h3>The <code class="literal">"use-markup"</code> property</h3>
718
 
<pre class="programlisting">  "use-markup"               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
718
<pre class="programlisting">  "use-markup"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
719
719
<p>
720
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the primary text of the dialog includes Pango markup. 
 
720
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the primary text of the dialog includes Pango markup. 
721
721
See <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#pango-parse-markup"><code class="function">pango_parse_markup()</code></a>.
722
722
</p>
723
723
<p>Default value: FALSE</p>
728
728
<a name="GtkMessageDialog.style-property-details"></a><h2>Style Property Details</h2>
729
729
<div class="refsect2" title='The "message-border" style property'>
730
730
<a name="GtkMessageDialog--s-message-border"></a><h3>The <code class="literal">"message-border"</code> style property</h3>
731
 
<pre class="programlisting">  "message-border"           <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
731
<pre class="programlisting">  "message-border"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
732
732
<p>Width of border around the label and image in the message dialog.</p>
733
733
<p>Allowed values: &gt;= 0</p>
734
734
<p>Default value: 12</p>
736
736
<hr>
737
737
<div class="refsect2" title='The "use-separator" style property'>
738
738
<a name="GtkMessageDialog--s-use-separator"></a><h3>The <code class="literal">"use-separator"</code> style property</h3>
739
 
<pre class="programlisting">  "use-separator"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read</pre>
 
739
<pre class="programlisting">  "use-separator"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read</pre>
740
740
<p>
741
741
Whether to draw a separator line between the message label and the buttons
742
742
in the dialog.