FontCollection ::GetFamilies, méthode (gdiplusheaders.h)
La méthode FontCollection ::GetFamilies obtient les familles de polices contenues dans cette collection de polices.
Syntaxe
Status GetFamilies(
[in] INT numSought,
[out] FontFamily *gpfamilies,
[out] INT *numFound
);
Paramètres
[in] numSought
Type : INT
Entier qui spécifie le nombre de familles de polices dans cette collection de polices.
[out] gpfamilies
Type : FontFamily*
Pointeur vers un tableau qui reçoit les objets FontFamily .
[out] numFound
Type : INT*
Pointeur vers un INT qui reçoit le nombre de familles de polices trouvées dans cette collection. Ce nombre doit être identique à la valeur numSought .
Valeur retournée
Type : État
Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status . Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .
Remarques
Une famille de polices se compose d’un type de police unique avec des styles associés. Un exemple de type de police unique est Arial Regular. Un exemple de famille de polices est un ensemble de polices contenant des polices de style Arial Regular, Arial Italic et Arial Bold.
Exemples
L’exemple suivant crée un objet PrivateFontCollection , obtient les objets FontFamily contenus dans la collection et utilise l’une des familles de polices pour dessiner du texte.
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);
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP, Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | gdiplusheaders.h (inclure Gdiplus.h) |
| Bibliothèque | Gdiplus.lib |
| DLL | Gdiplus.dll |