forked from AuroraMiddleware/gtk
11aed263b7
Tue May 14 16:44:09 2002 Owen Taylor <otaylor@redhat.com> * gtk/gtklabel.c (gtk_label_ensure_layout): Set the width of the layout to the actual wrap width (our requisition) not the width we set when calculating the width. This results in the lines being justified within the correct area. (#79157, Anders Carlsson) * gtk/gtkaccelgroup.c gtk/gtkmarshelers.list: Corrected registered parameter types of "accel_activate" and "accel_changed" signals. (Patch from Murray Cumming, #78798) * gtk/gtkrc.c (gtk_rc_make_default_dir): Switch binary-version and type to correspond to the current ordering in _gtk_get_module_path. (#78746, Sergey Kuzminov) * gtk/gtkrc.c (gtk_rc_get_module_dir): Add docs pointing to the GTK_PATH documentation. * gtk/Makefile.am (uninstall-local): Delete key themes as well. (#81286, Kristian Rietveld.)
120 lines
3.2 KiB
Plaintext
120 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) */
|
|
g_signal_connect_swapped (GTK_OBJECT (dialog), "response",
|
|
G_CALLBACK (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>
|
|
|
|
<!-- ##### ARG GtkMessageDialog:message-border ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|