![]() |
![]() |
![]() |
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_list_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
|