Функция 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

Нет

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

Не имеется

 

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

Hosted by uCoz