本文使用 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"
这样分发应用的时候就不用附带分发字体文件了。
程序最终运行结果如下：
