![]() | ![]() | ![]() | libxfcegui4 Reference Manual | ![]() |
---|
XfceAboutDialog — display information about a project.
#include <libxfcegui4/libxfcegui4.h> struct XfceAboutInfo; struct XfceAboutDialog; #define XFCE_COPYRIGHT_TEXT (years, owner) XfceAboutInfo* xfce_about_info_new (const gchar *program, const gchar *version, const gchar *description, const gchar *copyright, const gchar *license); void xfce_about_info_free (XfceAboutInfo *info); void xfce_about_info_set_homepage (XfceAboutInfo *info, const gchar *homepage); void xfce_about_info_add_credit (XfceAboutInfo *info, const gchar *name, const gchar *mail, const gchar *task); GtkWidget* xfce_about_dialog_new (GtkWindow *parent, const XfceAboutInfo *info, GdkPixbuf *icon);
GObject +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkWindow +----GtkDialog +----XfceAboutDialog
struct XfceAboutDialog;
A dialog box widget that contains all the credit information relevant to a projects, and displays it in up to three notebook tabs.
#define XFCE_COPYRIGHT_TEXT(years, owner)
Generates a default copyright text from the given information.
years : | year information (e.g. "2002-2004"). |
owner : | the copyright owner. |
XfceAboutInfo* xfce_about_info_new (const gchar *program, const gchar *version, const gchar *description, const gchar *copyright, const gchar *license);
program : | program name (e.g. "xfce4-session") |
version : | application version. |
description : | short descriptive text (e.g. "Xfce session manager"). |
copyright : | copyright text, use the XFCE_COPYRIGHT_TEXT macro. This parameter is optional. If set to NULL, a default copyright text will be choosen. |
license : | optional license text, can either be the text of a license or can be one of the builtin license constants, which are limited to XFCE_LICENSE_BSD, XFCE_LICENSE_GPL and XFCE_LICENSE_LGPL currently. If NULL, no license text will be displayed. |
Returns : | the new XfceAboutInfo object or NULL on error. The result needs to be freed using xfce_about_info_free. |
void xfce_about_info_free (XfceAboutInfo *info);
Frees the info object and all resources covered by it.
info : | the XfceAboutInfo object. |
void xfce_about_info_set_homepage (XfceAboutInfo *info, const gchar *homepage);
Associates a homepage with the info object.
info : | the XfceAboutInfo object. |
homepage : | the URL of the projects website, has to be a valid URL, that can be loaded by a webbrowser. |
void xfce_about_info_add_credit (XfceAboutInfo *info, const gchar *name, const gchar *mail, const gchar *task);
Adds a credit to the info object.
info : | an XfceAboutInfo object. |
name : | the full name of the person. |
mail : | the persons email address. |
task : | the persons task in the project. |
GtkWidget* xfce_about_dialog_new (GtkWindow *parent, const XfceAboutInfo *info, GdkPixbuf *icon);
parent : | parent window or NULL. |
info : | an XfceAboutInfo object with the about info. |
icon : | an optional icon, if NULL, no icon will be displayed. |
Returns : | the newly allocated dialog widget. |
<< Dialogs | XfceAppMenuItem >> |