Method

GtkColorChooseradd_palette

since: 3.4

Declaration [src]

void
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

Parameters

orientation

Type: GtkOrientation

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

colors_per_line

Type: gint

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

n_colors

Type: gint

The total number of elements in colors.

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.