Handy.StyleManager:color-scheme
Description: Reference for property Handy.StyleManager:color-scheme

### Property

# Handy StyleManager:color-scheme

since: 1.6

#### Declaration

    property color-scheme: Handy.ColorScheme [ read, write ]

#### Description [src]

The requested application color scheme.

The effective appearance will be decided based on the application color scheme and the system preferred color scheme. The `HdyStyleManager:dark` property can be used to query the current effective appearance.

The `HDY_COLOR_SCHEME_PREFER_LIGHT` color scheme results in the application using light appearance unless the system prefers dark colors. This is the default value.

The `HDY_COLOR_SCHEME_PREFER_DARK` color scheme results in the application using dark appearance, but can still switch to the light appearance if the system can prefers it, for example, when the high contrast preference is enabled.

The `HDY_COLOR_SCHEME_FORCE_LIGHT` and `HDY_COLOR_SCHEME_FORCE_DARK` values ignore the system preference entirely, they are useful if the application wants to match its UI to its content or to provide a separate color scheme switcher.

If a per-`GdkDisplay` style manager has its color scheme set to `HDY_COLOR_SCHEME_DEFAULT`, it will inherit the color scheme from the default style manager.

For the default style manager, `HDY_COLOR_SCHEME_DEFAULT` is equivalent to `HDY_COLOR_SCHEME_FORCE_LIGHT`.

The `HdyStyleManager:system-supports-color-schemes` property can be used to check if the current environment provides a color scheme preference.

Type:`HdyColorScheme`

Available since: 1.6

Default value | HDY_COLOR_SCHEME_DEFAULT
Getter method | `hdy_style_manager_get_color_scheme()`
Setter method | `hdy_style_manager_set_color_scheme()`

#### Flags

Readable | yes
Writable | yes
Construct | no
Construct only | no