1/* GTK - The GIMP Toolkit
2
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>
6
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.
11
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.
16
17 You should have received a copy of the GNU Library General Public
18 License along with this library. If not, see <http://www.gnu.org/licenses/>.
19
20 Author: Anders Carlsson <andersca@codefactory.se>
21*/
22
23#ifndef __GTK_ABOUT_DIALOG_H__
24#define __GTK_ABOUT_DIALOG_H__
25
26#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
27#error "Only <gtk/gtk.h> can be included directly."
28#endif
29
30#include <gtk/gtkwindow.h>
31
32G_BEGIN_DECLS
33
34#define GTK_TYPE_ABOUT_DIALOG (gtk_about_dialog_get_type ())
35#define GTK_ABOUT_DIALOG(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GTK_TYPE_ABOUT_DIALOG, GtkAboutDialog))
36#define GTK_IS_ABOUT_DIALOG(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GTK_TYPE_ABOUT_DIALOG))
37
38typedef struct _GtkAboutDialog GtkAboutDialog;
39
40/**
41 * GtkLicense:
42 * @GTK_LICENSE_UNKNOWN: No license specified
43 * @GTK_LICENSE_CUSTOM: A license text is going to be specified by the
44 * developer
45 * @GTK_LICENSE_GPL_2_0: The GNU General Public License, version 2.0 or later
46 * @GTK_LICENSE_GPL_3_0: The GNU General Public License, version 3.0 or later
47 * @GTK_LICENSE_LGPL_2_1: The GNU Lesser General Public License, version 2.1 or later
48 * @GTK_LICENSE_LGPL_3_0: The GNU Lesser General Public License, version 3.0 or later
49 * @GTK_LICENSE_BSD: The BSD standard license
50 * @GTK_LICENSE_MIT_X11: The MIT/X11 standard license
51 * @GTK_LICENSE_ARTISTIC: The Artistic License, version 2.0
52 * @GTK_LICENSE_GPL_2_0_ONLY: The GNU General Public License, version 2.0 only
53 * @GTK_LICENSE_GPL_3_0_ONLY: The GNU General Public License, version 3.0 only
54 * @GTK_LICENSE_LGPL_2_1_ONLY: The GNU Lesser General Public License, version 2.1 only
55 * @GTK_LICENSE_LGPL_3_0_ONLY: The GNU Lesser General Public License, version 3.0 only
56 * @GTK_LICENSE_AGPL_3_0: The GNU Affero General Public License, version 3.0 or later
57 * @GTK_LICENSE_AGPL_3_0_ONLY: The GNU Affero General Public License, version 3.0 only
58 * @GTK_LICENSE_BSD_3: The 3-clause BSD licence
59 * @GTK_LICENSE_APACHE_2_0: The Apache License, version 2.0
60 * @GTK_LICENSE_MPL_2_0: The Mozilla Public License, version 2.0
61 *
62 * The type of license for an application.
63 *
64 * This enumeration can be expanded at later date.
65 */
66typedef enum {
67 GTK_LICENSE_UNKNOWN,
68 GTK_LICENSE_CUSTOM,
69
70 GTK_LICENSE_GPL_2_0,
71 GTK_LICENSE_GPL_3_0,
72
73 GTK_LICENSE_LGPL_2_1,
74 GTK_LICENSE_LGPL_3_0,
75
76 GTK_LICENSE_BSD,
77 GTK_LICENSE_MIT_X11,
78
79 GTK_LICENSE_ARTISTIC,
80
81 GTK_LICENSE_GPL_2_0_ONLY,
82 GTK_LICENSE_GPL_3_0_ONLY,
83 GTK_LICENSE_LGPL_2_1_ONLY,
84 GTK_LICENSE_LGPL_3_0_ONLY,
85
86 GTK_LICENSE_AGPL_3_0,
87 GTK_LICENSE_AGPL_3_0_ONLY,
88
89 GTK_LICENSE_BSD_3,
90 GTK_LICENSE_APACHE_2_0,
91 GTK_LICENSE_MPL_2_0
92} GtkLicense;
93
94
95GDK_AVAILABLE_IN_ALL
96GType gtk_about_dialog_get_type (void) G_GNUC_CONST;
97GDK_AVAILABLE_IN_ALL
98GtkWidget *gtk_about_dialog_new (void);
99GDK_AVAILABLE_IN_ALL
100void gtk_show_about_dialog (GtkWindow *parent,
101 const char *first_property_name,
102 ...) G_GNUC_NULL_TERMINATED;
103GDK_AVAILABLE_IN_ALL
104const char * gtk_about_dialog_get_program_name (GtkAboutDialog *about);
105GDK_AVAILABLE_IN_ALL
106void gtk_about_dialog_set_program_name (GtkAboutDialog *about,
107 const char *name);
108GDK_AVAILABLE_IN_ALL
109const char * gtk_about_dialog_get_version (GtkAboutDialog *about);
110GDK_AVAILABLE_IN_ALL
111void gtk_about_dialog_set_version (GtkAboutDialog *about,
112 const char *version);
113GDK_AVAILABLE_IN_ALL
114const char * gtk_about_dialog_get_copyright (GtkAboutDialog *about);
115GDK_AVAILABLE_IN_ALL
116void gtk_about_dialog_set_copyright (GtkAboutDialog *about,
117 const char *copyright);
118GDK_AVAILABLE_IN_ALL
119const char * gtk_about_dialog_get_comments (GtkAboutDialog *about);
120GDK_AVAILABLE_IN_ALL
121void gtk_about_dialog_set_comments (GtkAboutDialog *about,
122 const char *comments);
123GDK_AVAILABLE_IN_ALL
124const char * gtk_about_dialog_get_license (GtkAboutDialog *about);
125GDK_AVAILABLE_IN_ALL
126void gtk_about_dialog_set_license (GtkAboutDialog *about,
127 const char *license);
128GDK_AVAILABLE_IN_ALL
129void gtk_about_dialog_set_license_type (GtkAboutDialog *about,
130 GtkLicense license_type);
131GDK_AVAILABLE_IN_ALL
132GtkLicense gtk_about_dialog_get_license_type (GtkAboutDialog *about);
133
134GDK_AVAILABLE_IN_ALL
135gboolean gtk_about_dialog_get_wrap_license (GtkAboutDialog *about);
136GDK_AVAILABLE_IN_ALL
137void gtk_about_dialog_set_wrap_license (GtkAboutDialog *about,
138 gboolean wrap_license);
139
140GDK_AVAILABLE_IN_ALL
141const char * gtk_about_dialog_get_system_information (GtkAboutDialog *about);
142GDK_AVAILABLE_IN_ALL
143void gtk_about_dialog_set_system_information (GtkAboutDialog *about,
144 const char *system_information);
145GDK_AVAILABLE_IN_ALL
146const char * gtk_about_dialog_get_website (GtkAboutDialog *about);
147GDK_AVAILABLE_IN_ALL
148void gtk_about_dialog_set_website (GtkAboutDialog *about,
149 const char *website);
150GDK_AVAILABLE_IN_ALL
151const char * gtk_about_dialog_get_website_label (GtkAboutDialog *about);
152GDK_AVAILABLE_IN_ALL
153void gtk_about_dialog_set_website_label (GtkAboutDialog *about,
154 const char *website_label);
155GDK_AVAILABLE_IN_ALL
156const char * const * gtk_about_dialog_get_authors (GtkAboutDialog *about);
157GDK_AVAILABLE_IN_ALL
158void gtk_about_dialog_set_authors (GtkAboutDialog *about,
159 const char **authors);
160GDK_AVAILABLE_IN_ALL
161const char * const * gtk_about_dialog_get_documenters (GtkAboutDialog *about);
162GDK_AVAILABLE_IN_ALL
163void gtk_about_dialog_set_documenters (GtkAboutDialog *about,
164 const char **documenters);
165GDK_AVAILABLE_IN_ALL
166const char * const * gtk_about_dialog_get_artists (GtkAboutDialog *about);
167GDK_AVAILABLE_IN_ALL
168void gtk_about_dialog_set_artists (GtkAboutDialog *about,
169 const char **artists);
170GDK_AVAILABLE_IN_ALL
171const char * gtk_about_dialog_get_translator_credits (GtkAboutDialog *about);
172GDK_AVAILABLE_IN_ALL
173void gtk_about_dialog_set_translator_credits (GtkAboutDialog *about,
174 const char *translator_credits);
175GDK_AVAILABLE_IN_ALL
176GdkPaintable * (GtkAboutDialog *about);
177GDK_AVAILABLE_IN_ALL
178void (GtkAboutDialog *about,
179 GdkPaintable *);
180GDK_AVAILABLE_IN_ALL
181const char * gtk_about_dialog_get_logo_icon_name (GtkAboutDialog *about);
182GDK_AVAILABLE_IN_ALL
183void gtk_about_dialog_set_logo_icon_name (GtkAboutDialog *about,
184 const char *icon_name);
185GDK_AVAILABLE_IN_ALL
186void gtk_about_dialog_add_credit_section (GtkAboutDialog *about,
187 const char *section_name,
188 const char **people);
189
190G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkAboutDialog, g_object_unref)
191
192G_END_DECLS
193
194#endif /* __GTK_ABOUT_DIALOG_H__ */
195
196
197

source code of gtk/gtk/gtkaboutdialog.h