.. wxPython Phoenix documentation

   This file was generated by Phoenix's sphinx generator and associated
   tools, do not edit by hand.

   Copyright: (c) 2011-2017 by Total Control Software
   License:   wxWindows License

.. include:: headings.inc



.. _wx.ColourDialog:

==========================================================================================================================================
|phoenix_title|  **wx.ColourDialog**
==========================================================================================================================================

This class represents the colour chooser dialog.          







         



.. seealso:: :ref:`ColourDialog Overview <colourdialog overview>`, :ref:`wx.Colour`, :ref:`wx.ColourData`, `wx.GetColourFromUser`         







|

|class_hierarchy| Class Hierarchy
=================================

.. raw:: html

   <div id="toggleBlock" onclick="return toggleVisibility(this)" class="closed" style="cursor:pointer;">
   <img id="toggleBlock-trigger" src="_static/images/closed.png"/>
   Inheritance diagram for class <strong>ColourDialog</strong>:
   </div>
   <div id="toggleBlock-summary" style="display:block;"></div>
   <div id="toggleBlock-content" style="display:none;">
   <p class="graphviz">
   <center><img src="_static/images/inheritance/wx.ColourDialog_inheritance.png" alt="Inheritance diagram of ColourDialog" usemap="#dummy" class="inheritance"/></center>
   </div>
   <script type="text/javascript">toggleVisibilityOnLoad(document.getElementById('toggleBlock'))</script>
   <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="wx.Trackable.html" title="Add-on base class for a trackable object." alt="" coords="5,5,108,35"/> <area shape="rect" id="node4" href="wx.EvtHandler.html" title="A class that can handle events from the windowing system." alt="" coords="59,83,171,112"/> <area shape="rect" id="node2" href="wx.Object.html" title="This is the root class of many of the wxWidgets classes." alt="" coords="133,5,215,35"/> <area shape="rect" id="node3" href="wx.Window.html" title="wx.Window  is the base class for all windows and represents any visible object on screen." alt="" coords="71,160,160,189"/> <area shape="rect" id="node6" href="wx.NonOwnedWindow.html" title="Common base class for all non-child windows." alt="" coords="36,237,195,267"/> <area shape="rect" id="node5" href="wx.TopLevelWindow.html" title="wx.TopLevelWindow  is a common base class for wx.Dialog  and wx.Frame." alt="" coords="43,315,188,344"/> <area shape="rect" id="node7" href="wx.Dialog.html" title="A dialog box is a window with a title bar and sometimes a system menu, which can be moved around the screen." alt="" coords="74,392,157,421"/> <area shape="rect" id="node8" href="wx.ColourDialog.html" title="This class represents the colour chooser dialog." alt="" coords="54,469,177,499"/> </map> 
   </p>

|


|method_summary| Methods Summary
================================

================================================================================ ================================================================================
:meth:`~wx.ColourDialog.__init__`                                                Constructor.
:meth:`~wx.ColourDialog.Create`                                                  Same as :ref:`wx.ColourDialog`.
:meth:`~wx.ColourDialog.GetColourData`                                           Returns the colour data associated with the colour dialog.
:meth:`~wx.ColourDialog.ShowModal`                                               Shows the dialog, returning ``wx.ID_OK`` if the user pressed ``wx.OK``, and ``wx.ID_CANCEL`` otherwise.
================================================================================ ================================================================================


|


|property_summary| Properties Summary
=====================================

================================================================================ ================================================================================
:attr:`~wx.ColourDialog.ColourData`                                              See :meth:`~wx.ColourDialog.GetColourData`
================================================================================ ================================================================================


|


|api| Class API
===============


.. class:: wx.ColourDialog(Dialog)

   **Possible constructors**::

       ColourDialog(parent, data=None)
       
   
   This class represents the colour chooser dialog.



   .. method:: __init__(self, parent, data=None)

      Constructor.                  

      Pass a parent window, and optionally a pointer to a block of colour data, which will be copied to the colour dialog's colour data. 

      Custom colours from colour data object will be used in the dialog's colour palette. Invalid entries in custom colours list will be ignored on some platforms(GTK) or replaced with white colour on platforms where custom colours palette has fixed size (MSW). 

                


      :param `parent`: 
      :type `parent`: wx.Window
      :param `data`: 
      :type `data`: wx.ColourData






      .. seealso:: :ref:`wx.ColourData`    








   .. method:: Create(self, parent, data=None)

      Same as :ref:`wx.ColourDialog`.                  


      :param `parent`: 
      :type `parent`: wx.Window
      :param `data`: 
      :type `data`: wx.ColourData




      :rtype: `bool`








   .. method:: GetColourData(self)

      Returns the colour data associated with the colour dialog.                  

      :rtype: :ref:`wx.ColourData`








   .. method:: ShowModal(self)

      Shows the dialog, returning ``wx.ID_OK`` if the user pressed ``wx.OK``, and ``wx.ID_CANCEL`` otherwise.                  

      :rtype: `int`








   .. attribute:: ColourData

      See :meth:`~wx.ColourDialog.GetColourData`