![]() |
![]() |
![]() |
GNOME UI Library Reference Manual | ![]() |
---|---|---|---|---|
#include <libgnomeui/libgnomeui.h> GnomeAbout; GtkWidget* gnome_about_new (const gchar *name, const gchar *version, const gchar *copyright, const gchar *comments, const gchar **authors, const gchar **documenters, const gchar *translator_credits, GdkPixbuf *logo_pixbuf); void gnome_about_construct (GnomeAbout *about, const gchar *name, const gchar *version, const gchar *copyright, const gchar *comments, const gchar **authors, const gchar **documenters, const gchar *translator_credits, GdkPixbuf *logo_pixbuf);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkWindow +----GtkDialog +----GnomeAbout
"authors" GValueArray : Write "comments" gchararray : Read / Write "copyright" gchararray : Read / Write "documenters" GValueArray : Write "logo" GdkPixbuf : Write "name" gchararray : Read / Write "translator-credits" gchararray : Read / Write "version" gchararray : Read / Write
The GnomeAbout widget is used as the standard way of displaying credits in an
application. Typically, it will be called when a user selects the
About...
option from the Help
menu. With
one simple function call, the application can then display all of the
appropriate information.
typedef struct _GnomeAbout GnomeAbout;
GnomeAbout
is deprecated and should not be used in newly-written code.
A dialog box widget containing all of the relevant credit information and displaying as three notebook pages.
GtkWidget* gnome_about_new (const gchar *name, const gchar *version, const gchar *copyright, const gchar *comments, const gchar **authors, const gchar **documenters, const gchar *translator_credits, GdkPixbuf *logo_pixbuf);
gnome_about_new
is deprecated and should not be used in newly-written code.
Construct an application's credits box. The authors
array cannot be empty
and the translator_credits
should be marked as a translatable string (so
that only the translator for the currently active locale is displayed).
name : |
The name of the application. |
version : |
The version string of the application. |
copyright : |
The application's copyright statement. |
comments : |
A short miscellaneous string. |
authors : |
An NULL terminated array of the application authors.
|
documenters : |
An array of the application documenters. |
translator_credits : |
The translator for the current locale. |
logo_pixbuf : |
The application's logo. |
Returns : | A new "About" dialog. |
void gnome_about_construct (GnomeAbout *about, const gchar *name, const gchar *version, const gchar *copyright, const gchar *comments, const gchar **authors, const gchar **documenters, const gchar *translator_credits, GdkPixbuf *logo_pixbuf);
gnome_about_construct
is deprecated and should not be used in newly-written code.
Similar to gnome_about_new()
except that the pre-existing about
widget is
used. Note that in this version of the function, authors
is not checked to
be non-NULL
, so callers must be careful, since bad things will happen if
this condition is not met.
about : |
An existing GnomeAbout instance. |
name : |
The name of the application. |
version : |
The version string of the application. |
copyright : |
The application's copyright statement. |
comments : |
A short miscellaneous string. |
authors : |
An NULL terminated array of the application authors.
|
documenters : |
An array of the application documenters. |
translator_credits : |
The translator for the current locale. |
logo_pixbuf : |
The application's logo. |
comments
" property"comments" gchararray : Read / Write
Comments about the program.
Default value: NULL
copyright
" property"copyright" gchararray : Read / Write
Copyright information for the program.
Default value: NULL
documenters
" property"documenters" GValueArray : Write
List of people documenting the program.
translator-credits
" property"translator-credits" gchararray : Read / Write
Credits to the translators. This string should be marked as translatable.
Default value: NULL