ctk_color_chooser_get_rgba ()

void
ctk_color_chooser_get_rgba (CtkColorChooser *chooser,
                            CdkRGBA *color);

Gets the currently-selected color.

Since: 3.4

ctk_color_chooser_set_rgba ()

void
ctk_color_chooser_set_rgba (CtkColorChooser *chooser,
                            const CdkRGBA *color);

Sets the color.

Since: 3.4

ctk_color_chooser_get_use_alpha ()

gboolean
ctk_color_chooser_get_use_alpha (CtkColorChooser *chooser);

Returns whether the color chooser shows the alpha channel.

Since: 3.4

ctk_color_chooser_set_use_alpha ()

void
ctk_color_chooser_set_use_alpha (CtkColorChooser *chooser,
                                 gboolean use_alpha);

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

Since: 3.4

ctk_color_chooser_add_palette ()

void
ctk_color_chooser_add_palette (CtkColorChooser *chooser,
                               CtkOrientation orientation,
                               gint colors_per_line,
                               gint n_colors,
                               CdkRGBA *colors);

Adds a palette to the color chooser. If orientation is horizontal, the colors are grouped in rows, with colors_per_line colors in each row. If horizontal is FALSE, the colors are grouped in columns instead.

The default color palette of CtkColorChooserWidget has 27 colors, organized in columns of 3 colors. The default gray palette has 9 grays in a single row.

The layout of the color chooser widget works best when the palettes have 9-10 columns.

Calling this function for the first time has the side effect of removing the default color and gray palettes from the color chooser.

If colors is NULL, removes all previously added palettes.

Since: 3.4

CtkColorChooser

typedef struct _CtkColorChooser CtkColorChooser;

The “rgba” property

  “rgba”                     CdkRGBA *

The ::rgba property contains the currently selected color, as a CdkRGBA struct. The property can be set to change the current selection programmatically.

Owner: CtkColorChooser

Flags: Read / Write

Since: 3.4

The “use-alpha” property

  “use-alpha”                gboolean

When ::use-alpha is TRUE, colors may have alpha (translucency) information. When it is FALSE, the CdkRGBA struct obtained via the “rgba” property will be forced to have alpha == 1.

Implementations are expected to show alpha by rendering the color over a non-uniform background (like a checkerboard pattern).

Owner: CtkColorChooser

Flags: Read / Write

Default value: TRUE

Since: 3.4

The “color-activated” signal

void
user_function (CtkColorChooser *chooser,
               CdkRGBA         *color,
               gpointer         user_data)

Emitted when a color is activated from the color chooser. This usually happens when the user clicks a color swatch, or a color is selected and the user presses one of the keys Space, Shift+Space, Return or Enter.

Flags: Run First

Since: 3.4