Функция GetTextFaceA (wingdi.h)
Функция 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.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение — это количество символов, скопированных в буфер.
Если функция выполняется неудачно, возвращается нулевое значение.
Комментарии
Имя шрифта копируется как строка символов, завершающаяся нулевым значением.
Если имя превышает число символов, указанное параметром nCount , имя усекается.
Примечание
Заголовок wingdi.h определяет GetTextFace в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |