Функция GetTextExtentExPointI

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

Синтаксис

BOOL GetTextExtentExPointI(
  HDC hdc,         // дескриптор DC
  LPWORD pgiIn,    // массив индексов глифов
  int cgi,         // число глифов в массиве
  int nMaxExtent,  // максимальная ширина отформатированной строки
  LPINT lpnFit,    // максимальное число символов
  LPINT alpDx,     // массив отдельных ширин строк
  LPSIZE lpSize    // размеры строки
);

Параметры

hdc

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

pgiIn

[in] Указатель на массив индексов глифа, для которых должны быть возвращены протяженности.

cgi

[in] Устанавливает число глифов в массиве, указанном параметром pgiIn .

nMaxExtent

[in] Устанавливает максимальную допустимую ширину, в логических единицах измерения, отформатированной строки.

lpnFit

[out] Указатель на целое число, принимающее подсчет максимального числа символов, которые должны быть помещены в пространство, заданное параметром nMaxExtent. Когда параметр lpnFit - ПУСТО (NULL), параметр nMaxExtent игнорируется.

alpDx

[out] Указатель на массив целых чисел, который принимает частичные протяженности глифов. Каждый элемент в массиве дает расстояние, в логических единицах измерения, между началом массива индексов глифов и одного из глифов, который помещается в пространстве, заданном параметром nMaxExtent . Этот массив должен иметь, по крайней мере, столько же элементов, что и количество индексов глифов, заданных параметром cgi , потому что внутри используется весь массив. Функция заполняет, массив допустимыми протяженностями для стольких же индексов глифов, сколько их задается параметром lpnFit. Если lpnDx имеет значение ПУСТО (NULL), функция не вычисляет частичные размеры строк.

lpSize

[out] Указатель на структуру SIZE, которая принимает размеры массива индексов глифов, в логических единицах измерения. Этот параметр не может быть ПУСТО (NULL).

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

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

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

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	Нет
Замечания по платформе	Не имеется

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

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

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