|
|
|
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" gchararray : Read / Write
Comments about the program.
Default value: NULL
"copyright" gchararray : Read / Write
Copyright information for the program.
Default value: NULL
"documenters" GValueArray : Write
List of people documenting the program.
"translator-credits" gchararray : Read / Write
Credits to the translators. This string should be marked as translatable.
Default value: NULL