Método FontFamily::GetFamilyName (gdiplusheaders.h)

O método FontFamily::GetFamilyName obtém o nome dessa família de fontes.

Sintaxe

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

Parâmetros

[out] name

Tipo: WCHAR[LF_FACESIZE]

Nome dessa família de fontes.

[in] language

Tipo: WCHAR

Opcional. Valor de dezesseis bits que especifica o idioma a ser usado. O valor padrão é LANG_NEUTRAL, que é o idioma padrão do usuário.

Valor retornado

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

Ao especificar LANG_NEUTRAL como a ID do idioma, é comum passar apenas LANG_NEUTRAL como no exemplo a seguir:

stat = FontFamily.GetFamilyName(name, LANG_NEUTRAL);

Se você estiver especificando um idioma diferente de LANG_NEUTRAL, use MAKELANGID para criar a combinação de linguagem e sublanguagem como no exemplo a seguir:

LANGID language = MAKELANGID(LANG_CHINESE, SUBLANG_CHINESE_TRADITIONAL);

Para obter uma listagem dos idiomas e sublanguages disponíveis, consulte Winnt.h.

Exemplos

O exemplo a seguir cria um objeto FontFamily , obtém o nome da família e gera o nome como texto.

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

Requisitos

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

Confira também

Construindo fontes e famílias de fontes

Enumeração de fontes instaladas

FontFamily