如何枚举字体

项目
01/28/2024

本概述将演示如何按系列名称枚举系统字体集合中的字体。

此概述包含以下部分：

步骤 1：获取系统字体集合。
步骤 2：获取字体系列计数。
创建一个 for Loop。
结论
示例代码

步骤 1：获取系统字体集合。

使用DirectWrite工厂提供的 GetSystemFontCollection 方法返回 IDWriteFontCollection，其中包含所有系统字体。

IDWriteFontCollection* pFontCollection = NULL;

// Get the system font collection.
if (SUCCEEDED(hr))
{
    hr = pDWriteFactory->GetSystemFontCollection(&pFontCollection);
}

步骤 2：获取字体系列计数。

接下来，使用 IDWriteFontCollection：：GetFontFamilyCount 从字体集合中获取字体系列计数。我们将使用此函数循环访问集合中的每个字体系列。

UINT32 familyCount = 0;

// Get the number of font families in the collection.
if (SUCCEEDED(hr))
{
    familyCount = pFontCollection->GetFontFamilyCount();
}

创建一个 for Loop。

for (UINT32 i = 0; i < familyCount; ++i)

有了字体集合和字体计数后，剩余的步骤将循环访问每个字体系列，检索 IDWriteFontFamily 对象并查询它。

步骤 3：获取字体系列。

使用 IDWriteFontCollection：：GetFontFamily 获取 IDWriteFontFamily 对象，并将其传递给当前索引 i。

IDWriteFontFamily* pFontFamily = NULL;

// Get the font family.
if (SUCCEEDED(hr))
{
    hr = pFontCollection->GetFontFamily(i, &pFontFamily);
}

步骤 4：获取系列名称。

使用 IDWriteFontFamily：：GetFamilyNames 获取字体系列名称。这是 IDWriteLocalizedStrings 对象。它可以为字体系列具有多个本地化版本的系列名称。

IDWriteLocalizedStrings* pFamilyNames = NULL;

// Get a list of localized strings for the family name.
if (SUCCEEDED(hr))
{
    hr = pFontFamily->GetFamilyNames(&pFamilyNames);
}

步骤 5：查找区域设置名称。

使用 IDWriteLocalizedStrings：：FindLocaleName 方法获取所需区域设置中的字体 famliy 名称。在这种情况下，首先检索并请求默认区域设置。如果这不起作用，则会请求“en-us”区域设置。如果未找到任一指定区域设置，则此示例只是回退到索引 0，即第一个可用的区域设置。

UINT32 index = 0;
BOOL exists = false;

wchar_t localeName[LOCALE_NAME_MAX_LENGTH];

if (SUCCEEDED(hr))
{
    // Get the default locale for this user.
    int defaultLocaleSuccess = GetUserDefaultLocaleName(localeName, LOCALE_NAME_MAX_LENGTH);

    // If the default locale is returned, find that locale name, otherwise use "en-us".
    if (defaultLocaleSuccess)
    {
        hr = pFamilyNames->FindLocaleName(localeName, &index, &exists);
    }
    if (SUCCEEDED(hr) && !exists) // if the above find did not find a match, retry with US English
    {
        hr = pFamilyNames->FindLocaleName(L"en-us", &index, &exists);
    }
}

// If the specified locale doesn't exist, select the first on the list.
if (!exists)
    index = 0;

步骤 6：获取系列名称字符串长度和字符串的长度。

最后，使用 IDWriteLocalizedStrings：：GetStringLength 获取系列名称字符串的长度。使用此长度分配足够大的字符串来保存名称，然后使用 IDWriteLocalizedStrings：：GetString 获取字体系列名称。

UINT32 length = 0;

// Get the string length.
if (SUCCEEDED(hr))
{
    hr = pFamilyNames->GetStringLength(index, &length);
}

// Allocate a string big enough to hold the name.
wchar_t* name = new (std::nothrow) wchar_t[length+1];
if (name == NULL)
{
    hr = E_OUTOFMEMORY;
}

// Get the family name.
if (SUCCEEDED(hr))
{
    hr = pFamilyNames->GetString(index, name, length+1);
}

结论

在区域设置中具有姓氏或名称后，可以列出这些名称供用户选择，或将其传递给 CreateTextFormat，以开始使用指定的字体系列设置文本格式，等等。

示例代码

若要查看此示例的完整源代码，请参阅字体枚举示例。

通过