/* PIKA - Photo and Image Kooker Application * a rebranding of The GNU Image Manipulation Program (created with heckimp) * A derived work which may be trivial. However, any changes may be (C)2023 by Aldercone Studio * * Original copyright, applying to most contents (license remains unchanged): * Copyright (C) 1995 Spencer Kimball and Peter Mattis * * pikaradioaction.c * Copyright (C) 2004 Michael Natterer * Copyright (C) 2008 Sven Neumann * Copyright (C) 2023 Jehan * * 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 3 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, see . */ #include "config.h" #include #include #include "libpikabase/pikabase.h" #include "libpikawidgets/pikawidgets.h" #include "widgets-types.h" #include "pikaaction.h" #include "pikaaction-history.h" #include "pikaradioaction.h" /** * PikaRadioAction: * * An action which is part of a group of radio actions. It is guaranteed that at * most one action is active in the group. * * The "state" in any of the actions of the group is the @value associated to * the active action of the group. */ enum { PROP_0, PROP_VALUE, PROP_GROUP, PROP_GROUP_LABEL, PROP_CURRENT_VALUE }; struct _PikaRadioActionPrivate { GSList *group; gchar *group_label; gint value; }; static void pika_radio_action_g_action_iface_init (GActionInterface *iface); static void pika_radio_action_dispose (GObject *object); static void pika_radio_action_finalize (GObject *object); static void pika_radio_action_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec); static void pika_radio_action_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec); static gboolean pika_radio_action_get_enabled (GAction *action); static void pika_radio_action_change_state (GAction *action, GVariant *value); static const GVariantType * pika_radio_action_get_state_type (GAction *action); static GVariant * pika_radio_action_get_state (GAction *action); static const GVariantType * pika_radio_action_get_parameter_type (GAction *action); static void pika_radio_action_activate (GAction *action, GVariant *parameter); static gboolean pika_radio_action_toggle (PikaToggleAction *action); G_DEFINE_TYPE_WITH_CODE (PikaRadioAction, pika_radio_action, PIKA_TYPE_TOGGLE_ACTION, G_ADD_PRIVATE (PikaRadioAction) G_IMPLEMENT_INTERFACE (G_TYPE_ACTION, pika_radio_action_g_action_iface_init)) #define parent_class pika_radio_action_parent_class static void pika_radio_action_class_init (PikaRadioActionClass *klass) { GObjectClass *object_class = G_OBJECT_CLASS (klass); PikaToggleActionClass *toggle_class = PIKA_TOGGLE_ACTION_CLASS (klass); object_class->dispose = pika_radio_action_dispose; object_class->finalize = pika_radio_action_finalize; object_class->get_property = pika_radio_action_get_property; object_class->set_property = pika_radio_action_set_property; toggle_class->toggle = pika_radio_action_toggle; /** * PikaRadioAction:value: * * The value is an arbitrary integer which can be used as a convenient way to * determine which action in the group is currently active in an ::activate * signal handler. * See pika_radio_action_get_current_value() for convenient ways to get and * set this property. **/ g_object_class_install_property (object_class, PROP_VALUE, g_param_spec_int ("value", "Value", "The value returned by pika_radio_action_get_current_value() when this action is the current action of its group.", G_MININT, G_MAXINT, 0, PIKA_PARAM_READWRITE)); /** * PikaRadioAction:group: * * Sets a new group for a radio action. */ g_object_class_install_property (object_class, PROP_GROUP, g_param_spec_object ("group", "Group", "The radio action whose group this action belongs to.", PIKA_TYPE_RADIO_ACTION, PIKA_PARAM_WRITABLE)); /** * PikaRadioAction:group-label: * * Sets the group label. It will be common to all actions in a same group. */ g_object_class_install_property (object_class, PROP_GROUP_LABEL, g_param_spec_string ("group-label", "Group string", "The label for all the radio action in the group this action belongs to.", NULL, PIKA_PARAM_WRITABLE | G_PARAM_EXPLICIT_NOTIFY)); /** * PikaRadioAction:value: * * The value property of the currently active member of the group to which * this action belongs. **/ g_object_class_install_property (object_class, PROP_CURRENT_VALUE, g_param_spec_int ("current-value", "Current value", "The value property of the currently active member of the group to which this action belongs.", G_MININT, G_MAXINT, 0, PIKA_PARAM_READWRITE)); } static void pika_radio_action_g_action_iface_init (GActionInterface *iface) { iface->get_name = (const gchar* (*) (GAction*)) pika_action_get_name; iface->activate = pika_radio_action_activate; iface->get_enabled = pika_radio_action_get_enabled; iface->change_state = pika_radio_action_change_state; iface->get_state_type = pika_radio_action_get_state_type; iface->get_state = pika_radio_action_get_state; iface->get_parameter_type = pika_radio_action_get_parameter_type; } static void pika_radio_action_init (PikaRadioAction *action) { action->priv = pika_radio_action_get_instance_private (action); action->priv->group = NULL; action->priv->group_label = NULL; } static void pika_radio_action_dispose (GObject *object) { PikaRadioAction *action = PIKA_RADIO_ACTION (object); if (action->priv->group) { GSList *group; GSList *slist; group = g_slist_remove (action->priv->group, action); for (slist = group; slist; slist = slist->next) { PikaRadioAction *tmp_action = slist->data; tmp_action->priv->group = group; } action->priv->group = NULL; } G_OBJECT_CLASS (parent_class)->dispose (object); } static void pika_radio_action_finalize (GObject *object) { PikaRadioAction *action = PIKA_RADIO_ACTION (object); g_clear_pointer (&action->priv->group_label, g_free); G_OBJECT_CLASS (parent_class)->finalize (object); } static void pika_radio_action_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { PikaRadioAction *action = PIKA_RADIO_ACTION (object); switch (prop_id) { case PROP_VALUE: g_value_set_int (value, action->priv->value); break; case PROP_CURRENT_VALUE: g_value_set_int (value, pika_radio_action_get_current_value (action)); break; case PROP_GROUP_LABEL: g_value_set_string (value, pika_radio_action_get_group_label (action)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void pika_radio_action_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { PikaRadioAction *action = PIKA_RADIO_ACTION (object); switch (prop_id) { case PROP_VALUE: action->priv->value = g_value_get_int (value); break; case PROP_GROUP: { PikaRadioAction *arg; GSList *slist = NULL; if (G_VALUE_HOLDS_OBJECT (value)) { arg = PIKA_RADIO_ACTION (g_value_get_object (value)); if (arg) slist = pika_radio_action_get_group (arg); pika_radio_action_set_group (action, slist); } } break; case PROP_GROUP_LABEL: pika_radio_action_set_group_label (action, g_value_get_string (value)); break; case PROP_CURRENT_VALUE: pika_radio_action_set_current_value (action, g_value_get_int (value)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static gboolean pika_radio_action_get_enabled (GAction *action) { PikaRadioAction *radio = PIKA_RADIO_ACTION (action); return pika_radio_action_get_current_value (radio) != radio->priv->value; } static void pika_radio_action_change_state (GAction *action, GVariant *value) { g_return_if_fail (PIKA_IS_ACTION (action)); g_return_if_fail (value != NULL); g_return_if_fail (g_variant_is_of_type (value, G_VARIANT_TYPE_INT32)); pika_radio_action_set_current_value (PIKA_RADIO_ACTION (action), g_variant_get_int32 (value)); } static const GVariantType * pika_radio_action_get_state_type (GAction *action) { return G_VARIANT_TYPE_INT32; } static GVariant * pika_radio_action_get_state (GAction *action) { PikaRadioAction *radio; GVariant *state; g_return_val_if_fail (PIKA_IS_RADIO_ACTION (action), NULL); radio = PIKA_RADIO_ACTION (action); state = g_variant_new_int32 (pika_radio_action_get_current_value (radio)); return g_variant_ref_sink (state); } /* This is a bit on the ugly side. In order to be shown as a radio item when the * GUI is created by GTK (which happens either on macOS or with environment * variable PIKA_GTK_MENUBAR), the menu item requires a "target" attribute * (which is automatically added in PikaMenuModel) and the action needs to have * a parameter type of the right type. * In reality, how we use our radio actions is to have several tied actions * rather than a single action to which we pass a parameter (we ignore the * passed parameter anyway). This makes it a lot easier to have people assign * shortcuts to these. * So the ugly part is to add a parameter type here, even though the parameter * just won't be used. * See #9704. */ static const GVariantType * pika_radio_action_get_parameter_type (GAction *action) { return G_VARIANT_TYPE_INT32; } static void pika_radio_action_activate (GAction *action, GVariant *parameter) { PikaRadioAction *radio; g_return_if_fail (PIKA_IS_RADIO_ACTION (action)); radio = PIKA_RADIO_ACTION (action); pika_radio_action_set_current_value (radio, radio->priv->value); g_signal_emit_by_name (radio, "toggled"); } static gboolean pika_radio_action_toggle (PikaToggleAction *action) { gboolean active = pika_toggle_action_get_active (action); if (! active) { PikaRadioAction *radio = PIKA_RADIO_ACTION (action); pika_radio_action_set_current_value (radio, radio->priv->value); return pika_toggle_action_get_active (action); } return FALSE; } /* public functions */ PikaAction * pika_radio_action_new (const gchar *name, const gchar *label, const gchar *short_label, const gchar *tooltip, const gchar *icon_name, const gchar *help_id, gint value, PikaContext *context) { PikaAction *action; action = g_object_new (PIKA_TYPE_RADIO_ACTION, "name", name, "label", label, "short-label", short_label, "tooltip", tooltip, "icon-name", icon_name, "value", value, "context", context, NULL); pika_action_set_help_id (action, help_id); return action; } GSList * pika_radio_action_get_group (PikaRadioAction *action) { g_return_val_if_fail (PIKA_IS_RADIO_ACTION (action), NULL); return action->priv->group; } void pika_radio_action_set_group (PikaRadioAction *action, GSList *group) { g_return_if_fail (PIKA_IS_RADIO_ACTION (action)); g_return_if_fail (! g_slist_find (group, action)); if (action->priv->group) { GSList *slist; action->priv->group = g_slist_remove (action->priv->group, action); for (slist = action->priv->group; slist; slist = slist->next) { PikaRadioAction *tmp_action = slist->data; tmp_action->priv->group = action->priv->group; } } action->priv->group = g_slist_prepend (group, action); g_clear_pointer (&action->priv->group_label, g_free); if (group) { GSList *slist; action->priv->group_label = g_strdup (PIKA_RADIO_ACTION (group->data)->priv->group_label); for (slist = action->priv->group; slist; slist = slist->next) { PikaRadioAction *tmp_action = slist->data; tmp_action->priv->group = action->priv->group; } } else { pika_toggle_action_set_active (PIKA_TOGGLE_ACTION (action), TRUE); } g_object_notify (G_OBJECT (action), "group-label"); } void pika_radio_action_set_group_label (PikaRadioAction *action, const gchar *label) { GSList *slist; g_return_if_fail (PIKA_IS_RADIO_ACTION (action)); for (slist = action->priv->group; slist; slist = slist->next) { PikaRadioAction *tmp_action = slist->data; g_clear_pointer (&tmp_action->priv->group_label, g_free); if (label != NULL) tmp_action->priv->group_label = g_strdup (label); g_object_notify (G_OBJECT (tmp_action), "group-label"); } } const gchar * pika_radio_action_get_group_label (PikaRadioAction *action) { g_return_val_if_fail (PIKA_IS_RADIO_ACTION (action), NULL); return action->priv->group_label; } gint pika_radio_action_get_current_value (PikaRadioAction *action) { GSList *slist; g_return_val_if_fail (PIKA_IS_RADIO_ACTION (action), 0); if (action->priv->group) { for (slist = action->priv->group; slist; slist = slist->next) { PikaToggleAction *toggle_action = slist->data; if (pika_toggle_action_get_active (toggle_action)) return PIKA_RADIO_ACTION (toggle_action)->priv->value; } } return action->priv->value; } void pika_radio_action_set_current_value (PikaRadioAction *action, gint current_value) { GSList *slist; PikaToggleAction *changed1 = NULL; PikaToggleAction *changed2 = NULL; g_return_if_fail (PIKA_IS_RADIO_ACTION (action)); if (action->priv->group) { for (slist = action->priv->group; slist; slist = slist->next) { PikaToggleAction *toggle = slist->data; PikaRadioAction *radio = slist->data; if (radio->priv->value == current_value && ! pika_toggle_action_get_active (toggle)) { /* Change the "active" state but don't notify the property change * immediately. We want to notify both "active" properties * together so that we are always in consistent state. */ _pika_toggle_action_set_active (toggle, TRUE); changed1 = toggle; } else if (pika_toggle_action_get_active (toggle)) { changed2 = toggle; } } } if (! changed1) { g_warning ("Radio group does not contain an action with value '%d'", current_value); } else { if (changed2) { _pika_toggle_action_set_active (changed2, FALSE); g_object_notify (G_OBJECT (changed2), "active"); g_signal_emit_by_name (changed2, "toggled"); g_object_notify (G_OBJECT (changed2), "enabled"); g_object_notify (G_OBJECT (changed2), "state"); } g_object_notify (G_OBJECT (changed1), "active"); for (slist = action->priv->group; slist; slist = slist->next) { g_object_notify (slist->data, "current-value"); pika_action_emit_change_state (PIKA_ACTION (slist->data), g_variant_new_int32 (current_value)); } g_object_notify (G_OBJECT (changed1), "enabled"); g_object_notify (G_OBJECT (changed1), "state"); } }