Функция GetTextFaceW (wingdi.h)
Функция GetTextFace извлекает имя шрифта, выбранного в указанном контексте устройства.
Синтаксис
int GetTextFaceW(
[in] HDC hdc,
[in] int c,
[out] LPWSTR lpName
);
Параметры
[in] hdc
Дескриптор контекста устройства.
[in] c
Длина буфера, на который указывает lpFaceName. Для функции ANSI это число BYTE, а для функции Юникод — число СЛОВ. Обратите внимание, что для функции ANSI символы на кодовых страницах SBCS занимают по одному байту, в то время как большинство символов на кодовых страницах DBCS занимают два байта. Для функции Юникода наиболее определенные в настоящее время символы Юникода (в базовой многоязыковой плоскости (BMP)) — это один WORD, а суррогаты Юникода — два WORD.
[out] lpName
Указатель на буфер, получающий имя шрифта. Если этот параметр имеет значение NULL, функция возвращает количество символов в имени, включая завершающий символ NULL.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение — это количество символов, скопированных в буфер.
Если функция выполняется неудачно, возвращается нулевое значение.
Комментарии
Имя шрифта копируется в виде символьной строки с пустым завершением.
Если имя превышает число символов, указанное параметром nCount , оно усекается.
Примечание
Заголовок wingdi.h определяет GetTextFace в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |