PIKApp/libpika/pikapropchooser-private.c

93 lines
3.2 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 <gegl-paramspecs.h>
#include <gtk/gtk.h>
#include "pikaui.h"
#include "pikapropchooser-private.h"
/* PropChooser
* A GtkWidget, more specifically a GtkButtonWidget.
* Pops up a chooser widget.
* Has Prop widget trait, i.e. binds property of the chooser widget
* to a property of a ProcedureConfig.
*
* For now, only for Resource choosers,
* which are named PikaResourceSelectButton ("select" means "choose")
*
* A factory creates the widgets.
*/
/* Not public i.e. not annotated.
*
* Used only by PikaProcedureDialog.
* These could be in the public API,
* if we want plugins to create their own widget that updates the plugin's own property.
*
* The following is in the style of GObject annotations, but is not public.
* @config: Object to which property is attached.
* @property_name: Name of property controlled by button.
*
* Creates a #PikaBrushSelectButton that displays and sets the property.
*
* @config is usually a PikaProcedureConfig (but it could be otherwise.)
* The @config must have a property with name @property_name.
* The property must be type #PikaBrush.
* The @property_name need not be "brush",
* since the @config may have more than one property of type #PikaBrush.
*
* The button is labeled with the @property_name's nick.
*
* When pushed, the button shows a dialog that lets the user choose a brush.
*/
GtkWidget *
pika_prop_chooser_brush_new (GObject *config, const gchar *property_name, const gchar *title)
{
return pika_prop_chooser_factory (pika_brush_select_button_new, config, property_name, title);
};
GtkWidget *
pika_prop_chooser_font_new (GObject *config, const gchar *property_name, const gchar *title)
{
return pika_prop_chooser_factory (pika_font_select_button_new, config, property_name, title);
};
GtkWidget *
pika_prop_chooser_gradient_new (GObject *config, const gchar *property_name, const gchar *title)
{
return pika_prop_chooser_factory (pika_gradient_select_button_new, config, property_name, title);
};
GtkWidget *
pika_prop_chooser_palette_new (GObject *config, const gchar *property_name, const gchar *title)
{
return pika_prop_chooser_factory (pika_palette_select_button_new, config, property_name, title);
};
GtkWidget *
pika_prop_chooser_pattern_new (GObject *config, const gchar *property_name, const gchar *title)
{
return pika_prop_chooser_factory (pika_pattern_select_button_new, config, property_name, title);
};