FontCollection::GetFamilies-Methode (gdiplusheaders.h)
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 |