Метод ITextServices::OnTxPropertyBitsChange (textserv.h)

Статья
08/26/2023

Задает свойства (представленные битами) для элемента управления .

Синтаксис

HRESULT OnTxPropertyBitsChange(
  [in] DWORD dwMask,
  [in] DWORD dwBits
);

Параметры

[in] dwMask

Тип: DWORD

Биты, представляющие изменяемые свойства. Возможные битовые значения см. в списке значений TXTBIT_* в dwBits.

[in] dwBits

Тип: DWORD

Новые значения для свойств битов. Это может быть любое сочетание следующего.

Значение	Значение
TXTBIT_ALLOWBEEP	Если задано значение TRUE, включен звуковой сигнал.
TXTBIT_AUTOWORDSEL	Если задано значение TRUE, функция autoWordSelect включена.
TXTBIT_BACKSTYLECHANGE	Если задано значение TRUE, то стиль возврата изменился. См. раздел TxGetBackStyle.
TXTBIT_CHARFORMATCHANGE	Если задано значение TRUE, формат символа изменился.
TXTBIT_CLIENTRECTCHANGE	Если задано значение TRUE, прямоугольник клиента изменился.
TXTBIT_DISABLEDRAG	Если задано значение TRUE, перетаскивание отключено.
TXTBIT_D2DDWRITE	Используйте Direct2D/DirectWrite для этого экземпляра, а не GDI/Uniscribe.
TXTBIT_D2DPIXELSNAPPED	Отрисовка глифов до ближайших позиций пикселей. Допустимо, только если задано D2DDWRITE.
TXTBIT_D2DSUBPIXELLINES	Рисуйте линии с точностью допиксели. Не привязывайте к пикселям текстовые линии, подчеркивание и зачеркивание в дополнительном направлении потока текста (обычно по вертикали). Допустимо только в том случае, если задано D2DDWRITE, а D2DPIXELSNAPPED не задано.
TXTBIT_D2DSIMPLETYPOGRAPHY	Отрисовка текста с помощью простой типографии (без отрисовки глифов). Это значение допустимо, только если также указано TXTBIT_D2DDWRITE.
TXTBIT_EXTENTCHANGE	Если задано значение TRUE, размер клиентского прямоугольника изменился.
TXTBIT_HIDESELECTION	Если задано значение TRUE, объект текстовых служб должен скрывать выделение, если элемент управления неактивен. Если значение FALSE, выделение должно отображаться, когда элемент управления неактивен. Обратите внимание, что это означает , TXTBIT_SAVESELECTION имеет значение TRUE.
TXTBIT_MAXLENGTHCHANGE	Если задано значение TRUE, максимальная длина текста в элементе управления изменилась.
TXTBIT_MULTILINE	Если задано значение TRUE, объект текстовых служб должен работать в многострочного режиме. Используйте значение TXTBIT_WORDWRAP , чтобы определить, следует ли переносить линии в прямоугольник представления или обрезать их. Если значение РАВНО FALSE, объект текстовых служб не должен обрабатывать возврат каретки или канал строки из клавиши ВВОД и должен усечь входящий текст, содержащий жесткие разрывы строк непосредственно перед первым разрывом строки. Кроме того, можно усечь текст, заданный с помощью ITextServices::TxSetText, так как узел не должен использовать однострочный элемент управления при привязке к многострочному полю.
TXTBIT_NOTHREADREFCOUNT	Не ссылайтесь на данные TLS от имени этого экземпляра.
TXTBIT_PARAFORMATCHANGE	Если задано значение TRUE, формат абзаца изменился.
TXTBIT_READONLY	Если задано значение TRUE, объект текстовых служб не должен принимать изменения в пользовательском интерфейсе. Однако он по-прежнему должен принимать программные изменения через EM_SETTEXTEX, EM_REPLACESEL и ITextServices::TxSetText. Кроме того, пользователь должен по-прежнему иметь возможность перемещать точку вставки, выделять текст и выполнять другие операции, которые не изменяют содержимое, например Копировать.
TXTBIT_RICHTEXT	Если задано значение TRUE, объект текстовых служб должен находиться в режиме форматированного текста. Если значение FALSE, оно находится в режиме обычного текста. Обратите внимание, что это влияет на применение команд редактирования. Например, применение полужирного шрифта к части текста в элементе управления с простым редактированием делает весь текст полужирным. Однако для элемента управления с расширенным редактированием это делает только выделенный текст полужирным.
TXTBIT_SAVESELECTION	Если задано значение TRUE, границы выделенного фрагмента должны сохраняться, когда элемент управления неактивен. Если значение FALSE, когда элемент управления снова активен, границы выделения могут быть сброшены на начало = 0, длина = 0.
TXTBIT_SCROLLBARCHANGE	Если задано значение TRUE, полоса прокрутки изменилась.
TXTBIT_SELBARCHANGE	Если задано значение TRUE, ширина панели выбора изменилась.
TXTBIT_SHOWACCELERATOR	Если задано значение , символ ускорителя должен быть подчеркнут. Это необходимо задать, чтобы вызвать TxGetAcceleratorPos.
TXTBIT_SHOWPASSWORD	Отображение строк паролей.
TXTBIT_USECURRENTBKG	Не поддерживается.
TXTBIT_USEPASSWORD	Если задано значение TRUE, текст отображается с помощью символа пароля, полученного TxGetPasswordChar. Уведомление для этого свойства может означать либо изменение символа пароля, либо то, что символ пароля не использовался ранее, но используется сейчас (или наоборот).
TXTBIT_VERTICAL	Не поддерживается.
TXTBIT_VIEWINSETCHANGE	Если задано значение TRUE, набор изменен.
TXTBIT_WORDWRAP	Если значение TRUE и TXTBIT_MULTILINE также имеет значение TRUE, многострочный элемент управления должен обернуть линию в прямоугольник представления. Если это свойство имеет значение FALSE , а TXTBIT_MULTILINE — TRUE, строки не должны быть заключены в оболочку, а обрезаются. Следует игнорировать правую часть прямоугольника представления. Если TXTBIT_MULTILINE имеет значение FALSE, это свойство не действует.

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

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет S_OK.

Если метод завершается сбоем, возвращается следующий код HRESULT . Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок в COM.

Код возврата	Описание
E_NOTIMPL	Не реализован.

Клиентский прямоугольник — это прямоугольник, за рисование и управление которым отвечает объект текстовых служб. Узел использует объект текстовых служб для рисования этой области. Объект текстовых служб не должен закрашивать или сделать недействительными области за пределами этого прямоугольника. Кроме того, узел перенаправит сообщения мыши в объект текстовых служб, когда курсор находится над этим прямоугольником. Этот прямоугольник выражается в клиентских координатах содержащего окна.

Набор представлений — это объем пространства на каждой стороне между клиентским прямоугольником и прямоугольником представления. Прямоугольник представления (также называемый прямоугольником форматирования) — это прямоугольник, в котором должен быть отформатирован текст. Дополнительные сведения см. в разделе TxGetViewInset.

Задний стиль — это стиль фона клиентского прямоугольника. Это может быть TXTBACK_TRANSPARENT или TXTBACK_SOLID. См. раздел TXTBACKSTYLE.

Свойство полосы прокрутки указывает на изменения полосы прокрутки: какая полоса прокрутки присутствует, скрыты ли полосы прокрутки или отключены, если прокрутка невозможна, а также включена ли автоматическая прокрутка, когда точка вставки выходит за рамки клиентского прямоугольника.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	textserv.h
DLL	Msftedit.dll