PIKApp/libpikawidgets/pikastringcombobox.c

489 lines
15 KiB
C
Raw Normal View History

2023-09-26 00:35:21 +02:00
/* LIBPIKA - The PIKA Library
* Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
*
* pikastringcombobox.c
* Copyright (C) 2007 Sven Neumann <sven@gimp.org>
*
* This library 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 3 of the License, or (at your option) any later version.
*
* This library 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 this library. If not, see
* <https://www.gnu.org/licenses/>.
*/
#include "config.h"
#include <string.h>
#include <gtk/gtk.h>
#include "libpikabase/pikabase.h"
#include "pikawidgetstypes.h"
#include "pikastringcombobox.h"
/**
* SECTION: pikastringcombobox
* @title: PikaStringComboBox
* @short_description: A #GtkComboBox subclass to select strings.
*
* A #GtkComboBox subclass to select strings.
**/
enum
{
PROP_0,
PROP_ID_COLUMN,
PROP_LABEL_COLUMN,
2023-10-30 23:55:30 +01:00
PROP_ELLIPSIZE,
PROP_VALUE
2023-09-26 00:35:21 +02:00
};
struct _PikaStringComboBoxPrivate
{
2023-10-30 23:55:30 +01:00
gint id_column;
gint label_column;
GtkCellRenderer *text_renderer;
PikaStringSensitivityFunc sensitivity_func;
gpointer sensitivity_data;
GDestroyNotify sensitivity_destroy;
2023-09-26 00:35:21 +02:00
};
#define GET_PRIVATE(obj) (((PikaStringComboBox *) (obj))->priv)
2023-10-30 23:55:30 +01:00
static void pika_string_combo_box_constructed (GObject *object);
static void pika_string_combo_box_set_property (GObject *object,
guint property_id,
const GValue *value,
GParamSpec *pspec);
static void pika_string_combo_box_get_property (GObject *object,
guint property_id,
GValue *value,
GParamSpec *pspec);
static void pika_string_combo_box_cell_data_func (GtkCellLayout *cell_layout,
GtkCellRenderer *cell,
GtkTreeModel *tree_model,
GtkTreeIter *iter,
PikaStringComboBoxPrivate *priv);
2023-09-26 00:35:21 +02:00
G_DEFINE_TYPE_WITH_PRIVATE (PikaStringComboBox, pika_string_combo_box,
GTK_TYPE_COMBO_BOX)
#define parent_class pika_string_combo_box_parent_class
static void
pika_string_combo_box_class_init (PikaStringComboBoxClass *klass)
{
GObjectClass *object_class = G_OBJECT_CLASS (klass);
object_class->constructed = pika_string_combo_box_constructed;
object_class->set_property = pika_string_combo_box_set_property;
object_class->get_property = pika_string_combo_box_get_property;
/**
* PikaStringComboBox:id-column:
*
* The column in the associated GtkTreeModel that holds unique
* string IDs.
*
* Since: 2.4
*/
g_object_class_install_property (object_class,
PROP_ID_COLUMN,
g_param_spec_int ("id-column",
"ID Column",
"The model column that holds the ID",
0, G_MAXINT,
0,
PIKA_PARAM_READWRITE |
G_PARAM_CONSTRUCT_ONLY));
/**
* PikaStringComboBox:label-column:
*
* The column in the associated GtkTreeModel that holds strings to
* be used as labels in the combo-box.
*
* Since: 2.4
*/
g_object_class_install_property (object_class,
PROP_LABEL_COLUMN,
g_param_spec_int ("label-column",
"Label Column",
"The model column that holds the label",
0, G_MAXINT,
0,
PIKA_PARAM_READWRITE |
G_PARAM_CONSTRUCT_ONLY));
/**
* PikaStringComboBox:ellipsize:
*
* Specifies the preferred place to ellipsize text in the combo-box,
* if the cell renderer does not have enough room to display the
* entire string.
*
* Since: 2.4
*/
g_object_class_install_property (object_class,
PROP_ELLIPSIZE,
g_param_spec_enum ("ellipsize",
"Ellipsize",
"Ellipsize mode for the text cell renderer",
PANGO_TYPE_ELLIPSIZE_MODE,
PANGO_ELLIPSIZE_NONE,
PIKA_PARAM_READWRITE));
2023-10-30 23:55:30 +01:00
/**
* PikaStringComboBox:value:
*
* The active value (different from the "active" property of
* GtkComboBox which is the active index).
*
* Since: 3.0
*/
g_object_class_install_property (object_class, PROP_VALUE,
g_param_spec_string ("value",
"Value",
"Value of active item",
NULL,
PIKA_PARAM_READWRITE |
G_PARAM_EXPLICIT_NOTIFY));
2023-09-26 00:35:21 +02:00
}
static void
pika_string_combo_box_init (PikaStringComboBox *combo_box)
{
combo_box->priv = pika_string_combo_box_get_instance_private (combo_box);
}
static void
pika_string_combo_box_constructed (GObject *object)
{
PikaStringComboBoxPrivate *priv = GET_PRIVATE (object);
GtkCellRenderer *cell;
G_OBJECT_CLASS (parent_class)->constructed (object);
priv->text_renderer = cell = gtk_cell_renderer_text_new ();
gtk_cell_layout_pack_start (GTK_CELL_LAYOUT (object), cell, TRUE);
gtk_cell_layout_set_attributes (GTK_CELL_LAYOUT (object), cell,
"text", priv->label_column,
NULL);
2023-10-30 23:55:30 +01:00
gtk_cell_layout_set_cell_data_func (GTK_CELL_LAYOUT (object), priv->text_renderer,
(GtkCellLayoutDataFunc) pika_string_combo_box_cell_data_func,
priv, NULL);
/* The "changed" signal of the GtkComboBox also triggers a "value" property
* notification.
*/
g_signal_connect (object, "changed",
G_CALLBACK (g_object_notify),
"value");
2023-09-26 00:35:21 +02:00
}
static void
pika_string_combo_box_set_property (GObject *object,
guint property_id,
const GValue *value,
GParamSpec *pspec)
{
PikaStringComboBoxPrivate *priv = GET_PRIVATE (object);
switch (property_id)
{
case PROP_ID_COLUMN:
priv->id_column = g_value_get_int (value);
break;
case PROP_LABEL_COLUMN:
priv->label_column = g_value_get_int (value);
break;
case PROP_ELLIPSIZE:
g_object_set_property (G_OBJECT (priv->text_renderer),
pspec->name, value);
break;
2023-10-30 23:55:30 +01:00
case PROP_VALUE:
pika_string_combo_box_set_active (PIKA_STRING_COMBO_BOX (object),
g_value_get_string (value));
break;
2023-09-26 00:35:21 +02:00
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
break;
}
}
static void
pika_string_combo_box_get_property (GObject *object,
guint property_id,
GValue *value,
GParamSpec *pspec)
{
PikaStringComboBoxPrivate *priv = GET_PRIVATE (object);
switch (property_id)
{
case PROP_ID_COLUMN:
g_value_set_int (value, priv->id_column);
break;
case PROP_LABEL_COLUMN:
g_value_set_int (value, priv->label_column);
break;
case PROP_ELLIPSIZE:
g_object_get_property (G_OBJECT (priv->text_renderer),
pspec->name, value);
break;
2023-10-30 23:55:30 +01:00
case PROP_VALUE:
{
gchar *v;
v = pika_string_combo_box_get_active (PIKA_STRING_COMBO_BOX (object));
g_value_take_string (value, v);
}
break;
2023-09-26 00:35:21 +02:00
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
break;
}
}
static gboolean
pika_string_model_lookup (GtkTreeModel *model,
gint column,
const gchar *id,
GtkTreeIter *iter)
{
GValue value = G_VALUE_INIT;
gboolean iter_valid;
/* This lookup could be backed up by a hash table or some other
* data structure instead of doing a list traversal. But since this
* is a GtkComboBox, there shouldn't be many entries anyway...
*/
for (iter_valid = gtk_tree_model_get_iter_first (model, iter);
iter_valid;
iter_valid = gtk_tree_model_iter_next (model, iter))
{
const gchar *str;
gtk_tree_model_get_value (model, iter, column, &value);
str = g_value_get_string (&value);
if (str && strcmp (str, id) == 0)
{
g_value_unset (&value);
break;
}
g_value_unset (&value);
}
return iter_valid;
}
/**
* pika_string_combo_box_new:
* @model: a #GtkTreeModel
* @id_column: the model column of the ID
* @label_column: the modl column of the label
*
* Returns: a new #PikaStringComboBox.
*
* Since: 2.4
**/
GtkWidget *
pika_string_combo_box_new (GtkTreeModel *model,
gint id_column,
gint label_column)
{
g_return_val_if_fail (GTK_IS_TREE_MODEL (model), NULL);
g_return_val_if_fail (gtk_tree_model_get_column_type (model,
id_column) == G_TYPE_STRING, NULL);
g_return_val_if_fail (gtk_tree_model_get_column_type (model,
label_column) == G_TYPE_STRING, NULL);
return g_object_new (PIKA_TYPE_STRING_COMBO_BOX,
"model", model,
"id-column", id_column,
"label-column", label_column,
NULL);
}
/**
* pika_string_combo_box_set_active:
* @combo_box: a #PikaStringComboBox
* @id: the ID of the item to select
*
* Looks up the item that belongs to the given @id and makes it the
* selected item in the @combo_box.
*
* Returns: %TRUE on success or %FALSE if there was no item for
2023-10-30 23:55:30 +01:00
* this value.
2023-09-26 00:35:21 +02:00
*
* Since: 2.4
**/
gboolean
pika_string_combo_box_set_active (PikaStringComboBox *combo_box,
const gchar *id)
{
g_return_val_if_fail (PIKA_IS_STRING_COMBO_BOX (combo_box), FALSE);
if (id)
{
GtkTreeModel *model;
GtkTreeIter iter;
gint column;
model = gtk_combo_box_get_model (GTK_COMBO_BOX (combo_box));
column = GET_PRIVATE (combo_box)->id_column;
if (pika_string_model_lookup (model, column, id, &iter))
{
gtk_combo_box_set_active_iter (GTK_COMBO_BOX (combo_box), &iter);
2023-10-30 23:55:30 +01:00
g_object_notify (G_OBJECT (combo_box), "value");
2023-09-26 00:35:21 +02:00
return TRUE;
}
return FALSE;
}
else
{
gtk_combo_box_set_active (GTK_COMBO_BOX (combo_box), -1);
2023-10-30 23:55:30 +01:00
g_object_notify (G_OBJECT (combo_box), "value");
2023-09-26 00:35:21 +02:00
return TRUE;
}
}
/**
* pika_string_combo_box_get_active:
* @combo_box: a #PikaStringComboBox
*
* Retrieves the value of the selected (active) item in the @combo_box.
*
* Returns: newly allocated ID string or %NULL if nothing was selected
*
* Since: 2.4
**/
gchar *
pika_string_combo_box_get_active (PikaStringComboBox *combo_box)
{
GtkTreeIter iter;
g_return_val_if_fail (PIKA_IS_STRING_COMBO_BOX (combo_box), NULL);
if (gtk_combo_box_get_active_iter (GTK_COMBO_BOX (combo_box), &iter))
{
GtkTreeModel *model = gtk_combo_box_get_model (GTK_COMBO_BOX (combo_box));
gchar *value;
gint column;
column = GET_PRIVATE (combo_box)->id_column;
gtk_tree_model_get (model, &iter,
column, &value,
-1);
return value;
}
return NULL;
}
2023-10-30 23:55:30 +01:00
/**
* pika_string_combo_box_set_sensitivity:
* @combo_box: a #PikaStringComboBox
* @func: a function that returns a boolean value, or %NULL to unset
* @data: data to pass to @func
* @destroy: destroy notification for @data
*
* Sets a function that is used to decide about the sensitivity of
* rows in the @combo_box. Use this if you want to set certain rows
* insensitive.
*
* Calling gtk_widget_queue_draw() on the @combo_box will cause the
* sensitivity to be updated.
*
* Since: 3.0
**/
void
pika_string_combo_box_set_sensitivity (PikaStringComboBox *combo_box,
PikaStringSensitivityFunc func,
gpointer data,
GDestroyNotify destroy)
{
PikaStringComboBoxPrivate *priv;
g_return_if_fail (PIKA_IS_STRING_COMBO_BOX (combo_box));
priv = GET_PRIVATE (combo_box);
if (priv->sensitivity_destroy)
{
GDestroyNotify d = priv->sensitivity_destroy;
priv->sensitivity_destroy = NULL;
d (priv->sensitivity_data);
}
priv->sensitivity_func = func;
priv->sensitivity_data = data;
priv->sensitivity_destroy = destroy;
gtk_widget_queue_draw (GTK_WIDGET (combo_box));
}
/* Private functions. */
static void
pika_string_combo_box_cell_data_func (GtkCellLayout *cell_layout,
GtkCellRenderer *cell,
GtkTreeModel *tree_model,
GtkTreeIter *iter,
PikaStringComboBoxPrivate *priv)
{
if (priv->sensitivity_func)
{
gchar *id;
gboolean sensitive;
gtk_tree_model_get (tree_model, iter,
priv->id_column, &id,
-1);
sensitive = priv->sensitivity_func (id, priv->sensitivity_data);
g_object_set (cell,
"sensitive", sensitive,
NULL);
g_free (id);
}
}