Перечисление шрифтов

Статья
01/28/2024

В этом обзоре показано, как перечислить шрифты в системной коллекции шрифтов по имени семейства.

Этот обзор состоит из следующих частей:

Шаг 1. Получение коллекции системных шрифтов.
Шаг 2. Получение числа семейств шрифтов.
Сделайте for Loop.
Заключение
Пример кода

Шаг 1. Получение коллекции системных шрифтов.

Используйте метод GetSystemFontCollection, предоставляемый фабрикой DirectWrite, чтобы вернуть 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. Получение семейства шрифтов.

Получение объекта IDWriteFontFamily с помощью IDWriteFontCollection::GetFontFamily и передачи его текущего индекса 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. Поиск имени языкового стандарта.

Получите имя шрифта famliy в нужном языковом стандарте с помощью метода IDWriteLocalizedStrings::FindLocaleName . В этом случае сначала извлекается и запрашивается языковой стандарт по умолчанию. Если это не работает, запрашивается языковой стандарт 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, чтобы начать форматирование текста с указанным семейством шрифтов и т. д.

Пример кода

Полный исходный код для этого примера см. в примере перечисления шрифтов.

Поделиться через