Re: About dialog api

[Matthias Clasen <maclas gmx de>]

On Sat, 2003-04-26 at 01:23, iain wrote:
> On Thu, 2003-04-24 at 01:53, Matthias Clasen wrote:
> > The interest in this seems to have worn off, so let me summarize my
> > current understanding of the outcome:
> > 
> > Functions:
> > 
> > GtkWidget *gtk_about_dialog_new      (void);
> > 
> > void       gtk_about_dialog_show     (GtkWindow    *parent,
> > 				      const gchar *first_property_name,
> > 				      ...);
> > If there isn't already an about dialog attached to parent, this function
> > will create a new one from the provided properties. Otherwise it will
> > just show the one attached to parent.
> 
> How can I have one about dialog attached to multiple windows?
> My use case (which I would assume would be very common) is an
> application that has many toplevel windows, all the same, each with a
> different file open in them. Each window has a Help->About menu, but
> when I click it, I only want one about box to show up.

You would probably want the about box to be transient to the toplevel
from which it was popped up, but I agree that they would most likely all
have the same contents.

> 
> It might be because I'm very tired, but I don't see need to have 2
> functions...

_show() is just a convenience wrapper around _new(), g_object_set() and
gtk_window_present(). _new() is just what remains of the regular widget
api, if all getters and setters are omitted.

Matthias