PIKApp/libpikawidgets/pikaenumcombobox.c

212 lines
6.0 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
*
* pikaenumcombobox.c
* Copyright (C) 2004 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 <gtk/gtk.h>
#include "libpikabase/pikabase.h"
#include "pikawidgetstypes.h"
#include "pikaenumcombobox.h"
#include "pikaenumstore.h"
#include "libpika/libpika-intl.h"
/**
* SECTION: pikaenumcombobox
* @title: PikaEnumComboBox
* @short_description: A #PikaIntComboBox subclass for selecting an enum value.
*
* A #GtkComboBox subclass for selecting an enum value.
**/
enum
{
PROP_0,
PROP_MODEL
};
static void pika_enum_combo_box_set_property (GObject *object,
guint prop_id,
const GValue *value,
GParamSpec *pspec);
static void pika_enum_combo_box_get_property (GObject *object,
guint prop_id,
GValue *value,
GParamSpec *pspec);
G_DEFINE_TYPE (PikaEnumComboBox, pika_enum_combo_box,
PIKA_TYPE_INT_COMBO_BOX)
#define parent_class pika_enum_combo_box_parent_class
static void
pika_enum_combo_box_class_init (PikaEnumComboBoxClass *klass)
{
GObjectClass *object_class = G_OBJECT_CLASS (klass);
object_class->set_property = pika_enum_combo_box_set_property;
object_class->get_property = pika_enum_combo_box_get_property;
/* override the "model" property of GtkComboBox */
g_object_class_install_property (object_class,
PROP_MODEL,
g_param_spec_object ("model",
"Model",
"The enum store used by this combo box",
PIKA_TYPE_ENUM_STORE,
PIKA_PARAM_READWRITE));
}
static void
pika_enum_combo_box_init (PikaEnumComboBox *combo_box)
{
}
static void
pika_enum_combo_box_set_property (GObject *object,
guint prop_id,
const GValue *value,
GParamSpec *pspec)
{
GtkComboBox *combo_box = GTK_COMBO_BOX (object);
switch (prop_id)
{
case PROP_MODEL:
gtk_combo_box_set_model (combo_box, g_value_get_object (value));
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
break;
}
}
static void
pika_enum_combo_box_get_property (GObject *object,
guint prop_id,
GValue *value,
GParamSpec *pspec)
{
GtkComboBox *combo_box = GTK_COMBO_BOX (object);
switch (prop_id)
{
case PROP_MODEL:
g_value_set_object (value, gtk_combo_box_get_model (combo_box));
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
break;
}
}
/**
* pika_enum_combo_box_new:
* @enum_type: the #GType of an enum.
*
* Creates a #GtkComboBox readily filled with all enum values from a
* given @enum_type. The enum needs to be registered to the type
* system. It should also have %PikaEnumDesc descriptions registered
* that contain translatable value names. This is the case for the
* enums used in the PIKA PDB functions.
*
* This is just a convenience function. If you need more control over
* the enum values that appear in the combo_box, you can create your
* own #PikaEnumStore and use pika_enum_combo_box_new_with_model().
*
* Returns: a new #PikaEnumComboBox.
*
* Since: 2.4
**/
GtkWidget *
pika_enum_combo_box_new (GType enum_type)
{
GtkListStore *store;
GtkWidget *combo_box;
g_return_val_if_fail (G_TYPE_IS_ENUM (enum_type), NULL);
store = pika_enum_store_new (enum_type);
combo_box = g_object_new (PIKA_TYPE_ENUM_COMBO_BOX,
"model", store,
NULL);
g_object_unref (store);
return combo_box;
}
/**
* pika_enum_combo_box_new_with_model
* @enum_store: a #PikaEnumStore to use as the model
*
* Creates a #GtkComboBox for the given @enum_store.
*
* Returns: a new #PikaEnumComboBox.
*
* Since: 2.4
**/
GtkWidget *
pika_enum_combo_box_new_with_model (PikaEnumStore *enum_store)
{
g_return_val_if_fail (PIKA_IS_ENUM_STORE (enum_store), NULL);
return g_object_new (PIKA_TYPE_ENUM_COMBO_BOX,
"model", enum_store,
NULL);
}
/**
* pika_enum_combo_box_set_icon_prefix:
* @combo_box: a #PikaEnumComboBox
* @icon_prefix: a prefix to create icon names from enum values
*
* Attempts to create icons for all items in the @combo_box. See
* pika_enum_store_set_icon_prefix() to find out what to use as
* @icon_prefix.
*
* Since: 2.10
**/
void
pika_enum_combo_box_set_icon_prefix (PikaEnumComboBox *combo_box,
const gchar *icon_prefix)
{
GtkTreeModel *model;
g_return_if_fail (PIKA_IS_ENUM_COMBO_BOX (combo_box));
model = gtk_combo_box_get_model (GTK_COMBO_BOX (combo_box));
pika_enum_store_set_icon_prefix (PIKA_ENUM_STORE (model), icon_prefix);
}