qt6-bb10/examples
Volker Hilsheimer 95d4e6baba ColorScheme: make QStyleHints::colorScheme writable for applications
Applications can request the color scheme to be either explicitly light
or dark, or to follow the system default by setting the scheme to
Qt::ColorScheme::Unknown.

Setting the color scheme will make the request to the QPlatformTheme
implementation, which can then use the appropriate implementation to
set the application's appearance so that both palette and window
decoration follow the requested color scheme. This should trigger
theme change and palette change events. A change to the effective
scheme should then call back into QStyleHintsPrivate::updateColorScheme,
which will emit the changed signal for the property.

Implement this for macOS (Cocoa), iOS, Android, and Windows.

On macOS, we have to use deprecated AppKit APIs; the replacements for
those APIs are not suitable for this use case. On iOS, the setting is
for each UIWindow, which we can update or initialize based on an
explicitly requested scheme.

On Android we can piggy-back on the logic added when dark theme support
was introduced in b4a9bb1f6a.

On Windows, we have to fake a dark palette if the dark scheme is
requested on a light system, as there is no API to read a dark palette.
However, we also have to ignore any application preference if a high-
contrast accessibility theme is selected by the user (we report the
color scheme as unknown; there are both light and dark high-contrast
themes), and read the system palette using the GetSysColor API, which
is used for light mode. And we need to initialize windows with the
correct frame if the application explicitly overrides the system color
scheme.

Add an auto-test to the QApplication test, as that gives us the most
coverage to confirm that QStyleHints emits the changed signal, and that
Theme- and PaletteChange events are received by the toplevel widget
when the color scheme actually changes. This test has to be skipped
on platforms where we cannot set the color scheme programmatically.

Add the option to explicitly select the color scheme to the widget
gallery example, and default it to dark mode.

Fixes: QTBUG-124490
Change-Id: I7302993c0121284bf9d3b72e3149c6abbe6bd261
Reviewed-by: Tor Arne Vestbø <tor.arne.vestbo@qt.io>
2024-05-10 01:15:12 +02:00
..
aggregate install a sane top-level examples.pro file 2012-12-11 13:37:57 +01:00
corelib Remove check for Qt version > 4 that's not useful now 2024-04-24 18:46:34 +02:00
dbus CMake: Add deployment API to our examples 2024-03-22 20:23:52 +01:00
gui rhiwindow: Set DPR on image texture to ensure DPR-agnostic drawing 2024-04-18 23:15:25 +02:00
network CMake: Add deployment API to our examples 2024-03-22 20:23:52 +01:00
opengl CMake: Add deployment API to our examples 2024-03-22 20:23:52 +01:00
qmake examples: port qmake examples to new connection style 2022-12-21 22:52:17 +02:00
qtconcurrent CMake: Add deployment API to our examples 2024-03-22 20:23:52 +01:00
qtestlib CMake: Add deployment API to our examples 2024-03-22 20:23:52 +01:00
sql CMake: Add deployment API to our examples 2024-03-22 20:23:52 +01:00
vulkan CMake: Add deployment API to our examples 2024-03-22 20:23:52 +01:00
widgets ColorScheme: make QStyleHints::colorScheme writable for applications 2024-05-10 01:15:12 +02:00
xml CMake: Add deployment API to our examples 2024-03-22 20:23:52 +01:00
CMakeLists.txt CMake: Allow building all examples as standalone just like tests 2024-03-14 11:44:16 +01:00
README
examples.pro Remove undocumented embedded examples 2023-11-17 19:39:33 +01:00

README

Qt is supplied with a number of example applications that have been
written to provide developers with examples of the Qt API in use,
highlight good programming practice, and showcase features found in each of
Qt's core technologies.


Documentation for examples can be found in the Examples section
of the Qt documentation.