Função GetKerningPairsA (wingdi.h)

  • Artigo

A função GetKerningPairs recupera os pares de kerning de caracteres para a fonte selecionada no momento para o contexto de 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 pares de kerning nNumPairs , 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 retornado

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.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de funçã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

Confira também

Funções de fonte e texto

Visão geral de fontes e texto

KERNINGPAIR