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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] hdc

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

[in] nPairs

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

[out] lpKernPair

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

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

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

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

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll

См. также

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

шрифтов и текста

KERNINGPAIR

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