Método FontCollection::GetFamilies (gdiplusheaders.h)

Artículo
02/26/2024

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