Функция GetTextExtentPointI вычисляет ширину и высоту заданного массива индексов глифов.
Синтаксис
BOOL GetTextExtentPointI( HDC hdc, // дескриптор DC LPWORD pgiIn, // индексы глифов int cgi, // число индексов в массиве LPSIZE lpSize // размер строки ); |
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается с ошибкой, величина возвращаемого значения - ноль.
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 |
Нет |
Замечания по платформе |
Не имеется |