Функция 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

См. также раздел

Drawtext

Функции шрифта и текста

Общие сведения о шрифтах и тексте

GetTextCharacterExtra

TextOut