Интерфейс IDWriteFontFamily (dwrite.h)
Представляет семейство связанных шрифтов.
Наследование
Интерфейс IDWriteFontFamily наследуется от IDWriteFontList. IDWriteFontFamily также имеет следующие типы элементов:
Методы
Интерфейс IDWriteFontFamily содержит следующие методы.
| IDWriteFontFamily::GetFamilyNames Создает локализованный объект строк, содержащий имена семейства шрифтов, индексированные по имени языкового стандарта. (IDWriteFontFamily.GetFamilyNames) |
| IDWriteFontFamily::GetFirstMatchingFont Возвращает шрифт, который лучше всего соответствует заданным свойствам. |
| IDWriteFontFamily::GetMatchingFonts Возвращает список шрифтов в семействе шрифтов, ранжированных в порядке их соответствия указанным свойствам. |
Комментарии
Семейство шрифтов — это набор шрифтов, которые имеют одно и то же имя семейства, например "Times New Roman", но отличающиеся по функциям. К этим различиям признаков относятся стиль, например курсив, и вес, например полужирный.
На следующем рисунке показаны примеры шрифтов, входящих в семейство шрифтов Times New Roman.
Объект IDWriteFontFamily можно получить из коллекции шрифтов с помощью метода IDWriteFontCollection::GetFontFamily , показанного в следующем примере. GetFontFamily принимает индекс UINT32 и возвращает семейство шрифтов для шрифта по указанному индексу.
IDWriteFontFamily* pFontFamily = NULL;
// Get the font family.
if (SUCCEEDED(hr))
{
hr = pFontCollection->GetFontFamily(i, &pFontFamily);
}
Имя семейства шрифтов используется для указания семейства шрифтов для объектов макета текста и форматирования текста. Список локализованных имен семейств шрифтов можно получить из объекта IDWriteFontFamily в виде объекта IDWriteLocalizedStrings с помощью метода IDWriteFontFamily::GetFamilyNames , как показано в следующем коде.
IDWriteLocalizedStrings* pFamilyNames = NULL;
// Get a list of localized strings for the family name.
if (SUCCEEDED(hr))
{
hr = pFontFamily->GetFamilyNames(&pFamilyNames);
}
Требования
| Минимальная версия клиента | Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | dwrite.h |