The effective appearance will be decided based on the application color
scheme and the system preferred color scheme. The
[propertyStyleManager: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-[classGdk.Display] 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 [propertyStyleManager:system-supports-color-schemes] property can be
used to check if the current environment provides a color scheme
dddpreference.
The requested application color scheme.
The effective appearance will be decided based on the application color scheme and the system preferred color scheme. The [property
StyleManager:dark] property can be used to query the current effective appearance.The
HDY_COLOR_SCHEME_PREFER_LIGHTcolor scheme results in the application using light appearance unless the system prefers dark colors. This is the default value.The
HDY_COLOR_SCHEME_PREFER_DARKcolor 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_LIGHTandHDY_COLOR_SCHEME_FORCE_DARKvalues 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-[class
Gdk.Display] style manager has its color scheme set toHDY_COLOR_SCHEME_DEFAULT, it will inherit the color scheme from the default style manager.For the default style manager,
HDY_COLOR_SCHEME_DEFAULTis equivalent toHDY_COLOR_SCHEME_FORCE_LIGHT.The [property
StyleManager:system-supports-color-schemes] property can be used to check if the current environment provides a color scheme dddpreference.