Función GetTextFaceA (wingdi.h)

Artículo
08/27/2023

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