Pileus Git - ~andy/gtk/blob - gtk/gtkaboutdialog.h

   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 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.
  21
  22    Author: Anders Carlsson <andersca@codefactory.se>
  23 */
  24
  25 #ifndef __GTK_ABOUT_DIALOG_H__
  26 #define __GTK_ABOUT_DIALOG_H__
  27
  28 #include <gtk/gtkdialog.h>
  29
  30 G_BEGIN_DECLS
  31
  32 #define GTK_TYPE_ABOUT_DIALOG            (gtk_about_dialog_get_type ())
  33 #define GTK_ABOUT_DIALOG(object)         (G_TYPE_CHECK_INSTANCE_CAST ((object), GTK_TYPE_ABOUT_DIALOG, GtkAboutDialog))
  34 #define GTK_ABOUT_DIALOG_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_ABOUT_DIALOG, GtkAboutDialogClass))
  35 #define GTK_IS_ABOUT_DIALOG(object)      (G_TYPE_CHECK_INSTANCE_TYPE ((object), GTK_TYPE_ABOUT_DIALOG))
  36 #define GTK_IS_ABOUT_DIALOG_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_ABOUT_DIALOG))
  37 #define GTK_ABOUT_DIALOG_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_ABOUT_DIALOG, GtkAboutDialogClass))
  38
  39 typedef struct _GtkAboutDialog        GtkAboutDialog;
  40 typedef struct _GtkAboutDialogClass   GtkAboutDialogClass;
  41
  42 struct _GtkAboutDialog
  43 {
  44   GtkDialog parent_instance;
  45
  46   /*< private >*/
  47   gpointer private_data;
  48 };
  49
  50 struct _GtkAboutDialogClass
  51 {
  52   GtkDialogClass parent_class;
  53
  54   /* Padding for future expansion */
  55   void (*_gtk_reserved1) (void);
  56   void (*_gtk_reserved2) (void);
  57   void (*_gtk_reserved3) (void);
  58   void (*_gtk_reserved4) (void);
  59 };
  60
  61 GType                  gtk_about_dialog_get_type               (void) G_GNUC_CONST;
  62 GtkWidget             *gtk_about_dialog_new                    (void);
  63 void                   gtk_show_about_dialog                   (GtkWindow       *parent,
  64                                                                 const gchar     *first_property_name,
  65                                                                 ...) G_GNUC_NULL_TERMINATED;
  66
  67 #ifndef GTK_DISABLE_DEPRECATED
  68 G_CONST_RETURN gchar  *gtk_about_dialog_get_name               (GtkAboutDialog  *about);
  69 void                   gtk_about_dialog_set_name               (GtkAboutDialog  *about,
  70                                                                 const gchar     *name);
  71 #endif /* GTK_DISABLE_DEPRECATED */
  72 G_CONST_RETURN gchar  *gtk_about_dialog_get_program_name       (GtkAboutDialog  *about);
  73 void                   gtk_about_dialog_set_program_name       (GtkAboutDialog  *about,
  74                                                                 const gchar     *name);
  75 G_CONST_RETURN gchar  *gtk_about_dialog_get_version            (GtkAboutDialog  *about);
  76 void                   gtk_about_dialog_set_version            (GtkAboutDialog  *about,
  77                                                                 const gchar     *version);
  78 G_CONST_RETURN gchar  *gtk_about_dialog_get_copyright          (GtkAboutDialog  *about);
  79 void                   gtk_about_dialog_set_copyright          (GtkAboutDialog  *about,
  80                                                                 const gchar     *copyright);
  81 G_CONST_RETURN gchar  *gtk_about_dialog_get_comments           (GtkAboutDialog  *about);
  82 void                   gtk_about_dialog_set_comments           (GtkAboutDialog  *about,
  83                                                                 const gchar     *comments);
  84 G_CONST_RETURN gchar  *gtk_about_dialog_get_license            (GtkAboutDialog  *about);
  85 void                   gtk_about_dialog_set_license            (GtkAboutDialog  *about,
  86                                                                 const gchar     *license);
  87
  88 gboolean               gtk_about_dialog_get_wrap_license       (GtkAboutDialog  *about);
  89 void                   gtk_about_dialog_set_wrap_license       (GtkAboutDialog  *about,
  90                                                                 gboolean         wrap_license);
  91
  92 G_CONST_RETURN gchar  *gtk_about_dialog_get_website            (GtkAboutDialog  *about);
  93 void                   gtk_about_dialog_set_website            (GtkAboutDialog  *about,
  94                                                                 const gchar     *website);
  95 G_CONST_RETURN gchar  *gtk_about_dialog_get_website_label      (GtkAboutDialog  *about);
  96 void                   gtk_about_dialog_set_website_label      (GtkAboutDialog  *about,
  97                                                                 const gchar     *website_label);
  98 G_CONST_RETURN gchar* G_CONST_RETURN * gtk_about_dialog_get_authors            (GtkAboutDialog  *about);
  99 void                   gtk_about_dialog_set_authors            (GtkAboutDialog  *about,
 100                                                                 const gchar    **authors);
 101 G_CONST_RETURN gchar* G_CONST_RETURN * gtk_about_dialog_get_documenters        (GtkAboutDialog  *about);
 102 void                   gtk_about_dialog_set_documenters        (GtkAboutDialog  *about,
 103                                                                 const gchar    **documenters);
 104 G_CONST_RETURN gchar* G_CONST_RETURN * gtk_about_dialog_get_artists            (GtkAboutDialog  *about);
 105 void                   gtk_about_dialog_set_artists            (GtkAboutDialog  *about,
 106                                                                 const gchar    **artists);
 107 G_CONST_RETURN gchar  *gtk_about_dialog_get_translator_credits (GtkAboutDialog  *about);
 108 void                   gtk_about_dialog_set_translator_credits (GtkAboutDialog  *about,
 109                                                                 const gchar     *translator_credits);
 110 GdkPixbuf             *gtk_about_dialog_get_logo               (GtkAboutDialog  *about);
 111 void                   gtk_about_dialog_set_logo               (GtkAboutDialog  *about,
 112                                                                 GdkPixbuf       *logo);
 113 G_CONST_RETURN gchar  *gtk_about_dialog_get_logo_icon_name     (GtkAboutDialog  *about);
 114 void                   gtk_about_dialog_set_logo_icon_name     (GtkAboutDialog  *about,
 115                                                                 const gchar     *icon_name);
 116
 117 typedef void (* GtkAboutDialogActivateLinkFunc) (GtkAboutDialog *about,
 118                                                  const gchar    *link,
 119                                                  gpointer        data);
 120
 121 GtkAboutDialogActivateLinkFunc gtk_about_dialog_set_email_hook (GtkAboutDialogActivateLinkFunc func,
 122                                                                 gpointer                       data,
 123                                                                 GDestroyNotify                 destroy);
 124 GtkAboutDialogActivateLinkFunc gtk_about_dialog_set_url_hook   (GtkAboutDialogActivateLinkFunc func,
 125                                                                 gpointer                       data,
 126                                                                 GDestroyNotify                 destroy);
 127
 128 G_END_DECLS
 129
 130 #endif /* __GTK_ABOUT_DIALOG_H__ */
 131
 132