~ubuntu-branches/ubuntu/raring/gtk+2.0/raring-proposed

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</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> (<code><a class="link" href="GtkWindow.html" title="GtkWindow">GtkWindow</a> *parent</code>,

<code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags">GtkDialogFlags</a> flags</code>,

<code><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType">GtkMessageType</a> type</code>,

<code><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType">GtkButtonsType</a> buttons</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *message_format</code>,

<code>const gchar *message_format</code>,

<code>...</code>);

void <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-set-markup" title="gtk_message_dialog_set_markup ()">gtk_message_dialog_set_markup</a> (<code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a> *message_dialog</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *str</code>);

<code>const gchar *str</code>);

void <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-set-image" title="gtk_message_dialog_set_image ()">gtk_message_dialog_set_image</a> (<code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a> *dialog</code>,

<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *image</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-get-image" title="gtk_message_dialog_get_image ()">gtk_message_dialog_get_image</a> (<code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a> *dialog</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-get-message-area" title="gtk_message_dialog_get_message_area ()">gtk_message_dialog_get_message_area</a> (<code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a> *message_dialog</code>);

void <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>

(<code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a> *message_dialog</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *message_format</code>,

<code>const gchar *message_format</code>,

<code>...</code>);

void <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>

(<code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a> *message_dialog</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *message_format</code>,

<code>const gchar *message_format</code>,

<code>...</code>);

</pre>

</div>

106

"<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--image" title='The "image" property'>image</a>" <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* : Read / Write

107

"<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--message-area" title='The "message-area" property'>message-area</a>" <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* : Read

108

"<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">GtkMessageType</a> : Read / Write / Construct

109

"<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">gchar</a>* : Read / Write

110

"<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">gboolean</a> : Read / Write

111

"<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">gchar</a>* : Read / Write

112

"<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">gboolean</a> : Read / Write

109

"<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--secondary-text" title='The "secondary-text" property'>secondary-text</a>" gchar* : Read / Write

110

111

"<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--text" title='The "text" property'>text</a>" gchar* : Read / Write

112

"<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--use-markup" title='The "use-markup" property'>use-markup</a>" gboolean : Read / Write

113

</pre>

114

</div>

115

116

<a name="GtkMessageDialog.style-properties"></a><h2>Style Properties</h2>

117

118

"<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">gint</a> : Read

119

"<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">gboolean</a> : Read

118

"<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--s-message-border" title='The "message-border" style property'>message-border</a>" gint : Read

119

"<a class="link" href="GtkMessageDialog.html#GtkMessageDialog--s-use-separator" title='The "use-separator" style property'>use-separator</a>" gboolean : Read

120

</pre>

121

</div>

122

134

returns when any dialog button is clicked.

135

136

137

<a name="id514072"></a>Example 8. A modal dialog.

137

<a name="id596022"></a>Example 8. A modal dialog.

138

139

140

<tbody>

152

<a href="GtkMessageDialog.html#GTK-MESSAGE-ERROR:CAPS">GTK_MESSAGE_ERROR</a>,

153

<a href="GtkMessageDialog.html#GTK-BUTTONS-CLOSE:CAPS">GTK_BUTTONS_CLOSE</a>,

154

"Error loading file '%s': %s",

155

filename, <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strerror">g_strerror</a> (errno));

155

filename, g_strerror (errno));

156

<a href="GtkDialog.html#gtk-dialog-run">gtk_dialog_run</a> (GTK_DIALOG (dialog));

157

<a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a> (dialog);</pre></td>

158

</tr>

165

You might do a non-modal <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a> as follows:

166

167

168

<a name="id514097"></a>Example 9. A non-modal dialog.

168

<a name="id625978"></a>Example 9. A non-modal dialog.

169

170

171

<tbody>

186

<a href="GtkMessageDialog.html#GTK-MESSAGE-ERROR:CAPS">GTK_MESSAGE_ERROR</a>,

187

<a href="GtkMessageDialog.html#GTK-BUTTONS-CLOSE:CAPS">GTK_BUTTONS_CLOSE</a>,

188

"Error loading file '%s': %s",

189

190

191

/* Destroy the dialog when the user responds to it (e.g. clicks a button) */

192

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a> (dialog, "response",

339

<code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags">GtkDialogFlags</a> flags</code>,

340

<code><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType">GtkMessageType</a> type</code>,

341

<code><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType">GtkButtonsType</a> buttons</code>,

342

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *message_format</code>,

342

<code>const gchar *message_format</code>,

343

344

345

Creates a new message dialog, which is a simple dialog with an icon

356

<tbody>

357

<tr>

358

<td><code>parent</code> :</td>

359

<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. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

359

<td>transient parent, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for none. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

360

</td>

361

</tr>

362

<tr>

374

<tr>

375

<td><code>message_format</code> :</td>

376

<td>

377

<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>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

377

<code class="function">printf()</code>-style format string, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

378

</td>

379

</tr>

380

<tr>

392

<code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags">GtkDialogFlags</a> flags</code>,

393

<code><a class="link" href="GtkMessageDialog.html#GtkMessageType" title="enum GtkMessageType">GtkMessageType</a> type</code>,

394

<code><a class="link" href="GtkMessageDialog.html#GtkButtonsType" title="enum GtkButtonsType">GtkButtonsType</a> buttons</code>,

395

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *message_format</code>,

395

<code>const gchar *message_format</code>,

396

397

398

Creates a new message dialog, which is a simple dialog with an icon

399

indicating the dialog type (error, warning, etc.) and some text which

400

is marked up with the <a href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango text markup language</a>.

400

is marked up with the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango text markup language</a>.

401

When the user clicks a button a "response" signal is emitted with

402

response IDs from <a class="link" href="GtkDialog.html#GtkResponseType" title="enum GtkResponseType">GtkResponseType</a>. See <a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> for more details.

403

404

405

Special XML characters in the <code class="function">printf()</code> arguments passed to this

406

function will automatically be escaped as necessary.

407

(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.)

407

(See <code class="function">g_markup_printf_escaped()</code> for how this is implemented.)

408

Usually this is what you want, but if you have an existing

409

Pango markup string that you want to use literally as the

410

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>

429

<a href="GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS">GTK_DIALOG_DESTROY_WITH_PARENT</a>,

430

<a href="GtkMessageDialog.html#GTK-MESSAGE-ERROR:CAPS">GTK_MESSAGE_ERROR</a>,

431

<a href="GtkMessageDialog.html#GTK-BUTTONS-CLOSE:CAPS">GTK_BUTTONS_CLOSE</a>,

432

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>);

432

<a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a>);

433

<a href="GtkMessageDialog.html#gtk-message-dialog-set-markup">gtk_message_dialog_set_markup</a> (GTK_MESSAGE_DIALOG (dialog),

434

markup);</pre></td>

435

</tr>

447

<tbody>

448

<tr>

449

<td><code>parent</code> :</td>

450

451

</td>

452

</tr>

453

<tr>

465

<tr>

466

<td><code>message_format</code> :</td>

467

<td>

468

469

</td>

470

</tr>

471

<tr>

481

482

<a name="gtk-message-dialog-set-markup"></a><h3>gtk_message_dialog_set_markup ()</h3>

483

<pre class="programlisting">void gtk_message_dialog_set_markup (<code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a> *message_dialog</code>,

484

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *str</code>);</pre>

484

<code>const gchar *str</code>);</pre>

485

486

Sets the text of the message dialog to be <code>str</code>, which is marked

487

up with the <GTKDOCLINK HREF="PangoMarkupFormat">Pango text markup

500

</tr>

501

<tr>

502

503

<td>markup string (see <a href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango markup format</a>)</td>

503

<td>markup string (see <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango markup format</a>)</td>

504

</tr>

505

</tbody>

506

</table></div>

598

<a name="gtk-message-dialog-format-secondary-text"></a><h3>gtk_message_dialog_format_secondary_text ()</h3>

599

<pre class="programlisting">void gtk_message_dialog_format_secondary_text

600

(<code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a> *message_dialog</code>,

601

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *message_format</code>,

601

<code>const gchar *message_format</code>,

602

603

604

Sets the secondary text of the message dialog to be <code>message_format</code>

622

<tr>

623

<td><code>message_format</code> :</td>

624

<td>

625

626

</td>

627

</tr>

628

</tbody>

634

<a name="gtk-message-dialog-format-secondary-markup"></a><h3>gtk_message_dialog_format_secondary_markup ()</h3>

635

<pre class="programlisting">void gtk_message_dialog_format_secondary_markup

636

(<code><a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a> *message_dialog</code>,

637

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *message_format</code>,

637

<code>const gchar *message_format</code>,

638

639

640

Sets the secondary text of the message dialog to be <code>message_format</code> (with

641

<code class="function">printf()</code>-style), which is marked up with the

642

<a href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango text markup language</a>.

642

<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango text markup language</a>.

643

644

645

Note that setting a secondary text makes the primary text become

648

649

Due to an oversight, this function does not escape special XML characters

650

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

651

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>

651

may contain special XML characters, you should use <code class="function">g_markup_printf_escaped()</code>

652

to escape it.

653

654

664

5</pre></td>

665

<td class="listing_code"><pre class="programlisting">gchar *msg;

666

667

msg = <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped">g_markup_printf_escaped</a> (message_format, ...);

667

msg = g_markup_printf_escaped (message_format, ...);

668

<a href="GtkMessageDialog.html#gtk-message-dialog-format-secondary-markup">gtk_message_dialog_format_secondary_markup</a> (message_dialog, "%s", msg);

669

669

g_free (msg);</pre></td>

670

</tr>

671

</tbody>

672

</table>

688

<tr>

689

<td><code>message_format</code> :</td>

690

<td>printf()-style markup string (see

691

<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>

691

<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango markup format</a>), or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>

692

</td>

693

</tr>

694

</tbody>

738

<hr>

739

740

<a name="GtkMessageDialog--secondary-text"></a><h3>The <code class="literal">"secondary-text"</code> property</h3>

741

<pre class="programlisting"> "secondary-text" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write</pre>

741

<pre class="programlisting"> "secondary-text" gchar* : Read / Write</pre>

742

743

The secondary text of the message dialog.

744

748

<hr>

749

750

<a name="GtkMessageDialog--secondary-use-markup"></a><h3>The <code class="literal">"secondary-use-markup"</code> property</h3>

751

<pre class="programlisting"> "secondary-use-markup" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write</pre>

751

<pre class="programlisting"> "secondary-use-markup" gboolean : Read / Write</pre>

752

753

<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.

754

See <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#pango-parse-markup"><code class="function">pango_parse_markup()</code></a>.

753

<code class="literal">TRUE</code> if the secondary text of the dialog includes Pango markup.

754

See <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#pango-parse-markup"><code class="function">pango_parse_markup()</code></a>.

755

756

Default value: FALSE

757

Since 2.10

759

<hr>

760

761

<a name="GtkMessageDialog--text"></a><h3>The <code class="literal">"text"</code> property</h3>

762

<pre class="programlisting"> "text" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a>* : Read / Write</pre>

762

<pre class="programlisting"> "text" gchar* : Read / Write</pre>

763

764

The primary text of the message dialog. If the dialog has

765

a secondary text, this will appear as the title.

770

<hr>

771

772

<a name="GtkMessageDialog--use-markup"></a><h3>The <code class="literal">"use-markup"</code> property</h3>

773

<pre class="programlisting"> "use-markup" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write</pre>

773

<pre class="programlisting"> "use-markup" gboolean : Read / Write</pre>

774

775

<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.

776

See <a href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#pango-parse-markup"><code class="function">pango_parse_markup()</code></a>.

775

<code class="literal">TRUE</code> if the primary text of the dialog includes Pango markup.

776

See <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#pango-parse-markup"><code class="function">pango_parse_markup()</code></a>.

777

778

Default value: FALSE

779

Since 2.10

783

<a name="GtkMessageDialog.style-property-details"></a><h2>Style Property Details</h2>

784

785

<a name="GtkMessageDialog--s-message-border"></a><h3>The <code class="literal">"message-border"</code> style property</h3>

786

<pre class="programlisting"> "message-border" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read</pre>

786

<pre class="programlisting"> "message-border" gint : Read</pre>

787

Width of border around the label and image in the message dialog.

788

Allowed values: >= 0

789

Default value: 12

791

<hr>

792

793

<a name="GtkMessageDialog--s-use-separator"></a><h3>The <code class="literal">"use-separator"</code> style property</h3>

794

<pre class="programlisting"> "use-separator" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read</pre>

794

<pre class="programlisting"> "use-separator" gboolean : Read</pre>

795

796

<h3 class="title">Warning</h3>

797

<code class="literal">GtkMessageDialog:use-separator</code> has been deprecated since version 2.22 and should not be used in newly-written code. This style property will be removed in GTK+ 3

811

</div>

812

813

<hr>

814

Generated by GTK-Doc V1.18</div>

814

Generated by GTK-Doc V1.18.1</div>

815

</body>

816

</html>

b'\\ No newline at end of file'

Older »