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

Статья
11/20/2024

Функция 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

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