forked from AuroraMiddleware/gtk
fc4a6b955d
* gtk/gtkdialog.c, gtk/gtkrc.c, gtk/gtkwidget.c: Markup fixes.
* gdk-pixbuf-io.c: Markup fixes.
* gdk-pixbuf/tmpl/scaling.sgml, gdk/tmpl/fonts.sgml,
gdk/tmpl/general.sgml, gdk/tmpl/rgb.sgml, gdk/tmpl/visuals.sgml,
gdk/tmpl/windows.sgml, gtk/gtk-docs.sgml, gtk/tmpl/gtkaccellabel.sgml,
gtk/tmpl/gtkcombo.sgml, gtk/tmpl/gtkdialog.sgml,
gtk/tmpl/gtkdrawingarea.sgml, gtk/tmpl/gtkeditable.sgml,
gtk/tmpl/gtkfilesel.sgml, gtk/tmpl/gtkfontseldlg.sgml,
gtk/tmpl/gtkimage.sgml, gtk/tmpl/gtkmain.sgml, gtk/tmpl/gtkmenu.sgml,
gtk/tmpl/gtkmessagedialog.sgml, gtk/tmpl/gtkobject.sgml,
gtk/tmpl/gtkpaned.sgml, gtk/tmpl/gtkradiobutton.sgml,
gtk/tmpl/gtkrc.sgml, gtk/tmpl/gtkscale.sgml, gtk/tmpl/gtksignal.sgml,
gtk/tmpl/gtksocket.sgml, gtk/tmpl/gtkspinbutton.sgml,
gtk/tmpl/gtktogglebutton.sgml, gtk/tmpl/gtksignal.sgml,
gtk/tmpl/gtktooltips.sgml, gtk/tmpl/gtkwindow.sgml,
gdk/tmpl/regions.sgml, gtk/tmpl/gtkfontsel.sgml,
gtk/tmpl/gtkpixmap.sgml, gtk/tmpl/gtkprogress.sgml,
gtk/tmpl/gtkselection.sgml, gtk/tmpl/gtktable.sgml,
gtk/tmpl/gtktipsquery.sgml: Markup fixes (mainly examples).
115 lines
3.2 KiB
Plaintext
115 lines
3.2 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkMessageDialog
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
|
|
convenient message window
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
#GtkMessageDialog presents a dialog with an image representing the type of
|
|
message (Error, Question, etc.) alongside some message text. It's simply a
|
|
convenience widget; you could construct the equivalent of #GtkMessageDialog
|
|
from #GtkDialog without too much effort, but #GtkMessageDialog saves typing.
|
|
</para>
|
|
|
|
<para>
|
|
The easiest way to do a modal message dialog is to use gtk_dialog_run(), though
|
|
you can also pass in the %GTK_DIALOG_MODAL flag, gtk_dialog_run() automatically
|
|
makes the dialog modal and waits for the user to respond to it. gtk_dialog_run()
|
|
returns when any dialog button is clicked.
|
|
<example>
|
|
<title>A modal dialog.</title>
|
|
<programlisting>
|
|
dialog = gtk_message_dialog_new (main_application_window,
|
|
GTK_DIALOG_DESTROY_WITH_PARENT,
|
|
GTK_MESSAGE_ERROR,
|
|
GTK_BUTTONS_CLOSE,
|
|
"Error loading file '%s': %s",
|
|
filename, g_strerror (errno));
|
|
gtk_dialog_run (GTK_DIALOG (dialog));
|
|
gtk_widget_destroy (dialog);
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
|
|
<para>
|
|
You might do a non-modal #GtkMessageDialog as follows:
|
|
<example>
|
|
<title>A non-modal dialog.</title>
|
|
<programlisting>
|
|
dialog = gtk_message_dialog_new (main_application_window,
|
|
GTK_DIALOG_DESTROY_WITH_PARENT,
|
|
GTK_MESSAGE_ERROR,
|
|
GTK_BUTTONS_CLOSE,
|
|
"Error loading file '%s': %s",
|
|
filename, g_strerror (errno));
|
|
|
|
/* Destroy the dialog when the user responds to it (e.g. clicks a button) */
|
|
gtk_signal_connect_object (GTK_OBJECT (dialog), "response",
|
|
GTK_SIGNAL_FUNC (gtk_widget_destroy),
|
|
GTK_OBJECT (dialog));
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
#GtkDialog
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkMessageDialog ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
|
<!-- ##### ENUM GtkMessageType ##### -->
|
|
<para>
|
|
The type of message being displayed in the dialog.
|
|
</para>
|
|
|
|
@GTK_MESSAGE_INFO: Informational message
|
|
@GTK_MESSAGE_WARNING: Nonfatal warning message
|
|
@GTK_MESSAGE_QUESTION: Question requiring a choice
|
|
@GTK_MESSAGE_ERROR: Fatal error message
|
|
|
|
<!-- ##### ENUM GtkButtonsType ##### -->
|
|
<para>
|
|
Prebuilt sets of buttons for the dialog. If
|
|
none of these choices are appropriate, simply use %GTK_BUTTONS_NONE
|
|
then call gtk_dialog_add_buttons().
|
|
</para>
|
|
|
|
@GTK_BUTTONS_NONE: no buttons at all
|
|
@GTK_BUTTONS_OK: an OK button
|
|
@GTK_BUTTONS_CLOSE: a Close button
|
|
@GTK_BUTTONS_CANCEL: a Cancel button
|
|
@GTK_BUTTONS_YES_NO: Yes and No buttons
|
|
@GTK_BUTTONS_OK_CANCEL: OK and Cancel buttons
|
|
|
|
<!-- ##### FUNCTION gtk_message_dialog_new ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent:
|
|
@flags:
|
|
@type:
|
|
@buttons:
|
|
@message_format:
|
|
@Varargs:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### ARG GtkMessageDialog:message-type ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkMessageDialog:buttons ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|