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

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);
}

要件

こちらもご覧ください

FontCollection

FontCollection::GetFamilyCount

FontFamily

PrivateFontCollection

テキストとフォントの使用