Função GetCharABCWidthsA (wingdi.h)

Artigo
11/20/2024

A função GetCharABCWidths recupera as larguras, em unidades lógicas, de caracteres consecutivos em um intervalo especificado da fonte TrueType atual. Essa função é bem-sucedida somente com fontes TrueType.

Sintaxe

BOOL GetCharABCWidthsA(
  [in]  HDC   hdc,
  [in]  UINT  wFirst,
  [in]  UINT  wLast,
  [out] LPABC lpABC
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] wFirst

O primeiro caractere no grupo de caracteres consecutivos da fonte atual.

[in] wLast

O último caractere no grupo de caracteres consecutivos da fonte atual.

[out] lpABC

Um ponteiro para uma matriz de estruturas de ABC que recebe as larguras de caractere, em unidades lógicas. Essa matriz deve conter pelo menos quantas estruturas de ABC , pois há caracteres no intervalo especificado pelos parâmetros uFirstChar e uLastChar.

Valor de retorno

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

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

Observações

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 GetCharABCWidths recupera larguras A ou C negativas para um caractere, esse caractere inclui subexessões ou saliências.

Para converter as larguras abc em unidades de design de fonte, um aplicativo deve usar o valor armazenado no otmEMSquare membro de uma estrutura de 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 caracteres em fontes não TrueType, os aplicativos devem usar a função GetCharWidth.

Nota

O cabeçalho wingdi.h define GetCharABCWidths como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wingdi.h (inclua Windows.h)
biblioteca	Gdi32.lib
de DLL	Gdi32.dll

Consulte também

ABC

Funções de fonte e texto

fontes e visão geral de texto

GetCharWidth

GetOutlineTextMetrics

OUTLINETEXTMETRIC

Compartilhar via