diff options
Diffstat (limited to 'gsearchtool/libmateui-deprecated')
-rw-r--r-- | gsearchtool/libmateui-deprecated/Makefile.am | 12 | ||||
-rw-r--r-- | gsearchtool/libmateui-deprecated/README | 9 | ||||
-rw-r--r-- | gsearchtool/libmateui-deprecated/gsearchtool-entry.c | 625 | ||||
-rw-r--r-- | gsearchtool/libmateui-deprecated/gsearchtool-entry.h | 80 |
4 files changed, 726 insertions, 0 deletions
diff --git a/gsearchtool/libmateui-deprecated/Makefile.am b/gsearchtool/libmateui-deprecated/Makefile.am new file mode 100644 index 00000000..7a01c3c9 --- /dev/null +++ b/gsearchtool/libmateui-deprecated/Makefile.am @@ -0,0 +1,12 @@ +INCLUDES = -DGTK_DISABLE_DEPRECATED \ + -DGDK_DISABLE_DEPRECATED \ + -DG_DISABLE_DEPRECATED + + +noinst_LTLIBRARIES = libmateui-deprecated.la + +libmateui_deprecated_la_LIBADD = $(MATE_UTILS_LIBS) +libmateui_deprecated_la_CFLAGS = $(MATE_UTILS_CFLAGS) \ + $(WARN_CFLAGS) +libmateui_deprecated_la_SOURCES = gsearchtool-entry.h \ + gsearchtool-entry.c diff --git a/gsearchtool/libmateui-deprecated/README b/gsearchtool/libmateui-deprecated/README new file mode 100644 index 00000000..5f9a7f76 --- /dev/null +++ b/gsearchtool/libmateui-deprecated/README @@ -0,0 +1,9 @@ +MATE-Entry in the libmateui library will be removed from the MATE +software stack [1]. At this time, a replacement for the MATE Entry +widget has not been added to GTK+. The code in this directory +is based on a widget from the gedit source code. + +The bugzilla report at bugs.mate.org is #161483, "gtk-combo-box-entry +missing a history feature". + +[1] http://live.mate.org/LibmateMustDie diff --git a/gsearchtool/libmateui-deprecated/gsearchtool-entry.c b/gsearchtool/libmateui-deprecated/gsearchtool-entry.c new file mode 100644 index 00000000..7222c38f --- /dev/null +++ b/gsearchtool/libmateui-deprecated/gsearchtool-entry.c @@ -0,0 +1,625 @@ +/* + * gsearchtool-entry.c + * + * This file was modified from gedit (gedit-history-entry.c). + * + * Copyright (C) 2009 - Dennis Cranston + * Copyright (C) 2006 - Paolo Borelli + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, + * Boston, MA 02111-1307, USA. + * + * Author: Paolo Borelli (gedit-history-entry.c) + * + * Gsearchtool port by Dennis Cranston <[email protected]> + * + */ + +#ifdef HAVE_CONFIG_H +#include <config.h> +#endif + +#include <string.h> +#include <glib/gi18n.h> +#include <gtk/gtk.h> +#include <mateconf/mateconf-client.h> + +#include "gsearchtool-entry.h" + +enum { + PROP_0, + PROP_HISTORY_ID, + PROP_HISTORY_LENGTH +}; + +#define MIN_ITEM_LEN 0 +#define GSEARCH_HISTORY_ENTRY_HISTORY_LENGTH_DEFAULT 10 +#define GSEARCH_HISTORY_ENTRY_GET_PRIVATE(object)(G_TYPE_INSTANCE_GET_PRIVATE ((object), \ + GSEARCH_TYPE_HISTORY_ENTRY, \ + GsearchHistoryEntryPrivate)) + +struct _GsearchHistoryEntryPrivate +{ + gchar *history_id; + guint history_length; + + GtkEntryCompletion *completion; + + MateConfClient *mateconf_client; +}; + +G_DEFINE_TYPE (GsearchHistoryEntry, gsearch_history_entry, GTK_TYPE_COMBO_BOX) + +static void +gsearch_history_entry_set_property (GObject *object, + guint prop_id, + const GValue *value, + GParamSpec *spec) +{ + GsearchHistoryEntry *entry; + + g_return_if_fail (GSEARCH_IS_HISTORY_ENTRY (object)); + + entry = GSEARCH_HISTORY_ENTRY (object); + + switch (prop_id) { + case PROP_HISTORY_ID: + entry->priv->history_id = g_value_dup_string (value); + break; + case PROP_HISTORY_LENGTH: + gsearch_history_entry_set_history_length (entry, + g_value_get_uint (value)); + break; + default: + break; + } +} + +static void +gsearch_history_entry_get_property (GObject *object, + guint prop_id, + GValue *value, + GParamSpec *spec) +{ + GsearchHistoryEntryPrivate *priv; + + g_return_if_fail (GSEARCH_IS_HISTORY_ENTRY (object)); + + priv = GSEARCH_HISTORY_ENTRY (object)->priv; + + switch (prop_id) { + case PROP_HISTORY_ID: + g_value_set_string (value, priv->history_id); + break; + case PROP_HISTORY_LENGTH: + g_value_set_uint (value, priv->history_length); + break; + default: + G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, spec); + } +} + +static void +gsearch_history_entry_destroy (GtkObject *object) +{ + gsearch_history_entry_set_enable_completion (GSEARCH_HISTORY_ENTRY (object), + FALSE); + + GTK_OBJECT_CLASS (gsearch_history_entry_parent_class)->destroy (object); +} + +static void +gsearch_history_entry_finalize (GObject *object) +{ + GsearchHistoryEntryPrivate *priv; + + priv = GSEARCH_HISTORY_ENTRY (object)->priv; + + g_free (priv->history_id); + + if (priv->mateconf_client != NULL) + { + g_object_unref (G_OBJECT (priv->mateconf_client)); + priv->mateconf_client = NULL; + } + + G_OBJECT_CLASS (gsearch_history_entry_parent_class)->finalize (object); +} + +static void +gsearch_history_entry_class_init (GsearchHistoryEntryClass *klass) +{ + GObjectClass *object_class = G_OBJECT_CLASS (klass); + GtkObjectClass *gtkobject_class = GTK_OBJECT_CLASS (klass); + + object_class->set_property = gsearch_history_entry_set_property; + object_class->get_property = gsearch_history_entry_get_property; + object_class->finalize = gsearch_history_entry_finalize; + gtkobject_class->destroy = gsearch_history_entry_destroy; + + g_object_class_install_property (object_class, + PROP_HISTORY_ID, + g_param_spec_string ("history-id", + "History ID", + "History ID", + NULL, + G_PARAM_READWRITE | + G_PARAM_STATIC_STRINGS)); + + g_object_class_install_property (object_class, + PROP_HISTORY_LENGTH, + g_param_spec_uint ("history-length", + "Max History Length", + "Max History Length", + 0, + G_MAXUINT, + GSEARCH_HISTORY_ENTRY_HISTORY_LENGTH_DEFAULT, + G_PARAM_READWRITE | + G_PARAM_STATIC_STRINGS)); + + /* TODO: Add enable-completion property */ + + g_type_class_add_private (object_class, sizeof(GsearchHistoryEntryPrivate)); +} + +static GtkListStore * +get_history_store (GsearchHistoryEntry *entry) +{ + GtkTreeModel *store; + + store = gtk_combo_box_get_model (GTK_COMBO_BOX (entry)); + g_return_val_if_fail (GTK_IS_LIST_STORE (store), NULL); + + return (GtkListStore *) store; +} + +static char * +get_history_key (GsearchHistoryEntry *entry) +{ + gchar *tmp; + gchar *key; + + /* + * Store the data under /apps/mate-settings/ + * like the old MateEntry did + */ + + tmp = mateconf_escape_key (entry->priv->history_id, -1); + key = g_strconcat ("/apps/mate-settings/", + "mate-search-tool", + "/history-", + tmp, + NULL); + g_free (tmp); + + return key; +} + +static GSList * +get_history_list (GsearchHistoryEntry *entry) +{ + GtkListStore *store; + GtkTreeIter iter; + gboolean valid; + GSList *list = NULL; + + store = get_history_store (entry); + + valid = gtk_tree_model_get_iter_first (GTK_TREE_MODEL (store), + &iter); + + while (valid) + { + gchar *str; + + gtk_tree_model_get (GTK_TREE_MODEL (store), + &iter, + 0, &str, + -1); + + list = g_slist_prepend (list, str); + + valid = gtk_tree_model_iter_next (GTK_TREE_MODEL (store), + &iter); + } + + return g_slist_reverse (list); +} + +static void +gsearch_history_entry_save_history (GsearchHistoryEntry *entry) +{ + GSList *mateconf_items; + gchar *key; + + g_return_if_fail (GSEARCH_IS_HISTORY_ENTRY (entry)); + + mateconf_items = get_history_list (entry); + key = get_history_key (entry); + + mateconf_client_set_list (entry->priv->mateconf_client, + key, + MATECONF_VALUE_STRING, + mateconf_items, + NULL); + + g_slist_foreach (mateconf_items, (GFunc) g_free, NULL); + g_slist_free (mateconf_items); + g_free (key); +} + +static gboolean +remove_item (GtkListStore *store, + const gchar *text) +{ + GtkTreeIter iter; + + g_return_val_if_fail (text != NULL, FALSE); + + if (!gtk_tree_model_get_iter_first (GTK_TREE_MODEL (store), &iter)) + return FALSE; + + do + { + gchar *item_text; + + gtk_tree_model_get (GTK_TREE_MODEL (store), + &iter, + 0, + &item_text, + -1); + + if (item_text != NULL && + strcmp (item_text, text) == 0) + { + gtk_list_store_remove (store, &iter); + g_free (item_text); + return TRUE; + } + + g_free (item_text); + + } while (gtk_tree_model_iter_next (GTK_TREE_MODEL (store), &iter)); + + return FALSE; +} + +static void +clamp_list_store (GtkListStore *store, + guint max) +{ + GtkTreePath *path; + GtkTreeIter iter; + + /* -1 because TreePath counts from 0 */ + path = gtk_tree_path_new_from_indices (max - 1, -1); + + if (gtk_tree_model_get_iter (GTK_TREE_MODEL (store), &iter, path)) + { + while (1) + { + if (!gtk_list_store_remove (store, &iter)) + break; + } + } + + gtk_tree_path_free (path); +} + +static void +insert_history_item (GsearchHistoryEntry *entry, + const gchar *text, + gboolean prepend) +{ + GtkListStore *store; + GtkTreeIter iter; + + if (g_utf8_strlen (text, -1) <= MIN_ITEM_LEN) + return; + + store = get_history_store (entry); + + /* remove the text from the store if it was already + * present. If it wasn't, clamp to max history - 1 + * before inserting the new row, otherwise appending + * would not work */ + + if (!remove_item (store, text)) + clamp_list_store (store, + entry->priv->history_length - 1); + + if (prepend) + gtk_list_store_insert (store, &iter, 0); + else + gtk_list_store_append (store, &iter); + + gtk_list_store_set (store, + &iter, + 0, + text, + -1); + + gsearch_history_entry_save_history (entry); +} + +void +gsearch_history_entry_prepend_text (GsearchHistoryEntry *entry, + const gchar *text) +{ + g_return_if_fail (GSEARCH_IS_HISTORY_ENTRY (entry)); + g_return_if_fail (text != NULL); + + insert_history_item (entry, text, TRUE); +} + +void +gsearch_history_entry_append_text (GsearchHistoryEntry *entry, + const gchar *text) +{ + g_return_if_fail (GSEARCH_IS_HISTORY_ENTRY (entry)); + g_return_if_fail (text != NULL); + + insert_history_item (entry, text, FALSE); +} + +static void +gsearch_history_entry_load_history (GsearchHistoryEntry *entry) +{ + GSList *mateconf_items, *l; + GtkListStore *store; + GtkTreeIter iter; + gchar *key; + gint i; + + g_return_if_fail (GSEARCH_IS_HISTORY_ENTRY (entry)); + + store = get_history_store (entry); + key = get_history_key (entry); + + mateconf_items = mateconf_client_get_list (entry->priv->mateconf_client, + key, + MATECONF_VALUE_STRING, + NULL); + + gtk_list_store_clear (store); + + for (l = mateconf_items, i = 0; + l != NULL && i < entry->priv->history_length; + l = l->next, i++) + { + gtk_list_store_append (store, &iter); + gtk_list_store_set (store, + &iter, + 0, + l->data, + -1); + } + + g_slist_foreach (mateconf_items, (GFunc) g_free, NULL); + g_slist_free (mateconf_items); + g_free (key); +} + +void +gsearch_history_entry_clear (GsearchHistoryEntry *entry) +{ + GtkListStore *store; + + g_return_if_fail (GSEARCH_IS_HISTORY_ENTRY (entry)); + + store = get_history_store (entry); + gtk_list_store_clear (store); + + gsearch_history_entry_save_history (entry); +} + +static void +gsearch_history_entry_init (GsearchHistoryEntry *entry) +{ + GsearchHistoryEntryPrivate *priv; + + priv = GSEARCH_HISTORY_ENTRY_GET_PRIVATE (entry); + entry->priv = priv; + + priv->history_id = NULL; + priv->history_length = GSEARCH_HISTORY_ENTRY_HISTORY_LENGTH_DEFAULT; + + priv->completion = NULL; + + priv->mateconf_client = mateconf_client_get_default (); +} + +void +gsearch_history_entry_set_history_length (GsearchHistoryEntry *entry, + guint history_length) +{ + g_return_if_fail (GSEARCH_IS_HISTORY_ENTRY (entry)); + g_return_if_fail (history_length > 0); + + entry->priv->history_length = history_length; + + /* TODO: update if we currently have more items than max */ +} + +guint +gsearch_history_entry_get_history_length (GsearchHistoryEntry *entry) +{ + g_return_val_if_fail (GSEARCH_IS_HISTORY_ENTRY (entry), 0); + + return entry->priv->history_length; +} + +gchar * +gsearch_history_entry_get_history_id (GsearchHistoryEntry *entry) +{ + g_return_val_if_fail (GSEARCH_IS_HISTORY_ENTRY (entry), NULL); + + return g_strdup (entry->priv->history_id); +} + +void +gsearch_history_entry_set_enable_completion (GsearchHistoryEntry *entry, + gboolean enable) +{ + g_return_if_fail (GSEARCH_IS_HISTORY_ENTRY (entry)); + + if (enable) + { + if (entry->priv->completion != NULL) + return; + + entry->priv->completion = gtk_entry_completion_new (); + gtk_entry_completion_set_model (entry->priv->completion, + GTK_TREE_MODEL (get_history_store (entry))); + + /* Use model column 0 as the text column */ + gtk_entry_completion_set_text_column (entry->priv->completion, 0); + + gtk_entry_completion_set_minimum_key_length (entry->priv->completion, + MIN_ITEM_LEN); + + gtk_entry_completion_set_popup_completion (entry->priv->completion, FALSE); + gtk_entry_completion_set_inline_completion (entry->priv->completion, TRUE); + + /* Assign the completion to the entry */ + gtk_entry_set_completion (GTK_ENTRY (gsearch_history_entry_get_entry(entry)), + entry->priv->completion); + } + else + { + if (entry->priv->completion == NULL) + return; + + gtk_entry_set_completion (GTK_ENTRY (gsearch_history_entry_get_entry (entry)), + NULL); + + g_object_unref (entry->priv->completion); + + entry->priv->completion = NULL; + } +} + +gboolean +gsearch_history_entry_get_enable_completion (GsearchHistoryEntry *entry) +{ + g_return_val_if_fail (GSEARCH_IS_HISTORY_ENTRY (entry), FALSE); + + return entry->priv->completion != NULL; +} + +GtkWidget* gsearch_history_entry_new(const gchar *history_id, gboolean enable_completion) +{ + GtkWidget* ret; + GtkListStore* store; + + g_return_val_if_fail(history_id != NULL, NULL); + + /* Note that we are setting the model, so + * user must be careful to always manipulate + * data in the history through gsearch_history_entry_ + * functions. + */ + + store = gtk_list_store_new(1, G_TYPE_STRING); + + ret = g_object_new(GSEARCH_TYPE_HISTORY_ENTRY, + "history-id", history_id, + "model", store, + "has-entry", TRUE, + NULL); + + g_object_unref (store); + + /* loading has to happen after the model + * has been set. However the model is not a + * G_PARAM_CONSTRUCT property of GtkComboBox + * so we cannot do this in the constructor. + * For now we simply do here since this widget is + * not bound to other programming languages. + * A maybe better alternative is to override the + * model property of combobox and mark CONTRUCT_ONLY. + * This would also ensure that the model cannot be + * set explicitely at a later time. + */ + gsearch_history_entry_load_history (GSEARCH_HISTORY_ENTRY (ret)); + + gsearch_history_entry_set_enable_completion (GSEARCH_HISTORY_ENTRY (ret), + enable_completion); + + return ret; +} + +/* + * Utility function to get the editable text entry internal widget. + * I would prefer to not expose this implementation detail and + * simply make the GsearchHistoryEntry widget implement the + * GtkEditable interface. Unfortunately both GtkEditable and + * GtkComboBox have a "changed" signal and I am not sure how to + * handle the conflict. + */ +GtkWidget * +gsearch_history_entry_get_entry (GsearchHistoryEntry *entry) +{ + g_return_val_if_fail (GSEARCH_IS_HISTORY_ENTRY (entry), NULL); + + return gtk_bin_get_child (GTK_BIN (entry)); +} + +static void +escape_cell_data_func (GtkTreeViewColumn *col, + GtkCellRenderer *renderer, + GtkTreeModel *model, + GtkTreeIter *iter, + GsearchHistoryEntryEscapeFunc escape_func) +{ + gchar *str; + gchar *escaped; + + gtk_tree_model_get (model, iter, 0, &str, -1); + escaped = escape_func (str); + g_object_set (renderer, "text", escaped, NULL); + + g_free (str); + g_free (escaped); +} + +void +gsearch_history_entry_set_escape_func (GsearchHistoryEntry *entry, + GsearchHistoryEntryEscapeFunc escape_func) +{ + GList *cells; + + g_return_if_fail (GSEARCH_IS_HISTORY_ENTRY (entry)); + + cells = gtk_cell_layout_get_cells (GTK_CELL_LAYOUT (entry)); + + /* We only have one cell renderer */ + g_return_if_fail (cells->data != NULL && cells->next == NULL); + + if (escape_func != NULL) + gtk_cell_layout_set_cell_data_func (GTK_CELL_LAYOUT (entry), + GTK_CELL_RENDERER (cells->data), + (GtkCellLayoutDataFunc) escape_cell_data_func, + escape_func, + NULL); + else + gtk_cell_layout_set_cell_data_func (GTK_CELL_LAYOUT (entry), + GTK_CELL_RENDERER (cells->data), + NULL, + NULL, + NULL); + + g_list_free (cells); +} diff --git a/gsearchtool/libmateui-deprecated/gsearchtool-entry.h b/gsearchtool/libmateui-deprecated/gsearchtool-entry.h new file mode 100644 index 00000000..c67640ac --- /dev/null +++ b/gsearchtool/libmateui-deprecated/gsearchtool-entry.h @@ -0,0 +1,80 @@ +/* + * gsearchtool-entry.h + * + * This file was modified from gedit (gedit-history-entry.h). + * + * Copyright (C) 2009 - Dennis Cranston + * Copyright (C) 2006 - Paolo Borelli + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, + * Boston, MA 02111-1307, USA. + * + * Author: Paolo Borelli (gedit-history-entry.h) + * + * Gsearchtool port by Dennis Cranston <[email protected]> + * + */ + +#ifndef __GSEARCH_HISTORY_ENTRY_H__ +#define __GSEARCH_HISTORY_ENTRY_H__ + + +G_BEGIN_DECLS + +#define GSEARCH_TYPE_HISTORY_ENTRY (gsearch_history_entry_get_type()) +#define GSEARCH_HISTORY_ENTRY(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), GSEARCH_TYPE_HISTORY_ENTRY, GsearchHistoryEntry)) +#define GSEARCH_HISTORY_ENTRY_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), GSEARCH_TYPE_HISTORY_ENTRY, GsearchHistoryEntryClass)) +#define GSEARCH_IS_HISTORY_ENTRY(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), GSEARCH_TYPE_HISTORY_ENTRY)) +#define GSEARCH_IS_HISTORY_ENTRY_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), GSEARCH_TYPE_HISTORY_ENTRY)) +#define GSEARCH_HISTORY_ENTRY_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), GSEARCH_TYPE_HISTORY_ENTRY, GsearchHistoryEntryClass)) + + +typedef struct _GsearchHistoryEntry GsearchHistoryEntry; +typedef struct _GsearchHistoryEntryClass GsearchHistoryEntryClass; +typedef struct _GsearchHistoryEntryPrivate GsearchHistoryEntryPrivate; + +struct _GsearchHistoryEntryClass { + GtkComboBoxClass parent_class; +}; + +struct _GsearchHistoryEntry { + GtkComboBox parent_instance; + GsearchHistoryEntryPrivate* priv; +}; + +GType gsearch_history_entry_get_type(void) G_GNUC_CONST; + +GtkWidget* gsearch_history_entry_new(const gchar* history_id, gboolean enable_completion); +void gsearch_history_entry_prepend_text(GsearchHistoryEntry* entry, const gchar* text); +void gsearch_history_entry_append_text(GsearchHistoryEntry* entry, const gchar* text); +void gsearch_history_entry_clear(GsearchHistoryEntry* entry); + +void gsearch_history_entry_set_history_length(GsearchHistoryEntry* entry, guint max_saved); +guint gsearch_history_entry_get_history_length(GsearchHistoryEntry* gentry); + +gchar* gsearch_history_entry_get_history_id(GsearchHistoryEntry* entry); + +void gsearch_history_entry_set_enable_completion(GsearchHistoryEntry* entry, gboolean enable); +gboolean gsearch_history_entry_get_enable_completion(GsearchHistoryEntry* entry); + +GtkWidget* gsearch_history_entry_get_entry(GsearchHistoryEntry* entry); + +typedef gchar* (*GsearchHistoryEntryEscapeFunc)(const gchar* str); + +void gsearch_history_entry_set_escape_func(GsearchHistoryEntry* entry, GsearchHistoryEntryEscapeFunc escape_func); + +G_END_DECLS + +#endif /* __GSEARCH_HISTORY_ENTRY_H__ */ |