Metodo FontCollection::GetFamilies (gdiplusheaders.h)

Articolo
02/27/2024

Il metodo FontCollection::GetFamilies ottiene le famiglie di caratteri contenute in questa raccolta di caratteri.

Sintassi

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

Parametri

[in] numSought

Tipo: INT

Intero che specifica il numero di famiglie di caratteri in questa raccolta di caratteri.

[out] gpfamilies

Tipo: FontFamily*

Puntatore a una matrice che riceve gli oggetti FontFamily .

[out] numFound

Tipo: INT*

Puntatore a un INT che riceve il numero di famiglie di caratteri presenti in questa raccolta. Questo numero deve essere uguale al valore numSought .

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status . Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Una famiglia di caratteri è costituita da un singolo tipo di carattere con stili correlati. Un esempio di tipo di carattere singolo è Arial Regular. Un esempio di famiglia di caratteri è un set di tipi di carattere contenenti tipi di carattere Arial Regular, Arial Italic e Arial Bold style.

Esempio

L'esempio seguente crea un oggetto PrivateFontCollection , ottiene gli oggetti FontFamily contenuti nell'insieme e usa una delle famiglie di caratteri per disegnare testo.

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);
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusheaders.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll