GnomeDbSelectorPart

GnomeDbSelectorPart

Synopsis

                    GnomeDbSelectorPart;
void                gnome_db_selector_part_set_name     (GnomeDbSelectorPart *part,
                                                         const gchar *name);
const gchar *       gnome_db_selector_part_get_name     (GnomeDbSelectorPart *part);
void                gnome_db_selector_part_set_parent_part
                                                        (GnomeDbSelectorPart *part,
                                                         GnomeDbSelectorPart *parent_part);
GnomeDbSelectorPart * gnome_db_selector_part_get_parent_part
                                                        (GnomeDbSelectorPart *part);
GdkPixbuf *         gnome_db_selector_part_get_pixbuf   (GnomeDbSelectorPart *part);
void                gnome_db_selector_part_fill_tree_store
                                                        (GnomeDbSelectorPart *part,
                                                         GtkTreeStore *store,
                                                         GtkTreeIter *parent);
GdaSet *            gnome_db_selector_part_get_params   (GnomeDbSelectorPart *part,
                                                         GtkTreeStore *store,
                                                         GtkTreeIter *at_iter);
GdaSet *            gnome_db_selector_part_get_data     (GnomeDbSelectorPart *part,
                                                         GtkTreeStore *store,
                                                         GtkTreeIter *at_iter);
const GValue *      gnome_db_selector_part_get_value    (GnomeDbSelectorPart *part,
                                                         const gchar *id,
                                                         GtkTreeStore *store,
                                                         GtkTreeIter *at_iter);

enum                GnomeDbSelectorPartFillMode;
void                gnome_db_selector_part_obtain_new_store_row
                                                        (GnomeDbSelectorPart *part,
                                                         GnomeDbSelectorPartFillMode *in_out_mode,
                                                         GtkTreeStore *store,
                                                         GtkTreeIter *iter,
                                                         GtkTreeIter *parent_iter);

Object Hierarchy

  GInterface
   +----GnomeDbSelectorPart

Prerequisites

GnomeDbSelectorPart requires GObject.

Known Implementations

GnomeDbSelectorPart is implemented by GnomeDbSelectorSchema, GnomeDbSelectorView, GnomeDbSelectorMeta and GnomeDbSelectorTable.

Description

Details

GnomeDbSelectorPart

typedef struct _GnomeDbSelectorPart GnomeDbSelectorPart;


gnome_db_selector_part_set_name ()

void                gnome_db_selector_part_set_name     (GnomeDbSelectorPart *part,
                                                         const gchar *name);

Set part's name to make it easy to identify

part :

a GnomeDbSelectorPart object

name :

a name for part

gnome_db_selector_part_get_name ()

const gchar *       gnome_db_selector_part_get_name     (GnomeDbSelectorPart *part);

Retreive part's name.

part :

a GnomeDbSelectorPart object

Returns :

part's name

gnome_db_selector_part_set_parent_part ()

void                gnome_db_selector_part_set_parent_part
                                                        (GnomeDbSelectorPart *part,
                                                         GnomeDbSelectorPart *parent_part);

Declares to part that its part parent is parent_part

part :

a GnomeDbSelectorPart object

parent_part :

a GnomeDbSelectorPart object, or NULL

gnome_db_selector_part_get_parent_part ()

GnomeDbSelectorPart * gnome_db_selector_part_get_parent_part
                                                        (GnomeDbSelectorPart *part);

Get the parent of part.

part :

GnomeDbSelectorPart object

Returns :

the parent part, or NULL if there is none

gnome_db_selector_part_get_pixbuf ()

GdkPixbuf *         gnome_db_selector_part_get_pixbuf   (GnomeDbSelectorPart *part);

Get the preferred pixbug to be used when representing part

part :

GnomeDbSelectorPart object

Returns :

a new GdkPixbuf (or NULL). The caller must call g_object_unref() on it when finished

gnome_db_selector_part_fill_tree_store ()

void                gnome_db_selector_part_fill_tree_store
                                                        (GnomeDbSelectorPart *part,
                                                         GtkTreeStore *store,
                                                         GtkTreeIter *parent);

Make part populate (or refresh) the contents of store, under the parent node

part :

a GnomeDbSelectorPart object.

store :

a GtkTreeStore

parent :


gnome_db_selector_part_get_params ()

GdaSet *            gnome_db_selector_part_get_params   (GnomeDbSelectorPart *part,
                                                         GtkTreeStore *store,
                                                         GtkTreeIter *at_iter);

The caller does not own the returned GdaSet.

part :

a GnomeDbSelectorPart object

store :

a GtkTreeStore, or NULL

at_iter :

a GtkTreeIter, or NULL

Returns :


gnome_db_selector_part_get_data ()

GdaSet *            gnome_db_selector_part_get_data     (GnomeDbSelectorPart *part,
                                                         GtkTreeStore *store,
                                                         GtkTreeIter *at_iter);

The caller does not own the returned GdaSet.

part :

a GnomeDbSelectorPart object

store :

a GtkTreeStore, or NULL

at_iter :

a GtkTreeIter, or NULL

Returns :


gnome_db_selector_part_get_value ()

const GValue *      gnome_db_selector_part_get_value    (GnomeDbSelectorPart *part,
                                                         const gchar *id,
                                                         GtkTreeStore *store,
                                                         GtkTreeIter *at_iter);

Looks for a value which id is id in part (also looks in its parent hierarchy)

part :

a GnomeDbSelectorPart object

id :

the ID of the requested value

store :

a GtkTreeStore, or NULL

at_iter :

a GtkTreeIter, or NULL

Returns :

the (non modifiable) GValue, or NULL if not found

enum GnomeDbSelectorPartFillMode

typedef enum {
	GNOME_DB_SELECTOR_PART_FILL_MODE_FIRST_FILL,
	GNOME_DB_SELECTOR_PART_FILL_MODE_OVW_FIRST,
	GNOME_DB_SELECTOR_PART_FILL_MODE_OVW_NEXT
} GnomeDbSelectorPartFillMode;


gnome_db_selector_part_obtain_new_store_row ()

void                gnome_db_selector_part_obtain_new_store_row
                                                        (GnomeDbSelectorPart *part,
                                                         GnomeDbSelectorPartFillMode *in_out_mode,
                                                         GtkTreeStore *store,
                                                         GtkTreeIter *iter,
                                                         GtkTreeIter *parent_iter);

Reserved for GnomeDbSelectorPart implementations

part :

in_out_mode :

store :

iter :

parent_iter :