summaryrefslogtreecommitdiff
path: root/tools/glade/glade/gbwidgets/gbaboutdialog.c
diff options
context:
space:
mode:
Diffstat (limited to 'tools/glade/glade/gbwidgets/gbaboutdialog.c')
-rw-r--r--tools/glade/glade/gbwidgets/gbaboutdialog.c602
1 files changed, 602 insertions, 0 deletions
diff --git a/tools/glade/glade/gbwidgets/gbaboutdialog.c b/tools/glade/glade/gbwidgets/gbaboutdialog.c
new file mode 100644
index 00000000..dd454986
--- /dev/null
+++ b/tools/glade/glade/gbwidgets/gbaboutdialog.c
@@ -0,0 +1,602 @@
+/* Gtk+ User Interface Builder
+ * Copyright (C) 1999-2002 Damon Chaplin
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+#include <config.h>
+
+#include <gtk/gtk.h>
+#include "../gb.h"
+
+/* Include the 21x21 icon pixmap for this widget, to be used in the palette */
+#include "../graphics/aboutdialog.xpm"
+
+/*
+ * This is the GbWidget struct for this widget (see ../gbwidget.h).
+ * It is initialized in the init() function at the end of this file
+ */
+static GbWidget gbwidget;
+
+static gchar *Name = "GtkAboutDialog::name";
+static gchar *Copyright = "GtkAboutDialog::copyright";
+static gchar *Comments = "GtkAboutDialog::comments";
+static gchar *License = "GtkAboutDialog::license";
+static gchar *WrapLicense = "GtkAboutDialog::wrap_license";
+static gchar *Website = "GtkAboutDialog::website";
+static gchar *WebsiteLabel = "GtkAboutDialog::website_label";
+
+static gchar *Authors = "GtkAboutDialog::authors";
+static gchar *Documenters = "GtkAboutDialog::documenters";
+static gchar *Artists = "GtkAboutDialog::artists";
+static gchar *TranslatorCredits = "GtkAboutDialog::translator_credits";
+
+static gchar *Logo = "GtkAboutDialog::logo";
+
+
+static gchar *DestroyWithParent = "GtkAboutDialog|GtkWindow::destroy_with_parent";
+
+#define GLADE_TRANSLATORS_STRING "translator-credits"
+
+/* This is the old string we used for GnomeAbout, but translators don't like
+ it as the '_' character gets confused with an underlined accelerator key. */
+#define GLADE_TRANSLATORS_STRING2 "translator_credits"
+
+
+/******
+ * NOTE: To use these functions you need to uncomment them AND add a pointer
+ * to the function in the GbWidget struct at the end of this file.
+ ******/
+
+/*
+ * Creates a new GtkWidget of class GtkAboutDialog, performing any specialized
+ * initialization needed for the widget to work correctly in this environment.
+ * If a dialog box is used to initialize the widget, return NULL from this
+ * function, and call data->callback with your new widget when it is done.
+ */
+static GtkWidget*
+gb_about_dialog_new (GbWidgetNewData *data)
+{
+ GtkWidget *new_widget;
+ gchar *project_name;
+
+ new_widget = gtk_about_dialog_new ();
+
+ project_name = glade_project_get_name (data->project);
+ if (!project_name)
+ project_name = _("Application Name");
+ gtk_about_dialog_set_name (GTK_ABOUT_DIALOG (new_widget), project_name);
+
+ gtk_about_dialog_set_version (GTK_ABOUT_DIALOG (new_widget), "1.0");
+
+ /* Now we connect our normal delete_event handler. */
+ gtk_signal_connect (GTK_OBJECT (new_widget), "delete_event",
+ GTK_SIGNAL_FUNC (editor_close_window), NULL);
+
+ /* Set the default comment string for the translator credits. */
+ glade_util_set_translation_properties (new_widget, TranslatorCredits,
+ TRUE, "TRANSLATORS: Replace this string with your names, one name per line.", FALSE);
+
+ return new_widget;
+}
+
+
+
+/*
+ * Creates the components needed to edit the extra properties of this widget.
+ */
+static void
+gb_about_dialog_create_properties (GtkWidget * widget, GbWidgetCreateArgData * data)
+{
+ property_add_filename (Logo, _("Logo:"), _("The pixmap to use as the logo"));
+
+ property_add_string (Name, _("Program Name:"), _("The name of the application"));
+ property_add_text (Comments, _("Comments:"), _("Additional information, such as a description of the application"), 3);
+ property_add_text (Copyright, _("Copyright:"), _("The copyright notice"), 2);
+
+ property_add_string (Website, _("Website URL:"), _("The URL of the application's website"));
+ property_add_string (WebsiteLabel, _("Website Label:"), _("The label to display for the link to the website"));
+
+ property_add_text (License, _("License:"), _("The license details of the application"), 3);
+ property_add_bool (WrapLicense, _("Wrap License:"), _("If the license text should be wrapped"));
+
+ property_add_text (Authors, _("Authors:"), _("The authors of the package, one on each line"), 2);
+ property_add_text (Documenters, _("Documenters:"), _("The documenters of the package, one on each line"), 2);
+ property_add_text (Artists, _("Artists:"), _("The people who have created the artwork for the package, one on each line"), 2);
+ property_add_text (TranslatorCredits, _("Translators:"), _("The translators of the package. This should normally be left empty so that translators can add their names in the po files"), 2);
+
+ /* We onlt need the common DestroyWithParent window property. The others
+ shouldn't really need to be changed on a simple About dialog. */
+ gb_window_create_standard_properties (widget, data,
+ NULL, NULL, NULL, NULL,
+ NULL, NULL, NULL, NULL, NULL,
+ NULL, NULL,
+ NULL, DestroyWithParent, NULL,
+ NULL, NULL, NULL,
+ NULL, NULL, NULL, NULL);
+}
+
+
+
+/*
+ * Gets the properties of the widget. This is used for both displaying the
+ * properties in the property editor, and also for saving the properties.
+ */
+static void
+gb_about_dialog_get_properties (GtkWidget *widget, GbWidgetGetArgData * data)
+{
+ const gchar *name, *copyright, *comments, *license, *website, *website_label;
+ const char *translator_credits, *translator_credits_output;
+ gboolean wrap_license;
+
+ gb_window_get_standard_properties (widget, data,
+ NULL, NULL, NULL, NULL,
+ NULL, NULL, NULL, NULL, NULL,
+ NULL, NULL,
+ NULL, DestroyWithParent, NULL,
+ NULL, NULL, NULL,
+ NULL, NULL, NULL, NULL);
+
+ name = gtk_about_dialog_get_name (GTK_ABOUT_DIALOG (widget));
+ gb_widget_output_translatable_string (data, Name, name);
+
+ copyright = gtk_about_dialog_get_copyright (GTK_ABOUT_DIALOG (widget));
+ gb_widget_output_translatable_text (data, Copyright, copyright);
+
+ comments = gtk_about_dialog_get_comments (GTK_ABOUT_DIALOG (widget));
+ gb_widget_output_translatable_text (data, Comments, comments);
+
+ license = gtk_about_dialog_get_license (GTK_ABOUT_DIALOG (widget));
+ gb_widget_output_translatable_text (data, License, license);
+
+ wrap_license = gtk_about_dialog_get_wrap_license (GTK_ABOUT_DIALOG (widget));
+ gb_widget_output_bool (data, WrapLicense, wrap_license);
+
+ /* We store the Website & WebsiteURL in the object datalist, since the
+ widget does odd things when we set them. */
+ website = g_object_get_data (G_OBJECT (widget), Website);
+ gb_widget_output_string (data, Website, website);
+
+ website_label = g_object_get_data (G_OBJECT (widget), WebsiteLabel);
+ gb_widget_output_translatable_string (data, WebsiteLabel, website_label);
+
+ gb_widget_output_text (data, Authors,
+ gtk_object_get_data (GTK_OBJECT (widget), Authors));
+ gb_widget_output_text (data, Documenters,
+ gtk_object_get_data (GTK_OBJECT (widget),
+ Documenters));
+ gb_widget_output_text (data, Artists,
+ gtk_object_get_data (GTK_OBJECT (widget), Artists));
+
+ /* If we are saving, and translator_credits isn't set but is translatable,
+ we save the string "translator-credits". Translators can then
+ replace this with their own names in the po files. */
+ translator_credits = gtk_about_dialog_get_translator_credits (GTK_ABOUT_DIALOG (widget));
+ translator_credits_output = translator_credits;
+ if (data->action == GB_SAVING
+ && (!translator_credits || *translator_credits == '\0'))
+ {
+ gchar *comments_text;
+ gboolean translatable, context;
+
+ glade_util_get_translation_properties (widget, TranslatorCredits,
+ &translatable,
+ &comments_text, &context);
+ if (translatable)
+ translator_credits_output = GLADE_TRANSLATORS_STRING;
+ }
+ gb_widget_output_translatable_text (data, TranslatorCredits,
+ translator_credits_output);
+
+ gb_widget_output_pixmap_filename (data, Logo,
+ gtk_object_get_data (GTK_OBJECT (widget),
+ Logo));
+}
+
+
+static gchar**
+strv_from_property (GbWidgetSetArgData *data, GtkWidget *widget, const char *key)
+{
+ gchar **retval = NULL;
+ char *str;
+
+ str = gb_widget_input_text (data, key);
+ if (data->apply)
+ {
+ gtk_object_set_data_full (GTK_OBJECT (widget), key, g_strdup (str),
+ str ? g_free : NULL);
+ retval = g_strsplit (str, "\n", 0);
+ }
+ if (data->action == GB_APPLYING)
+ g_free (str);
+
+ return retval;
+}
+
+
+/*
+ * Sets the properties of the widget. This is used for both applying the
+ * properties changed in the property editor, and also for loading.
+ */
+static void
+gb_about_dialog_set_properties (GtkWidget * widget, GbWidgetSetArgData * data)
+{
+ gchar **authors, **documenters, **artists;
+ gchar *name, *copyright, *comments, *license, *website, *website_label;
+ gchar *translators, *filename, *old_filename;
+ GdkPixbuf *logo = NULL;
+ GObject *object;
+ gboolean wrap_license;
+
+ object = G_OBJECT (widget);
+
+ gb_window_set_standard_properties (widget, data,
+ NULL, NULL, NULL, NULL,
+ NULL, NULL, NULL, NULL, NULL,
+ NULL, NULL,
+ NULL, DestroyWithParent, NULL,
+ NULL, NULL, NULL,
+ NULL, NULL, NULL, NULL);
+
+ name = gb_widget_input_string (data, Name);
+ if (data->apply)
+ gtk_about_dialog_set_name (GTK_ABOUT_DIALOG (widget), name);
+
+ copyright = gb_widget_input_text (data, Copyright);
+ if (data->apply)
+ gtk_about_dialog_set_copyright (GTK_ABOUT_DIALOG (widget), copyright);
+ if (data->action == GB_APPLYING)
+ g_free (copyright);
+
+ comments = gb_widget_input_text (data, Comments);
+ if (data->apply)
+ gtk_about_dialog_set_comments (GTK_ABOUT_DIALOG (widget), comments);
+ if (data->action == GB_APPLYING)
+ g_free (comments);
+
+ license = gb_widget_input_text (data, License);
+ if (data->apply)
+ gtk_about_dialog_set_license (GTK_ABOUT_DIALOG (widget), license);
+ if (data->action == GB_APPLYING)
+ g_free (license);
+
+ wrap_license = gb_widget_input_bool (data, WrapLicense);
+ if (data->apply)
+ gtk_about_dialog_set_wrap_license (GTK_ABOUT_DIALOG (widget), wrap_license);
+
+
+ website = gb_widget_input_string (data, Website);
+ if (data->apply)
+ g_object_set_data_full (G_OBJECT (widget), Website, g_strdup (website),
+ website ? g_free : NULL);
+
+ website_label = gb_widget_input_string (data, WebsiteLabel);
+ if (data->apply)
+ g_object_set_data_full (G_OBJECT (widget), WebsiteLabel,
+ g_strdup (website_label),
+ website_label ? g_free : NULL);
+
+ authors = strv_from_property (data, widget, Authors);
+ if (data->apply)
+ gtk_about_dialog_set_authors (GTK_ABOUT_DIALOG (widget),
+ (const gchar**) authors);
+ g_strfreev (authors);
+
+ documenters = strv_from_property (data, widget, Documenters);
+ if (data->apply)
+ gtk_about_dialog_set_documenters (GTK_ABOUT_DIALOG (widget),
+ (const gchar**) documenters);
+ g_strfreev (documenters);
+
+ artists = strv_from_property (data, widget, Artists);
+ if (data->apply)
+ gtk_about_dialog_set_artists (GTK_ABOUT_DIALOG (widget),
+ (const gchar**) artists);
+ g_strfreev (artists);
+
+ translators = gb_widget_input_text (data, TranslatorCredits);
+ if (data->apply)
+ {
+ if (!strcmp (translators, GLADE_TRANSLATORS_STRING)
+ || !strcmp (translators, GLADE_TRANSLATORS_STRING2))
+ g_object_set (object, "translator-credits", "", NULL);
+ else
+ g_object_set (object, "translator-credits", translators, NULL);
+ }
+ if (data->action == GB_APPLYING)
+ g_free (translators);
+
+ filename = gb_widget_input_pixmap_filename (data, Logo);
+ if (data->apply)
+ {
+ if (filename && filename[0] == '\0')
+ filename = NULL;
+
+ old_filename = gtk_object_get_data (GTK_OBJECT (widget), Logo);
+ glade_project_remove_pixmap (data->project, old_filename);
+ gtk_object_set_data_full (GTK_OBJECT (widget), Logo,
+ g_strdup (filename), filename ? g_free : NULL);
+ glade_project_add_pixmap (data->project, filename);
+ logo = filename ? gdk_pixbuf_new_from_file (filename, NULL) : NULL;
+ g_object_set (object, "logo", logo, NULL);
+ if (logo)
+ g_object_unref (logo);
+ }
+ if (data->action == GB_LOADING)
+ g_free (filename);
+}
+
+
+
+/*
+ * Adds menu items to a context menu which is just about to appear!
+ * Add commands to aid in editing a GtkAboutDialog, with signals pointing to
+ * other functions in this file.
+ */
+/*
+static void
+gb_about_dialog_create_popup_menu (GtkWidget * widget, GbWidgetCreateMenuData * data)
+{
+
+}
+*/
+
+
+static gboolean
+output_creators_array (GtkWidget *widget, GbWidgetWriteSourceData *data,
+ gchar *array_name, gchar *property_name)
+{
+ gchar *string, **strv;
+ gint i;
+
+ string = gtk_object_get_data (GTK_OBJECT (widget), property_name);
+ if (!string || *string == '\0')
+ return FALSE;
+
+ source_add_decl (data, " const gchar *%s[] = {\n", array_name);
+
+ strv = g_strsplit (string, "\n", 0);
+ for (i = 0; strv[i]; i++)
+ {
+ if (strv[i][0])
+ source_add_decl (data, " %s,\n",
+ source_make_string (strv[i], FALSE));
+ }
+
+ source_add_decl (data, " NULL\n };\n");
+ g_strfreev (strv);
+
+ return TRUE;
+}
+
+/*
+ * Writes the source code needed to create this widget.
+ * You have to output everything necessary to create the widget here, though
+ * there are some convenience functions to help.
+ */
+static void
+gb_about_dialog_write_source (GtkWidget * widget, GbWidgetWriteSourceData * data)
+{
+ gboolean translatable, context, wrap_license;
+ gchar *comments;
+ const gchar *name, *copyright, *about_comments, *license;
+ const gchar *website, *website_label, *translators;
+ gchar *logo_filename;
+ char *pixbuf_name;
+
+ if (data->create_widget)
+ {
+ source_add (data, " %s = gtk_about_dialog_new ();\n", data->wname);
+ }
+
+ gb_widget_write_standard_source (widget, data);
+
+ gb_window_write_standard_source (widget, data,
+ NULL, NULL, NULL, NULL,
+ NULL, NULL, NULL, NULL, NULL,
+ NULL, NULL,
+ NULL, DestroyWithParent, NULL,
+ NULL, NULL, NULL,
+ NULL, NULL, NULL, NULL);
+
+ /* We set the version using the standard "VERSION" macro. */
+ source_add (data,
+ " gtk_about_dialog_set_version (GTK_ABOUT_DIALOG (%s), VERSION);\n", data->wname);
+
+ name = gtk_about_dialog_get_name (GTK_ABOUT_DIALOG (widget));
+ if (name && *name)
+ {
+ glade_util_get_translation_properties (widget, Name, &translatable,
+ &comments, &context);
+ source_add_translator_comments (data, translatable, comments);
+ source_add (data,
+ " gtk_about_dialog_set_name (GTK_ABOUT_DIALOG (%s), %s);\n",
+ data->wname,
+ source_make_string_full (name,
+ data->use_gettext && translatable,
+ context));
+ }
+
+ copyright = gtk_about_dialog_get_copyright (GTK_ABOUT_DIALOG (widget));
+ if (copyright && *copyright)
+ {
+ glade_util_get_translation_properties (widget, Copyright, &translatable,
+ &comments, &context);
+ source_add_translator_comments (data, translatable, comments);
+ source_add (data,
+ " gtk_about_dialog_set_copyright (GTK_ABOUT_DIALOG (%s), %s);\n",
+ data->wname,
+ source_make_string_full (copyright,
+ data->use_gettext && translatable,
+ context));
+ }
+
+ about_comments = gtk_about_dialog_get_comments (GTK_ABOUT_DIALOG (widget));
+ if (about_comments && *about_comments)
+ {
+ glade_util_get_translation_properties (widget, Comments, &translatable,
+ &comments, &context);
+ source_add_translator_comments (data, translatable, comments);
+ source_add (data,
+ " gtk_about_dialog_set_comments (GTK_ABOUT_DIALOG (%s), %s);\n",
+ data->wname,
+ source_make_string_full (about_comments,
+ data->use_gettext && translatable,
+ context));
+ }
+
+ license = gtk_about_dialog_get_license (GTK_ABOUT_DIALOG (widget));
+ if (license && *license)
+ {
+ glade_util_get_translation_properties (widget, License, &translatable,
+ &comments, &context);
+ source_add_translator_comments (data, translatable, comments);
+ source_add (data,
+ " gtk_about_dialog_set_license (GTK_ABOUT_DIALOG (%s), %s);\n",
+ data->wname,
+ source_make_string_full (license,
+ data->use_gettext && translatable,
+ context));
+ }
+
+ wrap_license = gtk_about_dialog_get_wrap_license (GTK_ABOUT_DIALOG (widget));
+ if (wrap_license)
+ {
+ source_add (data,
+ " gtk_about_dialog_set_wrap_license (GTK_ABOUT_DIALOG (%s), TRUE);\n",
+ data->wname);
+ }
+
+
+ website = g_object_get_data (G_OBJECT (widget), Website);
+ if (website && *website)
+ {
+ source_add (data,
+ " gtk_about_dialog_set_website (GTK_ABOUT_DIALOG (%s), %s);\n",
+ data->wname,
+ source_make_string (website, FALSE));
+ }
+
+ website_label = g_object_get_data (G_OBJECT (widget), WebsiteLabel);
+ if (website_label && *website_label)
+ {
+ glade_util_get_translation_properties (widget, WebsiteLabel,
+ &translatable,
+ &comments, &context);
+ source_add_translator_comments (data, translatable, comments);
+ source_add (data,
+ " gtk_about_dialog_set_website_label (GTK_ABOUT_DIALOG (%s), %s);\n",
+ data->wname,
+ source_make_string_full (website_label,
+ data->use_gettext && translatable,
+ context));
+ }
+
+
+ if (output_creators_array (widget, data, "authors", Authors))
+ source_add (data,
+ " gtk_about_dialog_set_authors (GTK_ABOUT_DIALOG (%s), authors);\n", data->wname);
+
+ if (output_creators_array (widget, data, "documenters", Documenters))
+ source_add (data,
+ " gtk_about_dialog_set_documenters (GTK_ABOUT_DIALOG (%s), documenters);\n", data->wname);
+
+ if (output_creators_array (widget, data, "artists", Artists))
+ source_add (data,
+ " gtk_about_dialog_set_artists (GTK_ABOUT_DIALOG (%s), artists);\n", data->wname);
+
+
+ /* If translators is set, then we use that specific string.
+ If it is not set, then if gettext support is enabled we output code
+ to call gettext to translate the special "translator_credits" string,
+ and use that if it is translated. */
+ translators = gtk_about_dialog_get_translator_credits (GTK_ABOUT_DIALOG (widget));
+ glade_util_get_translation_properties (widget, TranslatorCredits,
+ &translatable, &comments, &context);
+ if (translators && translators[0])
+ {
+ source_add_translator_comments_to_buffer (data, GLADE_DECLARATIONS, translatable, comments);
+ source_add_decl (data, " gchar *translators = %s;\n",
+ source_make_string (translators, FALSE));
+
+ source_add (data,
+ " gtk_about_dialog_set_translator_credits (GTK_ABOUT_DIALOG (%s), translators);\n", data->wname);
+ }
+ else if (data->use_gettext && translatable)
+ {
+ if (!comments || comments[0] == '\0')
+ comments = "TRANSLATORS: Replace this string with your names, one name per line.";
+
+ source_add_translator_comments_to_buffer (data, GLADE_DECLARATIONS,
+ translatable, comments);
+ source_add_decl (data,
+ " gchar *translators = _(\"%s\");\n",
+ GLADE_TRANSLATORS_STRING);
+
+ source_add (data,
+ " gtk_about_dialog_set_translator_credits (GTK_ABOUT_DIALOG (%s), translators);\n", data->wname);
+ }
+
+
+ logo_filename = gtk_object_get_data (GTK_OBJECT (widget), Logo);
+ if (logo_filename && logo_filename[0])
+ {
+ pixbuf_name = g_strdup_printf ("%s_logo_pixbuf", data->wname);
+
+ source_add_decl (data, " GdkPixbuf *%s;\n", pixbuf_name);
+ source_create_pixbuf (data, pixbuf_name, logo_filename);
+
+ source_add (data,
+ " gtk_about_dialog_set_logo (GTK_ABOUT_DIALOG (%s), %s);\n",
+ data->wname, pixbuf_name);
+
+ g_free (pixbuf_name);
+ }
+}
+
+
+
+/*
+ * Initializes the GbWidget structure.
+ * I've placed this at the end of the file so we don't have to include
+ * declarations of all the functions.
+ */
+GbWidget*
+gb_about_dialog_init ()
+{
+ /* Initialise the GTK type */
+ volatile GtkType type;
+ type = gtk_about_dialog_get_type();
+
+ /* Initialize the GbWidget structure */
+ gb_widget_init_struct(&gbwidget);
+
+ /* Fill in the pixmap struct & tooltip */
+ gbwidget.pixmap_struct = aboutdialog_xpm;
+ gbwidget.tooltip = _("About Dialog");
+
+ /* Fill in any functions that this GbWidget has */
+ gbwidget.gb_widget_new = gb_about_dialog_new;
+ gbwidget.gb_widget_create_properties = gb_about_dialog_create_properties;
+ gbwidget.gb_widget_get_properties = gb_about_dialog_get_properties;
+ gbwidget.gb_widget_set_properties = gb_about_dialog_set_properties;
+ gbwidget.gb_widget_write_source = gb_about_dialog_write_source;
+/*
+ gbwidget.gb_widget_create_popup_menu = gb_about_dialog_create_popup_menu;
+*/
+
+ return &gbwidget;
+}
+
generated by cgit v1.2.3 (git 2.39.1) at 2024-05-15 10:33:39 +0000