| GIMP Widgets Library Reference Manual |
|---|
GimpColorArea — Displays a GimpRGB color, optionally with alpha-channel.
struct GimpColorArea; enum GimpColorAreaType; GtkWidget* gimp_color_area_new (const GimpRGB *color, GimpColorAreaType type, GdkModifierType drag_mask); void gimp_color_area_set_color (GimpColorArea *area, const GimpRGB *color); void gimp_color_area_get_color (GimpColorArea *area, GimpRGB *color); gboolean gimp_color_area_has_alpha (GimpColorArea *area); void gimp_color_area_set_type (GimpColorArea *area, GimpColorAreaType type); void gimp_color_area_set_draw_border (GimpColorArea *area, gboolean draw_border);
"color-changed" void user_function (GimpColorArea *gimpcolorarea, gpointer user_data);
typedef enum
{
GIMP_COLOR_AREA_FLAT = 0,
GIMP_COLOR_AREA_SMALL_CHECKS,
GIMP_COLOR_AREA_LARGE_CHECKS
} GimpColorAreaType;
GtkWidget* gimp_color_area_new (const GimpRGB *color, GimpColorAreaType type, GdkModifierType drag_mask);
Creates a new GimpColorArea widget.
This returns a preview area showing the color. It handles color DND. If the color changes, the "color_changed" signal is emitted.
| color : | A pointer to a GimpRGB struct. |
| type : | The type of color area to create. |
| drag_mask : | The event_mask that should trigger drags. |
| Returns : | Pointer to the new GimpColorArea widget. |
void gimp_color_area_set_color (GimpColorArea *area, const GimpRGB *color);
Sets area to a different color.
| area : | Pointer to a GimpColorArea. |
| color : | Pointer to a GimpRGB struct that defines the new color. |
void gimp_color_area_get_color (GimpColorArea *area, GimpRGB *color);
Retrieves the current color of the area.
| area : | Pointer to a GimpColorArea. |
| color : | Pointer to a GimpRGB struct that is used to return the color. |
gboolean gimp_color_area_has_alpha (GimpColorArea *area);
Checks whether the area shows transparency information. This is determined via the area's GimpColorAreaType.
| area : | Pointer to a GimpColorArea. |
| Returns : | TRUE if area shows transparency information, FALSE otherwise. |
void gimp_color_area_set_type (GimpColorArea *area, GimpColorAreaType type);
Allows to change the type of area. The GimpColorAreaType determines whether the widget shows transparency information and chooses the size of the checkerboard used to do that.
| area : | Pointer to a GimpColorArea. |
| type : | A GimpColorAreaType. |
void gimp_color_area_set_draw_border (GimpColorArea *area, gboolean draw_border);
The area can draw a thin border in the foreground color around itself. This function allows to toggle this behaviour on and off. The default is not draw a border.
| area : | Pointer to a GimpColorArea. |
| draw_border : | whether to draw a border or not |
void user_function (GimpColorArea *gimpcolorarea, gpointer user_data);
| gimpcolorarea : | the object which received the signal. |
| user_data : | user data set when the signal handler was connected. |
| << GimpChainButton | GimpColorButton >> |