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

Статья
08/27/2023

Функция GetOutlineTextMetrics извлекает текстовые метрики для шрифтов TrueType.

Синтаксис

UINT GetOutlineTextMetricsA(
  [in]            HDC                  hdc,
  [in]            UINT                 cjCopy,
  [out, optional] LPOUTLINETEXTMETRICA potm
);

Параметры

[in] hdc

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

[in] cjCopy

Размер (в байтах) массива, получающего текстовые метрики.

[out, optional] potm

Указатель на структуру OUTLINETEXTMETRIC . Если этот параметр имеет значение NULL, функция возвращает размер буфера, необходимый для полученных данных метрик.

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

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

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

Структура OUTLINETEXTMETRIC содержит большую часть текстовой информации о метриках, предоставляемых для шрифтов TrueType (включая структуру TEXTMETRIC ). Размеры, возвращаемые в OUTLINETEXTMETRIC , находятся в логических единицах; они зависят от текущего режима сопоставления.

Примечание

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

Требования

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