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

  • Статья
  • Чтение занимает 4 мин

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

Синтаксис

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

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

Основные понятия

ITextServices

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

RECT

Справочные материалы

TxGetAcceleratorPos

TxGetBackStyle

TxGetClientRect

TxGetPasswordChar

TxSetText

Элементы управления "Полнофункциональные изменения" без окон