/* * GTK - The GIMP Toolkit * Copyright (C) 1998, 1999 Red Hat, Inc. * All rights reserved. * * This Library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public License as * published by the Free Software Foundation; either version 2 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 Library General Public * License along with this library. If not, see . */ /* Color picker button for GNOME * * Author: Federico Mena * * Modified by the GTK+ Team and others 2003. See the AUTHORS * file for a list of people on the GTK+ Team. See the ChangeLog * files for a list of changes. These files are distributed with * GTK+ at ftp://ftp.gtk.org/pub/gtk/. */ #include "config.h" #include "gtkcolorbutton.h" #include "gtkbinlayout.h" #include "gtkbutton.h" #include "gtkcolorchooser.h" #include "gtkcolorchooserprivate.h" #include "gtkcolorchooserdialog.h" #include "gtkcolorswatchprivate.h" #include "gtkdragdest.h" #include "gtkdragsource.h" #include "gtkintl.h" #include "gtkmain.h" #include "gtkmarshalers.h" #include "gtkprivate.h" #include "gtksnapshot.h" #include "gtkstylecontext.h" #include "gtkdragsource.h" #include "gtkdragdest.h" #include "gtkeventcontroller.h" /** * SECTION:gtkcolorbutton * @Short_description: A button to launch a color selection dialog * @Title: GtkColorButton * @See_also: #GtkFontButton * * The #GtkColorButton is a button which displays the currently selected * color and allows to open a color selection dialog to change the color. * It is suitable widget for selecting a color in a preference dialog. * * # CSS nodes * * GtkColorButton has a single CSS node with name button. To differentiate * it from a plain #GtkButton, it gets the .color style class. */ typedef struct _GtkColorButtonClass GtkColorButtonClass; struct _GtkColorButton { GtkWidget parent_instance; }; struct _GtkColorButtonClass { GtkWidgetClass parent_class; void (* color_set) (GtkColorButton *cp); }; typedef struct { GtkWidget *button; GtkWidget *swatch; /* Widget where we draw the color sample */ GtkWidget *cs_dialog; /* Color selection dialog */ gchar *title; /* Title for the color selection window */ GdkRGBA rgba; guint use_alpha : 1; /* Use alpha or not */ guint show_editor : 1; } GtkColorButtonPrivate; /* Properties */ enum { PROP_0, PROP_USE_ALPHA, PROP_TITLE, PROP_RGBA, PROP_SHOW_EDITOR }; /* Signals */ enum { COLOR_SET, LAST_SIGNAL }; /* gobject signals */ static void gtk_color_button_finalize (GObject *object); static void gtk_color_button_set_property (GObject *object, guint param_id, const GValue *value, GParamSpec *pspec); static void gtk_color_button_get_property (GObject *object, guint param_id, GValue *value, GParamSpec *pspec); /* gtkbutton signals */ static void gtk_color_button_clicked (GtkButton *button, gpointer user_data); static guint color_button_signals[LAST_SIGNAL] = { 0 }; static const char *drop_types[] = { "application/x-color" }; static void gtk_color_button_iface_init (GtkColorChooserInterface *iface); G_DEFINE_TYPE_WITH_CODE (GtkColorButton, gtk_color_button, GTK_TYPE_WIDGET, G_ADD_PRIVATE (GtkColorButton) G_IMPLEMENT_INTERFACE (GTK_TYPE_COLOR_CHOOSER, gtk_color_button_iface_init)) static void gtk_color_button_class_init (GtkColorButtonClass *klass) { GObjectClass *gobject_class; GtkWidgetClass *widget_class; gobject_class = G_OBJECT_CLASS (klass); widget_class = GTK_WIDGET_CLASS (klass); gobject_class->get_property = gtk_color_button_get_property; gobject_class->set_property = gtk_color_button_set_property; gobject_class->finalize = gtk_color_button_finalize; klass->color_set = NULL; /** * GtkColorButton:use-alpha: * * If this property is set to %TRUE, the color swatch on the button is * rendered against a checkerboard background to show its opacity and * the opacity slider is displayed in the color selection dialog. */ g_object_class_install_property (gobject_class, PROP_USE_ALPHA, g_param_spec_boolean ("use-alpha", P_("Use alpha"), P_("Whether to give the color an alpha value"), FALSE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); /** * GtkColorButton:title: * * The title of the color selection dialog */ g_object_class_install_property (gobject_class, PROP_TITLE, g_param_spec_string ("title", P_("Title"), P_("The title of the color selection dialog"), _("Pick a Color"), GTK_PARAM_READWRITE)); /** * GtkColorButton:rgba: * * The RGBA color. */ g_object_class_install_property (gobject_class, PROP_RGBA, g_param_spec_boxed ("rgba", P_("Current RGBA Color"), P_("The selected RGBA color"), GDK_TYPE_RGBA, GTK_PARAM_READWRITE)); /** * GtkColorButton::color-set: * @widget: the object which received the signal. * * The ::color-set signal is emitted when the user selects a color. * When handling this signal, use gtk_color_chooser_get_rgba() to * find out which color was just selected. * * Note that this signal is only emitted when the user * changes the color. If you need to react to programmatic color changes * as well, use the notify::color signal. */ color_button_signals[COLOR_SET] = g_signal_new (I_("color-set"), G_TYPE_FROM_CLASS (gobject_class), G_SIGNAL_RUN_FIRST, G_STRUCT_OFFSET (GtkColorButtonClass, color_set), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkColorButton:show-editor: * * Set this property to %TRUE to skip the palette * in the dialog and go directly to the color editor. * * This property should be used in cases where the palette * in the editor would be redundant, such as when the color * button is already part of a palette. */ g_object_class_install_property (gobject_class, PROP_SHOW_EDITOR, g_param_spec_boolean ("show-editor", P_("Show Editor"), P_("Whether to show the color editor right away"), FALSE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); gtk_widget_class_set_layout_manager_type (widget_class, GTK_TYPE_BIN_LAYOUT); gtk_widget_class_set_css_name (widget_class, "colorbutton"); } static void got_color (GObject *source, GAsyncResult *result, gpointer data) { GdkDrop *drop = GDK_DROP (source); const GValue *value; value = gdk_drop_read_value_finish (drop, result, NULL); if (value) { GdkRGBA *color = g_value_get_boxed (value); gtk_color_chooser_set_rgba (GTK_COLOR_CHOOSER (data), color); gdk_drop_finish (drop, GDK_ACTION_COPY); } else gdk_drop_finish (drop, 0); } static gboolean gtk_color_button_drag_drop (GtkDropTarget *dest, GdkDrop *drop, int x, int y, GtkColorButton *button) { if (gdk_drop_has_value (drop, GDK_TYPE_RGBA)) { gdk_drop_read_value_async (drop, GDK_TYPE_RGBA, G_PRIORITY_DEFAULT, NULL, got_color, button); return TRUE; } return FALSE; } static void gtk_color_button_drag_begin (GtkDragSource *source, GdkDrag *drag, GtkColorButton *button) { GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); GtkSnapshot *snapshot; GdkPaintable *paintable; snapshot = gtk_snapshot_new (); gtk_snapshot_append_color (snapshot, &priv->rgba, &GRAPHENE_RECT_INIT(0, 0, 48, 32)); paintable = gtk_snapshot_free_to_paintable (snapshot, NULL); gtk_drag_source_set_icon (source, paintable, 0, 0); g_object_unref (paintable); } static void get_rgba_value (GValue *value, gpointer data) { GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (GTK_COLOR_BUTTON (data)); g_value_set_boxed (value, &priv->rgba); } static void gtk_color_button_init (GtkColorButton *button) { GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); PangoLayout *layout; PangoRectangle rect; GtkStyleContext *context; GdkContentFormats *targets; GdkContentProvider *content; GtkDragSource *source; GtkDropTarget *dest; priv->button = gtk_button_new (); g_signal_connect (priv->button, "clicked", G_CALLBACK (gtk_color_button_clicked), button); gtk_widget_set_parent (priv->button, GTK_WIDGET (button)); priv->swatch = gtk_color_swatch_new (); layout = gtk_widget_create_pango_layout (GTK_WIDGET (button), "Black"); pango_layout_get_pixel_extents (layout, NULL, &rect); g_object_unref (layout); gtk_widget_set_size_request (priv->swatch, rect.width, rect.height); gtk_container_add (GTK_CONTAINER (priv->button), priv->swatch); priv->title = g_strdup (_("Pick a Color")); /* default title */ /* Start with opaque black, alpha disabled */ priv->rgba.red = 0; priv->rgba.green = 0; priv->rgba.blue = 0; priv->rgba.alpha = 1; priv->use_alpha = FALSE; targets = gdk_content_formats_new (drop_types, G_N_ELEMENTS (drop_types)); dest = gtk_drop_target_new (targets, GDK_ACTION_COPY); g_signal_connect (dest, "drag-drop", G_CALLBACK (gtk_color_button_drag_drop), button); gtk_widget_add_controller (GTK_WIDGET (button), GTK_EVENT_CONTROLLER (dest)); gdk_content_formats_unref (targets); source = gtk_drag_source_new (); content = gdk_content_provider_new_with_callback (GDK_TYPE_RGBA, get_rgba_value, button); gtk_drag_source_set_content (source, content); g_object_unref (content); g_signal_connect (source, "drag-begin", G_CALLBACK (gtk_color_button_drag_begin), button); gtk_widget_add_controller (priv->button, GTK_EVENT_CONTROLLER (source)); context = gtk_widget_get_style_context (GTK_WIDGET (priv->button)); gtk_style_context_add_class (context, "color"); } static void gtk_color_button_finalize (GObject *object) { GtkColorButton *button = GTK_COLOR_BUTTON (object); GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); if (priv->cs_dialog != NULL) gtk_widget_destroy (priv->cs_dialog); g_free (priv->title); gtk_widget_unparent (priv->button); G_OBJECT_CLASS (gtk_color_button_parent_class)->finalize (object); } /** * gtk_color_button_new: * * Creates a new color button. * * This returns a widget in the form of a small button containing * a swatch representing the current selected color. When the button * is clicked, a color-selection dialog will open, allowing the user * to select a color. The swatch will be updated to reflect the new * color when the user finishes. * * Returns: a new color button */ GtkWidget * gtk_color_button_new (void) { return g_object_new (GTK_TYPE_COLOR_BUTTON, NULL); } /** * gtk_color_button_new_with_rgba: * @rgba: A #GdkRGBA to set the current color with * * Creates a new color button. * * Returns: a new color button */ GtkWidget * gtk_color_button_new_with_rgba (const GdkRGBA *rgba) { return g_object_new (GTK_TYPE_COLOR_BUTTON, "rgba", rgba, NULL); } static gboolean dialog_destroy (GtkWidget *widget, gpointer data) { GtkColorButton *button = GTK_COLOR_BUTTON (data); GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); priv->cs_dialog = NULL; return FALSE; } static void dialog_response (GtkDialog *dialog, gint response, gpointer data) { if (response == GTK_RESPONSE_CANCEL) gtk_widget_hide (GTK_WIDGET (dialog)); else if (response == GTK_RESPONSE_OK) { GtkColorButton *button = GTK_COLOR_BUTTON (data); GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); gtk_color_chooser_get_rgba (GTK_COLOR_CHOOSER (dialog), &priv->rgba); gtk_color_swatch_set_rgba (GTK_COLOR_SWATCH (priv->swatch), &priv->rgba); gtk_widget_hide (GTK_WIDGET (dialog)); g_object_ref (button); g_signal_emit (button, color_button_signals[COLOR_SET], 0); g_object_freeze_notify (G_OBJECT (button)); g_object_notify (G_OBJECT (button), "rgba"); g_object_thaw_notify (G_OBJECT (button)); g_object_unref (button); } } /* Create the dialog and connects its buttons */ static void ensure_dialog (GtkColorButton *button) { GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); GtkWidget *parent, *dialog; if (priv->cs_dialog != NULL) return; parent = GTK_WIDGET (gtk_widget_get_root (GTK_WIDGET (button))); priv->cs_dialog = dialog = gtk_color_chooser_dialog_new (priv->title, NULL); gtk_window_set_hide_on_close (GTK_WINDOW (dialog), TRUE); if (GTK_IS_WINDOW (parent)) { if (GTK_WINDOW (parent) != gtk_window_get_transient_for (GTK_WINDOW (dialog))) gtk_window_set_transient_for (GTK_WINDOW (dialog), GTK_WINDOW (parent)); gtk_window_set_modal (GTK_WINDOW (dialog), gtk_window_get_modal (GTK_WINDOW (parent))); } g_signal_connect (dialog, "response", G_CALLBACK (dialog_response), button); g_signal_connect (dialog, "destroy", G_CALLBACK (dialog_destroy), button); } static void gtk_color_button_clicked (GtkButton *b, gpointer user_data) { GtkColorButton *button = user_data; GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); /* if dialog already exists, make sure it's shown and raised */ ensure_dialog (button); g_object_set (priv->cs_dialog, "show-editor", priv->show_editor, NULL); gtk_color_chooser_set_use_alpha (GTK_COLOR_CHOOSER (priv->cs_dialog), priv->use_alpha); gtk_color_chooser_set_rgba (GTK_COLOR_CHOOSER (priv->cs_dialog), &priv->rgba); G_GNUC_BEGIN_IGNORE_DEPRECATIONS gtk_window_present (GTK_WINDOW (priv->cs_dialog)); G_GNUC_END_IGNORE_DEPRECATIONS } static void gtk_color_button_set_rgba (GtkColorChooser *chooser, const GdkRGBA *rgba) { GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (GTK_COLOR_BUTTON (chooser)); g_return_if_fail (GTK_IS_COLOR_BUTTON (chooser)); g_return_if_fail (rgba != NULL); priv->rgba = *rgba; gtk_color_swatch_set_rgba (GTK_COLOR_SWATCH (priv->swatch), &priv->rgba); g_object_notify (G_OBJECT (chooser), "rgba"); } static void gtk_color_button_get_rgba (GtkColorChooser *chooser, GdkRGBA *rgba) { GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (GTK_COLOR_BUTTON (chooser)); g_return_if_fail (GTK_IS_COLOR_BUTTON (chooser)); g_return_if_fail (rgba != NULL); *rgba = priv->rgba; } static void set_use_alpha (GtkColorButton *button, gboolean use_alpha) { GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); use_alpha = (use_alpha != FALSE); if (priv->use_alpha != use_alpha) { priv->use_alpha = use_alpha; gtk_color_swatch_set_use_alpha (GTK_COLOR_SWATCH (priv->swatch), use_alpha); g_object_notify (G_OBJECT (button), "use-alpha"); } } /** * gtk_color_button_set_title: * @button: a #GtkColorButton * @title: String containing new window title * * Sets the title for the color selection dialog. */ void gtk_color_button_set_title (GtkColorButton *button, const gchar *title) { GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); gchar *old_title; g_return_if_fail (GTK_IS_COLOR_BUTTON (button)); old_title = priv->title; priv->title = g_strdup (title); g_free (old_title); if (priv->cs_dialog) gtk_window_set_title (GTK_WINDOW (priv->cs_dialog), priv->title); g_object_notify (G_OBJECT (button), "title"); } /** * gtk_color_button_get_title: * @button: a #GtkColorButton * * Gets the title of the color selection dialog. * * Returns: An internal string, do not free the return value */ const gchar * gtk_color_button_get_title (GtkColorButton *button) { GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); g_return_val_if_fail (GTK_IS_COLOR_BUTTON (button), NULL); return priv->title; } static void gtk_color_button_set_property (GObject *object, guint param_id, const GValue *value, GParamSpec *pspec) { GtkColorButton *button = GTK_COLOR_BUTTON (object); GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); switch (param_id) { case PROP_USE_ALPHA: set_use_alpha (button, g_value_get_boolean (value)); break; case PROP_TITLE: gtk_color_button_set_title (button, g_value_get_string (value)); break; case PROP_RGBA: gtk_color_chooser_set_rgba (GTK_COLOR_CHOOSER (button), g_value_get_boxed (value)); break; case PROP_SHOW_EDITOR: { gboolean show_editor = g_value_get_boolean (value); if (priv->show_editor != show_editor) { priv->show_editor = show_editor; g_object_notify (object, "show-editor"); } } break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec); break; } } static void gtk_color_button_get_property (GObject *object, guint param_id, GValue *value, GParamSpec *pspec) { GtkColorButton *button = GTK_COLOR_BUTTON (object); GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); switch (param_id) { case PROP_USE_ALPHA: g_value_set_boolean (value, priv->use_alpha); break; case PROP_TITLE: g_value_set_string (value, gtk_color_button_get_title (button)); break; case PROP_RGBA: { GdkRGBA rgba; gtk_color_chooser_get_rgba (GTK_COLOR_CHOOSER (button), &rgba); g_value_set_boxed (value, &rgba); } break; case PROP_SHOW_EDITOR: g_value_set_boolean (value, priv->show_editor); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec); break; } } static void gtk_color_button_add_palette (GtkColorChooser *chooser, GtkOrientation orientation, gint colors_per_line, gint n_colors, GdkRGBA *colors) { GtkColorButton *button = GTK_COLOR_BUTTON (chooser); GtkColorButtonPrivate *priv = gtk_color_button_get_instance_private (button); ensure_dialog (button); gtk_color_chooser_add_palette (GTK_COLOR_CHOOSER (priv->cs_dialog), orientation, colors_per_line, n_colors, colors); } static void gtk_color_button_iface_init (GtkColorChooserInterface *iface) { iface->get_rgba = gtk_color_button_get_rgba; iface->set_rgba = gtk_color_button_set_rgba; iface->add_palette = gtk_color_button_add_palette; }