XfceAboutDialog

XfceAboutDialog — display information about a project.

Synopsis


#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);


Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBin
                           +----GtkWindow
                                 +----GtkDialog
                                       +----XfceAboutDialog

Implemented Interfaces

XfceAboutDialog implements AtkImplementorIface.

Description

A dialog box widget containing all of the relevant credit information.

Details

struct XfceAboutInfo

struct XfceAboutInfo;


struct 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.


XFCE_COPYRIGHT_TEXT()

#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.

xfce_about_info_new ()

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.

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.

xfce_about_info_set_homepage ()

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.

xfce_about_info_add_credit ()

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.

xfce_about_dialog_new ()

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.