主题管理
用途:控制窗口是浅色 / 深色 / 跟随系统,以及在 Windows 11 上是否使用 Mica、亚克力等系统背景效果;也可直接设背景色字符串。2.0 里主题名都是 字符串(Light / Dark / System),不再使用旧头文件里的枚举类型名。
窗口明暗主题
对应 API:set_window_theme、get_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 常用取值:mica、micaAlt、acrylic(小写驼峰,与系统 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。