GtkColorButton

typedef struct _GtkColorButton GtkColorButton;

gtk_color_button_new ()

GtkWidget*  gtk_color_button_new            (void);

Creates a new color button. This returns a widget in the form of a small button containing a swatch representing the current selected color. When the button is clicked, a color-selection dialog will open, allowing the user to select a color. The swatch will be updated to reflect the new color when the user finishes.

Since 2.4

gtk_color_button_new_with_color ()

GtkWidget*  gtk_color_button_new_with_color (const GdkColor *color);

Creates a new color button.

Since 2.4

gtk_color_button_set_color ()

void        gtk_color_button_set_color      (GtkColorButton *color_button,
                                             const GdkColor *color);

Sets the current color to be color.

Since 2.4

gtk_color_button_get_color ()

void        gtk_color_button_get_color      (GtkColorButton *color_button,
                                             GdkColor *color);

Sets color to be the current color in the GtkColorButton widget.

Since 2.4

gtk_color_button_set_alpha ()

void        gtk_color_button_set_alpha      (GtkColorButton *color_button,
                                             guint16 alpha);

Sets the current opacity to be alpha.

Since 2.4

gtk_color_button_get_alpha ()

guint16     gtk_color_button_get_alpha      (GtkColorButton *color_button);

Returns the current alpha value.

Since 2.4

gtk_color_button_set_use_alpha ()

void        gtk_color_button_set_use_alpha  (GtkColorButton *color_button,
                                             gboolean use_alpha);

Sets whether or not the color button should use the alpha channel.

Since 2.4

gtk_color_button_get_use_alpha ()

gboolean    gtk_color_button_get_use_alpha  (GtkColorButton *color_button);

Does the color selection dialog use the alpha channel?

Since 2.4

gtk_color_button_set_title ()

void        gtk_color_button_set_title      (GtkColorButton *color_button,
                                             const gchar *title);

Sets the title for the color selection dialog.

Since 2.4

gtk_color_button_get_title ()

const gchar* gtk_color_button_get_title     (GtkColorButton *color_button);

Gets the title of the color selection dialog.

Since 2.4

The "alpha" property

  "alpha"                guint                 : Read / Write

The selected opacity value (0 fully transparent, 65535 fully opaque).

Allowed values: <= 65535

Default value: 65535

Since 2.4

The "color" property

  "color"                GdkColor              : Read / Write

The selected color.

Since 2.4

The "title" property

  "title"                gchararray            : Read / Write

The title of the color selection dialog

Default value: "Pick a Color"

Since 2.4

The "use-alpha" property

  "use-alpha"            gboolean              : Read / Write

If this property is set to TRUE, the color swatch on the button is rendered against a checkerboard background to show its opacity and the opacity slider is displayed in the color selection dialog.

Default value: FALSE

Since 2.4

The "color-set" signal

void        user_function                  (GtkColorButton *widget,
                                            gpointer user_data);

The ::color-set signal is emitted when the user selects a color. When handling this signal, use gtk_color_button_get_color() and gtk_color_button_get_alpha() to find out which color was just selected.

Since 2.4