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

Статья
08/27/2023

Функция GetTextMetrics заполняет указанный буфер метриками выбранного шрифта.

Синтаксис

BOOL GetTextMetricsA(
  [in]  HDC           hdc,
  [out] LPTEXTMETRICA lptm
);

Параметры

[in] hdc

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

[out] lptm

Указатель на структуру TEXTMETRIC , которая получает текстовые метрики.

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

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

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

Чтобы определить, является ли шрифт шрифтом TrueType, сначала выберите его в контроллере домена, затем вызовите Метод GetTextMetrics, а затем проверка для TMPF_TRUETYPE в TEXTMETRIC.tmPitchAndFamily. Обратите внимание, что GetDC возвращает неинициализированный контроллер домена, в котором в качестве шрифта по умолчанию используется "System" (точечный шрифт). таким образом, необходимость выбора шрифта в контроллере домена.

Примеры

Пример см. в разделе Отображение ввода с клавиатуры в разделе Использование ввода с клавиатуры или рисование текста из разных шрифтов в одной строке.

Примечание

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

Требования


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