Метод ITextStoreAnchorSink::OnTextChange (texttor.h)

Статья
08/26/2023

Вызывается при изменении текста в текстовом потоке.

Синтаксис

HRESULT OnTextChange(
  [in] DWORD   dwFlags,
  [in] IAnchor *paStart,
  [in] IAnchor *paEnd
);

Параметры

[in] dwFlags

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

Значение	Значение
0	Текст изменился.
TS_TC_CORRECTION	Текст представляет собой преобразование (исправление) существующего содержимого, и сохраняются любые специальные сведения о разметке текста (метаданные), такие как данные ФАЙЛА WAV или идентификатор языка. Этот флаг используется для приложений, которым необходимо сохранить данные, связанные с исходным текстом.

Значение

0

Текст изменился.

TS_TC_CORRECTION

Текст представляет собой преобразование (исправление) существующего содержимого, и сохраняются любые специальные сведения о разметке текста (метаданные), такие как данные ФАЙЛА WAV или идентификатор языка. Этот флаг используется для приложений, которым необходимо сохранить данные, связанные с исходным текстом.

[in] paStart

Указатель на привязку, расположенную в начале измененного текста.

[in] paEnd

Указатель на привязку, расположенную в конце измененного текста.

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

Этот метод может возвращать одно из этих значений.

Значение	Описание
S_OK	Метод выполнен успешно.
E_FAIL	Методу не удалось создать клонированные привязки для хранения изменений.
E_INVALIDARG	недопустимое значение paStart или paEnd .
E_OUTOFMEMORY	Произошел сбой выделения памяти.
TS_E_NOLOCK	Диспетчер TSF удерживает на документе блокировку. Обычно это указывает, что метод был вызван из другого метода ITextStoreAnchor , например ITextStoreAnchor::SetText.

Этот метод вызывается только в том случае, если приложение изменяет собственный текст, а не когда клиент изменяет текст с помощью одного из методов ITextStoreAnchor , например ITextStoreAnchor::SetText или ITextStoreAnchor::InsertTextAtSelection.

При вызове этого метода приложение должно иметь возможность предоставить блокировку документа.

Требования


Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	textstor.h
DLL	Msctf.dll
Распространяемые компоненты	TSF 1.0 в Windows 2000 Профессиональная