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

Статья
11/20/2024

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

Синтаксис

int GetTextFaceA(
  [in]  HDC   hdc,
  [in]  int   c,
  [out] LPSTR lpName
);

Параметры

[in] hdc

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

[in] c

Длина буфера, на которую указывает lpFaceName. Для функции ANSI это число BYTE, а для функции Юникода это число WORD. Обратите внимание, что для функции ANSI символы на кодовых страницах SBCS принимают один байт, а большинство символов в кодовых страницах DBCS занимают два байта; Для функции Юникода в настоящее время наиболее определенные символы Юникода (те, которые находятся в базовой многоязычной плоскости (BMP)) являются одним СЛОВОм, а суррогаты Юникода являются двумя WORD.

[out] lpName

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

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

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

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

Замечания

Имя шрифта копируется в виде строки символов, завершаемой значением NULL.

Если имя больше числа символов, указанных параметром nCount, имя усечено.

Заметка

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

Требования

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