通过

FontFamily：：GetFamilyName 方法 (gdiplusheaders.h)

  • 项目

FontFamily：：GetFamilyName 方法获取此字体系列的名称。

语法

Status GetFamilyName(
  [out] LPWSTR name,
  [in]  LANGID language
);

parameters

[out] name

类型： WCHAR[LF_FACESIZE]

此字体系列的名称。

[in] language

类型： WCHAR

可选。 指定要使用的语言的 16 位值。 默认值为 LANG_NEUTRAL，这是用户的默认语言。

返回值

类型： 状态

如果该方法成功，则返回 Ok，这是 Status 枚举的元素。

如果方法失败，它将返回 Status 枚举的其他元素之一。

注解

将 LANG_NEUTRAL 指定为语言 ID 时，通常的做法是仅传递 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
标头 gdiplusheaders.h (包括 Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

另请参阅

构造字体系列和字体

枚举安装的字体

FontFamily