跳到主要内容

主题管理

用途:控制窗口是浅色 / 深色 / 跟随系统,以及在 Windows 11 上是否使用 Mica、亚克力等系统背景效果;也可直接设背景色字符串。2.0 里主题名都是 字符串Light / Dark / System),不再使用旧头文件里的枚举类型名。


窗口明暗主题

对应 API:set_window_themeget_window_theme用途:切换或查询当前窗口(及内嵌 WebView)的明暗主题

int32_t set_window_theme(uint32_t window_id, const char* theme);
int32_t get_window_theme(uint32_t window_id);

theme"Light""Dark""System"NULL(由库给默认)。


set_window_backdrop

用途:在 Windows 11 上给窗口加上系统提供的背景材质(如云母、亚克力),和系统设置里「个性化」那类效果一致。backdrop_type 常用取值:micamicaAltacrylic(小写驼峰,与系统 DWM API 一致)。

int32_t set_window_backdrop(uint32_t window_id, const char* backdrop_type);

set_window_background_color

用途:用 十六进制颜色(如 #RRGGBB)填窗口背景,不依赖 Mica。

int32_t set_window_background_color(uint32_t window_id, const char* background_color_hex);

创建窗口时顺带指定

WebViewWindowOptions.theme 里填初始主题,见 核心 API