Функция GetTextExtentPointA (wingdi.h)

Статья
11/20/2024

Функция GetTextExtentPoint вычисляет ширину и высоту указанной строки текста.

Примечание Эта функция предоставляется только для совместимости с 16-разрядными версиями Windows. Приложения должны вызывать функцию GetTextExtentPoint32, которая обеспечивает более точные результаты.

Синтаксис

BOOL GetTextExtentPointA(
  [in]  HDC    hdc,
  [in]  LPCSTR lpString,
  [in]  int    c,
  [out] LPSIZE lpsz
);

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] lpString

Указатель на строку, указывающую текст. Строка не должна быть завершена нулевой, так как cbString указывает длину строки.

[in] c

Длина строки, на которую указывает lpString.

[out] lpsz

Указатель на структуру SIZE, которая получает измерения строки в логических единицах.

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

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

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

Замечания

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

Так как некоторые устройства керн символов, сумма экстентов символов в строке может не совпадать с степенью строки.

Вычисляемая ширина строки учитывает интервалы между диаграммами, заданные функцией SetTextCharacterExtra.

Заметка

Заголовок wingdi.h определяет GetTextExtentPoint как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll

См. также

функции шрифта и текста

шрифтов и текста

GetTextExtentPoint32

SIZE

SetTextCharacterExtra

Поделиться через