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

El método FontFamily::GetFamilyName obtiene el nombre de esta familia de fuentes.

Sintaxis

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

Parámetros

[out] name

Tipo: WCHAR[LF_FACESIZE]

Nombre de esta familia de fuentes.

[in] language

Tipo: WCHAR

Opcional. Valor de dieciséis bits que especifica el idioma que se va a usar. El valor predeterminado es LANG_NEUTRAL, que es el idioma predeterminado del usuario.

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Al especificar LANG_NEUTRAL como identificador de idioma, es habitual pasar solo LANG_NEUTRAL como en el ejemplo siguiente:

stat = FontFamily.GetFamilyName(name, LANG_NEUTRAL);

Si va a especificar un idioma distinto de LANG_NEUTRAL, use MAKELANGID para crear la combinación de idioma y sublanguaje como en el ejemplo siguiente:

LANGID language = MAKELANGID(LANG_CHINESE, SUBLANG_CHINESE_TRADITIONAL);

Para obtener una lista de los idiomas y sublanguajes disponibles, consulta Winnt.h.

Ejemplos

En el ejemplo siguiente se crea un objeto FontFamily , se obtiene el nombre de familia y se genera el nombre 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 compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusheaders.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll

Consulte también

Construcción de familias de fuentes y fuentes

Enumeración de fuentes instaladas

FontFamily