gtk.ColorSelectionDialog — a standard dialog for selecting a color.


class gtk.ColorSelectionDialog(gtk.Dialog):

def get_color_selection()


+-- gobject.GObject
  +-- gtk.Object
    +-- gtk.Widget
      +-- gtk.Container
        +-- gtk.Bin
          +-- gtk.Window
            +-- gtk.Dialog
              +-- gtk.ColorSelectionDialog

Implemented Interfaces

gtk.ColorSelectionDialog implements gtk.Buildable

gtk.ColorSelectionDialog Properties

gtk.Object Properties

gtk.Widget Properties

gtk.Container Properties

gtk.Window Properties

gtk.Dialog Properties

"cancel-button"ReadThe cancel button of the dialog.
"color-selection"ReadThe color selection embedded in the dialog.
"help-button"ReadThe help button of the dialog.
"ok-button"ReadThe OK button of the dialog.

gtk.ColorSelectionDialog Style Properties

gtk.Widget Style Properties

gtk.Dialog Style Properties


"colorsel"ReadThe gtk.ColorSelection widget contained in the dialog.
"ok_button"ReadThe "OK" button contained in the dialog.
"cancel_button"ReadThe "Cancel" button contained in the dialog.
"help_button"ReadThe "Help" button contained in the dialog.


The gtk.ColorSelectionDialog provides a standard dialog that allows a user to select a color. The gtk.ColorSelectionDialog uses an embedded gtk.ColorSelection to provide color selection capability.

Use the attributes (ok_button, cancel_button and help_button) of the colorselectiondialog to connect handlers to the "OK", "Cancel" and "Help" button "clicked" signals. The colorsel attribute provides access to the colorselection widget. Connect a handler to its "color-changed" signal to be notified when the color is changed. The current color can be retrieved using the gtk.ColorSelection.get_current_color() method.



title :

a string to be used as the dialog title.

Returns :

a new colorselectiondialog

Creates a new gtk.ColorSelectionDialog using the string contained in title as the text for the dialog title.



    def get_color_selection()

Returns :

the embedded gtk.ColorSelection.


This method is available in PyGTK 2.14 and above.

The get_color_selection() method retrieves the gtk.ColorSelection widget embedded in the dialog.