Функция GetKerningPairs

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

Синтаксис

DWORD GetKerningPairs(
  HDC hdc,                 // дескриптор DC
  DWORD nNumPairs,         // число пар для кернинга
  LPKERNINGPAIR lpkrnpair  // массив пар кернинга
);

Параметры

hdc

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

nNumPairs

[in] Устанавливает число пар в массиве lpkrnpair. Если шрифт имеет больше пары кернинга, чем nNumPairs , функция возвращает значение ошибки.

lpkrnpair

[out] Указатель на массив структур KERNINGPAIR, который получает пары кернинга. Массив должен содержать по крайней мере столько же структур, как это установлено параметром nNumPairs . Если этот параметр имеет значение ПУСТО (NULL), функция возвращает общее количество пар кернинга шрифта.

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

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

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

Windows NT/2000/XP: Чтобы получить дополнительные сведения об ошибке, вызовите функцию GetLastError.

Замечания

Windows 95/98/Me: GetKerningPairsW поддерживается подпрограммой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в требованиях этой подпрограммы для систем Windows 95/98/Me.

Смотри также

Обзор шрифты и текст, Функции, используемые шрифтами и текстом, KERNINGPAIR

Размещение и совместимость GetKerningPairs
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Используемая библиотека	Gdi32.lib
Заголовочный файл
- объявлено в	Wingdi.h
- включено в	Windows.h
Unicode	Реализуется как версии Unicode и ANSI в Windows NT /2000/XP. Поддерживается также подпрограммой Microsoft Layer for Unicode
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки