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

Статья
11/20/2024

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

Примечание Эта функция предоставляется только для совместимости с 16-разрядными версиями Windows. Приложения должны вызывать функцию GetCharWidth32, которая обеспечивает более точные результаты.

Синтаксис

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 iFirstChar и iLastChar.

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

Заметка

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

Требования

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