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

  • Статья

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

Синтаксис

BOOL GetCharWidth32A(
  [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 и iLastChar .

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

Примеры

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

Примечание

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

Требования

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

См. также раздел

Функции шрифта и текста

Общие сведения о шрифтах и тексте

GetCharABCWidths

GetCharABCWidthsFloat

GetCharWidthFloat