phoenix_title wx.lib.colourselect.ColourSelect

A subclass of wx.lib.buttons.GenBitmapButton that, when clicked, will display a colour selection dialog.


class_hierarchy Class Hierarchy

Inheritance diagram for class ColourSelect:

method_summary Methods Summary

__init__

Default class constructor.

GetColour

Returns the current colour set for the ColourSelect.

GetCustomColours

Returns the current set of custom colour values to be shown in the

GetLabel

Returns the current text label for the ColourSelect.

GetValue

Returns the current colour set for the ColourSelect.

MakeBitmap

Creates a bitmap representation of the current selected colour.

OnChange

Fires the EVT_COLOURSELECT event, as the user has changed the current colour.

OnClick

Handles the wx.EVT_BUTTON event for ColourSelect.

SetBitmap

Sets the bitmap representation of the current selected colour to the button.

SetColour

Sets the current colour for ColourSelect.

SetCustomColours

Sets the list of custom colour values to be shown in colour dialog, if

SetLabel

Sets the new text label for wx.ColourSelect.

SetValue

Sets the current colour for ColourSelect. Same as


property_summary Properties Summary

Colour

Returns the current colour set for the ColourSelect.

CustomColours

Returns the current set of custom colour values to be shown in the

Label

Returns the current text label for the ColourSelect.

Value

Returns the current colour set for the ColourSelect.


api Class API

class ColourSelect(wx.lib.buttons.GenBitmapButton)

A subclass of wx.lib.buttons.GenBitmapButton that, when clicked, will display a colour selection dialog.


Methods

__init__(self, parent, id=wx.ID_ANY, label="", colour=wx.BLACK, pos=wx.DefaultPosition, size=wx.DefaultSize, callback=None, style=0)

Default class constructor.

Parameters
  • parent (wx.Window) – parent window. Must not be None;

  • id (integer) – window identifier. A value of -1 indicates a default value;

  • label (string) – the button text label;

  • wx.Colour – a valid wx.Colour instance, which will be the default initial colour for this button;

  • pos (tuple or wx.Point) – the control position. A value of (-1, -1) indicates a default position, chosen by either the windowing system or wxPython, depending on platform;

  • size (tuple or wx.Size) – the control size. A value of (-1, -1) indicates a default size, chosen by either the windowing system or wxPython, depending on platform;

  • callback (PyObject) – a callable method/function that will be called every time the user chooses a new colour;

  • style (integer) – the button style.



GetColour(self)

Returns the current colour set for the ColourSelect.

Return type

wx.Colour



GetCustomColours(self)

Returns the current set of custom colour values to be shown in the colour dialog, if supported.

Return type

CustomColourData



GetLabel(self)

Returns the current text label for the ColourSelect.

Return type

string



GetValue(self)

Returns the current colour set for the ColourSelect. Same as GetColour.

Return type

wx.Colour



MakeBitmap(self)

Creates a bitmap representation of the current selected colour.



OnChange(self)

Fires the EVT_COLOURSELECT event, as the user has changed the current colour.



OnClick(self, event)

Handles the wx.EVT_BUTTON event for ColourSelect.

Parameters

event – a wx.CommandEvent event to be processed.



SetBitmap(self, bmp)

Sets the bitmap representation of the current selected colour to the button.

Parameters

bmp (wx.Bitmap) – the new bitmap.



SetColour(self, colour)

Sets the current colour for ColourSelect.

Parameters

colour (tuple or string or wx.Colour) – the new colour for ColourSelect.



SetCustomColours(self, colours)

Sets the list of custom colour values to be shown in colour dialog, if supported.

Parameters

colours – An instance of CustomColourData or a 16

element list of None or wx.Colour values.



SetLabel(self, label)

Sets the new text label for wx.ColourSelect.

Parameters

label (string) – the new text label for ColourSelect.



SetValue(self, colour)

Sets the current colour for ColourSelect. Same as SetColour.

Parameters

colour (tuple or string or wx.Colour) – the new colour for ColourSelect.


Properties

Colour

Returns the current colour set for the ColourSelect.

Return type

wx.Colour



CustomColours

Returns the current set of custom colour values to be shown in the colour dialog, if supported.

Return type

CustomColourData



Label

Returns the current text label for the ColourSelect.

Return type

string



Value

Returns the current colour set for the ColourSelect. Same as GetColour.

Return type

wx.Colour