FontCollection::GetFamilies-Methode (gdiplusheaders.h)

Artikel
02/29/2024

Die FontCollection::GetFamilies-Methode ruft die Schriftartfamilien ab, die in dieser Schriftartensammlung enthalten sind.

Syntax

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

Parameter

[in] numSought

Typ: INT

Ganzzahl, die die Anzahl der Schriftfamilien in dieser Schriftartensammlung angibt.

[out] gpfamilies

Typ: FontFamily*

Zeiger auf ein Array, das die FontFamily-Objekte empfängt .

[out] numFound

Typ: INT*

Zeiger auf einen INT , der die Anzahl der Schriftartfamilien empfängt, die in dieser Sammlung gefunden wurden. Diese Zahl sollte mit dem numSought-Wert identisch sein.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration . Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Eine Schriftfamilie besteht aus einem einzelnen Schriftarttyp mit zugehörigen Formatvorlagen. Ein Beispiel für einen einzelnen Schriftarttyp ist Arial Regular. Ein Beispiel für eine Schriftartenfamilie ist eine Reihe von Schriftarten, die Die Schriftarten Arial Regular, Arial Italic und Arial Bold enthalten.

Beispiele

Im folgenden Beispiel wird ein PrivateFontCollection-Objekt erstellt, die FontFamily-Objekte abgerufen, die in der Auflistung enthalten sind, und eine der Schriftartfamilien verwendet, um Text zu zeichnen.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll