Función GetCharABCWidthsI (wingdi.h)

Artículo
08/27/2023

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

Sintaxis

BOOL GetCharABCWidthsI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPABC  pabc
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] giFirst

Primer índice de glifo del grupo de índices de glifos consecutivos de la fuente actual. Este parámetro solo se usa si el parámetro pgi es NULL.

[in] cgi

Número de índices de glifo.

[in] pgi

Puntero a una matriz que contiene índices de glifo. Si este parámetro es NULL, se usa el parámetro giFirst en su lugar. El parámetro cgi especifica el número de índices de glifo en esta matriz.

[out] pabc

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 índices de glifo especificados por el parámetro cgi .

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

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. El ancho avanzado total se especifica mediante A+B+C.

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

Para convertir los anchos ABC en unidades de diseño de fuentes, 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 los índices de glifo en fuentes que no son TrueType, las aplicaciones deben usar la función GetCharWidthI .

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