Функция GetCharWidthA (wingdi.h)
Функция GetCharWidth извлекает ширину в логических координатах последовательных символов в указанном диапазоне из текущего шрифта.
Синтаксис
BOOL GetCharWidthA(
[in] HDC hdc,
[in] UINT iFirst,
[in] UINT iLast,
[out] LPINT lpBuffer
);
Параметры
[in] hdc
Дескриптор контекста устройства.
[in] iFirst
Первый символ в группе последовательных символов.
[in] iLast
Последний символ в группе последовательных символов, который не должен предшествовать указанному первому символу.
[out] lpBuffer
Указатель на буфер, который получает ширину символов в логических координатах.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение.
Комментарии
GetCharWidth нельзя использовать для шрифтов TrueType. Чтобы получить ширину символов для шрифтов TrueType, используйте GetCharABCWidths.
Диапазон является инклюзивным; то есть возвращаемые ширины включают ширину символов, заданных параметрами iFirstChar и iLastChar .
Если символ не существует в текущем шрифте, ему назначается ширина символа по умолчанию.
Примечание
Заголовок wingdi.h определяет GetCharWidth как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |