FontFamily::GetFamilyName, méthode (gdiplusheaders.h)

La méthode FontFamily::GetFamilyName obtient le nom de cette famille de polices.

Syntaxe

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

Paramètres

[out] name

Type : WCHAR[LF_FACESIZE]

Nom de cette famille de polices.

[in] language

Type : WCHAR

Optionnel. Valeur seize bits qui spécifie la langue à utiliser. La valeur par défaut est LANG_NEUTRAL, qui est la langue par défaut de l’utilisateur.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Notes

Lorsque vous spécifiez LANG_NEUTRAL comme ID de langue, il est courant de passer simplement LANG_NEUTRAL comme dans l’exemple suivant :

stat = FontFamily.GetFamilyName(name, LANG_NEUTRAL);

Si vous spécifiez une langue autre que LANG_NEUTRAL, utilisez MAKELANGID pour créer la combinaison langue et sous-langue, comme dans l’exemple suivant :

LANGID language = MAKELANGID(LANG_CHINESE, SUBLANG_CHINESE_TRADITIONAL);

Pour obtenir la liste des langues et sous-langues disponibles, consultez Winnt.h.

Exemples

L’exemple suivant crée un objet FontFamily , obtient le nom de la famille et génère le nom sous forme de texte.

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

Configuration requise

Voir aussi

Construction de familles et de polices de polices

Énumération des polices installées

FontFamily