Función GetCharABCWidthsA (wingdi.h)

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 , ya que hay caracteres en el intervalo especificado por los parámetros de uFirstChar y uLastChar.

Valor devuelto

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

Si se produce un error en la función, el valor devuelto es cero.

Observaciones

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. El 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 total avanzado.

Cuando la función GetCharABCWidths de 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 fuentes, una aplicación debe usar el valor almacenado en el otmEMSquare miembro 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 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wingdi.h (incluya Windows.h)
biblioteca de	Gdi32.lib
DLL de	Gdi32.dll

Consulte también

ABC

funciones de fuente y texto de

de información general de fuentes y texto de

GetCharWidth

GetOutlineTextMetrics

OUTLINETEXTMETRIC