:right-sidebar: True

ColorChooserWidget
===================================================================

.. currentmodule:: gi.repository.Gtk





.. deprecated:: 4.10

   Direct use of ``GtkColorChooserWidget`` is deprecated.



.. class:: ColorChooserWidget(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.Gtk.Widget`, :class:`~gi.repository.GObject.InitiallyUnowned`, :class:`~gi.repository.GObject.Object`



Implemented Interfaces: :class:`~gi.repository.Gtk.Accessible`, :class:`~gi.repository.Gtk.Buildable`, :class:`~gi.repository.Gtk.ColorChooser`, :class:`~gi.repository.Gtk.ConstraintTarget`



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 :obj:`~gi.repository.Gtk.ColorChooserWidget.new`.

To change the initially selected color, use
:obj:`~gi.repository.Gtk.ColorChooser.set_rgba`. To get the selected color use
:obj:`~gi.repository.Gtk.ColorChooser.get_rgba`.

The ``GtkColorChooserWidget`` is used in the :obj:`~gi.repository.Gtk.ColorChooserDialog`
to provide a dialog for selecting colors.

CSS names
---------

``GtkColorChooserWidget`` has a single CSS node with name colorchooser.



Constructors
------------

.. rst-class:: interim-class

.. class:: ColorChooserWidget
   :no-index:


   .. classmethod:: new() -> ~gi.repository.Gtk.Widget

      Creates a new ``GtkColorChooserWidget``.
















Properties
----------

.. rst-class:: interim-class

.. class:: ColorChooserWidget
   :no-index:
   

   .. attribute:: props.show_editor
      :type: bool

      :const:`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.