* /en/Gtk/MessageDialog.xml: Fixed remark.

svn path=/trunk/gtk-sharp/; revision=16996
This commit is contained in:
Martin Willemoes Hansen 2003-08-01 19:45:19 +00:00
parent 9bfd52ed64
commit 3d8f2791c1
2 changed files with 30 additions and 27 deletions

View File

@ -1,3 +1,7 @@
2003-08-01 Martin Willemoes Hansen <mwh@sysrq.dk>
* /en/Gtk/MessageDialog.xml: Fixed remark.
2003-08-01 John Luke <jluke@cfl.rr.com>
* /en/*.xml: use C#-style names, ex Gdk instead of GDK

View File

@ -10,36 +10,35 @@
<summary>Convenient message window</summary>
<remarks>
<para>
<see cref="T:Gtk.MessageDialog" /> presents a <see cref="T:Gtk.Dialog" /> with an image representing the <see cref="T:Gtk.MessageType" /> (Error, Question, etc.) alongside some message text.
It's simply a convenience <see cref="T:Gtk.Widget" />; you could construct the equivalent of <see cref="T:Gtk.MessageDialog" /> from <see cref="T:Gtk.Dialog" /> without too much effort, but <see cref="T:Gtk.MessageDialog" /> saves typing.
</para>
<see cref="T:Gtk.MessageDialog" /> presents a <see cref="T:Gtk.Dialog" /> with an image representing the
<see cref="T:Gtk.MessageType" /> (Error, Question, etc.) alongside some message text.
It's simply a convenience <see cref="T:Gtk.Widget" />; you could construct the equivalent of
<see cref="T:Gtk.MessageDialog" /> from <see cref="T:Gtk.Dialog" /> without too much effort, but
<see cref="T:Gtk.MessageDialog" /> saves typing.
</para>
<para>
The easiest way to do a modal message dialog is to use <see cref="M:Gtk.Dialog.Run()" />,
though you can also pass in the <see cref="F:Gtk.DialogFlags.Modal" /> flag, <see cref="M:Gtk.Dialog.Run()" /> automatically makes the <see cref="T:Gtk.MessageDialog" /> from <see cref="T:Gtk.Dialog" /> modal and waits for the user to respond to it.
<see cref="M:Gtk.Dialog.Run()" /> returns when any <see cref="T:Gtk.Button" /> in the <see cref="T:Gtk.Dialog" /> is clicked.
</para>
<para>A modal dialog
<example>
The MessageDialog is displayed using <see cref="M:Gtk.Dialog.Run()" />, which
automatically makes the <see cref="T:Gtk.MessageDialog" /> from
<see cref="T:Gtk.Dialog" /> modal and waits for the user to respond to it.
<see cref="M:Gtk.Dialog.Run()" /> returns when any <see cref="T:Gtk.Button" />
in the <see cref="T:Gtk.Dialog" /> is clicked.
</para>
<para>
A message dialog
<example>
<code lang="C#">
MessageDialog md = new MessageDialog
(parent_window, Gtk.DialogFlags.DestroyWithParent,
Gtk.MessageType.Error, Gtk.ButtonsType.Close, "Error loading file");
MessageDialog md = new MessageDialog (parent_window,
DialogFlags.DestroyWithParent,
MessageType.Error,
ButtonsType.Close, "Error loading file");
md.Run ();
md.Destroy ();
</code>
</example></para>
<para>A non-modal dialog
<example>
<code lang="C#">
MessageDialog md = new MessageDialog
(parent_window, Gtk.DialogFlags.DestroyWithParent,
Gtk.MessageType.Error, Gtk.ButtonsType.Close, "Error loading file");
// Destroy the dialog when the user responds to it (e.g. clicks a button)
// ::add signal handler code here::
</code>
</example></para>
int result = md.Run ();
</code>
</example>
</para>
<para>
If you would like a non modal dialog just set the Modal property of the dialog, ie my_dialog.Modal = false;
</para>
</remarks>
</Docs>
<Base>