ColorChooser#

Deprecated since version 4.10:

Use ColorDialog and ColorDialogButton

instead of widgets implementing GtkColorChooser

class ColorChooser(*args, **kwargs)#

Implementations: ColorButton, ColorChooserDialog, ColorChooserWidget

GtkColorChooser is an interface that is implemented by widgets for choosing colors.

Depending on the situation, colors may be allowed to have alpha (translucency).

In GTK, the main widgets that implement this interface are ColorChooserWidget, ColorChooserDialog and ColorButton.

Methods#

class ColorChooser
add_palette(orientation: Orientation, colors_per_line: int, colors: list[RGBA] | None = None) → None#

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 ColorChooserWidget has 45 colors, organized in columns of 5 colors (this includes some grays).

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 palette from the color chooser.

If colors is None, removes all previously added palettes.

Deprecated since version 4.10: Use ColorDialog instead

Parameters:

  • orientation – HORIZONTAL if the palette should be displayed in rows, VERTICAL for columns

  • colors_per_line – the number of colors to show in each row/column

  • colors – the colors of the palette

get_rgba() → RGBA#

Gets the currently-selected color.

Deprecated since version 4.10: Use ColorDialog instead

get_use_alpha() → bool#

Returns whether the color chooser shows the alpha channel.

Deprecated since version 4.10: Use ColorDialog instead

set_rgba(color: RGBA) → None#

Sets the color.

Deprecated since version 4.10: Use ColorDialog instead

Parameters:

color – the new color

set_use_alpha(use_alpha: bool) → None#

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

Deprecated since version 4.10: Use ColorDialog instead

Parameters:

use_alpha – True if color chooser should use alpha channel, False if not

Properties#

class ColorChooser
props.rgba: RGBA#

The type of the None singleton.

Deprecated since version 4.10:

Use ColorDialog and ColorDialogButton

instead of widgets implementing GtkColorChooser

props.use_alpha: bool#

The type of the None singleton.

Deprecated since version 4.10:

Use ColorDialog and ColorDialogButton

instead of widgets implementing GtkColorChooser

Signals#

class ColorChooser.signals
color_activated(color: RGBA) → None#

The type of the None singleton.

Deprecated since version 4.10:

Use ColorDialog and ColorDialogButton

instead of widgets implementing GtkColorChooser

Parameters:

color – the color

Virtual Methods#

class ColorChooser
do_add_palette(orientation: Orientation, colors_per_line: int, colors: list[RGBA] | None = None) → None#

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 ColorChooserWidget has 45 colors, organized in columns of 5 colors (this includes some grays).

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 palette from the color chooser.

If colors is None, removes all previously added palettes.

Deprecated since version 4.10: Use ColorDialog instead

Parameters:

  • orientation – HORIZONTAL if the palette should be displayed in rows, VERTICAL for columns

  • colors_per_line – the number of colors to show in each row/column

  • colors – the colors of the palette

do_color_activated(color: RGBA) → None#

The type of the None singleton.

Parameters:

color

do_get_rgba() → RGBA#

Gets the currently-selected color.

Deprecated since version 4.10: Use ColorDialog instead

do_set_rgba(color: RGBA) → None#

Sets the color.

Deprecated since version 4.10: Use ColorDialog instead

Parameters:

color – the new color