libs/gtkmm2/gtk/gtkmm/aboutdialog.h

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