/*
* Evolution internal utilities - Glade dialog widget utilities
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) version 3.
*
* 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with the program; if not, see
*
*
* Authors:
* Federico Mena-Quintero
*
* Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
*
*/
#ifdef HAVE_CONFIG_H
#include
#endif
#include
#include
#include
#include
#include "e-dialog-widgets.h"
/* Converts an mapped value to the appropriate index in an item group. The
* values for the items are provided as a -1-terminated array.
*/
static gint
value_to_index (const gint *value_map,
gint value)
{
gint i;
for (i = 0; value_map[i] != -1; i++)
if (value_map[i] == value)
return i;
return -1;
}
/* Converts an index in an item group to the appropriate mapped value. See the
* function above.
*/
static gint
index_to_value (const gint *value_map,
gint index)
{
gint i;
/* We do this the hard way, i.e. not as a simple array reference, to
* check for correctness.
*/
for (i = 0; value_map[i] != -1; i++)
if (i == index)
return value_map[i];
return -1;
}
/**
* e_dialog_editable_set:
* @widget: A #GtkEditable widget.
* @value: String value.
*
* Sets the string value inside a #GtkEditable-derived widget.
**/
void
e_dialog_editable_set (GtkWidget *widget,
const gchar *value)
{
gint pos = 0;
g_return_if_fail (GTK_IS_EDITABLE (widget));
gtk_editable_delete_text (GTK_EDITABLE (widget), 0, -1);
if (value)
gtk_editable_insert_text (GTK_EDITABLE (widget), value, strlen (value), &pos);
}
/**
* e_dialog_editable_get:
* @widget: A #GtkEditable widget.
*
* Queries the string value inside a #GtkEditable-derived widget.
*
* Return value: String value. You should free it when you are done with it.
* This function can return NULL if the string could not be converted from
* GTK+'s encoding into UTF8.
**/
gchar *
e_dialog_editable_get (GtkWidget *widget)
{
g_return_val_if_fail (GTK_IS_EDITABLE (widget), NULL);
return gtk_editable_get_chars (GTK_EDITABLE (widget), 0, -1);
}
/**
* e_dialog_combo_box_set:
* @widget: A #GtkComboBox.
* @value: Enumerated value.
* @value_map: Map from enumeration values to array indices.
*
* Sets the selected item in a #GtkComboBox. Please read the description of
* e_dialog_radio_set() to see how @value_map maps enumeration values to item
* indices.
**/
void
e_dialog_combo_box_set (GtkWidget *widget,
gint value,
const gint *value_map)
{
gint i;
g_return_if_fail (GTK_IS_COMBO_BOX (widget));
g_return_if_fail (value_map != NULL);
i = value_to_index (value_map, value);
if (i != -1)
gtk_combo_box_set_active (GTK_COMBO_BOX (widget), i);
else
g_message (
"e_dialog_combo_box_set(): could not "
"find value %d in value map!", value);
}
/**
* e_dialog_combo_box_get:
* @widget: A #GtkComboBox.
* @value_map: Map from enumeration values to array indices.
*
* Queries the selected item in a #GtkComboBox. Please read the description
* of e_dialog_radio_set() to see how @value_map maps enumeration values to item
* indices.
*
* Return value: Enumeration value which corresponds to the selected item in the
* combo box.
**/
gint
e_dialog_combo_box_get (GtkWidget *widget,
const gint *value_map)
{
gint active;
gint i;
g_return_val_if_fail (GTK_IS_COMBO_BOX (widget), -1);
g_return_val_if_fail (value_map != NULL, -1);
active = gtk_combo_box_get_active (GTK_COMBO_BOX (widget));
i = index_to_value (value_map, active);
if (i == -1) {
g_message (
"e_dialog_combo_box_get(): could not "
"find index %d in value map!", i);
return -1;
}
return i;
}
/**
* e_dialog_append_list_store_text:
* @list_store: A #GtkListStore
* @text_column: A string column ID, where to write @text_value
* @text_value: A string to be added to the @list_store
**/
void
e_dialog_append_list_store_text (GtkTreeModel *list_store,
gint text_column,
const gchar *text_value)
{
GtkTreeIter iter;
GtkListStore *store;
g_return_if_fail (GTK_IS_LIST_STORE (list_store));
g_return_if_fail (text_column >= 0);
g_return_if_fail (text_value != NULL);
store = GTK_LIST_STORE (list_store);
gtk_list_store_append (store, &iter);
gtk_list_store_set (store, &iter, text_column, text_value, -1);
}