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