XfceAboutDialog

XfceAboutDialog — display information about a project.

Synopsis

#include <libxfcegui4/libxfcegui4.h>

                    XfceAboutInfo;
                    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
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----GtkDialog
                                             +----XfceAboutDialog

Implemented Interfaces

XfceAboutDialog implements AtkImplementorIface and GtkBuildable.

Properties

  "copyright"                gchar*                : Read / Write
  "description"              gchar*                : Read / Write
  "homepage"                 gchar*                : Read / Write
  "icon"                     GdkPixbuf*            : Read / Write
  "license"                  gchar*                : Read / Write
  "program"                  gchar*                : Read / Write
  "version"                  gchar*                : Read / Write

Description

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

Details

XfceAboutInfo

typedef struct _XfceAboutInfo XfceAboutInfo;

XfceAboutDialog

typedef struct _XfceAboutDialog 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) ("Copyright (c) " years "\n" owner "\nAll rights reserved.")

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 :

 an XfceAboutInfo.

xfce_about_info_set_homepage ()

void                xfce_about_info_set_homepage        (XfceAboutInfo *info,
                                                         const gchar *homepage);

Associates a homepage with the info object.

info :

 an XfceAboutInfo.

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.

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. Deprecated: Use xfce_about_dialog_new_with_values instead.

Property Details

The "copyright" property

  "copyright"                gchar*                : Read / Write

Program Copyright.

Default value: NULL

The "description" property

  "description"              gchar*                : Read / Write

Program Description.

Default value: NULL

The "homepage" property

  "homepage"                 gchar*                : Read / Write

Program Homepage.

Default value: NULL

The "icon" property

  "icon"                     GdkPixbuf*            : Read / Write

icon to use, if any.

The "license" property

  "license"                  gchar*                : Read / Write

Program License.

Default value: NULL

The "program" property

  "program"                  gchar*                : Read / Write

Program Name.

Default value: NULL

The "version" property

  "version"                  gchar*                : Read / Write

Program Version.

Default value: NULL

Generated by GTK-Doc V1.19