Xournal++在Windows 11深色模式下标题栏显示异常的解决方案

Xournal++是一款优秀的开源笔记和PDF注释工具，但在Windows 11系统中使用深色模式时，用户可能会遇到标题栏保持白色的问题。本文将深入分析该问题的原因，并提供有效的解决方案。

问题现象分析

当用户在Windows 11系统中启用深色模式后，Xournal++的主界面虽然可以正常切换到深色主题，但窗口标题栏却仍然保持白色。这种视觉不一致不仅影响美观，在夜间使用时还会造成明显的视觉不适。

技术背景

Windows 11系统提供了DWMWA_USE_IMMERSIVE_DARK_MODE属性，允许应用程序将窗口标题栏设置为深色模式。然而，由于GTK框架与Windows原生API的交互限制，Xournal++无法直接通过常规方式实现这一效果。

解决方案

方法一：启用GTK客户端装饰(CSD)

最有效的解决方案是强制Xournal++使用GTK自带的窗口装饰而非系统原生装饰：

1. 临时解决方案（仅对当前会话有效）：

   set GTK_CSD=1
   xournal++.exe
   

2. 永久解决方案（添加系统环境变量）：

   • 打开系统属性中的环境变量设置
   • 添加新的用户/系统变量
   • 变量名：GTK_CSD
   • 变量值：1

方法二：代码级解决方案（开发者参考）

对于开发者而言，可以通过直接调用Windows API来实现深色标题栏。虽然原始issue中提到的代码方案会导致段错误，但正确的实现方式应该是：

#include <gdk/gdkwin32.h>
#include <dwmapi.h>

// 获取窗口句柄
GdkWindow* gdk_window = gtk_widget_get_window(GTK_WIDGET(window));
HWND hwnd = (HWND)gdk_win32_window_get_handle(gdk_window);

// 设置深色模式
BOOL dark_mode = TRUE;
DwmSetWindowAttribute(hwnd, DWMWA_USE_IMMERSIVE_DARK_MODE, 
                     &dark_mode, sizeof(dark_mode));

注意事项

1. 使用GTK_CSD=1方案时，窗口装饰将由GTK绘制，可能会与系统原生装饰有细微差异
2. 代码级解决方案需要正确处理窗口生命周期，避免在窗口未初始化时调用API
3. 两种方案都需要确保Windows系统本身已启用深色模式

结语

通过上述方法，用户可以轻松解决Xournal++在Windows 11深色模式下标题栏显示异常的问题。对于普通用户，推荐使用环境变量方案；对于开发者，则可以进一步研究代码级解决方案，为项目贡献更完善的深色模式支持。