Как перечислить шрифты

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

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

• Шаг 1: Получите коллекцию системных шрифтов.
• шаг 2. Получение числа семейств шрифтов.
• создать цикл For.
  • шаг 3. Получение семейства шрифтов.
  • Шаг 4: Получите фамилии.
  • Шаг 5. Найдите название локали.
  • шаге 6. Получение длины строки имени семейства и строки.
• Заключение
• пример кода

Используйте метод GetSystemFontCollection, предоставляемый фабрикой DirectWrite, чтобы вернуть IDWriteFontCollection со всеми системными шрифтами.

IDWriteFontCollection* pFontCollection = NULL;

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

Затем получите число семейств шрифтов из коллекции шрифтов с помощью IDWriteFontCollection::GetFontFamilyCount. Мы будем использовать это для перебора каждого семейства шрифтов в коллекции.

UINT32 familyCount = 0;

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

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

Теперь, когда у вас есть коллекция шрифтов и число шрифтов, следующие шаги проходят по каждому семейству шрифтов, извлекая объект IDWriteFontFamily и запрашивая его.

Получите объект IDWriteFontFamily с помощью метода IDWriteFontCollection::GetFontFamily, передав ему текущий индекс i.

IDWriteFontFamily* pFontFamily = NULL;

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

Получите имена семейств шрифтов с помощью IDWriteFontFamily::GetFamilyNames. Это объект IDWriteLocalizedStrings. Он может иметь несколько локализованных версий названия семейства шрифтов.

IDWriteLocalizedStrings* pFamilyNames = NULL;

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

Получите название семейства шрифтов в нужной локали с помощью метода 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;

Наконец, получите длину строки имени семейства с помощью 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, чтобы начать форматирование текста с указанным семейством шрифтов и т. д.

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