Функция GetTextExtentPointI

Функция GetTextExtentPointI вычисляет ширину и высоту заданного массива индексов глифов.

Синтаксис

BOOL GetTextExtentPointI(
  HDC hdc,           // дескриптор DC
  LPWORD pgiIn,      // индексы глифов
  int cgi,           // число индексов в массиве
  LPSIZE lpSize      // размер строки
);

Параметры

hdc
[in] Дескриптор контекста устройства.
pgiIn
[in] Указатель на массив индексов глифов.
cgi
[in] Устанавливает число индексов глифов.
lpSize
[out] Указатель на структуру SIZE, которая принимает размеры строки, в логических единицах измерения.

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

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

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

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

Замечания

Функция GetTextExtentPointI использует текущий выбранный шрифт, чтобы вычислить размеры массива индексов глифов. Ширина и высота, в логических единицах измерения, вычисляются, не считая какое-либо отсечение.

При возвращении протяженности текста, эта функция предполагает, что текст горизонтален, то есть, что наклон является всегда 0. Это истинно и для горизонтальных и для вертикальных измерений текста. Даже если используется шрифт, определяющий наклон отличный от нуля, эта функция не будет использовать угол при вычислении  протяженности текста - приложение должно преобразовать его явно.

Поскольку некоторые символы несут в себе выносные элементы , сумма протяженностей отдельных индексов глифов может быть не равной общей длине массива индексов глифов в целом.

Расчетная ширина строки принимает во внимание межсимвольный интервал, установленный функцией SetTextCharacterExtra.

Смотри также

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

Размещение и совместимость GetTextExtentPointI

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Нет

Windows Me

Нет

Windows 98

Нет

Windows 95

Нет

Используемая библиотека

Gdi32.lib

Заголовочный файл

 

- объявлено в

Wingdi.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz