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

Статья
03/04/2024

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

Синтаксис

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

Параметры

[in] hdc

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

[in] nPairs

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

[out] lpKernPair

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

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

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

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

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

Требования

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

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

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

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

KERNINGPAIR

Share via