Функция GetCharWidth

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

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

Синтаксис

BOOL GetCharWidth(
  HDC hdc,         // дескриптор DC
  UINT iFirstChar, // первый символ в диапазоне
  UINT iLastChar,  // последний символ в диапазоне
  LPINT lpBuffer   // буфер для ширины
);

Параметры

hdc

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

iFirstChar

[in] Устанавливает первый символ в группе последовательности символов.

iLastChar

[in] Устанавливает последний символ в группе последовательности символов, который не должен предшествовать заданному первому символу.

lpBuffer

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

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

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

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

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

Замечания

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

Диапазон является неделимым; то есть возвращаемые размеры включают ширину символов, заданных iFirstChar и параметрами iLastChar .

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

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

Смотри также

Обзор шрифты и текст, Функции, используемые шрифтами и текстом, GetCharABCWidths, GetCharABCWidthsFloat, GetCharWidth32, GetCharWidthFloat

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

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