Метод FontFamily::GetFamilyName (gdiplusheaders.h)
Метод FontFamily::GetFamilyName получает имя этого семейства шрифтов.
Синтаксис
Status GetFamilyName(
[out] LPWSTR name,
[in] LANGID language
);
Параметры
[out] name
Тип: WCHAR[LF_FACESIZE]
Имя этого семейства шрифтов.
[in] language
Тип: WCHAR
Необязательный элемент. Шестнадцать битов, указывающее используемый язык. Значение по умолчанию — LANG_NEUTRAL, который является языком пользователя по умолчанию.
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .
Комментарии
При указании LANG_NEUTRAL в качестве идентификатора языка обычно передается только LANG_NEUTRAL, как показано в следующем примере:
stat = FontFamily.GetFamilyName(name, LANG_NEUTRAL);
Если вы указываете язык, отличный от LANG_NEUTRAL, используйте MAKELANGID, чтобы создать сочетание языка и подязыка, как показано в следующем примере:
LANGID language = MAKELANGID(LANG_CHINESE, SUBLANG_CHINESE_TRADITIONAL);
Список доступных языков и подязыков см. в разделе Winnt.h.
Примеры
В следующем примере создается объект FontFamily , возвращается имя семейства и выводится имя в виде текста.
VOID Example_GetFamilyName(HDC hdc)
{
Graphics graphics(hdc);
// Create a FontFamily object.
FontFamily nameFontFamily(L"arial");
// Get the cell ascent of the font family in design units.
WCHAR familyName[LF_FACESIZE];
nameFontFamily.GetFamilyName(familyName);
// Copy the cell ascent into a string and draw the string.
SolidBrush solidbrush(Color(255, 0, 0, 0));
Font font(&nameFontFamily, 16);
graphics.DrawString(familyName, -1, &font, PointF(0, 0), &solidbrush);
}
Требования
| Минимальная версия клиента | Windows XP, Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | gdiplusheaders.h (включая Gdiplus.h) |
| Библиотека | Gdiplus.lib |
| DLL | Gdiplus.dll |
См. также раздел
Создание семейств и шрифтов шрифтов