PIKApp/libpika/pikaresourceselectbutton.c

601 lines
20 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
*
* 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
* Library 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 <gegl.h>
#include <gtk/gtk.h>
#include "libpikawidgets/pikawidgets.h"
#include "pika.h"
#include "pikauitypes.h"
#include "pikaresourceselectbutton.h"
#include "pikauimarshal.h"
#include "libpika-intl.h"
/**
* SECTION: pikaresourceselectbutton
* @title: PikaResourceSelectButton
* @short_description: Base class for buttons that popup a resource
* selection dialog.
*
* A button which pops up a resource selection dialog.
*
* Subclasses: PikaFontSelectButton is a minimal one.
* A subclass provides button trait (clickable),
* but possibly not a GtkButton and may have many sub widgets.
*
* Responsibilities:
*
* - implementing outer container widget,
* - managing clicks and popping up a remote chooser,
* - having a resource property,
* - signaling when user selects resource
* - receiving drag,
* - triggering draws of the button interior (by subclass) and draws of remote popup chooser.
*
* Collaborations:
*
* - owned by PikaProcedureDialog via PikaPropWidget
* - resource property usually bound to a PikaConfig for a PikaPluginProcedure.
* - communicates using PikaResourceSelect with remote PikaPDBDialog,
* to choose an installed PikaResource owned by core.
*
* Subclass responsibilities:
*
* - creating interior widgets
* - drawing the interior (a preview of the chosen resource)
* - declaring which interior widgets are drag destinations
* - declaring which interior widgets are clickable (generate "clicked" signal)
* - generate "clicked" (delegating to GtkButton or implementing from mouse events)
*
* Class is abstract and cannot be instantiated: no new () method.
* Instead, instantiate a subclass.
*
* Since: 3.0
**/
enum
{
RESOURCE_SET,
LAST_SIGNAL
};
enum
{
PROP_0,
PROP_TITLE,
PROP_RESOURCE,
N_PROPS
};
typedef struct
{
PikaResource *resource;
gchar *title;
const gchar *temp_callback_from_remote_dialog;
GtkWidget *interior_widget;
} PikaResourceSelectButtonPrivate;
/* local function prototypes */
static void pika_resource_select_button_dispose (GObject *object);
static void pika_resource_select_button_finalize (GObject *object);
static void pika_resource_select_button_set_property (GObject *object,
guint property_id,
const GValue *value,
GParamSpec *pspec);
static void pika_resource_select_button_get_property (GObject *object,
guint property_id,
GValue *value,
GParamSpec *pspec);
static void pika_resource_select_button_clicked (PikaResourceSelectButton *self);
static void pika_resource_select_button_callback (PikaResource *resource,
gboolean dialog_closing,
gpointer user_data);
static void pika_resource_select_drag_data_received (PikaResourceSelectButton *self,
GdkDragContext *context,
gint x,
gint y,
GtkSelectionData *selection,
guint info,
guint time);
static void pika_resource_select_button_set_remote_dialog (PikaResourceSelectButton *self,
PikaResource *resource);
static void pika_resource_select_button_draw_interior (PikaResourceSelectButton *self,
PikaResource *resource);
static guint resource_button_signals[LAST_SIGNAL] = { 0 };
static GParamSpec *resource_button_props[N_PROPS] = { NULL, };
G_DEFINE_TYPE_WITH_PRIVATE (PikaResourceSelectButton, pika_resource_select_button,
GTK_TYPE_BOX)
static void
pika_resource_select_button_class_init (PikaResourceSelectButtonClass *klass)
{
GObjectClass *object_class = G_OBJECT_CLASS (klass);
object_class->dispose = pika_resource_select_button_dispose;
object_class->finalize = pika_resource_select_button_finalize;
object_class->set_property = pika_resource_select_button_set_property;
object_class->get_property = pika_resource_select_button_get_property;
klass->resource_set = NULL;
/**
* PikaResourceSelectButton:title:
*
* The title to be used for the resource selection popup dialog.
*
* Since: 2.4
*/
resource_button_props[PROP_TITLE] =
g_param_spec_string ("title",
"Title",
"The title to be used for the resource selection popup dialog",
"Resource Selection",
PIKA_PARAM_READWRITE |
G_PARAM_CONSTRUCT_ONLY);
/**
* PikaResourceSelectButton:resource:
*
* The currently selected resource.
*
* Since: 2.4
*/
resource_button_props[PROP_RESOURCE] =
pika_param_spec_resource ("resource",
"Resource",
"The currently selected resource",
TRUE, /* none_ok */
PIKA_PARAM_READWRITE);
g_object_class_install_properties (object_class,
N_PROPS, resource_button_props);
/**
* PikaResourceSelectButton::resource-set:
* @widget: the object which received the signal.
* @resource: the currently selected resource.
* @dialog_closing: whether the dialog was closed or not.
*
* The ::resource-set signal is emitted when the user selects a resource.
*
* Since: 2.4
*/
resource_button_signals[RESOURCE_SET] =
g_signal_new ("resource-set",
G_TYPE_FROM_CLASS (klass),
G_SIGNAL_RUN_FIRST,
G_STRUCT_OFFSET (PikaResourceSelectButtonClass, resource_set),
NULL, NULL,
_pikaui_marshal_VOID__POINTER_BOOLEAN,
G_TYPE_NONE, 2,
G_TYPE_OBJECT,
G_TYPE_BOOLEAN);
}
static void
pika_resource_select_button_init (PikaResourceSelectButton *self)
{
gtk_orientable_set_orientation (GTK_ORIENTABLE (self),
GTK_ORIENTATION_HORIZONTAL);
gtk_box_set_spacing (GTK_BOX (self), 6);
}
static void
pika_resource_select_button_dispose (GObject *self)
{
pika_resource_select_button_close_popup (PIKA_RESOURCE_SELECT_BUTTON (self));
G_OBJECT_CLASS (pika_resource_select_button_parent_class)->dispose (self);
}
static void
pika_resource_select_button_finalize (GObject *object)
{
PikaResourceSelectButton *self = PIKA_RESOURCE_SELECT_BUTTON (object);
PikaResourceSelectButtonPrivate *priv = pika_resource_select_button_get_instance_private (self);
g_clear_pointer (&priv->title, g_free);
G_OBJECT_CLASS (pika_resource_select_button_parent_class)->finalize (object);
}
/**
* pika_resource_select_button_set_drag_target:
* @self: A #PikaResourceSelectButton
* @drag_region_widget: An interior widget to be a droppable region
* and emit "drag-data-received" signal
* @drag_target: The drag target to accept
*
* Called by a subclass init to specialize the instance.
*
* Subclass knows its interior widget whose region is a drop zone.
* Subclass knows what things can be dropped (target.)
* Self (super) handles the drop.
*
* Since: 3.0
**/
void
pika_resource_select_button_set_drag_target (PikaResourceSelectButton *self,
GtkWidget *drag_region_widget,
const GtkTargetEntry *drag_target)
{
g_return_if_fail (PIKA_IS_RESOURCE_SELECT_BUTTON (self));
g_return_if_fail (drag_target != NULL);
g_return_if_fail (drag_region_widget != NULL);
gtk_drag_dest_set (drag_region_widget,
GTK_DEST_DEFAULT_HIGHLIGHT |
GTK_DEST_DEFAULT_MOTION |
GTK_DEST_DEFAULT_DROP,
drag_target, 1, /* Pass array of size 1 */
GDK_ACTION_COPY);
/* connect drag_region_widget's drag_received signal to self's callback. */
g_signal_connect_swapped (drag_region_widget, "drag-data-received",
G_CALLBACK (pika_resource_select_drag_data_received),
self);
}
/**
* pika_resource_select_button_set_clickable:
* @self: A #PikaResourceSelectButton
* @widget: An interior widget that emits "clicked" signal
*
* Called by a subclass init to specialize the instance.
*
* Subclass knows its interior widget whose region when clicked
* should popup remote chooser.
* Self handles the click event.
*
* Since: 3.0
**/
void
pika_resource_select_button_set_clickable (PikaResourceSelectButton *self,
GtkWidget *widget)
{
g_return_if_fail (PIKA_IS_RESOURCE_SELECT_BUTTON (self));
g_return_if_fail (widget != NULL);
g_return_if_fail (GTK_IS_WIDGET (widget));
/* Require the widget have a signal "clicked", usually a button. */
g_signal_connect_swapped (widget, "clicked",
G_CALLBACK (pika_resource_select_button_clicked),
self);
}
/**
* pika_resource_select_button_get_resource:
* @self: A #PikaResourceSelectButton
*
* Gets the currently selected resource.
*
* Returns: (transfer none): an internal copy of the resource which must not be freed.
* You should ref and unref it when you want to own the resource.
*
* Since: 2.4
*/
PikaResource *
pika_resource_select_button_get_resource (PikaResourceSelectButton *self)
{
PikaResourceSelectButtonPrivate *priv;
g_return_val_if_fail (PIKA_IS_RESOURCE_SELECT_BUTTON (self), NULL);
priv = pika_resource_select_button_get_instance_private (self);
return priv->resource;
}
/**
* pika_resource_select_button_set_resource:
* @self: A #PikaResourceSelectButton
* @resource: Resource to set.
*
* Sets the currently selected resource.
* This will select the resource in both the button and any chooser popup.
*
* Since: 2.4
*/
void
pika_resource_select_button_set_resource (PikaResourceSelectButton *self,
PikaResource *resource)
{
PikaResourceSelectButtonPrivate *priv;
g_return_if_fail (PIKA_IS_RESOURCE_SELECT_BUTTON (self));
g_return_if_fail (resource != NULL);
priv = pika_resource_select_button_get_instance_private (self);
if (priv->temp_callback_from_remote_dialog)
{
/* A popup chooser dialog is already shown.
* Call its setter to change the selection there
* (since all views of the resource must be consistent.)
* That will call back, which will change our own view of the resource.
*/
pika_resource_select_button_set_remote_dialog (self, resource);
}
else
{
/* Call our own setter. */
pika_resource_select_button_callback (resource, FALSE, self);
}
}
/* Calls the virtual method of a similar name, which subclasses must override.
*
* resource: The instance to be drawn.
*
* A subclass knows how to draw its interior.
* Called by super when the view is invalidated (needs to be redrawn.)
* Not public.
*/
static void
pika_resource_select_button_draw_interior (PikaResourceSelectButton *self,
PikaResource *resource)
{
PikaResourceSelectButtonClass *klass;
g_return_if_fail (PIKA_IS_RESOURCE_SELECT_BUTTON (self));
g_return_if_fail (PIKA_IS_RESOURCE (resource));
klass = PIKA_RESOURCE_SELECT_BUTTON_GET_CLASS (self);
g_return_if_fail (klass->draw_interior != NULL);
klass->draw_interior (self);
}
/* private functions */
static void
pika_resource_select_button_set_remote_dialog (PikaResourceSelectButton *self,
PikaResource *resource)
{
PikaResourceSelectButtonPrivate *priv;
PikaResourceSelectButtonClass *klass;
g_return_if_fail (PIKA_IS_RESOURCE_SELECT_BUTTON (self));
g_return_if_fail (resource != NULL);
priv = pika_resource_select_button_get_instance_private (self);
klass = PIKA_RESOURCE_SELECT_BUTTON_GET_CLASS (self);
g_return_if_fail (klass->resource_type != G_TYPE_INVALID);
/* The ultimate remote setter is e.g. pika_fonts_set_popup, a PDB procedure.
*
* !!! Use the passed resource, not priv->resource.
* Expect a callback which will change priv->resource.
*/
pika_resource_select_set (priv->temp_callback_from_remote_dialog,
resource,
klass->resource_type);
}
static void
pika_resource_select_button_set_property (GObject *object,
guint property_id,
const GValue *gvalue,
GParamSpec *pspec)
{
PikaResourceSelectButton *self = PIKA_RESOURCE_SELECT_BUTTON (object);
PikaResourceSelectButtonPrivate *priv = pika_resource_select_button_get_instance_private (self);
switch (property_id)
{
case PROP_TITLE:
priv->title = g_value_dup_string (gvalue);
break;
case PROP_RESOURCE:
priv->resource = g_value_get_object (gvalue);
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
break;
}
}
static void
pika_resource_select_button_get_property (GObject *object,
guint property_id,
GValue *value,
GParamSpec *pspec)
{
PikaResourceSelectButton *self = PIKA_RESOURCE_SELECT_BUTTON (object);
PikaResourceSelectButtonPrivate *priv = pika_resource_select_button_get_instance_private (self);
switch (property_id)
{
case PROP_TITLE:
g_value_set_string (value, priv->title);
break;
case PROP_RESOURCE:
g_value_set_object (value, priv->resource);
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
break;
}
}
/* A callback from the remote resource select popup.
* When user chooses a resource.
* Via a temporary PDB procedure.
*
* Set self's model (priv->resource)
* Notify any parent widget subscribed on the "resource" property
* typically a prop widget.
* Update the view, since model changed.
*/
static void
pika_resource_select_button_callback (PikaResource *resource,
gboolean dialog_closing,
gpointer user_data)
{
PikaResourceSelectButton *self = PIKA_RESOURCE_SELECT_BUTTON (user_data);
PikaResourceSelectButtonPrivate *priv = pika_resource_select_button_get_instance_private (self);
priv->resource = resource;
/* Feedback user choice of resource into the look of the widget interior.
* Call virtual method overridden by subclass.
*/
pika_resource_select_button_draw_interior (self, priv->resource);
if (dialog_closing)
priv->temp_callback_from_remote_dialog = NULL;
g_signal_emit (self, resource_button_signals[RESOURCE_SET], 0,
resource, dialog_closing);
g_object_notify_by_pspec (G_OBJECT (self),
resource_button_props[PROP_RESOURCE]);
}
static void
pika_resource_select_button_clicked (PikaResourceSelectButton *self)
{
PikaResourceSelectButtonPrivate *priv = pika_resource_select_button_get_instance_private (self);
PikaResourceSelectButtonClass *klass = PIKA_RESOURCE_SELECT_BUTTON_GET_CLASS (self);
if (priv->temp_callback_from_remote_dialog)
{
/* Popup already created. Calling setter raises the popup. */
pika_resource_select_button_set_remote_dialog (self, priv->resource);
}
else
{
/* Call PikaResourceSelect which dispatches on resource_type. */
priv->temp_callback_from_remote_dialog =
pika_resource_select_new (priv->title,
priv->resource,
klass->resource_type,
pika_resource_select_button_callback,
self,
NULL); /* No func to free data. */
}
}
/* Drag methods. */
static void
pika_resource_select_drag_data_received (PikaResourceSelectButton *self,
GdkDragContext *context,
gint x,
gint y,
GtkSelectionData *selection,
guint info,
guint time)
{
gint length = gtk_selection_data_get_length (selection);
gchar *str;
PikaResourceSelectButtonClass *klass;
klass = PIKA_RESOURCE_SELECT_BUTTON_GET_CLASS (self);
/* Require class resource_type was initialized. */
g_assert (klass->resource_type != 0);
/* Drag data is a string that is the ID of the resource. */
if (gtk_selection_data_get_format (selection) != 8 || length < 1)
{
g_warning ("%s: received invalid resource data", G_STRFUNC);
return;
}
str = g_strndup ((const gchar *) gtk_selection_data_get_data (selection),
length);
if (g_utf8_validate (str, -1, NULL))
{
gint pid;
gpointer unused;
gint name_offset = 0;
if (sscanf (str, "%i:%p:%n", &pid, &unused, &name_offset) >= 2 &&
pid == pika_getpid () && name_offset > 0)
{
gchar *name = str + name_offset;
PikaResource *resource;
resource = pika_resource_get_by_name (klass->resource_type, name);
pika_resource_select_button_set_resource (self, resource);
}
}
g_free (str);
}
/**
* pika_resource_select_button_close_popup:
* @self: A #PikaResourceSelectButton
*
* Closes the popup resource chooser dialog associated with @self.
*
* FUTURE: Possibly obsolete this by making it private,
* since only called by script-fu-interface.c.
* Might be needed if we allow plugins to implement their own dialogs.
*
* Since: 2.4
*/
void
pika_resource_select_button_close_popup (PikaResourceSelectButton *self)
{
PikaResourceSelectButtonPrivate *priv;
g_return_if_fail (PIKA_IS_RESOURCE_SELECT_BUTTON (self));
priv = pika_resource_select_button_get_instance_private (self);
if (priv->temp_callback_from_remote_dialog)
{
pika_resource_select_destroy (priv->temp_callback_from_remote_dialog);
priv->temp_callback_from_remote_dialog = NULL;
}
/* Else already closed. */
}