gui/src/aboutdialog.h

   1 #ifndef _GTKMM_ABOUTDIALOG_H
   2 #define _GTKMM_ABOUTDIALOG_H
   3
   4 //
   5 // This was copied from gtkmm 2.10.6 and hacked up a bit, so
   6 // that we have a dialog class for systems using older
   7 // versions of gtkmm24.  Debian stable, I'm looking at you...
   8 //
   9 // Chris Frey <cdfrey@foursquare.net>
  10 //
  11
  12 #include <glibmm.h>
  13
  14 /* aboutdialog.h
  15  *
  16  * Copyright (C) 2004 The gtkmm Development Team
  17  *
  18  * This library is free software; you can redistribute it and/or
  19  * modify it under the terms of the GNU Library General Public
  20  * License as published by the Free Software Foundation; either
  21  * version 2 of the License, or (at your option) any later version.
  22  *
  23  * This library is distributed in the hope that it will be useful,
  24  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  25  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  26  * Library General Public License for more details.
  27  *
  28  * You should have received a copy of the GNU Library General Public
  29  * License along with this library; if not, write to the Free
  30  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  31  */
  32
  33 #include <gtkmm/dialog.h>
  34 //#include <glibmm/listhandle.h>
  35
  36
  37 #ifndef DOXYGEN_SHOULD_SKIP_THIS
  38 typedef struct _GtkAboutDialog GtkAboutDialog;
  39 typedef struct _GtkAboutDialogClass GtkAboutDialogClass;
  40 #endif /* DOXYGEN_SHOULD_SKIP_THIS */
  41
  42
  43 namespace Gtk
  44 { class AboutDialog_Class; } // namespace Gtk
  45 namespace Gtk
  46 {
  47
  48 /** The AboutDialog offers a simple way to display information about a program like its logo, name, copyright,
  49  * website and license. It is also possible to give credits to the authors, documenters, translators and artists
  50  * who have worked on the program. An about dialog is typically opened when the user selects the About option
  51  * from the Help menu. All parts of the dialog are optional.
  52  *
  53  * About dialogs often contain links and email addresses. Gtk::AboutDialog supports this by offering global
  54  * hooks, which are called when the user clicks on a link or email address, see set_email_hook() and
  55  * set_url_hook(). Email addresses in the authors, documenters and artists properties are recognized by looking
  56  * for <user@host>, URLs are recognized by looking for http://url, with the URL extending to the next space,
  57  * tab or line break.
  58  *
  59  * @ingroup Dialogs
  60  */
  61
  62 class AboutDialog : public Dialog
  63 {
  64   public:
  65 #ifndef DOXYGEN_SHOULD_SKIP_THIS
  66   typedef AboutDialog CppObjectType;
  67   typedef AboutDialog_Class CppClassType;
  68   typedef GtkAboutDialog BaseObjectType;
  69   typedef GtkAboutDialogClass BaseClassType;
  70 #endif /* DOXYGEN_SHOULD_SKIP_THIS */
  71
  72   virtual ~AboutDialog();
  73
  74 #ifndef DOXYGEN_SHOULD_SKIP_THIS
  75
  76 private:
  77   friend class AboutDialog_Class;
  78   static CppClassType aboutdialog_class_;
  79
  80   // noncopyable
  81   AboutDialog(const AboutDialog&);
  82   AboutDialog& operator=(const AboutDialog&);
  83
  84 protected:
  85   explicit AboutDialog(const Glib::ConstructParams& construct_params);
  86   explicit AboutDialog(GtkAboutDialog* castitem);
  87
  88 #endif /* DOXYGEN_SHOULD_SKIP_THIS */
  89
  90 public:
  91 #ifndef DOXYGEN_SHOULD_SKIP_THIS
  92   static GType get_type()      G_GNUC_CONST;
  93   static GType get_base_type() G_GNUC_CONST;
  94 #endif
  95
  96   ///Provides access to the underlying C GtkObject.
  97   GtkAboutDialog*       gobj()       { return reinterpret_cast<GtkAboutDialog*>(gobject_); }
  98
  99   ///Provides access to the underlying C GtkObject.
 100   const GtkAboutDialog* gobj() const { return reinterpret_cast<GtkAboutDialog*>(gobject_); }
 101
 102
 103 public:
 104   //C++ methods used to invoke GTK+ virtual functions:
 105 #ifdef GLIBMM_VFUNCS_ENABLED
 106 #endif //GLIBMM_VFUNCS_ENABLED
 107
 108 protected:
 109   //GTK+ Virtual Functions (override these to change behaviour):
 110 #ifdef GLIBMM_VFUNCS_ENABLED
 111 #endif //GLIBMM_VFUNCS_ENABLED
 112
 113   //Default Signal Handlers::
 114 #ifdef GLIBMM_DEFAULT_SIGNAL_HANDLERS_ENABLED
 115 #endif //GLIBMM_DEFAULT_SIGNAL_HANDLERS_ENABLED
 116
 117
 118 private:
 119
 120
 121 public:
 122   AboutDialog();
 123
 124
 125   /** Returns the program name displayed in the about dialog.
 126    * @return The program name. The string is owned by the about
 127    * dialog and must not be modified.
 128    *
 129    * @newin2p6.
 130    */
 131   Glib::ustring get_name() const;
 132
 133   /** Sets the name to display in the about dialog.
 134    * If this is not set, it defaults to Glib::get_application_name().
 135    *
 136    * @newin2p6
 137    * @param name The program name.
 138    */
 139   void set_name(const Glib::ustring& name);
 140
 141   /** Returns the version string.
 142    * @return The version string. The string is owned by the about
 143    * dialog and must not be modified.
 144    *
 145    * @newin2p6.
 146    */
 147   Glib::ustring get_version() const;
 148
 149   /** Sets the version string to display in the about dialog.
 150    *
 151    * @newin2p6
 152    * @param version The version string.
 153    */
 154   void set_version(const Glib::ustring& version);
 155
 156   /** Returns the copyright string.
 157    * @return The copyright string. The string is owned by the about
 158    * dialog and must not be modified.
 159    *
 160    * @newin2p6.
 161    */
 162   Glib::ustring get_copyright() const;
 163
 164   /** Sets the copyright string to display in the about dialog.
 165    * This should be a short string of one or two lines.
 166    *
 167    * @newin2p6
 168    * @param copyright The copyright string.
 169    */
 170   void set_copyright(const Glib::ustring& copyright);
 171
 172   /** Returns the comments string.
 173    * @return The comments. The string is owned by the about
 174    * dialog and must not be modified.
 175    *
 176    * @newin2p6.
 177    */
 178   Glib::ustring get_comments() const;
 179
 180   /** Sets the comments string to display in the about
 181    * dialog. This should be a short string of one or
 182    * two lines.
 183    *
 184    * @newin2p6
 185    * @param comments A comments string.
 186    */
 187   void set_comments(const Glib::ustring& comments);
 188
 189   /** Returns the license information.
 190    * @return The license information. The string is owned by the about
 191    * dialog and must not be modified.
 192    *
 193    * @newin2p6.
 194    */
 195   Glib::ustring get_license() const;
 196
 197   /** Sets the license information to be displayed in the secondary
 198    * license dialog. If @a license  is <tt>0</tt>, the license button is
 199    * hidden.
 200    *
 201    * @newin2p6
 202    * @param license The license information or <tt>0</tt>.
 203    */
 204   void set_license(const Glib::ustring& license);
 205
 206   /** Returns the website URL.
 207    * @return The website URL. The string is owned by the about
 208    * dialog and must not be modified.
 209    *
 210    * @newin2p6.
 211    */
 212   Glib::ustring get_website() const;
 213
 214   /** Sets the URL to use for the website link.
 215    *
 216    * @newin2p6
 217    * @param website A URL string starting with "http://".
 218    */
 219   void set_website(const Glib::ustring& website);
 220
 221   /** Returns the label used for the website link.
 222    * @return The label used for the website link. The string is owned by the about
 223    * dialog and must not be modified.
 224    *
 225    * @newin2p6.
 226    */
 227   Glib::ustring get_website_label() const;
 228
 229   /** Sets the label to be used for the website link.
 230    * It defaults to the website URL.
 231    *
 232    * @newin2p6
 233    * @param website_label The label used for the website link.
 234    */
 235   void set_website_label(const Glib::ustring& website_label);
 236
 237
 238   /** Returns the string which are displayed in the authors tab
 239    * of the secondary credits dialog.
 240    * @return A <tt>0</tt>-terminated string array containing
 241    * the authors. The array is owned by the about dialog
 242    * and must not be modified.
 243    *
 244    * @newin2p6.
 245    */
 246   Glib::StringArrayHandle get_authors() const;
 247
 248
 249   /** Sets the strings which are displayed in the authors tab
 250    * of the secondary credits dialog.
 251    *
 252    * @newin2p6
 253    * @param authors A <tt>0</tt>-terminated array of strings.
 254    */
 255   void set_authors(const Glib::StringArrayHandle& authors) const;
 256
 257
 258   /** Returns the string which are displayed in the documenters
 259    * tab of the secondary credits dialog.
 260    * @return A <tt>0</tt>-terminated string array containing
 261    * the documenters. The array is owned by the about dialog
 262    * and must not be modified.
 263    *
 264    * @newin2p6.
 265    */
 266   Glib::StringArrayHandle get_documenters() const;
 267
 268
 269   /** Sets the strings which are displayed in the documenters tab
 270    * of the secondary credits dialog.
 271    *
 272    * @newin2p6
 273    * @param documenters A <tt>0</tt>-terminated array of strings.
 274    */
 275   void set_documenters(const Glib::StringArrayHandle& documenters);
 276
 277   /** Returns the string which are displayed in the artists tab
 278    * of the secondary credits dialog.
 279    * @return A <tt>0</tt>-terminated string array containing
 280    * the artists. The array is owned by the about dialog
 281    * and must not be modified.
 282    *
 283    * @newin2p6.
 284    */
 285   Glib::StringArrayHandle get_artists() const;
 286
 287   /** Sets the strings which are displayed in the artists tab
 288    * of the secondary credits dialog.
 289    *
 290    * @newin2p6
 291    * @param artists A <tt>0</tt>-terminated array of strings.
 292    */
 293   void set_artists(const Glib::StringArrayHandle& artists);
 294
 295   /** Returns the translator credits string which is displayed
 296    * in the translators tab of the secondary credits dialog.
 297    * @return The translator credits string. The string is
 298    * owned by the about dialog and must not be modified.
 299    *
 300    * @newin2p6.
 301    */
 302   Glib::ustring get_translator_credits() const;
 303
 304   /** Sets the translator credits string which is displayed in
 305    * the translators tab of the secondary credits dialog.
 306    *
 307    * The intended use for this string is to display the translator
 308    * of the language which is currently used in the user interface.
 309    * Using gettext(), a simple way to achieve that is to mark the
 310    * string for translation:
 311    * @code
 312    * gtk_about_dialog_set_translator_credits (about, _("translator-credits"));
 313    * @endcode
 314    * It is a good idea to use the customary msgid "translator-credits" for this
 315    * purpose, since translators will already know the purpose of that msgid, and
 316    * since Gtk::AboutDialog will detect if "translator-credits" is untranslated
 317    * and hide the tab.
 318    *
 319    * @newin2p6
 320    * @param translator_credits The translator credits.
 321    */
 322   void set_translator_credits(const Glib::ustring& translator_credits);
 323
 324
 325   /** Returns the pixbuf displayed as logo in the about dialog.
 326    * @return The pixbuf displayed as logo. The pixbuf is
 327    * owned by the about dialog. If you want to keep a reference
 328    * to it, you have to call Glib::object_ref() on it.
 329    *
 330    * @newin2p6.
 331    */
 332   Glib::RefPtr<Gdk::Pixbuf> get_logo();
 333
 334   /** Returns the pixbuf displayed as logo in the about dialog.
 335    * @return The pixbuf displayed as logo. The pixbuf is
 336    * owned by the about dialog. If you want to keep a reference
 337    * to it, you have to call Glib::object_ref() on it.
 338    *
 339    * @newin2p6.
 340    */
 341   Glib::RefPtr<const Gdk::Pixbuf> get_logo() const;
 342
 343
 344   /** Sets the pixbuf to be displayed as logo in
 345    * the about dialog. If it is <tt>0</tt>, the default
 346    * window icon set with Gtk::Window::set_default_icon()
 347    * will be used.
 348    *
 349    * @newin2p6
 350    * @param logo A Gdk::Pixbuf, or <tt>0</tt>.
 351    */
 352   void set_logo(const Glib::RefPtr<Gdk::Pixbuf>& logo);
 353
 354
 355   /** Returns the icon name displayed as logo in the about dialog.
 356    * @return The icon name displayed as logo. The string is
 357    * owned by the dialog. If you want to keep a reference
 358    * to it, you have to call Glib::strdup() on it.
 359    *
 360    * @newin2p6.
 361    */
 362   Glib::ustring get_logo_icon_name() const;
 363
 364   /** Sets the pixbuf to be displayed as logo in
 365    * the about dialog. If it is <tt>0</tt>, the default
 366    * window icon set with Gtk::Window::set_default_icon()
 367    * will be used.
 368    *
 369    * @newin2p6
 370    * @param icon_name An icon name, or <tt>0</tt>.
 371    */
 372   void set_logo_icon_name(const Glib::ustring& icon_name);
 373
 374
 375   /** Returns whether the license text in @a about  is
 376    * automatically wrapped.
 377    * @return <tt>true</tt> if the license text is wrapped
 378    *
 379    * @newin2p8.
 380    */
 381 //  bool get_wrap_license() const;
 382
 383   /** Sets whether the license text in @a about  is
 384    * automatically wrapped.
 385    *
 386    * @newin2p8
 387    * @param wrap_license Whether to wrap the license.
 388    */
 389 //  void set_wrap_license(bool wrap_license);
 390
 391   /** For instance,
 392    * void on_activate_link_url(AboutDialog& about_dialog, const Glib::ustring& link);
 393    */
 394   typedef sigc::slot<void, AboutDialog& /* about_dialog */, const Glib::ustring& /* link */> SlotActivateLink;
 395
 396   /** Installs a global callback to be called whenever the user activates an email link in an about dialog.
 397    * @param slot A function or method to call when an email link is activated.
 398    */
 399   static void set_email_hook(const SlotActivateLink& slot);
 400
 401
 402   /** Installs a global callback to be called whenever the user activates a URL link in an about dialog.
 403    * @param slot A function or method to call when a URL link is activated.
 404    */
 405   static void set_url_hook(const SlotActivateLink& slot);
 406
 407
 408 //TODO: Deprecate this, because it conflicts with the property in GtkWidget, which will be deprecated in GTK+ 2.12.
 409   #ifdef GLIBMM_PROPERTIES_ENABLED
 410 /** The name of the program. If this is not set
 411    *
 412    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 413    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 414    * the value of the property changes.
 415    */
 416   Glib::PropertyProxy<Glib::ustring> property_name() ;
 417 #endif //#GLIBMM_PROPERTIES_ENABLED
 418
 419 #ifdef GLIBMM_PROPERTIES_ENABLED
 420 /** The name of the program. If this is not set
 421    *
 422    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 423    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 424    * the value of the property changes.
 425    */
 426   Glib::PropertyProxy_ReadOnly<Glib::ustring> property_name() const;
 427 #endif //#GLIBMM_PROPERTIES_ENABLED
 428
 429
 430   #ifdef GLIBMM_PROPERTIES_ENABLED
 431 /** The version of the program.
 432    *
 433    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 434    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 435    * the value of the property changes.
 436    */
 437   Glib::PropertyProxy<Glib::ustring> property_version() ;
 438 #endif //#GLIBMM_PROPERTIES_ENABLED
 439
 440 #ifdef GLIBMM_PROPERTIES_ENABLED
 441 /** The version of the program.
 442    *
 443    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 444    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 445    * the value of the property changes.
 446    */
 447   Glib::PropertyProxy_ReadOnly<Glib::ustring> property_version() const;
 448 #endif //#GLIBMM_PROPERTIES_ENABLED
 449
 450   #ifdef GLIBMM_PROPERTIES_ENABLED
 451 /** Copyright information for the program.
 452    *
 453    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 454    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 455    * the value of the property changes.
 456    */
 457   Glib::PropertyProxy<Glib::ustring> property_copyright() ;
 458 #endif //#GLIBMM_PROPERTIES_ENABLED
 459
 460 #ifdef GLIBMM_PROPERTIES_ENABLED
 461 /** Copyright information for the program.
 462    *
 463    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 464    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 465    * the value of the property changes.
 466    */
 467   Glib::PropertyProxy_ReadOnly<Glib::ustring> property_copyright() const;
 468 #endif //#GLIBMM_PROPERTIES_ENABLED
 469
 470   #ifdef GLIBMM_PROPERTIES_ENABLED
 471 /** Comments about the program.
 472    *
 473    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 474    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 475    * the value of the property changes.
 476    */
 477   Glib::PropertyProxy<Glib::ustring> property_comments() ;
 478 #endif //#GLIBMM_PROPERTIES_ENABLED
 479
 480 #ifdef GLIBMM_PROPERTIES_ENABLED
 481 /** Comments about the program.
 482    *
 483    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 484    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 485    * the value of the property changes.
 486    */
 487   Glib::PropertyProxy_ReadOnly<Glib::ustring> property_comments() const;
 488 #endif //#GLIBMM_PROPERTIES_ENABLED
 489
 490   #ifdef GLIBMM_PROPERTIES_ENABLED
 491 /** The URL for the link to the website of the program.
 492    *
 493    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 494    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 495    * the value of the property changes.
 496    */
 497   Glib::PropertyProxy<Glib::ustring> property_website() ;
 498 #endif //#GLIBMM_PROPERTIES_ENABLED
 499
 500 #ifdef GLIBMM_PROPERTIES_ENABLED
 501 /** The URL for the link to the website of the program.
 502    *
 503    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 504    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 505    * the value of the property changes.
 506    */
 507   Glib::PropertyProxy_ReadOnly<Glib::ustring> property_website() const;
 508 #endif //#GLIBMM_PROPERTIES_ENABLED
 509
 510   #ifdef GLIBMM_PROPERTIES_ENABLED
 511 /** The label for the link to the website of the program. If this is not set
 512    *
 513    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 514    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 515    * the value of the property changes.
 516    */
 517   Glib::PropertyProxy<Glib::ustring> property_website_label() ;
 518 #endif //#GLIBMM_PROPERTIES_ENABLED
 519
 520 #ifdef GLIBMM_PROPERTIES_ENABLED
 521 /** The label for the link to the website of the program. If this is not set
 522    *
 523    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 524    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 525    * the value of the property changes.
 526    */
 527   Glib::PropertyProxy_ReadOnly<Glib::ustring> property_website_label() const;
 528 #endif //#GLIBMM_PROPERTIES_ENABLED
 529
 530   #ifdef GLIBMM_PROPERTIES_ENABLED
 531 /** The license of the program.
 532    *
 533    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 534    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 535    * the value of the property changes.
 536    */
 537   Glib::PropertyProxy<Glib::ustring> property_license() ;
 538 #endif //#GLIBMM_PROPERTIES_ENABLED
 539
 540 #ifdef GLIBMM_PROPERTIES_ENABLED
 541 /** The license of the program.
 542    *
 543    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 544    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 545    * the value of the property changes.
 546    */
 547   Glib::PropertyProxy_ReadOnly<Glib::ustring> property_license() const;
 548 #endif //#GLIBMM_PROPERTIES_ENABLED
 549
 550   #ifdef GLIBMM_PROPERTIES_ENABLED
 551 /** List of authors of the program.
 552    *
 553    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 554    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 555    * the value of the property changes.
 556    */
 557   Glib::PropertyProxy<Glib::StringArrayHandle> property_authors() ;
 558 #endif //#GLIBMM_PROPERTIES_ENABLED
 559
 560 #ifdef GLIBMM_PROPERTIES_ENABLED
 561 /** List of authors of the program.
 562    *
 563    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 564    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 565    * the value of the property changes.
 566    */
 567   Glib::PropertyProxy_ReadOnly<Glib::StringArrayHandle> property_authors() const;
 568 #endif //#GLIBMM_PROPERTIES_ENABLED
 569
 570   #ifdef GLIBMM_PROPERTIES_ENABLED
 571 /** List of people documenting the program.
 572    *
 573    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 574    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 575    * the value of the property changes.
 576    */
 577   Glib::PropertyProxy<Glib::StringArrayHandle> property_documenters() ;
 578 #endif //#GLIBMM_PROPERTIES_ENABLED
 579
 580 #ifdef GLIBMM_PROPERTIES_ENABLED
 581 /** List of people documenting the program.
 582    *
 583    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 584    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 585    * the value of the property changes.
 586    */
 587   Glib::PropertyProxy_ReadOnly<Glib::StringArrayHandle> property_documenters() const;
 588 #endif //#GLIBMM_PROPERTIES_ENABLED
 589
 590   #ifdef GLIBMM_PROPERTIES_ENABLED
 591 /** Credits to the translators. This string should be marked as translatable.
 592    *
 593    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 594    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 595    * the value of the property changes.
 596    */
 597   Glib::PropertyProxy<Glib::StringArrayHandle> property_translator_credits() ;
 598 #endif //#GLIBMM_PROPERTIES_ENABLED
 599
 600 #ifdef GLIBMM_PROPERTIES_ENABLED
 601 /** Credits to the translators. This string should be marked as translatable.
 602    *
 603    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 604    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 605    * the value of the property changes.
 606    */
 607   Glib::PropertyProxy_ReadOnly<Glib::StringArrayHandle> property_translator_credits() const;
 608 #endif //#GLIBMM_PROPERTIES_ENABLED
 609
 610   #ifdef GLIBMM_PROPERTIES_ENABLED
 611 /** List of people who have contributed artwork to the program.
 612    *
 613    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 614    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 615    * the value of the property changes.
 616    */
 617   Glib::PropertyProxy<Glib::StringArrayHandle> property_artists() ;
 618 #endif //#GLIBMM_PROPERTIES_ENABLED
 619
 620 #ifdef GLIBMM_PROPERTIES_ENABLED
 621 /** List of people who have contributed artwork to the program.
 622    *
 623    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 624    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 625    * the value of the property changes.
 626    */
 627   Glib::PropertyProxy_ReadOnly<Glib::StringArrayHandle> property_artists() const;
 628 #endif //#GLIBMM_PROPERTIES_ENABLED
 629
 630   #ifdef GLIBMM_PROPERTIES_ENABLED
 631 /** A logo for the about box. If this is not set
 632    *
 633    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 634    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 635    * the value of the property changes.
 636    */
 637   Glib::PropertyProxy< Glib::RefPtr<Gdk::Pixbuf> > property_logo() ;
 638 #endif //#GLIBMM_PROPERTIES_ENABLED
 639
 640 #ifdef GLIBMM_PROPERTIES_ENABLED
 641 /** A logo for the about box. If this is not set
 642    *
 643    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 644    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 645    * the value of the property changes.
 646    */
 647   Glib::PropertyProxy_ReadOnly< Glib::RefPtr<Gdk::Pixbuf> > property_logo() const;
 648 #endif //#GLIBMM_PROPERTIES_ENABLED
 649
 650   #ifdef GLIBMM_PROPERTIES_ENABLED
 651 /** A named icon to use as the logo for the about box.
 652    *
 653    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 654    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 655    * the value of the property changes.
 656    */
 657   Glib::PropertyProxy<Glib::ustring> property_logo_icon_name() ;
 658 #endif //#GLIBMM_PROPERTIES_ENABLED
 659
 660 #ifdef GLIBMM_PROPERTIES_ENABLED
 661 /** A named icon to use as the logo for the about box.
 662    *
 663    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 664    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 665    * the value of the property changes.
 666    */
 667   Glib::PropertyProxy_ReadOnly<Glib::ustring> property_logo_icon_name() const;
 668 #endif //#GLIBMM_PROPERTIES_ENABLED
 669
 670   #ifdef GLIBMM_PROPERTIES_ENABLED
 671 /** Whether to wrap the license text.
 672    *
 673    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 674    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 675    * the value of the property changes.
 676    */
 677 //  Glib::PropertyProxy<bool> property_wrap_license() ;
 678 #endif //#GLIBMM_PROPERTIES_ENABLED
 679
 680 #ifdef GLIBMM_PROPERTIES_ENABLED
 681 /** Whether to wrap the license text.
 682    *
 683    * You rarely need to use properties because there are get_ and set_ methods for almost all of them.
 684    * @return A PropertyProxy that allows you to get or set the property of the value, or receive notification when
 685    * the value of the property changes.
 686    */
 687 //  Glib::PropertyProxy_ReadOnly<bool> property_wrap_license() const;
 688 #endif //#GLIBMM_PROPERTIES_ENABLED
 689
 690
 691 };
 692
 693 } // namespace Gtk
 694
 695
 696 namespace Glib
 697 {
 698   /** @relates Gtk::AboutDialog
 699    * @param object The C instance
 700    * @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
 701    * @result A C++ instance that wraps this C instance.
 702    */
 703   Gtk::AboutDialog* wrap(GtkAboutDialog* object, bool take_copy = false);
 704 } //namespace Glib
 705
 706
 707 #endif /* _GTKMM_ABOUTDIALOG_H */
 708