| GNOME Video Arcade Reference Manual | ||||
|---|---|---|---|---|
GvaGameStoreGvaGameStore — A GtkTreeModel that stores game information |
GvaGameStore;
GtkTreeModel* gva_game_store_new (void);
GtkTreeModel* gva_game_store_new_from_query (const gchar *sql,
GError **error);
void gva_game_store_clear (GvaGameStore *game_store);
void gva_game_store_index_insert (GvaGameStore *game_store,
const gchar *key,
GtkTreeIter *iter);
GtkTreePath* gva_game_store_index_lookup (GvaGameStore *game_store,
const gchar *key);
GvaGameStore implements GtkBuildable, GtkTreeModel, GtkTreeDragSource, GtkTreeDragDest and GtkTreeSortable.
typedef struct _GvaGameStore GvaGameStore;
Contains only private data that should be read and manipulated using the functions below.
GtkTreeModel* gva_game_store_new (void);
Creates a new GvaGameStore with pre-defined columns and settings.
Returns : |
a new GvaGameStore |
GtkTreeModel* gva_game_store_new_from_query (const gchar *sql, GError **error);
This may be the most powerful function in GNOME Video Arcade.
Creates a new GvaGameStore by executing the given SQL query on the games database and converting the results to tree model rows. The resulting GtkTreeModel can then be plugged into a GtkTreeView.
XXX Say more here.
|
an SQL query |
|
return locations for a GError, or NULL
|
Returns : |
a new GvaGameStore |
void gva_game_store_clear (GvaGameStore *game_store);
Removes all rows from game_store and clears the internal index.
|
a GvaGameStore |
void gva_game_store_index_insert (GvaGameStore *game_store, const gchar *key, GtkTreeIter *iter);
Adds an entry to game_store's internal index. You will want to call
this immediately after adding a new row to game_store, such as with
gtk_tree_store_append().
|
a GvaGameStore |
|
an index key |
|
a GtkTreeIter pointing to a row in game_store
|
GtkTreePath* gva_game_store_index_lookup (GvaGameStore *game_store, const gchar *key);
Looks up the row corresponding to key in game_store and returns a
GtkTreePath to it, or NULL if the row was not found.
|
a GvaGameStore |
|
an index key |
Returns : |
a GtkTreePath to the row corresponding to key, or NULL
|