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

Статья
03/08/2023

Функция 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. Это относится как к горизонтальным, так и к вертикальным измерениям текста. Даже если используется шрифт, указывающий ненулевой escapement, эта функция не будет использовать угол при вычислении экстента текста. Приложение должно преобразовать его явным образом.

Так как на некоторых устройствах есть символы kern, сумма экстентов символов в строке может быть не равна экстенту строки.

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

Примечание

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

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll