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


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

Метод 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 содержат результаты вставки текста. Значения этих параметров зависят от того, как приложение реализует вставку текста в документ.

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

[in] pDataObject

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

[out] ppaStart

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

[out] ppaEnd

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

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

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

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

Комментарии

Клиенты должны использовать этот метод для вставки объекта в текстовый поток, так как константа TS_CHAR_EMBEDDED не может быть передана в ITextStoreAnchor::SetText.

Требования

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

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

Idataobject

ITextStoreAnchor

ITextStoreAnchor::QueryInsertEmbedded

ITextStoreAnchor::SetText

Константы TF_IAS_*

TS_CHAR_EMBEDDED