Функция GetKerningPairsA (wingdi.h)

Статья
08/27/2023

Функция GetKerningPairs извлекает пары символьного кернинга для выбранного в данный момент шрифта для указанного контекста устройства.

Синтаксис

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

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] nPairs

Количество пар в массиве lpkrnpair . Если шрифт содержит более пар кернинга nNumPairs , функция возвращает ошибку.

[out] lpKernPair

Указатель на массив структур KERNINGPAIR , который получает пары kerning. Массив должен содержать по крайней мере столько структур, сколько указано параметром nNumPairs . Если этот параметр имеет значение NULL, функция возвращает общее количество пар кернинга для шрифта.

Возвращаемое значение

Если функция выполнена успешно, возвращаемым значением будет количество пар kerning.

Если функция выполняется неудачно, возвращается нулевое значение.

Заголовок wingdi.h определяет GetKerningPairs как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll

См. также раздел

Функции шрифта и текста

Общие сведения о шрифтах и тексте

KERNINGPAIR

Поделиться через