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

Статья
11/20/2024

Функция 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll

См. также

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

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

GetTextMetrics

OUTLINETEXTMETRIC

TEXTMETRIC

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