Back to Cpython

:mod:`!tkinter.colorchooser` --- Color choosing dialog

Doc/library/tkinter.colorchooser.rst

3.15.0b31.4 KB
Original Source

:mod:!tkinter.colorchooser --- Color choosing dialog

.. module:: tkinter.colorchooser :synopsis: Color choosing dialog

Source code: :source:Lib/tkinter/colorchooser.py


The :mod:!tkinter.colorchooser module provides the :class:Chooser class as an interface to the native color picker dialog. Chooser implements a modal color choosing dialog window. The Chooser class inherits from the :class:~tkinter.commondialog.Dialog class.

.. class:: Chooser(master=None, **options)

The class implementing the modal color-choosing dialog. Most applications use the :func:askcolor convenience function rather than instantiating this class directly.

.. function:: askcolor(color=None, **options)

Show a modal color-choosing dialog and return the chosen color. color is the color selected when the dialog opens. The return value is a tuple ((r, g, b), hexstr), where r, g and b are the red, green and blue components as integers in the range 0–255 and hexstr is the equivalent Tk color string, such as '#ff8000'. If the user cancels the dialog, (None, None) is returned.

.. versionchanged:: 3.10 The RGB values in the returned color are now integers in the range 0–255 instead of floats.

.. seealso::

Module :mod:tkinter.commondialog Tkinter standard dialog module