1 /* GTK - The GIMP Toolkit
3 Copyright (C) 2001 CodeFactory AB
4 Copyright (C) 2001 Anders Carlsson <andersca@codefactory.se>
5 Copyright (C) 2003, 2004 Matthias Clasen <mclasen@redhat.com>
7 This library is free software; you can redistribute it and/or
8 modify it under the terms of the GNU Library General Public License as
9 published by the Free Software Foundation; either version 2 of the
10 License, or (at your option) any later version.
12 This library is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 Library General Public License for more details.
17 You should have received a copy of the GNU Library General Public
18 License along with the Gnome Library; see the file COPYING.LIB. If not,
19 write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA.
22 Author: Anders Carlsson <andersca@codefactory.se>
25 #if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
26 #error "Only <gtk/gtk.h> can be included directly."
29 #ifndef __GTK_ABOUT_DIALOG_H__
30 #define __GTK_ABOUT_DIALOG_H__
32 #include <gtk/gtkdialog.h>
36 #define GTK_TYPE_ABOUT_DIALOG (gtk_about_dialog_get_type ())
37 #define GTK_ABOUT_DIALOG(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GTK_TYPE_ABOUT_DIALOG, GtkAboutDialog))
38 #define GTK_ABOUT_DIALOG_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_ABOUT_DIALOG, GtkAboutDialogClass))
39 #define GTK_IS_ABOUT_DIALOG(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GTK_TYPE_ABOUT_DIALOG))
40 #define GTK_IS_ABOUT_DIALOG_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_ABOUT_DIALOG))
41 #define GTK_ABOUT_DIALOG_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_ABOUT_DIALOG, GtkAboutDialogClass))
43 typedef struct _GtkAboutDialog GtkAboutDialog;
44 typedef struct _GtkAboutDialogClass GtkAboutDialogClass;
49 * The <structname>GtkAboutDialog</structname> struct contains
50 * only private fields and should not be directly accessed.
52 struct _GtkAboutDialog
54 GtkDialog parent_instance;
57 gpointer GSEAL (private_data);
60 struct _GtkAboutDialogClass
62 GtkDialogClass parent_class;
64 /* Padding for future expansion */
65 void (*_gtk_reserved1) (void);
66 void (*_gtk_reserved2) (void);
67 void (*_gtk_reserved3) (void);
68 void (*_gtk_reserved4) (void);
71 GType gtk_about_dialog_get_type (void) G_GNUC_CONST;
72 GtkWidget *gtk_about_dialog_new (void);
73 void gtk_show_about_dialog (GtkWindow *parent,
74 const gchar *first_property_name,
75 ...) G_GNUC_NULL_TERMINATED;
76 G_CONST_RETURN gchar *gtk_about_dialog_get_program_name (GtkAboutDialog *about);
77 void gtk_about_dialog_set_program_name (GtkAboutDialog *about,
79 G_CONST_RETURN gchar *gtk_about_dialog_get_version (GtkAboutDialog *about);
80 void gtk_about_dialog_set_version (GtkAboutDialog *about,
81 const gchar *version);
82 G_CONST_RETURN gchar *gtk_about_dialog_get_copyright (GtkAboutDialog *about);
83 void gtk_about_dialog_set_copyright (GtkAboutDialog *about,
84 const gchar *copyright);
85 G_CONST_RETURN gchar *gtk_about_dialog_get_comments (GtkAboutDialog *about);
86 void gtk_about_dialog_set_comments (GtkAboutDialog *about,
87 const gchar *comments);
88 G_CONST_RETURN gchar *gtk_about_dialog_get_license (GtkAboutDialog *about);
89 void gtk_about_dialog_set_license (GtkAboutDialog *about,
90 const gchar *license);
92 gboolean gtk_about_dialog_get_wrap_license (GtkAboutDialog *about);
93 void gtk_about_dialog_set_wrap_license (GtkAboutDialog *about,
94 gboolean wrap_license);
96 G_CONST_RETURN gchar *gtk_about_dialog_get_website (GtkAboutDialog *about);
97 void gtk_about_dialog_set_website (GtkAboutDialog *about,
98 const gchar *website);
99 G_CONST_RETURN gchar *gtk_about_dialog_get_website_label (GtkAboutDialog *about);
100 void gtk_about_dialog_set_website_label (GtkAboutDialog *about,
101 const gchar *website_label);
102 G_CONST_RETURN gchar* G_CONST_RETURN * gtk_about_dialog_get_authors (GtkAboutDialog *about);
103 void gtk_about_dialog_set_authors (GtkAboutDialog *about,
104 const gchar **authors);
105 G_CONST_RETURN gchar* G_CONST_RETURN * gtk_about_dialog_get_documenters (GtkAboutDialog *about);
106 void gtk_about_dialog_set_documenters (GtkAboutDialog *about,
107 const gchar **documenters);
108 G_CONST_RETURN gchar* G_CONST_RETURN * gtk_about_dialog_get_artists (GtkAboutDialog *about);
109 void gtk_about_dialog_set_artists (GtkAboutDialog *about,
110 const gchar **artists);
111 G_CONST_RETURN gchar *gtk_about_dialog_get_translator_credits (GtkAboutDialog *about);
112 void gtk_about_dialog_set_translator_credits (GtkAboutDialog *about,
113 const gchar *translator_credits);
114 GdkPixbuf *gtk_about_dialog_get_logo (GtkAboutDialog *about);
115 void gtk_about_dialog_set_logo (GtkAboutDialog *about,
117 G_CONST_RETURN gchar *gtk_about_dialog_get_logo_icon_name (GtkAboutDialog *about);
118 void gtk_about_dialog_set_logo_icon_name (GtkAboutDialog *about,
119 const gchar *icon_name);
122 * GtkAboutDialogActivateLinkFunc:
123 * @about: the #GtkAboutDialog in which the link was activated
124 * @link_: the URL or email address to which the activated link points
125 * @data: user data that was passed when the function was registered
126 * with gtk_about_dialog_set_email_hook() or
127 * gtk_about_dialog_set_url_hook()
129 * The type of a function which is called when a URL or email
132 typedef void (* GtkAboutDialogActivateLinkFunc) (GtkAboutDialog *about,
136 GtkAboutDialogActivateLinkFunc gtk_about_dialog_set_email_hook (GtkAboutDialogActivateLinkFunc func,
138 GDestroyNotify destroy);
139 GtkAboutDialogActivateLinkFunc gtk_about_dialog_set_url_hook (GtkAboutDialogActivateLinkFunc func,
141 GDestroyNotify destroy);
145 #endif /* __GTK_ABOUT_DIALOG_H__ */