Compartilhar via


Função GetCharABCWidthsI (wingdi.h)

A função GetCharABCWidthsI recupera as larguras, em unidades lógicas, de índices de glifo consecutivos em um intervalo especificado da fonte TrueType atual. Essa função só tem êxito com fontes TrueType.

Sintaxe

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

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 da fonte atual. Esse parâmetro só será usado se o parâmetro pgi for NULL.

[in] cgi

O número de índices de glifo.

[in] pgi

Um ponteiro para uma matriz que contém índices de glifo. Se esse parâmetro for NULL, o parâmetro giFirst será usado. O parâmetro cgi especifica o número de índices de glifo nessa matriz.

[out] pabc

Um ponteiro para uma matriz de estruturas ABC que recebe as larguras de caractere, em unidades lógicas. Essa matriz deve conter pelo menos quantas estruturas ABC houver índices de glifo especificados pelo parâmetro cgi .

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

O rasterizador TrueType fornece espaçamento de caracteres ABC depois que um tamanho de ponto específico foi selecionado. Um espaçamento é a distância adicionada à posição atual antes de colocar o glifo. O espaçamento B é a largura da parte preta do glifo. Espaçamento C é a distância adicionada à posição atual para fornecer espaço em branco à direita do glifo. A largura avançada total é especificada por A+B+C.

Quando a função GetCharABCWidthsI recupera larguras negativas de A ou C para um caractere, esse caractere inclui pendências ou saliências.

Para converter as larguras abc em unidades de design de fonte, um aplicativo deve usar o valor armazenado no membro otmEMSquare de uma estrutura OUTLINETEXTMETRIC . Esse valor pode ser recuperado chamando a função GetOutlineTextMetrics .

As larguras ABC do caractere padrão são usadas para caracteres fora do intervalo da fonte selecionada no momento.

Para recuperar as larguras dos índices de glifo em fontes não TrueType, os aplicativos devem usar a função GetCharWidthI .

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

Confira também

ABC

Funções de fonte e texto

Visão geral de fontes e texto

GetCharWidth

GetOutlineTextMetrics

OUTLINETEXTMETRIC