Функция GetCharABCWidths

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

Синтаксис

BOOL GetCharABCWidths(
  HDC hdc,         // дескриптор DC
  UINT uFirstChar, // первый символ на одной линии
  UINT uLastChar,  // последний символ на одной линии
  LPABC lpabc      // ширина массива символов
);

Параметр

hdc

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

uFirstChar
[in] Устанавливает первый символ в группе последовательности символов текущего шрифта.
uLastChar
[in] Устанавливает последний символ в группе последовательности символов текущего шрифта.
lpabc
[out] Указатель на массив структур ABC, которые получают ширины символа, в логических единицах измерения. Этот массив должен содержать по крайней мере столько же структур ABC сколько есть символов в ряде, заданном параметрами uFirstChar и uLastChar.

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

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

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

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите функцию GetLastError.

Замечания

Растеризация шрифта формата TrueType предусматривает ABC интервал между знаками после того, как был выбран конкретный кегль шрифта в пунктах . А- пробел - это расстояние, добавляемое к текущей позиции перед размещением глифа. B- пробел - это ширина прорисованной части глифа. C- пробел - это расстояние, прибавляемое к текущей позиции, представляющее незаполненное пространство справа от глифа. Общая ширина, занимаемая знаком определяется как A+B+C.

Когда функция GetCharABCWidths извлекает отрицательную А или C ширину символа, значит этот символ включает в себя нависшие элементы или выступы.

Чтобы преобразовывать ширину ABC в расчетные единицы измерения шрифта, приложение должно использовать значение, сохраненное в члене otmEMSquare структуры OUTLINETEXTMETRIC. Это значение может быть извлечено при помощи вызова функции GetOutlineTextMetrics.

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

Чтобы извлечь ширину символов в не TrueType шрифтах, прикладные программы должны использовать функцию GetCharWidth.

Windows 95/98/Me: GetCharABCWidthsW поддерживается подпрограммой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в требованиях этой подпрограммы для систем Windows 95/98/Me.

Смотри также

Обзор шрифты и текст, Функции, используемые шрифтами и текстом, GetCharWidth, GetOutlineTextMetrics, OUTLINETEXTMETRIC, ABC

Размещение и совместимость GetCharABCWidths

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Gdi32.lib

Заголовочный файл

 

- объявлено в

Wingdi.h

- включено в

Windows.h

Unicode

Реализуется как версии Unicode и  ANSI в Windows NT /2000/XP.

Поддерживается также подпрограммой Microsoft Layer for Unicode

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz