GimpColorArea

GimpColorArea — Displays a GimpRGB color, optionally with alpha-channel.

Synopsis




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);

Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkDrawingArea
                     +----GimpColorArea

Implemented Interfaces

GimpColorArea implements AtkImplementorIface.

Signal Prototypes


"color-changed"
            void        user_function      (GimpColorArea *gimpcolorarea,
                                            gpointer user_data);

Description

Details

struct GimpColorArea

struct GimpColorArea;

enum GimpColorAreaType

typedef enum
{
  GIMP_COLOR_AREA_FLAT = 0,
  GIMP_COLOR_AREA_SMALL_CHECKS,
  GIMP_COLOR_AREA_LARGE_CHECKS
} GimpColorAreaType;

gimp_color_area_new ()

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.

gimp_color_area_set_color ()

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.

gimp_color_area_get_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.

gimp_color_area_has_alpha ()

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.

gimp_color_area_set_type ()

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.

gimp_color_area_set_draw_border ()

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

Signals

The "color-changed" signal

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.