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

Статья
11/20/2024

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

Синтаксис

BOOL GetCharABCWidthsFloatA(
  [in]  HDC        hdc,
  [in]  UINT       iFirst,
  [in]  UINT       iLast,
  [out] LPABCFLOAT lpABC
);

Параметры

[in] hdc

Обработка контекста устройства.

[in] iFirst

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

[in] iLast

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

[out] lpABC

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

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

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

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

Замечания

В отличие от функции getCharABCWidths, которая возвращает ширину только для шрифтов TrueType , функция getCharABCWidthsFlo at получает ширину для любого шрифта. Ширины, возвращаемые этой функцией, находятся в формате с плавающей запятой IEEE.

Если текущее преобразование "мир — устройство" не определено, возвращаемые ширины могут быть не целыми значениями, даже если соответствующие значения в пространстве устройства являются целыми числами.

Интервал — это расстояние, добавленное к текущей позиции перед размещением глифа. Интервал B — это ширина черной части глифа. Интервал C — это расстояние, добавленное к текущей позиции, чтобы обеспечить пробел справа от глифа. Общая расширенная ширина определяется A+B+C.

Пространства ABC измеряются вдоль базовой строки символа выбранного шрифта.

Ширины ABC символа по умолчанию используются для символов за пределами диапазона выбранного в данный момент шрифта.

Заметка

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

Требования

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