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

Статья
11/20/2024

Функция GetCharWidth32 извлекает ширину в логических координатах последовательных символов в указанном диапазоне от текущего шрифта.

Синтаксис

BOOL GetCharWidth32W(
  [in]  HDC   hdc,
  [in]  UINT  iFirst,
  [in]  UINT  iLast,
  [out] LPINT lpBuffer
);

Параметры

[in] hdc

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

[in] iFirst

Первый символ в группе последовательных символов.

[in] iLast

Последний символ в группе последовательных символов, который не должен предшествовать указанному первому символу.

[out] lpBuffer

Указатель на буфер, получающий ширину символов в логических координатах.

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

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

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

Замечания

GetCharWidth32 нельзя использовать в шрифтах TrueType. Чтобы получить ширину символов для шрифтов TrueType, используйте GetCharABCWidths.

Диапазон включаем; То есть возвращаемые ширины включают ширину символов, указанных параметрами iFirstChar iFirstChar и iLastChar.

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

Примеры

Пример см. в разделе "Отображение ввода клавиатуры" в с помощьюввода клавиатуры.

Заметка

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

Требования

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