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

Статья
08/27/2023

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

Синтаксис

BOOL GetCharWidthI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPINT  piWidths
);

Параметры

[in] hdc

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

[in] giFirst

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

[in] cgi

Число индексов глифов.

[in] pgi

Указатель на массив индексов глифов. Если этот параметр не имеет значение NULL, он используется вместо параметра giFirst .

[out] piWidths

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

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

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

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

Функция GetCharWidthI обрабатывает последовательные индексы глифов, если параметр pgi имеет значение NULL , а параметр giFirst указывает первый индекс глифа для обработки и параметр cgi , указывающий, сколько индексов глифов необходимо обработать. В противном случае функция GetCharWidthI обрабатывает массив индексов глифов, на которые указывает параметр pgi , с параметром cgi , указывающим, сколько индексов глифа необходимо обработать.

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

Требования


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