Metodo FontFamily::GetFamilyName (gdiplusheaders.h)

Il metodo FontFamily::GetFamilyName ottiene il nome di questa famiglia di caratteri.

Sintassi

Status GetFamilyName(
  [out] LPWSTR name,
  [in]  LANGID language
);

Parametri

[out] name

Tipo: WCHAR[LF_FACESIZE]

Nome della famiglia di caratteri.

[in] language

Tipo: WCHAR

Facoltativa. Valore a sedici bit che specifica la lingua da usare. Il valore predefinito è LANG_NEUTRAL, ovvero la lingua predefinita dell'utente.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Quando si specifica LANG_NEUTRAL come ID lingua, è pratica comune passare solo LANG_NEUTRAL come nell'esempio seguente:

stat = FontFamily.GetFamilyName(name, LANG_NEUTRAL);

Se si specifica una lingua diversa da LANG_NEUTRAL, usare MAKELANGID per creare la combinazione di lingua e sottolanguage come nell'esempio seguente:

LANGID language = MAKELANGID(LANG_CHINESE, SUBLANG_CHINESE_TRADITIONAL);

Per un elenco delle lingue e delle sottolanguages disponibili, vedi Winnt.h.

Esempio

L'esempio seguente crea un oggetto FontFamily , ottiene il nome della famiglia e restituisce il nome come testo.

VOID Example_GetFamilyName(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a FontFamily object.
   FontFamily nameFontFamily(L"arial");
   
   // Get the cell ascent of the font family in design units.
   WCHAR      familyName[LF_FACESIZE];
   nameFontFamily.GetFamilyName(familyName);

   // Copy the cell ascent into a string and draw the string.
   SolidBrush solidbrush(Color(255, 0, 0, 0));
   Font       font(&nameFontFamily, 16);
   graphics.DrawString(familyName, -1, &font, PointF(0, 0), &solidbrush);
}

Requisiti

Vedi anche

Costruzione di famiglie di caratteri e tipi di carattere

Enumerazione dei tipi di carattere installati

FontFamily