Método FontCollection::GetFamilies (gdiplusheaders.h)
El método FontCollection::GetFamilies obtiene las familias de fuentes contenidas en esta colección de fuentes.
Sintaxis
Status GetFamilies(
[in] INT numSought,
[out] FontFamily *gpfamilies,
[out] INT *numFound
);
Parámetros
[in] numSought
Tipo: INT
Entero que especifica el número de familias de fuentes de esta colección de fuentes.
[out] gpfamilies
Tipo: FontFamily*
Puntero a una matriz que recibe los objetos FontFamily .
[out] numFound
Tipo: INT*
Puntero a un INT que recibe el número de familias de fuentes encontradas en esta colección. Este número debe ser el mismo que el valor numSought .
Valor devuelto
Tipo: Estado
Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status . Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .
Comentarios
Una familia de fuentes consta de un único tipo de fuente con estilos relacionados. Un ejemplo de un único tipo de fuente es Arial Regular. Un ejemplo de una familia de fuentes es un conjunto de fuentes que contienen fuentes de estilo Arial Regular, Arial Italic y Arial Bold.
Ejemplos
En el ejemplo siguiente se crea un objeto PrivateFontCollection , se obtienen los objetos FontFamily contenidos en la colección y se usa una de las familias de fuentes para dibujar texto.
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);
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | gdiplusheaders.h (include Gdiplus.h) |
| Library | Gdiplus.lib |
| Archivo DLL | Gdiplus.dll |