GnomeScores

GnomeScores —

Synopsis


#include <libgnomeui/libgnomeui.h>


struct      GnomeScores;
GtkWidget*  gnome_scores_display_with_pixmap
                                            (const gchar *pixmap_logo,
                                             const gchar *app_name,
                                             const gchar *level,
                                             int pos);
GtkWidget*  gnome_scores_new                (guint n_scores,
                                             gchar **names,
                                             gfloat *scores,
                                             time_t *times,
                                             gboolean clear);
void        gnome_scores_construct          (GnomeScores *gs,
                                             guint n_scores,
                                             gchar **names,
                                             gfloat *scores,
                                             time_t *times,
                                             gboolean clear);
void        gnome_scores_set_logo_label     (GnomeScores *gs,
                                             const gchar *txt,
                                             const gchar *font,
                                             GdkColor *col);
void        gnome_scores_set_logo_pixmap    (GnomeScores *gs,
                                             const gchar *pix_name);
void        gnome_scores_set_logo_widget    (GnomeScores *gs,
                                             GtkWidget *w);
void        gnome_scores_set_color          (GnomeScores *gs,
                                             guint n,
                                             GdkColor *col);
void        gnome_scores_set_def_color      (GnomeScores *gs,
                                             GdkColor *col);
void        gnome_scores_set_colors         (GnomeScores *gs,
                                             GdkColor *col);
void        gnome_scores_set_logo_label_title
                                            (GnomeScores *gs,
                                             const gchar *txt);
void        gnome_scores_set_current_player (GnomeScores *gs,
                                             gint i);


Object Hierarchy


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

Implemented Interfaces

GnomeScores implements AtkImplementorIface.

Description

Details

struct GnomeScores

struct GnomeScores;


gnome_scores_display_with_pixmap ()

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

Does all the work of displaying the best scores. It calls gnome_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 gnome_score_init.
level : Level of the game or NULL.
pos : Position in the top ten of the current player, as returned by gnome_score_log.
Returns : If a dialog is displayed return it's pointer. It can also be NULL if no dialog is displayed

gnome_scores_new ()

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

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 GnomeScores widget

gnome_scores_construct ()

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

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

gs :
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?

gnome_scores_set_logo_label ()

void        gnome_scores_set_logo_label     (GnomeScores *gs,
                                             const gchar *txt,
                                             const gchar *font,
                                             GdkColor *col);

Creates a label to be the logo

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

gnome_scores_set_logo_pixmap ()

void        gnome_scores_set_logo_pixmap    (GnomeScores *gs,
                                             const gchar *pix_name);

Sets the logo on the scores dialog box to a pixmap

gs : A GnomeScores widget
pix_name : filename of a pixmap

gnome_scores_set_logo_widget ()

void        gnome_scores_set_logo_widget    (GnomeScores *gs,
                                             GtkWidget *w);

Set an arbitrary widget to be the logo.

gs : A GnomeScores widget
w : Widget to be used as logo.

gnome_scores_set_color ()

void        gnome_scores_set_color          (GnomeScores *gs,
                                             guint n,
                                             GdkColor *col);

Set the color of one entry.

gs : A GnomeScores widget
n : Entry to be changed.
col : Color.

gnome_scores_set_def_color ()

void        gnome_scores_set_def_color      (GnomeScores *gs,
                                             GdkColor *col);

Set the default color of the entries.

gs : A GnomeScores widget
col : Color

gnome_scores_set_colors ()

void        gnome_scores_set_colors         (GnomeScores *gs,
                                             GdkColor *col);

Set the color of all the entries.

gs : A GnomeScores widget
col : Array of colors.

gnome_scores_set_logo_label_title ()

void        gnome_scores_set_logo_label_title
                                            (GnomeScores *gs,
                                             const gchar *txt);

Creates a label to be the logo

gs : A GnomeScores widget
txt : Name of the logo.

gnome_scores_set_current_player ()

void        gnome_scores_set_current_player (GnomeScores *gs,
                                             gint i);

Set the index of the current player in top ten.

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