UI Composition 在 Win32 窗口中绘制字体图标

简介: 本文介绍如何在Win32中通过DirectWrite动态加载嵌入式字体资源(RT_RCDATA),构建自定义字体集合与多语言文本格式映射,实现跨平台一致的文本渲染,无需分发字体文件。使用DraftDepot一键发布。

本文使用 DraftDepot(稿仓 https://github.com/xland/DraftDepot)编辑并发布,DraftDepot 可以把一篇文章一键发布到多个平台。

在上一篇文章中,我们介绍了如何使用 UI Composition 技术在 Win32 窗口中绘制文本

生成自定义字体集合

ComPtr<IDWriteFontSetBuilder1> builder;
if (FAILED(dwriteFactory->CreateFontSetBuilder(&builder))) {
   
    _ASSERT_EXPR(FALSE, L"CreateFontSetBuilder, error");
    return;
}
// Microsoft::WRL::ComPtr<IDWriteInMemoryFontFileLoader> fontLoader;
if (!fontLoader) {
   
    dwriteFactory->CreateInMemoryFontFileLoader(fontLoader.GetAddressOf());
    dwriteFactory->RegisterFontFileLoader(fontLoader.Get());
}
// std::vector<std::wstring> fontNames;
for (const auto& resName : fontNames) {
   
    auto [pData, size] = Util::getRes(resName.c_str());  //工具方法,读取exe资源内的字体文件,见后文
    if (pData == nullptr || size == 0) {
   
        _ASSERT_EXPR(FALSE, L"load font res, error");
        return;
    }
    ComPtr<IDWriteFontFile> fontFile;
    auto hr = fontLoader->CreateInMemoryFontFileReference(dwriteFactory.Get(), pData, size, nullptr, fontFile.GetAddressOf());
    if (FAILED(hr)) {
   
        _ASSERT_EXPR(FALSE, L"font res decode, error");
        continue;
    }
    builder->AddFontFile(fontFile.Get());
}
ComPtr<IDWriteFontSet> customFontSet;
if (FAILED(builder->CreateFontSet(&customFontSet))) {
   
    _ASSERT_EXPR(FALSE, L"CreateFontSet, error");
    return;
}
// Microsoft::WRL::ComPtr<IDWriteFontCollection1> customFontCollection;
if (FAILED(dwriteFactory->CreateFontCollectionFromFontSet(customFontSet.Get(), customFontCollection.ReleaseAndGetAddressOf()))) {
   
    _ASSERT_EXPR(FALSE, L"CreateFontCollectionFromFontSet, error");
    return;
}

这段代码的作用是从应用程序资源中加载自定义字体,并构建一个独立的 DirectWrite 字体集合,

代码首先创建 IDWriteFontSetBuilder1 构建器,并以懒加载单例模式注册内存字体加载器 fontLoader,确保加载器只被初始化一次且不污染系统全局状态。

随后遍历字体资源列表,通过工具函数提取 exe 中的字体资源(二进制数据,稍后介绍此函数),

将字体二进制数据包装为 DWrite 可识别的字体文件引用并添加到构建器中 fontFile,单个字体加载失败不会影响整体流程,保证了程序的健壮性。

最终,构建器生成字体集合(customFontSet)并转换为 IDWriteFontCollection1 对象。

创建自定义字体TextFormat集合

// std::unordered_map<std::wstring, Microsoft::WRL::ComPtr<IDWriteTextFormat>> customFormats;
customFormats.clear();
if (!customFontCollection) return;
auto familyCount = customFontCollection->GetFontFamilyCount();
for (UINT32 i = 0; i < familyCount; i++) {
   
    ComPtr<IDWriteFontFamily> family;
    if (FAILED(customFontCollection->GetFontFamily(i, family.GetAddressOf()))) continue;
    ComPtr<IDWriteLocalizedStrings> names;
    if (FAILED(family->GetFamilyNames(names.GetAddressOf()))) continue;
    auto nameCount = names->GetCount();
    if (nameCount == 0) continue;
    // 先取第 0 个名字建 format
    UINT32 len{
    0 };
    if (FAILED(names->GetStringLength(0, &len))) continue;
    std::wstring first(len, L'\0');
    if (FAILED(names->GetString(0, first.data(), len + 1))) continue;
    ComPtr<IDWriteTextFormat> format;
    if (FAILED(dwriteFactory->CreateTextFormat(first.data(), customFontCollection.Get(),
        DWRITE_FONT_WEIGHT_NORMAL, DWRITE_FONT_STYLE_NORMAL, DWRITE_FONT_STRETCH_NORMAL,
        12.f, L"zh-CN", format.GetAddressOf()))) continue;
    // 各本地化名字都登记一份(同一个 format),调用方写哪个名字都能命中
    for (UINT32 j = 0; j < nameCount; j++) {
   
        if (FAILED(names->GetStringLength(j, &len))) continue;
        std::wstring name(len, L'\0');
        if (FAILED(names->GetString(j, name.data(), len + 1))) continue;
        std::transform(name.begin(), name.end(), name.begin(), ::towlower);
        customFormats[name] = format;
    }
}

这段代码首先遍历上一步生成的 customFontCollection 中的所有字体族,获取每个字体族的本地化名称列表。

由于一个字体通常包含多个名称(如英文名、中文名或不同语言下的别名),代码会提取第一个名称作为主名称。

调用 CreateTextFormat 创建一个默认的 IDWriteTextFormat 对象(12pt、常规字重)。

在创建好基础的 format 后,代码会遍历该字体的所有本地化名称,将它们统一转换为小写,并全部作为键(Key)指向同一个 format 对象(Value)存入字典。

这样的话后续渲染文本时,调用方无论传入字体的英文、中文还是任意大小写组合,都能以精准命中对应的文本格式。

这段代码为后续 DrawTextLayout 提供了开箱即用的格式模板。

使用自定义字体的TextFormat

IDWriteTextFormat* D2D::getTextFormat(const std::wstring& fontFamily)
{
   
    if (fontFamily.empty() || customFormats.empty()) return baseTextFormat.Get();
    std::wstring key{
    fontFamily };
    std::transform(key.begin(), key.end(), key.begin(), ::towlower);
    auto it = customFormats.find(key);
    return it == customFormats.end() ? baseTextFormat.Get() : it->second.Get();
}

auto format = d2d->getTextFormat(fontFamily);
d2d->dwriteFactory->CreateTextLayout(text.data(), (UINT32)text.length(), format, FLT_MAX, FLT_MAX, textLayout.ReleaseAndGetAddressOf());

这段代码首先对传入的字体族名称进行小写标准化处理,以确保与之前构建的 customFormats 字典键值匹配;

随后在字典中查找对应的 IDWriteTextFormat,若未找到或输入为空,则自动返回初始化阶段创建的 baseTextFormat(微软雅黑)作为兜底。
获取到安全的文本格式后,代码立即调用 CreateTextLayout 生成文本布局对象。

到这里,就和上一节介绍的使用系统字体绘制文本一样了。

附:读取exe资源中的字体文件

std::tuple<void*, DWORD> Util::getRes(const std::wstring& name)
{
   
    HRSRC hRes = FindResource(NULL, name.data(), RT_RCDATA);
    if (!hRes) {
   
        return std::make_tuple(nullptr, 0);
    }
    HGLOBAL hData = LoadResource(NULL, hRes);
    if (!hData) {
   
        return std::make_tuple(nullptr, 0);
    }
    void* pData = LockResource(hData);
    DWORD size = SizeofResource(NULL, hRes);
    return std::make_tuple(pData, size);
}

这段代码从 Windows PE 资源段中读取二进制数据的通用工具函数。

它通过标准的 Win32 资源读取方法(FindResource → LoadResource → LockResource)定位并锁定指定名称的 RT_RCDATA 资源,最终返回一个包含内存指针和数据大小的元组。

你只要通过这种形式设置应用程序的Res.rc文件即可把一个字体文件以资源的形式嵌入到exe中了

iconfong RCDATA "res/iconfont.ttf"

这样分发应用的时候就不用附带分发字体文件了。

程序最终运行结果如下:

目录
相关文章
|
27天前
|
人工智能 自然语言处理 测试技术
基于 JEV 的 UI 自动化改造实践:从页面探索到失败修复
最近讨论度很高的 AI 模型: JEV 。 它和常见的大模型不太一样。ChatGPT、Claude 这类模型更擅长对话、生成文本、写代码、解释问题;JEV 的定位更窄一些,主要用来做判断。调用接口后,它会根据输入内容返回结构化结果,程序可以直接读取这个结果,再决定下一步怎么执行。 这个特点很适合放在自动化流程里。 以 UI 自动化测试为例,传统脚本通常是提前写好步骤:点击哪个按钮、输入什么内容、断言哪个元素出现。只要页面结构稳定,这种方式没有问题。但在实际项目里,页面经常会出现一些不确定情况: 同一个业务入口在不同环境里文案不完全一致; 页面上有多个相似按钮,需要判断应该点哪一个; 执行失败后
112 1
|
27天前
Ubuntu22扩容磁盘到根目录
Ubuntu22扩容磁盘到根目录
205 1
|
27天前
|
网络协议 定位技术 数据库
IPv6单栈与去NAT:IP定位逻辑从“推测”走向“解析”的架构演进
IPv6正从政策驱动迈向单栈演进与“网络去NAT”实践,推动IP定位由IPv4时代的“猜位置”转向IPv6的“读前缀线索”。双栈过渡期需重点保障IPv4/IPv6定位一致性,依赖高覆盖、快更新的双栈IP库(如IP数据云)开展实测验证。(239字)
118 0
|
27天前
|
人工智能 定位技术
西安的 GEO 优化公司怎么挑:把「本地化」拆成可验证的交付证据
GEO(生成式引擎优化)是让AI精准引用机构公开材料的技术方法。当问题含“西安”等地域词,需处理“地域+行业+场景”复合意图——关键看其是否具备本地材料识别、信源对接与现场交付能力。本文提供可落地的核验路径:查问句集四行结构、验办公地址、溯信源渠道、核案例三匹配等,助您识别真本地化服务。(239字)
|
27天前
|
存储 弹性计算 监控
商协会活动报名峰值,用阿里云函数计算 FC 做弹性扩容
商协会年会报名等场景流量呈脉冲式爆发,函数计算(FC)弹性扩缩容能力完美匹配:峰值自动扩容、闲时缩容至零,按调用计费,成本大幅降低;配合API网关限流鉴权、表格存储原子操作与幂等设计,兼顾高并发稳定性与会员体验。(239字)
|
27天前
|
关系型数据库 数据库 PostgreSQL
Compose应用先于PostgreSQL就绪导致连接失败:healthcheck与service_healthy配置记录
本文详解Docker Compose冷启动时`connection refused`根因:`depends_on`仅保启动顺序,不等数据库就绪。通过为DB配置`healthcheck`+应用侧使用`condition: service_healthy`,实现真正依赖等待,避免手动重启“修复”。(239字)
|
27天前
|
安全
移动即时通信平台上的虚假招聘诈骗手法分析
本文剖析以虚假招聘为诱饵、引流至WhatsApp等私密即时通信平台实施的社会工程诈骗。聚焦“接触—转移—侵害”三阶段链条,揭示其利用移动端信任生态与求职者心理缺口的双重机制,强调“平台转移”是构建信任、规避监管的关键环节,并从用户识别、平台治理、行业协同三方面提出防御路径。(239字)
80 0
|
27天前
|
人工智能 算法 定位技术
Geo优化中,视频内容常踩的七个坑与规避方法
视频能否被生成式AI引用,关键不在画面质量,而在是否配备机器可读、可定位、可验证的文本层——包括精准字幕、结构化数据、章节时间戳及独立文字稿。文中梳理七大常见误区,直击“有内容却无引用”的核心症结。
119 0
|
27天前
|
数据采集 人工智能 自然语言处理
2026年评论私信聚合回复技术落地指南:核心能力拆解、选型避坑与成本核算
国内内容运营领域正从单平台单点运营阶段向跨平台矩阵化、全链路智能化运营阶段加速演进,评论私信作为用户与运营主体直接交互的核心触点,其管理效率与响应质量已经成为影响账号流量权重、线索转化效率、品牌用户口碑的关键变量。本文将从核心技术能力拆解、选型避坑逻辑、落地成本核算三个维度展开系统盘点,定位为面向运营从业者、企业技术负责人的实操型科普内容,以评论私信聚合回复的典型落地形态为示例,说明各项技术的实际表现形式与选型注意点。文中出现的各类平台与方案仅作技术逻辑举例,不代表任何推荐顺序。
|
4月前
|
IDE 数据可视化 API
【2026最新】OpenGL下载、安装配置、使用一篇搞定(附安装包+实例)
OpenGL是跨平台图形API,广泛用于游戏、CAD与科学可视化。本文详解在VS2026中配置GLFW环境:下载组件、设置包含目录与库路径、链接glfw3.lib,最后运行彩色三角形实例,助初学者快速入门图形编程。(239字)