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

Статья
08/26/2023

Вставляет текст в точку вставки или выделение.

Синтаксис

HRESULT InsertTextAtSelection(
  [in]  DWORD       dwFlags,
  [in]  const WCHAR *pchText,
  [in]  ULONG       cch,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

Параметры

[in] dwFlags

Указывает, будут ли параметры paStart и paEnd содержать результаты вставки текста.

Флаги TF_IAS_NOQUERY и TF_IAS_QUERYONLY нельзя объединить.

Значение	Значение
TF_IAS_NOQUERY	Текст вставляется, а значения параметров ppaStart и ppaEnd могут иметь значение NULL. Используйте этот флаг, если результаты вставки текста не требуются.
TF_IAS_QUERYONLY	Текст не вставляется, а привязки ppaStart и ppaEnd содержат результаты вставки текста. Значения этих параметров зависят от того, как приложение реализует вставку текста в документ. Используйте этот флаг для просмотра результатов вставки текста без фактической вставки текста. Текст нулевой длины можно вставить.

Значение

TF_IAS_NOQUERY

Текст вставляется, а значения параметров ppaStart и ppaEnd могут иметь значение NULL. Используйте этот флаг, если результаты вставки текста не требуются.

TF_IAS_QUERYONLY

Текст не вставляется, а привязки ppaStart и ppaEnd содержат результаты вставки текста. Значения этих параметров зависят от того, как приложение реализует вставку текста в документ. Используйте этот флаг для просмотра результатов вставки текста без фактической вставки текста. Текст нулевой длины можно вставить.

[in] pchText

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

[in] cch

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

[out] ppaStart

Указатель на объект привязки в начале вставки текста.

[out] ppaEnd

Указатель на объект привязки в конце вставки текста. Для точки вставки этот параметр будет совпадать со значением параметра ppaStart .

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

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

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

Требования


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

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

Композиции

ITextStoreAnchor

ITextStoreAnchorSink::OnTextChange

Константы TF_IAS_*

TS_TEXTCHANGE

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