Función GetTextMetricsW (wingdi.h)

Artículo
03/04/2024

La función GetTextMetrics rellena el búfer especificado con las métricas de la fuente seleccionada actualmente.

Sintaxis

BOOL GetTextMetricsW(
  [in]  HDC           hdc,
  [out] LPTEXTMETRICW lptm
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[out] lptm

Puntero a la estructura TEXTMETRIC que recibe las métricas de texto.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Para determinar si una fuente es una fuente TrueType, selecciónela primero en un controlador de dominio, luego llame a GetTextMetrics y, a continuación, busque TMPF_TRUETYPE en TEXTMETRIC.tmPitchAndFamily. Tenga en cuenta que GetDC devuelve un DC sin inicializar, que tiene "System" (una fuente de mapa de bits) como fuente predeterminada; por lo tanto, la necesidad de seleccionar una fuente en el controlador de dominio.

Ejemplos

Para obtener un ejemplo, vea "Mostrar entrada de teclado" en Usar la entrada del teclado o dibujar texto de fuentes diferentes en la misma línea.

Nota

El encabezado wingdi.h define GetTextMetrics 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

Requisito	Value
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