ui::ThemeColors¶

Header: winui/ui/themes/Theme.hpp.

The theme's colors by role, resolved for the era and mode the theme draws. Every theme fills every field, high contrast included, so a custom control can read these without checking Theme::variant first. Theme::palette (Fluent only), surfaces and the button visuals hold the era-specific detail behind them.

A theme's colors are read-only (Theme::colors()), since they are what the theme resolved to. To change them, pass a ThemeColors to Theme::fluent(colors) or Theme::classic(colors, ...), which derive a whole theme from it, or set a ThemeRequest (accent_override, mode, variant) on the window. The defaults are the Fluent light theme's colors, so ThemeColors{.accent = ...} describes a light theme with that accent.

New roles are added at the end. A role is never removed or renamed.

Example:

class SwatchControl : public ui::Element
{
protected:
    void render_override(ui::Renderer& r, const ui::RenderContext& context) const override
    {
        const ui::ThemeColors& c      = context.theme.colors();
        const float            radius = context.theme.corner_radius;
        r.fill_rounded_rect(bounds(), radius, is_enabled() ? c.accent : c.control_fill_disabled);
        r.stroke_rounded_rect(bounds(), radius, c.control_stroke, 1.0f);
        r.draw_text(label_, bounds(), c.text_on_accent, context.theme.text_style);
    }

private:
    std::string label_;
};