Función GetCharABCWidthsA (wingdi.h)

Artículo
03/13/2024

La función GetCharABCWidths recupera los anchos, en unidades lógicas, de caracteres consecutivos en un intervalo especificado de la fuente TrueType actual. Esta función solo se realiza correctamente con fuentes TrueType.

Sintaxis

BOOL GetCharABCWidthsA(
  [in]  HDC   hdc,
  [in]  UINT  wFirst,
  [in]  UINT  wLast,
  [out] LPABC lpABC
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] wFirst

Primer carácter del grupo de caracteres consecutivos de la fuente actual.

[in] wLast

Último carácter del grupo de caracteres consecutivos de la fuente actual.

[out] lpABC

Puntero a una matriz de estructuras ABC que recibe los anchos de caracteres, en unidades lógicas. Esta matriz debe contener al menos tantas estructuras ABC como haya caracteres en el intervalo especificado por los parámetros uFirstChar y uLastChar .

Valor devuelto

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

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

Comentarios

El rasterizador TrueType proporciona espaciado de caracteres ABC después de seleccionar un tamaño de punto específico. Un espaciado es la distancia agregada a la posición actual antes de colocar el glifo. El espaciado B es el ancho de la parte negra del glifo. Espaciado de C es la distancia agregada a la posición actual para proporcionar espacio en blanco a la derecha del glifo. A+B+C especifica el ancho avanzado total.

Cuando la función GetCharABCWidths recupera anchos A o C negativos para un carácter, ese carácter incluye los voladizos o los voladizos.

Para convertir los anchos ABC en unidades de diseño de fuente, una aplicación debe usar el valor almacenado en el miembro otmEMSquare de una estructura OUTLINETEXTMETRIC . Este valor se puede recuperar llamando a la función GetOutlineTextMetrics .

Los anchos ABC del carácter predeterminado se usan para caracteres fuera del intervalo de la fuente seleccionada actualmente.

Para recuperar los anchos de caracteres en fuentes que no son TrueType, las aplicaciones deben usar la función GetCharWidth .

Nota

El encabezado wingdi.h define GetCharABCWidths 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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