FontCollection::GetFamilies メソッド (gdiplusheaders.h)

[アーティクル]
02/29/2024

FontCollection::GetFamilies メソッドは、このフォントコレクションに含まれるフォントファミリを取得します。

構文

Status GetFamilies(
  [in]  INT        numSought,
  [out] FontFamily *gpfamilies,
  [out] INT        *numFound
);

パラメーター

[in] numSought

型: INT

このフォントコレクション内のフォントファミリの数を指定する整数。

[out] gpfamilies

種類: FontFamily*

FontFamily オブジェクトを受け取る配列へのポインター。

[out] numFound

型: INT*

このコレクション内にあるフォントファミリの数を受け取る INT へのポインター。この数値は、 numSought 値と同じである必要があります。

戻り値

種類: 状態

メソッドが成功した場合は、 Status 列挙体の要素である Ok を返します。メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

注釈

フォントファミリは、関連するスタイルを持つ 1 つのフォントの種類で構成されます。 1 つのフォントの種類の例として、Arial Regular があります。フォントファミリの例としては、Arial Regular、Arial Italic、Arial Bold スタイルのフォントを含むフォントのセットがあります。

例

次の例では、 PrivateFontCollection オブジェクトを作成し、コレクションに含まれる FontFamily オブジェクトを取得し、フォントファミリの 1 つを使用してテキストを描画します。

VOID Example_GetFamilies(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a PrivateFontCollection object, and add three families.
   PrivateFontCollection fontCollection;
   fontCollection.AddFontFile(L"C:\\WINNT\\Fonts\\Arial.ttf");
   fontCollection.AddFontFile(L"C:\\WINNT\\Fonts\\CourBI.ttf");
   fontCollection.AddFontFile(L"C:\\WINNT\\Fonts\\TimesBd.ttf");

   // Create an array to hold the font families, and get the font families of
   // fontCollection.
   FontFamily families[3];
   int numFamilies;
   fontCollection.GetFamilies(3, families, &numFamilies);

   // Create a Font object from the first FontFamily object in the array.
   Font myFont(&families[0], 16);

   // Use myFont to draw text.
   SolidBrush solidbrush(Color(255, 0, 0, 0));
   WCHAR string[] = L"This is an Arial font";
   graphics.DrawString(string,
                       21, &myFont, PointF(0, 0), &solidbrush);
}

要件

要件	値
サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdiplusheaders.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll