MateScores

## MateScores MateScores |

## Synopsis

    #include <libmateui/libmateui.h>

    struct              MateScores;
    GtkWidget *         mate_scores_display_with_pixmap    (const gchar *pixmap_logo,
                                                             const gchar *app_name,
                                                             const gchar *level,
                                                             int pos);
    GtkWidget *         mate_scores_new                    (guint n_scores,
                                                             gchar **names,
                                                             gfloat *scores,
                                                             time_t *times,
                                                             gboolean clear);
    void                mate_scores_construct              (MateScores *gs,
                                                             guint n_scores,
                                                             gchar **names,
                                                             gfloat *scores,
                                                             time_t *times,
                                                             gboolean clear);
    void                mate_scores_set_logo_label         (MateScores *gs,
                                                             const gchar *txt,
                                                             const gchar *font,
                                                             GdkColor *col);
    void                mate_scores_set_logo_pixmap        (MateScores *gs,
                                                             const gchar *pix_name);
    void                mate_scores_set_logo_widget        (MateScores *gs,
                                                             GtkWidget *w);
    void                mate_scores_set_color              (MateScores *gs,
                                                             guint n,
                                                             GdkColor *col);
    void                mate_scores_set_def_color          (MateScores *gs,
                                                             GdkColor *col);
    void                mate_scores_set_colors             (MateScores *gs,
                                                             GdkColor *col);
    void                mate_scores_set_logo_label_title   (MateScores *gs,
                                                             const gchar *txt);
    void                mate_scores_set_current_player     (MateScores *gs,
                                                             gint i);

## Object Hierarchy

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

## Implemented Interfaces

MateScores implements AtkImplementorIface and GtkBuildable.

## Description

## Details

### struct MateScores

    struct MateScores;

### Warning

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

### mate_scores_display_with_pixmap ()

    GtkWidget *         mate_scores_display_with_pixmap    (const gchar *pixmap_logo,
                                                             const gchar *app_name,
                                                             const gchar *level,
                                                             int pos);

### Warning

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

Does all the work of displaying the best scores. It calls mate_score_get_notables to retrieve the info, creates the window, and show it.

`pixmap_logo` : | Filename of a logo pixmap to display
`app_name` : | Name of the application, as in mate_score_init.
`level` : | Level of the game or `NULL`.
`pos` : | Position in the top ten of the current player, as returned by mate_score_log.
Returns : | If a dialog is displayed return it's pointer. It can also be `NULL` if no dialog is displayed

### mate_scores_new ()

    GtkWidget *         mate_scores_new                    (guint n_scores,
                                                             gchar **names,
                                                             gfloat *scores,
                                                             time_t *times,
                                                             gboolean clear);

### Warning

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

Creates the high-scores window.

`n_scores` : | Number of positions.
`names` : | Names of the players.
`scores` : | Scores
`times` : | Time in which the scores were done
`clear` : | Add a "Clear" Button?
Returns : | A new MateScores widget

### mate_scores_construct ()

    void                mate_scores_construct              (MateScores *gs,
                                                             guint n_scores,
                                                             gchar **names,
                                                             gfloat *scores,
                                                             time_t *times,
                                                             gboolean clear);

### Warning

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

useful for language bindings and subclassing, not to be used by itself, see mate_scores_new.

`n_scores` : | Number of positions.
`names` : | Names of the players.
`scores` : | Scores
`times` : | Time in which the scores were done
`clear` : | Add a "Clear" Button?

### mate_scores_set_logo_label ()

    void                mate_scores_set_logo_label         (MateScores *gs,
                                                             const gchar *txt,
                                                             const gchar *font,
                                                             GdkColor *col);

### Warning

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

Creates a label to be the logo

`gs` : | A MateScores widget
`txt` : | Text in the label.
`font` : | Font to use in the label.
`col` : | Color to use in the label.

### mate_scores_set_logo_pixmap ()

    void                mate_scores_set_logo_pixmap        (MateScores *gs,
                                                             const gchar *pix_name);

### Warning

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

Sets the logo on the scores dialog box to a pixmap

`gs` : | A MateScores widget
`pix_name` : | filename of a pixmap

### mate_scores_set_logo_widget ()

    void                mate_scores_set_logo_widget        (MateScores *gs,
                                                             GtkWidget *w);

### Warning

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

Set an arbitrary widget to be the logo.

`gs` : | A MateScores widget
`w` : | Widget to be used as logo.

### mate_scores_set_color ()

    void                mate_scores_set_color              (MateScores *gs,
                                                             guint n,
                                                             GdkColor *col);

### Warning

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

Set the color of one entry.

`gs` : | A MateScores widget
`n` : | Entry to be changed.
`col` : | Color.

### mate_scores_set_def_color ()

    void                mate_scores_set_def_color          (MateScores *gs,
                                                             GdkColor *col);

### Warning

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

Set the default color of the entries.

`gs` : | A MateScores widget
`col` : | Color

### mate_scores_set_colors ()

    void                mate_scores_set_colors             (MateScores *gs,
                                                             GdkColor *col);

### Warning

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

Set the color of all the entries.

`gs` : | A MateScores widget
`col` : | Array of colors.

### mate_scores_set_logo_label_title ()

    void                mate_scores_set_logo_label_title   (MateScores *gs,
                                                             const gchar *txt);

### Warning

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

Creates a label to be the logo

`gs` : | A MateScores widget
`txt` : | Name of the logo.

### mate_scores_set_current_player ()

    void                mate_scores_set_current_player     (MateScores *gs,
                                                             gint i);

### Warning

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

Set the index of the current player in top ten.

`gs` : | A MateScores widget
`i` : | Index of the current(from 0 to 9).