Функция 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 |
|
Замечания по платформе |
Не имеется |