X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkaboutdialog.h;h=fd96ae2287dd566cd5af749128ea94b9d6c1b61c;hb=HEAD;hp=5ed38fbb03a1b999eea4a78bb8da50457862ac1e;hpb=fce9c8b7d45145c4556650843218e0b76c065c18;p=~andy%2Fgtk diff --git a/gtk/gtkaboutdialog.h b/gtk/gtkaboutdialog.h index 5ed38fbb0..fd96ae228 100644 --- a/gtk/gtkaboutdialog.h +++ b/gtk/gtkaboutdialog.h @@ -1,4 +1,4 @@ -/* GTK - The GTK+ Toolkit +/* GTK - The GIMP Toolkit Copyright (C) 2001 CodeFactory AB Copyright (C) 2001 Anders Carlsson @@ -15,20 +15,18 @@ Library General Public License for more details. You should have received a copy of the GNU Library General Public - License along with the Gnome Library; see the file COPYING.LIB. If not, - write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, - Boston, MA 02111-1307, USA. + License along with this library. If not, see . Author: Anders Carlsson */ -#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) -#error "Only can be included directly." -#endif - #ifndef __GTK_ABOUT_DIALOG_H__ #define __GTK_ABOUT_DIALOG_H__ +#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) +#error "Only can be included directly." +#endif + #include G_BEGIN_DECLS @@ -42,19 +40,64 @@ G_BEGIN_DECLS typedef struct _GtkAboutDialog GtkAboutDialog; typedef struct _GtkAboutDialogClass GtkAboutDialogClass; - -struct _GtkAboutDialog +typedef struct _GtkAboutDialogPrivate GtkAboutDialogPrivate; + +/** + * GtkLicense: + * @GTK_LICENSE_UNKNOWN: No license specified + * @GTK_LICENSE_CUSTOM: A license text is going to be specified by the + * developer + * @GTK_LICENSE_GPL_2_0: The GNU General Public License, version 2.0 + * @GTK_LICENSE_GPL_3_0: The GNU General Public License, version 3.0 + * @GTK_LICENSE_LGPL_2_1: The GNU Lesser General Public License, version 2.1 + * @GTK_LICENSE_LGPL_3_0: The GNU Lesser General Public License, version 3.0 + * @GTK_LICENSE_BSD: The BSD standard license + * @GTK_LICENSE_MIT_X11: The MIT/X11 standard license + * @GTK_LICENSE_ARTISTIC: The Artistic License, version 2.0 + * + * The type of license for an application. + * + * This enumeration can be expanded at later date. + * + * Since: 3.0 + */ +typedef enum { + GTK_LICENSE_UNKNOWN, + GTK_LICENSE_CUSTOM, + + GTK_LICENSE_GPL_2_0, + GTK_LICENSE_GPL_3_0, + + GTK_LICENSE_LGPL_2_1, + GTK_LICENSE_LGPL_3_0, + + GTK_LICENSE_BSD, + GTK_LICENSE_MIT_X11, + + GTK_LICENSE_ARTISTIC +} GtkLicense; + +/** + * GtkAboutDialog: + * + * The GtkAboutDialog struct contains + * only private fields and should not be directly accessed. + */ +struct _GtkAboutDialog { GtkDialog parent_instance; /*< private >*/ - gpointer GSEAL (private_data); + GtkAboutDialogPrivate *priv; }; -struct _GtkAboutDialogClass +struct _GtkAboutDialogClass { GtkDialogClass parent_class; + gboolean (*activate_link) (GtkAboutDialog *dialog, + const gchar *uri); + /* Padding for future expansion */ void (*_gtk_reserved1) (void); void (*_gtk_reserved2) (void); @@ -65,69 +108,59 @@ struct _GtkAboutDialogClass GType gtk_about_dialog_get_type (void) G_GNUC_CONST; GtkWidget *gtk_about_dialog_new (void); void gtk_show_about_dialog (GtkWindow *parent, - const gchar *first_property_name, - ...) G_GNUC_NULL_TERMINATED; - -#ifndef GTK_DISABLE_DEPRECATED -G_CONST_RETURN gchar *gtk_about_dialog_get_name (GtkAboutDialog *about); -void gtk_about_dialog_set_name (GtkAboutDialog *about, - const gchar *name); -#endif /* GTK_DISABLE_DEPRECATED */ -G_CONST_RETURN gchar *gtk_about_dialog_get_program_name (GtkAboutDialog *about); + const gchar *first_property_name, + ...) G_GNUC_NULL_TERMINATED; +const gchar * gtk_about_dialog_get_program_name (GtkAboutDialog *about); void gtk_about_dialog_set_program_name (GtkAboutDialog *about, - const gchar *name); -G_CONST_RETURN gchar *gtk_about_dialog_get_version (GtkAboutDialog *about); + const gchar *name); +const gchar * gtk_about_dialog_get_version (GtkAboutDialog *about); void gtk_about_dialog_set_version (GtkAboutDialog *about, - const gchar *version); -G_CONST_RETURN gchar *gtk_about_dialog_get_copyright (GtkAboutDialog *about); + const gchar *version); +const gchar * gtk_about_dialog_get_copyright (GtkAboutDialog *about); void gtk_about_dialog_set_copyright (GtkAboutDialog *about, - const gchar *copyright); -G_CONST_RETURN gchar *gtk_about_dialog_get_comments (GtkAboutDialog *about); + const gchar *copyright); +const gchar * gtk_about_dialog_get_comments (GtkAboutDialog *about); void gtk_about_dialog_set_comments (GtkAboutDialog *about, - const gchar *comments); -G_CONST_RETURN gchar *gtk_about_dialog_get_license (GtkAboutDialog *about); + const gchar *comments); +const gchar * gtk_about_dialog_get_license (GtkAboutDialog *about); void gtk_about_dialog_set_license (GtkAboutDialog *about, - const gchar *license); + const gchar *license); +void gtk_about_dialog_set_license_type (GtkAboutDialog *about, + GtkLicense license_type); +GtkLicense gtk_about_dialog_get_license_type (GtkAboutDialog *about); gboolean gtk_about_dialog_get_wrap_license (GtkAboutDialog *about); void gtk_about_dialog_set_wrap_license (GtkAboutDialog *about, gboolean wrap_license); -G_CONST_RETURN gchar *gtk_about_dialog_get_website (GtkAboutDialog *about); +const gchar * gtk_about_dialog_get_website (GtkAboutDialog *about); void gtk_about_dialog_set_website (GtkAboutDialog *about, - const gchar *website); -G_CONST_RETURN gchar *gtk_about_dialog_get_website_label (GtkAboutDialog *about); + const gchar *website); +const gchar * gtk_about_dialog_get_website_label (GtkAboutDialog *about); void gtk_about_dialog_set_website_label (GtkAboutDialog *about, - const gchar *website_label); -G_CONST_RETURN gchar* G_CONST_RETURN * gtk_about_dialog_get_authors (GtkAboutDialog *about); + const gchar *website_label); +const gchar* const * gtk_about_dialog_get_authors (GtkAboutDialog *about); void gtk_about_dialog_set_authors (GtkAboutDialog *about, - const gchar **authors); -G_CONST_RETURN gchar* G_CONST_RETURN * gtk_about_dialog_get_documenters (GtkAboutDialog *about); + const gchar **authors); +const gchar* const * gtk_about_dialog_get_documenters (GtkAboutDialog *about); void gtk_about_dialog_set_documenters (GtkAboutDialog *about, - const gchar **documenters); -G_CONST_RETURN gchar* G_CONST_RETURN * gtk_about_dialog_get_artists (GtkAboutDialog *about); + const gchar **documenters); +const gchar* const * gtk_about_dialog_get_artists (GtkAboutDialog *about); void gtk_about_dialog_set_artists (GtkAboutDialog *about, - const gchar **artists); -G_CONST_RETURN gchar *gtk_about_dialog_get_translator_credits (GtkAboutDialog *about); + const gchar **artists); +const gchar * gtk_about_dialog_get_translator_credits (GtkAboutDialog *about); void gtk_about_dialog_set_translator_credits (GtkAboutDialog *about, - const gchar *translator_credits); + const gchar *translator_credits); GdkPixbuf *gtk_about_dialog_get_logo (GtkAboutDialog *about); void gtk_about_dialog_set_logo (GtkAboutDialog *about, - GdkPixbuf *logo); -G_CONST_RETURN gchar *gtk_about_dialog_get_logo_icon_name (GtkAboutDialog *about); + GdkPixbuf *logo); +const gchar * gtk_about_dialog_get_logo_icon_name (GtkAboutDialog *about); void gtk_about_dialog_set_logo_icon_name (GtkAboutDialog *about, - const gchar *icon_name); - -typedef void (* GtkAboutDialogActivateLinkFunc) (GtkAboutDialog *about, - const gchar *link_, - gpointer data); - -GtkAboutDialogActivateLinkFunc gtk_about_dialog_set_email_hook (GtkAboutDialogActivateLinkFunc func, - gpointer data, - GDestroyNotify destroy); -GtkAboutDialogActivateLinkFunc gtk_about_dialog_set_url_hook (GtkAboutDialogActivateLinkFunc func, - gpointer data, - GDestroyNotify destroy); + const gchar *icon_name); +GDK_AVAILABLE_IN_3_4 +void gtk_about_dialog_add_credit_section (GtkAboutDialog *about, + const gchar *section_name, + const gchar **people); G_END_DECLS