Функция GetTextExtentExPointI извлекает число символов в заданной строке, которая должна вместится внутри заданного пространства и заполняет массив протяженностей текста для каждого из этих символов. (Протяженность текста - это расстояние между началом пространства и символа, который должен быть вмещен в это пространство.) Эта информация полезна для вычислений перехода на новую строку.
Синтаксис
BOOL GetTextExtentExPointI( HDC hdc, // дескриптор DC LPWORD pgiIn, // массив индексов глифов int cgi, // число глифов в массиве int nMaxExtent, // максимальная ширина отформатированной строки LPINT lpnFit, // максимальное число символов LPINT alpDx, // массив отдельных ширин строк LPSIZE lpSize // размеры строки ); |
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается с ошибкой, величина возвращаемого значения - ноль.
Windows NT/2000/XP: Чтобы получит дополнительные информацию об ошибке, вызовите функцию GetLastError.
Если и параметр lpnFit и параметр lpnDx - значение ПУСТО (NULL), вызов функции GetTextExtentExPointI эквивалентен вызову функции GetTextExtentPointI.
При возвращении протяженности текста, эта функция предполагает, что текст горизонтален, то есть что наклон является всегда 0. Это истинно и для горизонтальных и для вертикальных измерений текста. Даже если используется шрифт, определяющий наклон отличный от нуля, эта функция не будет использовать угол при вычислении протяженности текста - приложение должно преобразовать его явно.
Обзор шрифты и текст, Функции, используемые шрифтами и текстом, GetTextExtentPoint, SIZE
Размещение и совместимость GetTextExtentExPointI |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Нет |
Windows Me |
Нет |
Windows 98 |
Нет |
Windows 95 |
Нет |
Используемая библиотека |
Gdi32.lib |
Заголовочный файл |
|
- объявлено в |
Wingdi.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |