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

Artigo
02/26/2024

O método FontCollection::GetFamilies obtém as famílias de fontes contidas nesta coleção de fontes.

Sintaxe

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

Parâmetros

[in] numSought

Tipo: INT

Inteiro que especifica o número de famílias de fontes nesta coleção de fontes.

[out] gpfamilies

Tipo: FontFamily*

Ponteiro para uma matriz que recebe os objetos FontFamily .

[out] numFound

Tipo: INT*

Ponteiro para um INT que recebe o número de famílias de fontes encontradas nesta coleção. Esse número deve ser o mesmo que o valor numSought .

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status . Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Uma família de fontes consiste em um único tipo de fonte com estilos relacionados. Um exemplo de um único tipo de fonte é Arial Regular. Um exemplo de uma família de fontes é um conjunto de fontes que contém fontes de estilo Arial Regular, Arial Italic e Arial Bold.

Exemplos

O exemplo a seguir cria um objeto PrivateFontCollection , obtém os objetos FontFamily contidos na coleção e usa uma das famílias de fontes para desenhar 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	Valor
Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll