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 | |
32 | G_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 | |
38 | typedef 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 | */ |
66 | typedef 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 | |
95 | GDK_AVAILABLE_IN_ALL |
96 | GType gtk_about_dialog_get_type (void) G_GNUC_CONST; |
97 | GDK_AVAILABLE_IN_ALL |
98 | GtkWidget *gtk_about_dialog_new (void); |
99 | GDK_AVAILABLE_IN_ALL |
100 | void gtk_show_about_dialog (GtkWindow *parent, |
101 | const char *first_property_name, |
102 | ...) G_GNUC_NULL_TERMINATED; |
103 | GDK_AVAILABLE_IN_ALL |
104 | const char * gtk_about_dialog_get_program_name (GtkAboutDialog *about); |
105 | GDK_AVAILABLE_IN_ALL |
106 | void gtk_about_dialog_set_program_name (GtkAboutDialog *about, |
107 | const char *name); |
108 | GDK_AVAILABLE_IN_ALL |
109 | const char * gtk_about_dialog_get_version (GtkAboutDialog *about); |
110 | GDK_AVAILABLE_IN_ALL |
111 | void gtk_about_dialog_set_version (GtkAboutDialog *about, |
112 | const char *version); |
113 | GDK_AVAILABLE_IN_ALL |
114 | const char * gtk_about_dialog_get_copyright (GtkAboutDialog *about); |
115 | GDK_AVAILABLE_IN_ALL |
116 | void gtk_about_dialog_set_copyright (GtkAboutDialog *about, |
117 | const char *copyright); |
118 | GDK_AVAILABLE_IN_ALL |
119 | const char * (GtkAboutDialog *about); |
120 | GDK_AVAILABLE_IN_ALL |
121 | void (GtkAboutDialog *about, |
122 | const char *); |
123 | GDK_AVAILABLE_IN_ALL |
124 | const char * gtk_about_dialog_get_license (GtkAboutDialog *about); |
125 | GDK_AVAILABLE_IN_ALL |
126 | void gtk_about_dialog_set_license (GtkAboutDialog *about, |
127 | const char *license); |
128 | GDK_AVAILABLE_IN_ALL |
129 | void gtk_about_dialog_set_license_type (GtkAboutDialog *about, |
130 | GtkLicense license_type); |
131 | GDK_AVAILABLE_IN_ALL |
132 | GtkLicense gtk_about_dialog_get_license_type (GtkAboutDialog *about); |
133 | |
134 | GDK_AVAILABLE_IN_ALL |
135 | gboolean gtk_about_dialog_get_wrap_license (GtkAboutDialog *about); |
136 | GDK_AVAILABLE_IN_ALL |
137 | void gtk_about_dialog_set_wrap_license (GtkAboutDialog *about, |
138 | gboolean wrap_license); |
139 | |
140 | GDK_AVAILABLE_IN_ALL |
141 | const char * gtk_about_dialog_get_system_information (GtkAboutDialog *about); |
142 | GDK_AVAILABLE_IN_ALL |
143 | void gtk_about_dialog_set_system_information (GtkAboutDialog *about, |
144 | const char *system_information); |
145 | GDK_AVAILABLE_IN_ALL |
146 | const char * gtk_about_dialog_get_website (GtkAboutDialog *about); |
147 | GDK_AVAILABLE_IN_ALL |
148 | void gtk_about_dialog_set_website (GtkAboutDialog *about, |
149 | const char *website); |
150 | GDK_AVAILABLE_IN_ALL |
151 | const char * gtk_about_dialog_get_website_label (GtkAboutDialog *about); |
152 | GDK_AVAILABLE_IN_ALL |
153 | void gtk_about_dialog_set_website_label (GtkAboutDialog *about, |
154 | const char *website_label); |
155 | GDK_AVAILABLE_IN_ALL |
156 | const char * const * gtk_about_dialog_get_authors (GtkAboutDialog *about); |
157 | GDK_AVAILABLE_IN_ALL |
158 | void gtk_about_dialog_set_authors (GtkAboutDialog *about, |
159 | const char **authors); |
160 | GDK_AVAILABLE_IN_ALL |
161 | const char * const * gtk_about_dialog_get_documenters (GtkAboutDialog *about); |
162 | GDK_AVAILABLE_IN_ALL |
163 | void gtk_about_dialog_set_documenters (GtkAboutDialog *about, |
164 | const char **documenters); |
165 | GDK_AVAILABLE_IN_ALL |
166 | const char * const * gtk_about_dialog_get_artists (GtkAboutDialog *about); |
167 | GDK_AVAILABLE_IN_ALL |
168 | void gtk_about_dialog_set_artists (GtkAboutDialog *about, |
169 | const char **artists); |
170 | GDK_AVAILABLE_IN_ALL |
171 | const char * gtk_about_dialog_get_translator_credits (GtkAboutDialog *about); |
172 | GDK_AVAILABLE_IN_ALL |
173 | void gtk_about_dialog_set_translator_credits (GtkAboutDialog *about, |
174 | const char *translator_credits); |
175 | GDK_AVAILABLE_IN_ALL |
176 | GdkPaintable *gtk_about_dialog_get_logo (GtkAboutDialog *about); |
177 | GDK_AVAILABLE_IN_ALL |
178 | void gtk_about_dialog_set_logo (GtkAboutDialog *about, |
179 | GdkPaintable *logo); |
180 | GDK_AVAILABLE_IN_ALL |
181 | const char * gtk_about_dialog_get_logo_icon_name (GtkAboutDialog *about); |
182 | GDK_AVAILABLE_IN_ALL |
183 | void gtk_about_dialog_set_logo_icon_name (GtkAboutDialog *about, |
184 | const char *icon_name); |
185 | GDK_AVAILABLE_IN_ALL |
186 | void gtk_about_dialog_add_credit_section (GtkAboutDialog *about, |
187 | const char *section_name, |
188 | const char **people); |
189 | |
190 | G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkAboutDialog, g_object_unref) |
191 | |
192 | G_END_DECLS |
193 | |
194 | #endif /* __GTK_ABOUT_DIALOG_H__ */ |
195 | |
196 | |
197 | |