Enumerazione dei tipi di carattere installati

La classe InstalledFontCollection eredita dalla classe base astratta FontCollection . È possibile utilizzare un oggetto InstalledFontCollection per enumerare i tipi di carattere installati nel computer. Il metodo FontCollection::GetFamilies di un oggetto InstalledFontCollection restituisce una matrice di oggetti FontFamily . Prima di chiamare FontCollection::GetFamilies, è necessario allocare un buffer di dimensioni sufficienti per contenere tale matrice. Per determinare le dimensioni del buffer necessario, chiamare il metodo FontCollection::GetFamilyCount e moltiplicare il valore restituito per sizeof(FontFamily).

Nell'esempio seguente vengono elencati i nomi di tutte le famiglie di caratteri installate nel computer. Il codice recupera i nomi della famiglia di caratteri chiamando il metodo FontFamily::GetFamilyName di ogni oggetto FontFamily nella matrice restituita da FontCollection::GetFamilies. Quando vengono recuperati i nomi di famiglia, vengono concatenati per formare un elenco delimitato da virgole. Il metodo DrawString della classe Graphics disegna quindi l'elenco delimitato da virgole in un rettangolo.

FontFamily   fontFamily(L"Arial");
Font         font(&fontFamily, 8, FontStyleRegular, UnitPoint);
RectF        rectF(10.0f, 10.0f, 500.0f, 500.0f);
SolidBrush   solidBrush(Color(255, 0, 0, 0));

INT          count = 0;
INT          found = 0;
WCHAR        familyName[LF_FACESIZE];  // enough space for one family name
WCHAR*       familyList = NULL;
FontFamily*  pFontFamily = NULL;

InstalledFontCollection installedFontCollection;

// How many font families are installed?
count = installedFontCollection.GetFamilyCount();

// Allocate a buffer to hold the array of FontFamily
// objects returned by GetFamilies.
pFontFamily = new FontFamily[count];

// Get the array of FontFamily objects.
installedFontCollection.GetFamilies(count, pFontFamily, &found);

// The loop below creates a large string that is a comma-separated
// list of all font family names.
// Allocate a buffer large enough to hold that string.
familyList = new WCHAR[count*(sizeof(familyName)+ 3)];
StringCchCopy(familyList, 1, L"");

for(INT j = 0; j < count; ++j)
{
   pFontFamily[j].GetFamilyName(familyName);  
   StringCchCatW(familyList, count*(sizeof(familyName)+ 3), familyName);
   StringCchCatW(familyList, count*(sizeof(familyName)+ 3), L",  ");
}

// Draw the large string (list of all families) in a rectangle.
graphics.DrawString(
   familyList, -1, &font, rectF, NULL, &solidBrush);

delete [] pFontFamily;
delete [] familyList;
            

La figura seguente mostra un possibile output del codice precedente. Se si esegue il codice, l'output potrebbe essere diverso, a seconda dei tipi di carattere installati nel computer.