Функция GetKerningPairsA (wingdi.h)
Функция 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 |