Функция SetTextCharacterExtra

Функция SetTextCharacterExtra устанавливает межсимвольный интервал. Межсимвольный интервал добавляется к каждому символу, включая в себя символы прерывания, когда система записывает строку текста.

Синтаксис

int SetTextCharacterExtra(
  HDC hdc,         // дескриптор DC
  int nCharExtra   // значение дополнительного пространства
);

Параметры

hdc

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

nCharExtra

[in] Устанавливает величину дополнительного пространства, в логических единицах измерения, которое добавляться к каждому символу. Если текущий режим отображения - не MM_TEXT, параметр nCharExtra преобразуется и округляется до ближайшего пикселя.

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

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

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

Windows NT/2000/XP: Чтобы получить дополнительные сведения об ошибке, вызовите GetLastError .

Смотри также

Обзор шрифты и текст, Функции, используемые шрифтами и текстом, DrawText, GetTextCharacterExtra, TextOut

Размещение и совместимость SetTextCharacterExtra
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Используемая библиотека	Gdi32.lib
Заголовочный файл
- объявлено в	Wingdi.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется