FontFamily::GetFamilyName メソッド (gdiplusheaders.h)

  • [アーティクル]

FontFamily::GetFamilyName メソッドは、このフォント ファミリの名前を取得します。

構文

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

パラメーター

[out] name

種類: WCHAR[LF_FACESIZE]

このフォント ファミリの名前。

[in] language

種類: WCHAR

省略可能。 使用する言語を指定する 16 ビット値。 既定値は LANG_NEUTRAL です。これはユーザーの既定の言語です。

戻り値

種類: 状態

メソッドが成功した場合は、 Status 列挙の要素である Ok を返します。

メソッドが失敗した場合は、 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