SetDarkMode

Selects how the button control participates in Windows dark mode.

C

void SftButton_SetDarkMode(HWND hwndCtl, int mode);

C++

void CSftButton::SetDarkMode(int mode);

Parameters

hwndCtl

The window handle of the button control.

mode

The dark mode setting. One of the following values:

Comments

SetDarkMode selects whether the button uses the dark or light color palette. The default is SFTBUTTON_DARKMODE_OFF, which keeps the button in the light palette regardless of the Windows setting - this preserves visual back-compatibility for applications written before dark mode existed. Applications that want to participate in dark mode should set SFTBUTTON_DARKMODE_AUTO to follow the Windows "Choose your mode" setting, or maintain their own Light / Dark toggle and switch each button to SFTBUTTON_DARKMODE_ON / OFF as the toggle changes.

When the mode is SFTBUTTON_DARKMODE_AUTO, the control sends SFTBUTTONN_DARKMODE_CHANGED to its parent window each time the active dark mode state flips so the application can repaint its own surrounding chrome.

Caller-supplied color overrides remain in effect in every mode - SetDarkMode does not override per-state background, gradient, text or border colors set by the application.

Dark mode requires Windows 10 version 1809 or later, or Windows 11.

Examples

C

            }
            return TRUE;
        case IDC_DARK_MODE:
            if (HIWORD(wParam) == BN_CLICKED) {
                BOOL fDark = IsDlgButtonChecked(hwndDlg, IDC_DARK_MODE) == BST_CHECKED;
                int btnMode = fDark ? SFTBUTTON_DARKMODE_ON : SFTBUTTON_DARKMODE_OFF;
                int ids[] = { IDC_SFTBUTTON1, IDC_SFTBUTTON2, IDC_SFTBUTTON3 };
                for (int i = 0; i < (int)(sizeof(ids) / sizeof(ids[0])); ++i)
                    SftButton_SetDarkMode(GetDlgItem(hwndDlg, ids[i]), btnMode);
                SftDarkMode_SetActive(fDark);
                SftDarkMode_ApplyToDialog(hwndDlg);
                InvalidateRect(hwndDlg, NULL, TRUE);
            }
            return TRUE;
        }
        break;

View Entire Sample Code

See Also GetDarkMode | IsDarkModeActive | SetHighContrastMode | Dark Mode | High Contrast | Notifications