Метод ITextStoreACP::InsertTextAtSelection (texttor.h)

Статья
03/08/2023

Метод ITextStoreACP::InsertTextAtSelection вставляет текст в точку вставки или выделенного фрагмента. Вызывающий объект должен иметь блокировку для чтения и записи документа перед вставкой текста.

Синтаксис

HRESULT InsertTextAtSelection(
  [in]  DWORD         dwFlags,
  [in]  const WCHAR   *pchText,
  [in]  ULONG         cch,
  [out] LONG          *pacpStart,
  [out] LONG          *pacpEnd,
  [out] TS_TEXTCHANGE *pChange
);

Параметры

[in] dwFlags

Указывает, содержат ли параметры pacpStart и pacpEnd , а также структуру TS_TEXTCHANGE результаты вставки текста.

Не удается объединить флаги TF_IAS_NOQUERY и TF_IAS_QUERYONLY.

Значение	Значение
0	Будет выполняться вставка текста, а параметры pacpStart и pacpEnd будут содержать результаты вставки текста. Структура TS_TEXTCHANGE должна быть заполнена этим флагом.
TF_IAS_NOQUERY	Вставляется текст, значения параметров pacpStart и pacpEnd могут иметь значение NULL, а структура TS_TEXTCHANGE должна быть заполнена. Используйте этот флаг для просмотра результатов вставки текста.
TF_IAS_QUERYONLY	Текст не вставляется, а значения параметров pacpStart и pacpEnd содержат результаты вставки текста. Значения этих параметров зависят от того, как приложение реализует вставку текста в документ. Дополнительные сведения см. в разделе «Примечания». Используйте этот флаг для просмотра результатов вставки текста без фактической вставки текста. При использовании этого флага необязательно заполнять структуру TS_TEXTCHANGE .

[in] pchText

Указатель на строку для вставки в документ. Строка может быть завершена со значением NULL .

[in] cch

Задает длину текста.

[out] pacpStart

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

[out] pacpEnd

Указатель на конечную позицию символа приложения, в которой выполняется вставка текста. Это значение параметра совпадает со значением параметра pacpStart для точки вставки.

[out] pChange

Указатель на структуру TS_TEXTCHANGE со следующими элементами.

Значение	Значение
acpStart	Начальная позиция символа приложения перед вставленным текстом в документ.
acpOldEnd	Конечная позиция символа приложения перед вставкой текста в документ. Это значение совпадает с значением acpStart для точки вставки. Если это значение отличается от acpStart, текст был выделен до вставки текста.
acpNewEnd	Конечная позиция после вставки текста.

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

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

Значение	Описание
S_OK	Метод выполнен успешно.
TS_E_NOLOCK	Вызывающий объект не имеет блокировки документа.
E_INVALIDARG	Недопустимый параметр pchText .

Значения параметров pacpStart и pacpEnd зависят от того, как клиентское приложение вставляет текст в документ. Например, если приложение устанавливает курсор в начале вставленного текста после вставки текста, то значение параметров pacpStart и pacpEnd совпадает с элементом acpStartструктуры TS_TEXTCHANGE .

Приложения не должны вызывать метод ITextStoreACPSink::OnTextChange в ответ на этот метод.

Требования

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