d7fb0842a1
I tried to have a not too overwhelming API, so we just ask for the label and initial color at construction. We keep sane defaults for the rest and let people tweak the result by getting the color area widgets themselves (if they need to force-showing flat colors or change the drag buttons in particular). Another thing I wondered about was the initial size of the color area. Without a size request or being in some container expanding its children (which may also be ugly), it ends up too small. I can imagine such widget being used especially when you want to display several color rectangles next to each other with a label each. So I just set it this way. Anyone is free to request a resize after constructing the object. Last but not least, the position of the label was especially of interest here. For my idea of a list of colors, I could definitely imagine color blocks aligned with vertically-oriented labels above or below. It might be worth adding an API for this later on.
114 lines
5.1 KiB
C
114 lines
5.1 KiB
C
/* LIBGIMP - The GIMP Library
|
|
* Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
|
|
*
|
|
* gimpwidgetstypes.h
|
|
*
|
|
* 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
|
|
* Lesser 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/>.
|
|
*/
|
|
|
|
#ifndef __GIMP_WIDGETS_TYPES_H__
|
|
#define __GIMP_WIDGETS_TYPES_H__
|
|
|
|
#include <libgimpconfig/gimpconfigtypes.h>
|
|
|
|
#include <libgimpwidgets/gimpwidgetsenums.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/* For information look into the html documentation */
|
|
|
|
|
|
typedef struct _GimpBrowser GimpBrowser;
|
|
typedef struct _GimpBusyBox GimpBusyBox;
|
|
typedef struct _GimpButton GimpButton;
|
|
typedef struct _GimpCellRendererColor GimpCellRendererColor;
|
|
typedef struct _GimpCellRendererToggle GimpCellRendererToggle;
|
|
typedef struct _GimpChainButton GimpChainButton;
|
|
typedef struct _GimpColorArea GimpColorArea;
|
|
typedef struct _GimpColorButton GimpColorButton;
|
|
typedef struct _GimpColorDisplay GimpColorDisplay;
|
|
typedef struct _GimpColorDisplayStack GimpColorDisplayStack;
|
|
typedef struct _GimpColorHexEntry GimpColorHexEntry;
|
|
typedef struct _GimpColorNotebook GimpColorNotebook;
|
|
typedef struct _GimpColorProfileChooserDialog GimpColorProfileChooserDialog;
|
|
typedef struct _GimpColorProfileComboBox GimpColorProfileComboBox;
|
|
typedef struct _GimpColorProfileStore GimpColorProfileStore;
|
|
typedef struct _GimpColorProfileView GimpColorProfileView;
|
|
typedef struct _GimpColorScale GimpColorScale;
|
|
typedef struct _GimpColorScaleEntry GimpColorScaleEntry;
|
|
typedef struct _GimpColorScales GimpColorScales;
|
|
typedef struct _GimpColorSelector GimpColorSelector;
|
|
typedef struct _GimpColorSelect GimpColorSelect;
|
|
typedef struct _GimpColorSelection GimpColorSelection;
|
|
typedef struct _GimpController GimpController;
|
|
typedef struct _GimpDialog GimpDialog;
|
|
typedef struct _GimpEnumStore GimpEnumStore;
|
|
typedef struct _GimpEnumComboBox GimpEnumComboBox;
|
|
typedef struct _GimpEnumLabel GimpEnumLabel;
|
|
typedef struct _GimpFileEntry GimpFileEntry;
|
|
typedef struct _GimpFrame GimpFrame;
|
|
typedef struct _GimpHintBox GimpHintBox;
|
|
typedef struct _GimpIntComboBox GimpIntComboBox;
|
|
typedef struct _GimpIntStore GimpIntStore;
|
|
typedef struct _GimpLabeled GimpLabeled;
|
|
typedef struct _GimpLabelColor GimpLabelColor;
|
|
typedef struct _GimpLabelEntry GimpLabelEntry;
|
|
typedef struct _GimpLabelSpin GimpLabelSpin;
|
|
typedef struct _GimpMemsizeEntry GimpMemsizeEntry;
|
|
typedef struct _GimpNumberPairEntry GimpNumberPairEntry;
|
|
typedef struct _GimpOffsetArea GimpOffsetArea;
|
|
typedef struct _GimpPageSelector GimpPageSelector;
|
|
typedef struct _GimpPathEditor GimpPathEditor;
|
|
typedef struct _GimpPickButton GimpPickButton;
|
|
typedef struct _GimpPreview GimpPreview;
|
|
typedef struct _GimpPreviewArea GimpPreviewArea;
|
|
typedef struct _GimpRuler GimpRuler;
|
|
typedef struct _GimpScaleEntry GimpScaleEntry;
|
|
typedef struct _GimpScrolledPreview GimpScrolledPreview;
|
|
typedef struct _GimpSizeEntry GimpSizeEntry;
|
|
typedef struct _GimpSpinButton GimpSpinButton;
|
|
typedef struct _GimpStringComboBox GimpStringComboBox;
|
|
typedef struct _GimpUnitComboBox GimpUnitComboBox;
|
|
typedef struct _GimpUnitStore GimpUnitStore;
|
|
typedef struct _GimpZoomModel GimpZoomModel;
|
|
|
|
|
|
/**
|
|
* GimpHelpFunc:
|
|
* @help_id: the help ID
|
|
* @help_data: the help user data
|
|
*
|
|
* This is the prototype for all functions you pass as @help_func to
|
|
* the various GIMP dialog constructors like gimp_dialog_new(),
|
|
* gimp_query_int_box() etc.
|
|
*
|
|
* Help IDs are textual identifiers the help system uses to figure
|
|
* which page to display.
|
|
*
|
|
* All these dialog constructors functions call gimp_help_connect().
|
|
*
|
|
* In most cases it will be ok to use gimp_standard_help_func() which
|
|
* does nothing but passing the @help_id string to gimp_help(). If
|
|
* your plug-in needs some more sophisticated help handling you can
|
|
* provide your own @help_func which has to call gimp_help() to
|
|
* actually display the help.
|
|
**/
|
|
typedef void (* GimpHelpFunc) (const gchar *help_id,
|
|
gpointer help_data);
|
|
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GIMP_WIDGETS_TYPES_H__ */
|