Поделиться через

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

  • Статья

Метод 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

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

Композиции

ITextStoreACP

ITextStoreACPSink::OnTextChange

Константы TF_IAS_*

TS_TEXTCHANGE