сообщение EM_SETTABSTOPS

Сообщение EM_SETTABSTOPS задает остановки табуляции в многостроковом элементе управления редактированием. При копировании текста в элемент управления любой символ табуляции в тексте создает пробел до следующей позиции табуляции.

Это сообщение обрабатывается только с помощью многостроковых элементов управления редактированием. Это сообщение можно отправить либо в элемент управления редактированием, либо в элемент управления с расширенными возможностями редактирования.

Параметры

wParam

Количество остановок табуляции, содержащихся в массиве. Если этот параметр равен нулю, параметр lParam игнорируется, а значения табуляции по умолчанию устанавливаются на каждые 32 единицы шаблонов диалоговых окон. Если этот параметр равен 1, позиции табуляции задаются на каждой n единице шаблона диалогового окна, где n — это расстояние, указываемое параметром lParam . Если этот параметр больше 1, lParam является указателем на массив табуляции.

lParam

Указатель на массив целых чисел без знака, указывающих позиции табуляции в единицах шаблонов диалоговых окон. Если параметр wParam равен 1, этот параметр является указателем на целое число без знака, содержащее расстояние между всеми точками табуляции в единицах шаблонов диалоговых окон.

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

Если заданы все вкладки, возвращается значение TRUE.

Если все вкладки не заданы, возвращается значение FALSE.

Комментарии

Сообщение EM_SETTABSTOPS не перерисовывает окно управления редактированием автоматически. Если приложение изменяет позиции табуляции для текста, уже имеющегося в элементе управления редактированием, оно должно вызвать функцию InvalidateRect для перерисовки окна элемента управления редактированием.

Значения, указанные в массиве, находятся в единицах шаблонов диалогов, которые являются независимыми от устройств единицами, используемыми в шаблонах диалоговых окон. Чтобы преобразовать измерения из единиц шаблона диалогового окна в единицы экрана (пиксели), используйте функцию MapDialogRect .

Расширенное редактирование: Поддерживается в Microsoft Rich Edit 3.0 и более поздних версиях. Полнофункционированный элемент управления редактированием может иметь максимальное количество остановок табуляции, указанное MAX_TAB_STOPS. Сведения о совместимости версий полнофункционированного редактирования с различными версиями системы см. в разделе Сведения об элементах управления расширенным редактированием.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Заголовок	Winuser.h (включая Windows.h)

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

Другие ресурсы

InvalidateRect

MapDialogRect