![]() | ![]() | ![]() | GIMP Widgets Library Reference Manual | ![]() |
---|
GimpColorAreaGimpColorArea — Displays a GimpRGB color, optionally with alpha-channel. | ![]() |
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" GimpRGB : Read / Write / Construct "drag-mask" GdkModifierType : Write / Construct Only "draw-border" gboolean : Read / Write "type" GimpColorAreaType : Read / Write / Construct
"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 |
color
" property"color" GimpRGB : Read / Write / Construct
The color displayed in the color area.
Since GIMP 2.4
draw-border
" property"draw-border" gboolean : Read / Write
Whether to draw a thin border in the foreground color around the area.
Default value: FALSE
Since GIMP 2.4
type
" property"type" GimpColorAreaType : Read / Write / Construct
The type of the color area.
Default value: GIMP_COLOR_AREA_FLAT
Since GIMP 2.4
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 >> |