/* GTK - The GIMP Toolkit Copyright (C) 2001 CodeFactory AB Copyright (C) 2001 Anders Carlsson Copyright (C) 2003, 2004 Matthias Clasen This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details. You should have received a copy of the GNU Library General Public License along with this library. If not, see . Author: Anders Carlsson */ #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 #define GTK_TYPE_ABOUT_DIALOG (gtk_about_dialog_get_type ()) #define GTK_ABOUT_DIALOG(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GTK_TYPE_ABOUT_DIALOG, GtkAboutDialog)) #define GTK_ABOUT_DIALOG_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_ABOUT_DIALOG, GtkAboutDialogClass)) #define GTK_IS_ABOUT_DIALOG(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GTK_TYPE_ABOUT_DIALOG)) #define GTK_IS_ABOUT_DIALOG_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_ABOUT_DIALOG)) #define GTK_ABOUT_DIALOG_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_ABOUT_DIALOG, GtkAboutDialogClass)) typedef struct _GtkAboutDialog GtkAboutDialog; typedef struct _GtkAboutDialogClass GtkAboutDialogClass; 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 or later * @GTK_LICENSE_GPL_3_0: The GNU General Public License, version 3.0 or later * @GTK_LICENSE_LGPL_2_1: The GNU Lesser General Public License, version 2.1 or later * @GTK_LICENSE_LGPL_3_0: The GNU Lesser General Public License, version 3.0 or later * @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 * @GTK_LICENSE_GPL_2_0_ONLY: The GNU General Public License, version 2.0 only. Since 3.12. * @GTK_LICENSE_GPL_3_0_ONLY: The GNU General Public License, version 3.0 only. Since 3.12. * @GTK_LICENSE_LGPL_2_1_ONLY: The GNU Lesser General Public License, version 2.1 only. Since 3.12. * @GTK_LICENSE_LGPL_3_0_ONLY: The GNU Lesser General Public License, version 3.0 only. Since 3.12. * @GTK_LICENSE_AGPL_3_0: The GNU Affero General Public License, version 3.0 or later. Since: 3.22. * * 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, GTK_LICENSE_GPL_2_0_ONLY, GTK_LICENSE_GPL_3_0_ONLY, GTK_LICENSE_LGPL_2_1_ONLY, GTK_LICENSE_LGPL_3_0_ONLY, GTK_LICENSE_AGPL_3_0 } GtkLicense; /** * GtkAboutDialog: * * The #GtkAboutDialog-struct contains * only private fields and should not be directly accessed. */ struct _GtkAboutDialog { GtkDialog parent_instance; /*< private >*/ GtkAboutDialogPrivate *priv; }; 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); void (*_gtk_reserved3) (void); void (*_gtk_reserved4) (void); }; GDK_AVAILABLE_IN_ALL GType gtk_about_dialog_get_type (void) G_GNUC_CONST; GDK_AVAILABLE_IN_ALL GtkWidget *gtk_about_dialog_new (void); GDK_AVAILABLE_IN_ALL void gtk_show_about_dialog (GtkWindow *parent, const gchar *first_property_name, ...) G_GNUC_NULL_TERMINATED; GDK_AVAILABLE_IN_ALL const gchar * gtk_about_dialog_get_program_name (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_program_name (GtkAboutDialog *about, const gchar *name); GDK_AVAILABLE_IN_ALL const gchar * gtk_about_dialog_get_version (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_version (GtkAboutDialog *about, const gchar *version); GDK_AVAILABLE_IN_ALL const gchar * gtk_about_dialog_get_copyright (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_copyright (GtkAboutDialog *about, const gchar *copyright); GDK_AVAILABLE_IN_ALL const gchar * gtk_about_dialog_get_comments (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_comments (GtkAboutDialog *about, const gchar *comments); GDK_AVAILABLE_IN_ALL const gchar * gtk_about_dialog_get_license (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_license (GtkAboutDialog *about, const gchar *license); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_license_type (GtkAboutDialog *about, GtkLicense license_type); GDK_AVAILABLE_IN_ALL GtkLicense gtk_about_dialog_get_license_type (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL gboolean gtk_about_dialog_get_wrap_license (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_wrap_license (GtkAboutDialog *about, gboolean wrap_license); GDK_AVAILABLE_IN_ALL const gchar * gtk_about_dialog_get_system_information (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_system_information (GtkAboutDialog *about, const gchar *system_information); GDK_AVAILABLE_IN_ALL const gchar * gtk_about_dialog_get_website (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_website (GtkAboutDialog *about, const gchar *website); GDK_AVAILABLE_IN_ALL const gchar * gtk_about_dialog_get_website_label (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_website_label (GtkAboutDialog *about, const gchar *website_label); GDK_AVAILABLE_IN_ALL const gchar* const * gtk_about_dialog_get_authors (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_authors (GtkAboutDialog *about, const gchar **authors); GDK_AVAILABLE_IN_ALL const gchar* const * gtk_about_dialog_get_documenters (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_documenters (GtkAboutDialog *about, const gchar **documenters); GDK_AVAILABLE_IN_ALL const gchar* const * gtk_about_dialog_get_artists (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_artists (GtkAboutDialog *about, const gchar **artists); GDK_AVAILABLE_IN_ALL const gchar * gtk_about_dialog_get_translator_credits (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_translator_credits (GtkAboutDialog *about, const gchar *translator_credits); GDK_AVAILABLE_IN_ALL cairo_surface_t *gtk_about_dialog_get_logo (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_logo (GtkAboutDialog *about, cairo_surface_t *logo); GDK_AVAILABLE_IN_ALL const gchar * gtk_about_dialog_get_logo_icon_name (GtkAboutDialog *about); GDK_AVAILABLE_IN_ALL void gtk_about_dialog_set_logo_icon_name (GtkAboutDialog *about, 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_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkAboutDialog, g_object_unref) G_END_DECLS #endif /* __GTK_ABOUT_DIALOG_H__ */