Compartilhar via


Função GetKerningPairsA (wingdi.h)

A função GetKerningPairs recupera os pares de kerning de caracteres para a fonte selecionada no momento para o contexto do dispositivo especificado.

Sintaxe

DWORD GetKerningPairsA(
  [in]  HDC           hdc,
  [in]  DWORD         nPairs,
  [out] LPKERNINGPAIR lpKernPair
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] nPairs

O número de pares na matriz lpkrnpair . Se a fonte tiver mais de nNumPairs pares de kerning, a função retornará um erro.

[out] lpKernPair

Um ponteiro para uma matriz de estruturas KERNINGPAIR que recebe os pares de kerning. A matriz deve conter pelo menos quantas estruturas forem especificadas pelo parâmetro nNumPairs. Se esse parâmetro for NULL, a função retornará o número total de pares de kerning para a fonte.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será o número de pares de kerning retornados.

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

Observações

Nota

O cabeçalho wingdi.h define GetKerningPairs 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

Funções de fonte e texto

fontes e visão geral de texto

KERNINGPAIR