since: 3.4

Declaration [src]

gtk_color_chooser_add_palette (
  GtkColorChooser* chooser,
  GtkOrientation orientation,
  gint colors_per_line,
  gint n_colors,
  GdkRGBA* colors

Description [src]

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

Available since: 3.4



Type: GtkOrientation

GTK_ORIENTATION_HORIZONTAL if the palette should be displayed in rows, GTK_ORIENTATION_VERTICAL for columns.


Type: gint

The number of colors to show in each row/column.


Type: gint

The total number of elements in colors.


Type: An array of GdkRGBA

The colors of the palette, or NULL.

The argument can be NULL.
The length of the array is specified in the n_colors argument.
The data is owned by the caller of the method.