wxWidgets maintains a database of standard RGB colours for a predefined set of named colours (such as "BLACK'', "LIGHT GREY''). The application may add to this set if desired by using AddColour and may use it to look up colours by names using Find or find the names for the standard colour suing FindName.
There is one predefined instance of this class called wxTheColourDatabase.
The standard database contains at least the following colours:
AQUAMARINE, BLACK, BLUE, BLUE VIOLET, BROWN, CADET BLUE, CORAL, CORNFLOWER BLUE, CYAN, DARK GREY, DARK GREEN, DARK OLIVE GREEN, DARK ORCHID, DARK SLATE BLUE, DARK SLATE GREY DARK TURQUOISE, DIM GREY, FIREBRICK, FOREST GREEN, GOLD, GOLDENROD, GREY, GREEN, GREEN YELLOW, INDIAN RED, KHAKI, LIGHT BLUE, LIGHT GREY, LIGHT STEEL BLUE, LIME GREEN, MAGENTA, MAROON, MEDIUM AQUAMARINE, MEDIUM BLUE, MEDIUM FOREST GREEN, MEDIUM GOLDENROD, MEDIUM ORCHID, MEDIUM SEA GREEN, MEDIUM SLATE BLUE, MEDIUM SPRING GREEN, MEDIUM TURQUOISE, MEDIUM VIOLET RED, MIDNIGHT BLUE, NAVY, ORANGE, ORANGE RED, ORCHID, PALE GREEN, PINK, PLUM, PURPLE, RED, SALMON, SEA GREEN, SIENNA, SKY BLUE, SLATE BLUE, SPRING GREEN, STEEL BLUE, TAN, THISTLE, TURQUOISE, VIOLET, VIOLET RED, WHEAT, WHITE, YELLOW, YELLOW GREEN.
Constructs the colour database. It will be initialized at the first use.
void AddColour(const wxString& colourName, const wxColour&colour)
void AddColour(const wxString& colourName, wxColour* colour)
Adds a colour to the database. If a colour with the same name already exists, it is replaced.
Please note that the overload taking a pointer is deprecated and will be removed in the next wxWidgets version, please don't use it.
wxColour FindColour(const wxString& colourName)
Finds a colour given the name. Returns an invalid colour object (that is, such that its Ok() method returns false) if the colour wasn't found in the database.
wxColour* FindColour(const wxString& colourName)
Finds a colour given the name. Returns NULL if not found or a pointer which must be deleted by the caller otherwise.
Please note that this method is deprecated and will be removed in the next wxWidgets version, please use Find instead of it.
wxString FindName(const wxColour& colour) const
Finds a colour name given the colour. Returns an empty string if the colour is not found in the database.