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

Статья
03/13/2024

Метод ITextStoreAnchor::InsertEmbeddedAtSelection вставляет объект IDataObject в точку вставки или выделения. Клиент, вызывающий этот метод, должен иметь блокировку чтения и записи перед вставкой объекта IDataObject в текстовый поток.

Синтаксис

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD       dwFlags,
  [in]  IDataObject *pDataObject,
  [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] pDataObject

Указатель на вставляемый объект IDataObject .

[out] ppaStart

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

[out] ppaEnd

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

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

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

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

Требования

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