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

Статья
08/27/2023

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

Синтаксис

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

Параметры

[in] hdc

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

[in] c

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

[out] lpName

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

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

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

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

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

Требования


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