PIKApp/app/widgets/pikaactionimpl.c

425 lines
14 KiB
C
Raw Normal View History

2023-09-26 00:35:21 +02:00
/* 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
*
* pikaaction.c
* Copyright (C) 2004-2019 Michael Natterer <mitch@gimp.org>
*
* 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 <https://www.gnu.org/licenses/>.
*/
#include "config.h"
#include <gegl.h>
#include <gtk/gtk.h>
#include "libpikabase/pikabase.h"
#include "widgets-types.h"
#include "pikaaction.h"
#include "pikaactionimpl.h"
#include "pikaaction-history.h"
enum
{
PROP_0,
PROP_ENABLED = PIKA_ACTION_PROP_LAST + 1,
PROP_PARAMETER_TYPE,
PROP_STATE_TYPE,
PROP_STATE
};
enum
{
CHANGE_STATE,
LAST_SIGNAL
};
struct _PikaActionImplPrivate
{
GVariantType *parameter_type;
GVariant *state;
GVariant *state_hint;
gboolean state_set_already;
};
static void pika_action_g_action_iface_init (GActionInterface *iface);
static void pika_action_impl_finalize (GObject *object);
static void pika_action_impl_set_property (GObject *object,
guint prop_id,
const GValue *value,
GParamSpec *pspec);
static void pika_action_impl_get_property (GObject *object,
guint prop_id,
GValue *value,
GParamSpec *pspec);
/* XXX Implementations for our PikaAction are widely inspired by GSimpleAction
* implementations.
*/
static void pika_action_impl_activate (GAction *action,
GVariant *parameter);
static void pika_action_impl_change_state (GAction *action,
GVariant *value);
static gboolean pika_action_impl_get_enabled (GAction *action);
static const GVariantType *
pika_action_impl_get_parameter_type (GAction *action);
static const GVariantType *
pika_action_impl_get_state_type (GAction *action);
static GVariant *
pika_action_impl_get_state (GAction *action);
static GVariant *
pika_action_impl_get_state_hint (GAction *action);
static void pika_action_impl_set_state (PikaAction *pika_action,
GVariant *value);
G_DEFINE_TYPE_WITH_CODE (PikaActionImpl, pika_action_impl, PIKA_TYPE_OBJECT,
G_ADD_PRIVATE (PikaActionImpl)
G_IMPLEMENT_INTERFACE (G_TYPE_ACTION, pika_action_g_action_iface_init)
G_IMPLEMENT_INTERFACE (PIKA_TYPE_ACTION, NULL))
#define parent_class pika_action_impl_parent_class
static guint pika_action_impl_signals[LAST_SIGNAL] = { 0 };
static void
pika_action_impl_class_init (PikaActionImplClass *klass)
{
GObjectClass *object_class = G_OBJECT_CLASS (klass);
pika_action_impl_signals[CHANGE_STATE] =
g_signal_new ("change-state",
G_TYPE_FROM_CLASS (klass),
G_SIGNAL_RUN_LAST | G_SIGNAL_MUST_COLLECT,
G_STRUCT_OFFSET (PikaActionImplClass, change_state),
NULL, NULL, NULL,
G_TYPE_NONE, 1,
G_TYPE_VARIANT);
object_class->finalize = pika_action_impl_finalize;
object_class->set_property = pika_action_impl_set_property;
object_class->get_property = pika_action_impl_get_property;
pika_action_install_properties (object_class);
/**
* PikaAction:enabled:
*
* If @action is currently enabled.
*
* If the action is disabled then calls to g_action_activate() and
* g_action_change_state() have no effect.
**/
g_object_class_install_property (object_class, PROP_ENABLED,
g_param_spec_boolean ("enabled",
"Enabled",
"If the action can be activated",
TRUE,
PIKA_PARAM_READWRITE));
/**
* PikaAction:parameter-type:
*
* The type of the parameter that must be given when activating the
* action.
**/
g_object_class_install_property (object_class, PROP_PARAMETER_TYPE,
g_param_spec_boxed ("parameter-type",
"Parameter Type",
"The type of GVariant passed to activate()",
G_TYPE_VARIANT_TYPE,
PIKA_PARAM_READWRITE |
G_PARAM_CONSTRUCT_ONLY));
/**
* PikaAction:state-type:
*
* The #GVariantType of the state that the action has, or %NULL if the
* action is stateless.
**/
g_object_class_install_property (object_class, PROP_STATE_TYPE,
g_param_spec_boxed ("state-type",
"State Type",
"The type of the state kept by the action",
G_TYPE_VARIANT_TYPE,
PIKA_PARAM_READABLE));
/**
* PikaAction:state:
*
* The state of the action, or %NULL if the action is stateless.
**/
g_object_class_install_property (object_class, PROP_STATE,
g_param_spec_variant ("state",
"State",
"The state the action is in",
G_VARIANT_TYPE_ANY,
NULL,
PIKA_PARAM_READWRITE | G_PARAM_CONSTRUCT));
}
static void
pika_action_g_action_iface_init (GActionInterface *iface)
{
iface->activate = pika_action_impl_activate;
iface->change_state = pika_action_impl_change_state;
iface->get_enabled = pika_action_impl_get_enabled;
iface->get_name = (const gchar* (*) (GAction*)) pika_action_get_name;
iface->get_parameter_type = pika_action_impl_get_parameter_type;
iface->get_state_type = pika_action_impl_get_state_type;
iface->get_state = pika_action_impl_get_state;
iface->get_state_hint = pika_action_impl_get_state_hint;
}
static void
pika_action_impl_init (PikaActionImpl *impl)
{
impl->priv = pika_action_impl_get_instance_private (impl);
impl->priv->state_set_already = FALSE;
pika_action_init (PIKA_ACTION (impl));
}
static void
pika_action_impl_finalize (GObject *object)
{
PikaActionImpl *impl = PIKA_ACTION_IMPL (object);
if (impl->priv->parameter_type)
g_variant_type_free (impl->priv->parameter_type);
if (impl->priv->state)
g_variant_unref (impl->priv->state);
if (impl->priv->state_hint)
g_variant_unref (impl->priv->state_hint);
G_OBJECT_CLASS (parent_class)->finalize (object);
}
static void
pika_action_impl_get_property (GObject *object,
guint prop_id,
GValue *value,
GParamSpec *pspec)
{
PikaActionImpl *impl = PIKA_ACTION_IMPL (object);
switch (prop_id)
{
case PROP_ENABLED:
g_value_set_boolean (value, pika_action_impl_get_enabled (G_ACTION (impl)));
break;
case PROP_PARAMETER_TYPE:
g_value_set_boxed (value, pika_action_impl_get_parameter_type (G_ACTION (impl)));
break;
case PROP_STATE_TYPE:
g_value_set_boxed (value, pika_action_impl_get_state_type (G_ACTION (impl)));
break;
case PROP_STATE:
g_value_take_variant (value, pika_action_impl_get_state (G_ACTION (impl)));
break;
default:
pika_action_get_property (object, prop_id, value, pspec);
break;
}
}
static void
pika_action_impl_set_property (GObject *object,
guint prop_id,
const GValue *value,
GParamSpec *pspec)
{
PikaActionImpl *impl = PIKA_ACTION_IMPL (object);
switch (prop_id)
{
case PROP_ENABLED:
pika_action_set_sensitive (PIKA_ACTION (impl),
g_value_get_boolean (value), NULL);
break;
case PROP_PARAMETER_TYPE:
impl->priv->parameter_type = g_value_dup_boxed (value);
break;
case PROP_STATE:
/* The first time we see this (during construct) we should just
* take the state as it was handed to us.
*
* After that, we should make sure we go through the same checks
* as the C API.
*/
if (!impl->priv->state_set_already)
{
impl->priv->state = g_value_dup_variant (value);
impl->priv->state_set_already = TRUE;
}
else
{
pika_action_impl_set_state (PIKA_ACTION (impl), g_value_get_variant (value));
}
break;
default:
pika_action_set_property (object, prop_id, value, pspec);
break;
}
}
static void
pika_action_impl_activate (GAction *action,
GVariant *parameter)
{
g_object_add_weak_pointer (G_OBJECT (action), (gpointer) &action);
pika_action_emit_activate (PIKA_ACTION (action), parameter);
if (action != NULL)
{
/* Some actions are self-destructive, such as the "windows-recent-*"
* actions which don't exist after being run. Don't log these.
*/
g_object_remove_weak_pointer (G_OBJECT (action), (gpointer) &action);
pika_action_history_action_activated (PIKA_ACTION (action));
}
}
static void
pika_action_impl_change_state (GAction *action,
GVariant *value)
{
/* If the user connected a signal handler then they are responsible
* for handling state changes.
*/
if (g_signal_has_handler_pending (action, pika_action_impl_signals[CHANGE_STATE], 0, TRUE))
g_signal_emit (action, pika_action_impl_signals[CHANGE_STATE], 0, value);
else
/* If not, then the default behavior is to just set the state. */
pika_action_impl_set_state (PIKA_ACTION (action), value);
}
static gboolean
pika_action_impl_get_enabled (GAction *action)
{
return pika_action_is_sensitive (PIKA_ACTION (action), NULL);
}
static const GVariantType *
pika_action_impl_get_parameter_type (GAction *action)
{
PikaActionImpl *impl = PIKA_ACTION_IMPL (action);
return impl->priv->parameter_type;
}
static const GVariantType *
pika_action_impl_get_state_type (GAction *action)
{
PikaActionImpl *impl = PIKA_ACTION_IMPL (action);
if (impl->priv->state != NULL)
return g_variant_get_type (impl->priv->state);
else
return NULL;
}
static GVariant *
pika_action_impl_get_state (GAction *action)
{
PikaActionImpl *impl = PIKA_ACTION_IMPL (action);
return impl->priv->state ? g_variant_ref (impl->priv->state) : NULL;
}
static GVariant *
pika_action_impl_get_state_hint (GAction *action)
{
PikaActionImpl *impl = PIKA_ACTION_IMPL (action);
if (impl->priv->state_hint != NULL)
return g_variant_ref (impl->priv->state_hint);
else
return NULL;
}
/* public functions */
PikaAction *
pika_action_impl_new (const gchar *name,
const gchar *label,
const gchar *short_label,
const gchar *tooltip,
const gchar *icon_name,
const gchar *help_id,
PikaContext *context)
{
PikaAction *action;
action = g_object_new (PIKA_TYPE_ACTION_IMPL,
"name", name,
"label", label,
"short-label", short_label,
"tooltip", tooltip,
"icon-name", icon_name,
"context", context,
NULL);
pika_action_set_help_id (action, help_id);
return action;
}
/* private functions */
static void
pika_action_impl_set_state (PikaAction *pika_action,
GVariant *value)
{
PikaActionImpl *impl;
const GVariantType *state_type;
g_return_if_fail (PIKA_IS_ACTION (pika_action));
g_return_if_fail (value != NULL);
impl = PIKA_ACTION_IMPL (pika_action);
state_type = impl->priv->state ? g_variant_get_type (impl->priv->state) : NULL;
g_return_if_fail (state_type != NULL);
g_return_if_fail (g_variant_is_of_type (value, state_type));
g_variant_ref_sink (value);
if (! impl->priv->state || ! g_variant_equal (impl->priv->state, value))
{
if (impl->priv->state)
g_variant_unref (impl->priv->state);
impl->priv->state = g_variant_ref (value);
g_object_notify (G_OBJECT (impl), "state");
}
g_variant_unref (value);
}