wxColourDatabase

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.

Derived from

None

Include files

<wx/gdicmn.h>

Remarks

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.

See also

wxColour



wxColourDatabase::wxColourDatabase



wxColourDatabase(void)

Constructs the colour database. It will be initialized at the first use.



wxColourDatabase::AddColour



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.



wxColourDatabase::Find



wxColour Find(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.



wxColourDatabase::FindName

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.

ymasuda 平成17年11月19日