Función GetTextFaceA (wingdi.h)
La función GetTextFace recupera el nombre del tipo de letra de la fuente seleccionada en el contexto de dispositivo especificado.
Sintaxis
int GetTextFaceA(
[in] HDC hdc,
[in] int c,
[out] LPSTR lpName
);
Parámetros
[in] hdc
Identificador del contexto del dispositivo.
[in] c
Longitud del búfer al que apunta lpFaceName. Para la función ANSI, es un recuento de BYTES y para la función Unicode es un recuento de WORD. Tenga en cuenta que, para la función ANSI, los caracteres de las páginas de códigos SBCS toman un byte cada uno, mientras que la mayoría de los caracteres de las páginas de códigos DBCS toman dos bytes; para la función Unicode, la mayoría de los caracteres Unicode definidos actualmente (los del plano multilingüe básico (BMP)) son una PALABRA mientras que los suplentes Unicode son dos WORD.
[out] lpName
Puntero al búfer que recibe el nombre del tipo de letra. Si este parámetro es NULL, la función devuelve el número de caracteres del nombre, incluido el carácter nulo de terminación.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es el número de caracteres copiados en el búfer.
Si la función no se realiza correctamente, el valor devuelto es cero.
Comentarios
El nombre de la letra de letra se copia como una cadena de caracteres terminada en NULL.
Si el nombre es mayor que el número de caracteres especificado por el parámetro nCount , el nombre se trunca.
Nota
El encabezado wingdi.h define GetTextFace como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wingdi.h (incluye Windows.h) |
| Library | Gdi32.lib |
| Archivo DLL | Gdi32.dll |