gtk_color_selection_new ()

GtkWidget *
gtk_color_selection_new (void);

Creates a new GtkColorSelection.

gtk_color_selection_set_has_opacity_control ()

void
gtk_color_selection_set_has_opacity_control
                               (GtkColorSelection *colorsel,
                                gboolean has_opacity);

Sets the colorsel to use or not use opacity.

gtk_color_selection_get_has_opacity_control ()

gboolean
gtk_color_selection_get_has_opacity_control
                               (GtkColorSelection *colorsel);

Determines whether the colorsel has an opacity control.

gtk_color_selection_set_has_palette ()

void
gtk_color_selection_set_has_palette (GtkColorSelection *colorsel,
                                     gboolean has_palette);

Shows and hides the palette based upon the value of has_palette .

gtk_color_selection_get_has_palette ()

gboolean
gtk_color_selection_get_has_palette (GtkColorSelection *colorsel);

Determines whether the color selector has a color palette.

gtk_color_selection_get_current_alpha ()

guint16
gtk_color_selection_get_current_alpha (GtkColorSelection *colorsel);

Returns the current alpha value.

gtk_color_selection_set_current_alpha ()

void
gtk_color_selection_set_current_alpha (GtkColorSelection *colorsel,
                                       guint16 alpha);

Sets the current opacity to be alpha .

The first time this is called, it will also set the original opacity to be alpha too.

gtk_color_selection_get_current_color ()

void
gtk_color_selection_get_current_color (GtkColorSelection *colorsel,
                                       GdkColor *color);

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

gtk_color_selection_set_current_color ()

void
gtk_color_selection_set_current_color (GtkColorSelection *colorsel,
                                       const GdkColor *color);

Sets the current color to be color .

The first time this is called, it will also set the original color to be color too.

gtk_color_selection_get_previous_alpha ()

guint16
gtk_color_selection_get_previous_alpha
                               (GtkColorSelection *colorsel);

Returns the previous alpha value.

gtk_color_selection_set_previous_alpha ()

void
gtk_color_selection_set_previous_alpha
                               (GtkColorSelection *colorsel,
                                guint16 alpha);

Sets the “previous” alpha to be alpha .

This function should be called with some hesitations, as it might seem confusing to have that alpha change.

gtk_color_selection_get_previous_color ()

void
gtk_color_selection_get_previous_color
                               (GtkColorSelection *colorsel,
                                GdkColor *color);

Fills color in with the original color value.

gtk_color_selection_set_previous_color ()

void
gtk_color_selection_set_previous_color
                               (GtkColorSelection *colorsel,
                                const GdkColor *color);

Sets the “previous” color to be color .

This function should be called with some hesitations, as it might seem confusing to have that color change. Calling gtk_color_selection_set_current_color() will also set this color the first time it is called.

gtk_color_selection_get_current_rgba ()

void
gtk_color_selection_get_current_rgba (GtkColorSelection *colorsel,
                                      GdkRGBA *rgba);

Sets rgba to be the current color in the GtkColorSelection widget.

Since 3.0

gtk_color_selection_set_current_rgba ()

void
gtk_color_selection_set_current_rgba (GtkColorSelection *colorsel,
                                      const GdkRGBA *rgba);

Sets the current color to be rgba .

The first time this is called, it will also set the original color to be rgba too.

Since 3.0

gtk_color_selection_get_previous_rgba ()

void
gtk_color_selection_get_previous_rgba (GtkColorSelection *colorsel,
                                       GdkRGBA *rgba);

Fills rgba in with the original color value.

Since 3.0

gtk_color_selection_set_previous_rgba ()

void
gtk_color_selection_set_previous_rgba (GtkColorSelection *colorsel,
                                       const GdkRGBA *rgba);

Sets the “previous” color to be rgba .

This function should be called with some hesitations, as it might seem confusing to have that color change. Calling gtk_color_selection_set_current_rgba() will also set this color the first time it is called.

Since 3.0

gtk_color_selection_is_adjusting ()

gboolean
gtk_color_selection_is_adjusting (GtkColorSelection *colorsel);

Gets the current state of the colorsel .

gtk_color_selection_palette_from_string ()

gboolean
gtk_color_selection_palette_from_string
                               (const gchar *str,
                                GdkColor **colors,
                                gint *n_colors);

Parses a color palette string; the string is a colon-separated list of color names readable by gdk_color_parse().

gtk_color_selection_palette_to_string ()

gchar *
gtk_color_selection_palette_to_string (const GdkColor *colors,
                                       gint n_colors);

Encodes a palette as a string, useful for persistent storage.

GtkColorSelectionChangePaletteFunc ()

void
(*GtkColorSelectionChangePaletteFunc) (const GdkColor *colors,
                                       gint n_colors);

gtk_color_selection_set_change_palette_with_screen_hook ()

GtkColorSelectionChangePaletteWithScreenFunc
gtk_color_selection_set_change_palette_with_screen_hook
                               (GtkColorSelectionChangePaletteWithScreenFunc func);

Installs a global function to be called whenever the user tries to modify the palette in a color selection.

This function should save the new palette contents, and update the “gtk-color-palette” GtkSettings property so all GtkColorSelection widgets will be modified.

Since 2.2

GtkColorSelectionChangePaletteWithScreenFunc ()

void
(*GtkColorSelectionChangePaletteWithScreenFunc)
                               (GdkScreen *screen,
                                const GdkColor *colors,
                                gint n_colors);

Since 2.2

struct GtkColorSelection

struct GtkColorSelection;

struct GtkColorSelectionClass

struct GtkColorSelectionClass {
  GtkBoxClass parent_class;

  void (*color_changed) (GtkColorSelection *color_selection);
};

The “current-alpha” property

  “current-alpha”            guint

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

Flags: Read / Write

Allowed values: <= 65535

Default value: 65535

The “current-color” property

  “current-color”            GdkColor *

The current GdkColor color.

Flags: Read / Write

The “current-rgba” property

  “current-rgba”             GdkRGBA *

The current RGBA color.

Flags: Read / Write

Since 3.0

The “has-opacity-control” property

  “has-opacity-control”      gboolean

Whether the color selector should allow setting opacity.

Flags: Read / Write

Default value: FALSE

The “has-palette” property

  “has-palette”              gboolean

Whether a palette should be used.

Flags: Read / Write

Default value: FALSE

The “color-changed” signal

void
user_function (GtkColorSelection *colorselection,
               gpointer           user_data)

This signal is emitted when the color changes in the GtkColorSelection according to its update policy.

Flags: Run First