Gtk Utilities

Files
file	gnc-gtk-utils.h
	gtk helper routines.

gtk Miscellaneous Functions
void	gnc_cbwe_set_by_string (GtkComboBox *cbwe, const gchar *text)
void	gnc_cbwe_add_completion (GtkComboBox *cbwe)
void	gnc_cbwe_require_list_item (GtkComboBox *cbwe)

Detailed Description

The API in this file is designed to provide support functions that wrap the base gtk functions and make them easier to use.

Function Documentation

void gnc_cbwe_set_by_string	(	GtkComboBox *	cbwe,
		const gchar *	text
	)

Find an entry in the GtkComboBox by its text value, and set the widget to that value. This function also records the index of that text value for use when the user leaves the widget.

Parameters

cbwe	A pointer to a GtkComboBox with entry widget.
text	The entry text to find in the model of the combo box entry.

Definition at line 41 of file gnc-gtk-utils.c.

{
    GtkTreeModel *model;
    GtkTreeIter iter;
    gchar *tree_string;
    gint column, index, id;
    gboolean match;

    model = gtk_combo_box_get_model(GTK_COMBO_BOX(cbwe));
    if (!gtk_tree_model_get_iter_first(model, &iter))
    {
        /* empty tree */
        gtk_combo_box_set_active(GTK_COMBO_BOX(cbwe), -1);
        return;
    }

    column = gtk_combo_box_get_entry_text_column(cbwe);
    do
    {
        gtk_tree_model_get(model, &iter, column, &tree_string, -1);
        match = g_utf8_collate(text, tree_string) == 0;
        g_free(tree_string);
        if (!match)
            continue;

        /* Found a matching string */
        id = GPOINTER_TO_INT(g_object_get_data(G_OBJECT(cbwe), CHANGED_ID));
        g_signal_handler_block(cbwe, id);
        gtk_combo_box_set_active_iter(GTK_COMBO_BOX(cbwe), &iter);
        g_signal_handler_unblock(cbwe, id);

        index = gtk_combo_box_get_active(GTK_COMBO_BOX(cbwe));
        g_object_set_data(G_OBJECT(cbwe), LAST_INDEX, GINT_TO_POINTER(index));
        return;
    }
    while (gtk_tree_model_iter_next(model, &iter));
}