gel-ui-utils

gel-ui-utils

Synopsis

#define             GEL_UI_IMAGE_DEF_NONE
gboolean            gel_ui_builder_connect_signal_from_def
                                                        (GtkBuilder *ui,
                                                         GelSignalDef def,
                                                         gpointer data);
gboolean            gel_ui_builder_connect_signal_from_def_multiple
                                                        (GtkBuilder *ui,
                                                         GelSignalDef defs[],
                                                         guint n_entries,
                                                         gpointer data,
                                                         guint *count);
void                gel_ui_container_clear              (GtkContainer *container);
GtkWidget *         gel_ui_container_find_widget        (GtkContainer *container,
                                                         const gchar *name);
void                gel_ui_container_replace_children   (GtkContainer *container,
                                                         GtkWidget *widget);
gboolean            gel_ui_list_model_get_iter_from_index
                                                        (GtkListStore *model,
                                                         GtkTreeIter *iter,
                                                         gint index);
void                gel_ui_list_store_insert_at_index   (GtkListStore *model,
                                                         gint index,
                                                         ...);
void                gel_ui_list_store_remove_at_index   (GtkListStore *model,
                                                         gint index);
void                gel_ui_list_store_set_at_index      (GtkListStore *model,
                                                         gint index,
                                                         ...);
gboolean            gel_ui_load_image_from_def          (GtkBuilder *ui,
                                                         GelUIImageDef *def,
                                                         GError **error);
gboolean            gel_ui_load_image_from_def_multiple (GtkBuilder *ui,
                                                         GelUIImageDef defs[],
                                                         guint *count);
GdkPixbuf *         gel_ui_load_pixbuf_from_imagedef    (GelUIImageDef def,
                                                         GError **error);
GtkBuilder *        gel_ui_load_resource                (gchar *ui_filename,
                                                         GError **error);
GQuark              gel_ui_quark                        ();
gint *              gel_ui_tree_view_get_selected_indices
                                                        (GtkTreeView *tv);
void                gel_ui_widget_disable_drop          (GtkWidget *widget);
void                gel_ui_widget_enable_drop           (GtkWidget *widget,
                                                         GCallback callback,
                                                         gpointer user_data);

Description

Details

GEL_UI_IMAGE_DEF_NONE

#define GEL_UI_IMAGE_DEF_NONE { NULL, NULL, -1, -1 }

gel_ui_builder_connect_signal_from_def ()

gboolean            gel_ui_builder_connect_signal_from_def
                                                        (GtkBuilder *ui,
                                                         GelSignalDef def,
                                                         gpointer data);

gel_ui_builder_connect_signal_from_def_multiple ()

gboolean            gel_ui_builder_connect_signal_from_def_multiple
                                                        (GtkBuilder *ui,
                                                         GelSignalDef defs[],
                                                         guint n_entries,
                                                         gpointer data,
                                                         guint *count);

gel_ui_container_clear ()

void                gel_ui_container_clear              (GtkContainer *container);

Removes all children from container using gtk_container_remove()

container :

A GtkContainer

gel_ui_container_find_widget ()

GtkWidget *         gel_ui_container_find_widget        (GtkContainer *container,
                                                         const gchar *name);

Tries to find widget named name in container recursively. If it is not found NULL is returned. No references are added in this function.

container :

A GtkContainer

name :

Child name

Returns :

The widget. [transfer none][allow-none]

gel_ui_container_replace_children ()

void                gel_ui_container_replace_children   (GtkContainer *container,
                                                         GtkWidget *widget);

Removes all children from container using gel_ui_container_clear() and then packs widget into container

container :

A GtkContainer

widget :

A GtkWidget. [transfer full]

gel_ui_list_model_get_iter_from_index ()

gboolean            gel_ui_list_model_get_iter_from_index
                                                        (GtkListStore *model,
                                                         GtkTreeIter *iter,
                                                         gint index);

Fills iter with the GtkTreeIter associated with index index

model :

A GtkListStore

iter :

A GtkTreeIter. [out caller-allocates]

index :

An index to get the iter from

Returns :

TRUE if an iter is found, FALSE otherwise

gel_ui_list_store_insert_at_index ()

void                gel_ui_list_store_insert_at_index   (GtkListStore *model,
                                                         gint index,
                                                         ...);

Wrapper around gtk_list_store_insert()

model :

A GtkListStore

index :

Where to insert data

Varargs :

Data to insert

gel_ui_list_store_remove_at_index ()

void                gel_ui_list_store_remove_at_index   (GtkListStore *model,
                                                         gint index);

Wrapper around gtk_list_store_remove()

model :

A GtkListStore

index :

Where is data to remove

gel_ui_list_store_set_at_index ()

void                gel_ui_list_store_set_at_index      (GtkListStore *model,
                                                         gint index,
                                                         ...);

gel_ui_load_image_from_def ()

gboolean            gel_ui_load_image_from_def          (GtkBuilder *ui,
                                                         GelUIImageDef *def,
                                                         GError **error);

gel_ui_load_image_from_def_multiple ()

gboolean            gel_ui_load_image_from_def_multiple (GtkBuilder *ui,
                                                         GelUIImageDef defs[],
                                                         guint *count);

gel_ui_load_pixbuf_from_imagedef ()

GdkPixbuf *         gel_ui_load_pixbuf_from_imagedef    (GelUIImageDef def,
                                                         GError **error);

Loads image from def into a GdkPixbuf. Pathname of the image is resolved via gel_resource_locate(). If an error is ocurred error is filled with the error and NULL is returned.

def :

Image definition

error :

Location for GError or NULL

Returns :

The GdkPixbuf or NULL. [allow-none][transfer full]

gel_ui_load_resource ()

GtkBuilder *        gel_ui_load_resource                (gchar *ui_filename,
                                                         GError **error);

Searchs and loads in to a GtkBuilder the UI file named ui_filename. The file is located via gel_resource_locate() function and the same rules are applied here.

ui_filename :

Filename for the UI file

error :

Location for GError or NULL

Returns :

The GtkBuilder for ui_filename or NULL. [transfer full]

gel_ui_quark ()

GQuark              gel_ui_quark                        ();

gel_ui_tree_view_get_selected_indices ()

gint *              gel_ui_tree_view_get_selected_indices
                                                        (GtkTreeView *tv);

Returns a NULL terminated array of gint with the indices of selected rows, only works with a GtkTreeView holding a GtkListModel

tv :

A GtkTreeView

Returns :

The selected indices, each index and the value it self must be freeed with g_free. [allow-none][transfer full]

gel_ui_widget_disable_drop ()

void                gel_ui_widget_disable_drop          (GtkWidget *widget);

Disables DnD functions added by gel_ui_widget_enable_drop on widget

widget :

A GtkWidget

gel_ui_widget_enable_drop ()

void                gel_ui_widget_enable_drop           (GtkWidget *widget,
                                                         GCallback callback,
                                                         gpointer user_data);

This function automatizes some of the black magic of DnD on Gtk+.

widget :

A GtkWidget

callback :

A GCallback to be called on "drag-drop" or "drag-data-received" signals. [type gpointer]

user_data :

Data to pass to callback