Función GetCharWidthI (wingdi.h)

Artículo
03/08/2023

La función GetCharWidthI recupera los anchos, en coordenadas lógicas, de índices de glifo consecutivos en un intervalo especificado de la fuente actual.

Sintaxis

BOOL GetCharWidthI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPINT  piWidths
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] giFirst

Primer índice de glifo en el grupo de índices de glifos consecutivos.

[in] cgi

Número de índices de glifo.

[in] pgi

Puntero a una matriz de índices de glifo. Si este parámetro no es NULL, se usa en lugar del parámetro giFirst .

[out] piWidths

Puntero a un búfer que recibe los anchos, en coordenadas lógicas.

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

La función GetCharWidthI procesa índices de glifo consecutivos si el parámetro pgi es NULL con el parámetro giFirst que indica el primer índice de glifo que se va a procesar y el parámetro cgi que indica cuántos índices de glifo se van a procesar. De lo contrario, la función GetCharWidthI procesa la matriz de índices de glifo señalados por el parámetro pgi con el parámetro cgi que indica cuántos índices de glifo se van a procesar.

Si un carácter no existe en la fuente actual, se le asigna el ancho del carácter predeterminado.

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