FontFamily：：GetFamilyName 方法 (gdiplusheaders.h)

FontFamily：：GetFamilyName方法會取得此字型系列的名稱。

語法

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

參數

[out] name

類型： WCHAR[LF_FACESIZE]

這個字型系列的名稱。

[in] language

類型： WCHAR

選擇性。 指定要使用之語言的十六位值。 預設值為 LANG_NEUTRAL，這是使用者的預設語言。

傳回值

類型： 狀態

如果方法成功，它會傳回 Ok，這是 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);
}

需求

另請參閱

建構字型系列和字型

列舉已安裝的字型

FontFamily