Função GetCharWidthI (wingdi.h)

Artigo
08/27/2023

A função GetCharWidthI recupera as larguras, em coordenadas lógicas, de índices de glifo consecutivos em um intervalo especificado da fonte atual.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] giFirst

O primeiro índice de glifo no grupo de índices de glifo consecutivos.

[in] cgi

O número de índices de glifo.

[in] pgi

Um ponteiro para uma matriz de índices de glifo. Se esse parâmetro não for NULL, ele será usado em vez do parâmetro giFirst .

[out] piWidths

Um ponteiro para um buffer que recebe as larguras, em coordenadas lógicas.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

A função GetCharWidthI processará índices de glifo consecutivos se o parâmetro pgi for NULL com o parâmetro giFirst indicando o primeiro índice de glifo a ser processado e o parâmetro cgi indicando quantos índices de glifo processar. Caso contrário, a função GetCharWidthI processará a matriz de índices de glifo apontados pelo parâmetro pgi com o parâmetro cgi indicando quantos índices de glifo processar.

Se um caractere não existir na fonte atual, ele será atribuído à largura do caractere padrão.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll