MateAbout

## MateAbout MateAbout — Display author, documenter and translator credits for an application. |

## Synopsis

    #include <libmateui/libmateui.h>

    struct              MateAbout;
    GtkWidget *         mate_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                mate_about_construct               (MateAbout *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);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkWindow
                                           +----GtkDialog
                                                 +----MateAbout

## Implemented Interfaces

MateAbout implements AtkImplementorIface and GtkBuildable.

## Properties

      "authors"                  GValueArray*          : Write
      "comments"                 gchar*                : Read / Write
      "copyright"                gchar*                : Read / Write
      "documenters"              GValueArray*          : Write
      "logo"                     GdkPixbuf*            : Write
      "name"                     gchar*                : Read / Write
      "translator-credits"       gchar*                : Read / Write
      "version"                  gchar*                : Read / Write

## Description

The MateAbout 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.

## Details

### struct MateAbout

    struct MateAbout;

### Warning

`MateAbout` 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.

### mate_about_new ()

    GtkWidget *         mate_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);

### Warning

`mate_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.

### mate_about_construct ()

    void                mate_about_construct               (MateAbout *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);

### Warning

`mate_about_construct` is deprecated and should not be used in newly-written code.

Similar to `mate_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 MateAbout 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.

## Property Details

### The `"authors"` property

      "authors"                  GValueArray*          : Write

List of authors of the programs.

### The `"comments"` property

      "comments"                 gchar*                : Read / Write

Comments about the program.

Default value: NULL

### The `"copyright"` property

      "copyright"                gchar*                : Read / Write

Copyright information for the program.

Default value: NULL

### The `"documenters"` property

      "documenters"              GValueArray*          : Write

List of people documenting the program.

### The `"logo"` property

      "logo"                     GdkPixbuf*            : Write

A logo for the about box.

### The `"name"` property

      "name"                     gchar*                : Read / Write

The name of the program.

Default value: NULL

### The `"translator-credits"` property

      "translator-credits"       gchar*                : Read / Write

Credits to the translators. This string should be marked as translatable.

Default value: NULL

### The `"version"` property

      "version"                  gchar*                : Read / Write

The version of the program.

Default value: NULL