Property

AdapStyleManager:color-scheme

since: 1

Declaration

property color-scheme: Adap.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 AdapStyleManager:dark property can be used to query the current effective appearance.

The ADAP_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 ADAP_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 ADAP_COLOR_SCHEME_FORCE_LIGHT and ADAP_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 ADAP_COLOR_SCHEME_DEFAULT, it will inherit the color scheme from the default style manager.

For the default style manager, ADAP_COLOR_SCHEME_DEFAULT is equivalent to ADAP_COLOR_SCHEME_PREFER_LIGHT.

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

Type: AdapColorScheme
Available since:1
Default valueADAP_COLOR_SCHEME_DEFAULT
Getter methodadap_style_manager_get_color_scheme()
Setter methodadap_style_manager_set_color_scheme()

Flags

Readableyes
Writableyes
Constructno
Construct onlyno