Функция SetTextCharacterExtra (wingdi.h)
Функция SetTextCharacterExtra задает межсимвийный интервал. Интервалы между символами добавляются к каждому символу, включая символы разрыва, когда система записывает строку текста.
Синтаксис
int SetTextCharacterExtra(
[in] HDC hdc,
[in] int extra
);
Параметры
[in] hdc
Дескриптор контекста устройства.
[in] extra
Объем дополнительного пространства в логических единицах, добавляемых к каждому символу. Если текущий режим сопоставления не MM_TEXT, параметр nCharExtra преобразуется и округляется до ближайшего пикселя.
Возвращаемое значение
Если функция выполняется успешно, возвращаемым значением будет предыдущий интервал между символами.
Если функция завершается сбоем, возвращаемое значение 0x80000000.
Комментарии
Эта функция поддерживается в основном для обеспечения совместимости с существующими приложениями. Новые приложения, как правило, не должны вызывать эту функцию, так как она несовместима со сложными скриптами (скриптами, требующими формирования текста; Примером этого является арабское письмо).
Рекомендуемый подход заключается в том, что вместо вызова этой функции, а затем TextOut, приложения должны вызывать ExtTextOut и использовать его параметр lpDx для предоставления ширины.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |