Skip to content

Gtk.ColorChooserWidget

class — extends Widget, Accessible, Buildable, ColorChooser, ConstraintTarget

:::warning Deprecated since 4.10 This API is deprecated. :::

The GtkColorChooserWidget widget lets the user select a color.

By default, the chooser presents a predefined palette of colors, plus a small number of settable custom colors. It is also possible to select a different color with the single-color editor.

To enter the single-color editing mode, use the context menu of any color of the palette, or use the '+' button to add a new custom color.

The chooser automatically remembers the last selection, as well as custom colors.

To create a GtkColorChooserWidget, use ColorChooserWidget.new.

To change the initially selected color, use ColorChooser.set_rgba. To get the selected color use ColorChooser.get_rgba.

The GtkColorChooserWidget is used in the ColorChooserDialog to provide a dialog for selecting colors.

Actions

GtkColorChooserWidget defines a set of built-in actions:

  • color.customize activates the color editor for the given color.
  • color.select emits the ColorChooser.color-activated signal for the given color.

CSS names

GtkColorChooserWidget has a single CSS node with name colorchooser.

Constructors

new

@classmethod
def new(cls) -> Widget

Creates a new GtkColorChooserWidget.

Properties

show_editor

show_editor: bool  # read/write

True when the color chooser is showing the single-color editor.

It can be set to switch the color chooser into single-color editing mode.