WPF中SystemColors.WindowTextBrushKey应用资源加载异常问题

一、Page中TextBlock不生效的原因与修复 #

你遇到的核心问题有两点：一是Frame加载的Page未正确应用应用级系统颜色资源，二是不同容器内的控件默认绑定的系统颜色键存在差异。

1. 控件默认Foreground的系统键差异 #

WPF中，Window内的TextBlock通常继承容器配色逻辑，使用WindowTextBrushKey；但Page内的TextBlock默认绑定的是ControlTextBrushKey。因此需要同时重写这两个键：

<Application.Resources>
    <!-- 覆盖窗口区域文本颜色 -->
    <SolidColorBrush x:Key="{x:Static SystemColors.WindowTextBrushKey}" Color="#FFF" />
    <!-- 覆盖控件区域文本颜色（Page内TextBlock默认使用） -->
    <SolidColorBrush x:Key="{x:Static SystemColors.ControlTextBrushKey}" Color="#FFF" />
</Application.Resources>

2. Frame加载Page的资源刷新 #

如果上述修改仍不生效，可在Page的Loaded事件中强制刷新资源上下文：

private void Page_Loaded(object sender, RoutedEventArgs e)
{
    var page = sender as Page;
    var tempResources = page.Resources;
    page.Resources = new ResourceDictionary();
    page.Resources.MergedDictionaries.Add(tempResources);
}

二、初始加载不生效的修复 #

系统颜色资源属于动态资源范畴，应用启动时可能存在加载顺序问题。可在Application_Startup事件中触发资源刷新：

private void Application_Startup(object sender, StartupEventArgs e)
{
    // 强制更新系统颜色缓存
    SystemColors.UpdateSystemColors();
    // 触发应用资源字典的更新
    var tempDict = new ResourceDictionary();
    Current.Resources.MergedDictionaries.Add(tempDict);
    Current.Resources.MergedDictionaries.Remove(tempDict);
}

三、无需额外框架的系统明暗模式跟随 #

通过监听系统主题变更事件，结合注册表判断系统明暗模式，自动更新应用配色：

1. 后台逻辑实现 #

using Microsoft.Win32;
using System.Windows;
using System.Windows.Media;

public partial class App : Application
{
    protected override void OnStartup(StartupEventArgs e)
    {
        base.OnStartup(e);
        SystemEvents.UserPreferenceChanged += SystemEvents_UserPreferenceChanged;
        ApplySystemTheme();
    }

    protected override void OnExit(ExitEventArgs e)
    {
        SystemEvents.UserPreferenceChanged -= SystemEvents_UserPreferenceChanged;
        base.OnExit(e);
    }

    private void SystemEvents_UserPreferenceChanged(object sender, UserPreferenceChangedEventArgs e)
    {
        if (e.Category == UserPreferenceCategory.General)
            ApplySystemTheme();
    }

    private void ApplySystemTheme()
    {
        bool isDarkMode = IsSystemDarkMode();
        var appResources = Current.Resources;

        if (isDarkMode)
        {
            appResources[SystemColors.WindowTextBrushKey] = new SolidColorBrush(Colors.White);
            appResources[SystemColors.ControlTextBrushKey] = new SolidColorBrush(Colors.White);
            appResources[SystemColors.WindowBrushKey] = new SolidColorBrush(Color.FromRgb(32, 32, 32));
            appResources[SystemColors.ControlBrushKey] = new SolidColorBrush(Color.FromRgb(48, 48, 48));
        }
        else
        {
            // 移除自定义资源，恢复系统默认配色
            appResources.Remove(SystemColors.WindowTextBrushKey);
            appResources.Remove(SystemColors.ControlTextBrushKey);
            appResources.Remove(SystemColors.WindowBrushKey);
            appResources.Remove(SystemColors.ControlBrushKey);
        }

        // 刷新所有窗口的资源绑定，确保控件立即应用新配色
        foreach (Window win in Current.Windows)
        {
            var tempRes = win.Resources;
            win.Resources = new ResourceDictionary();
            win.Resources.MergedDictionaries.Add(tempRes);
        }
    }

    private bool IsSystemDarkMode()
    {
        using (var regKey = Registry.CurrentUser.OpenSubKey(@"Software\Microsoft\Windows\CurrentVersion\Themes\Personalize"))
        {
            return regKey?.GetValue("AppsUseLightTheme") is 0;
        }
    }
}

2. 说明 #

• 该方案通过读取注册表判断系统明暗模式，兼容Windows 10及以上版本。
• 监听UserPreferenceChanged事件，实时响应系统主题变更。
• 刷新窗口资源字典确保所有控件立即应用新配色。

内容的提问来源于stack exchange，提问作者Barak Gall