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

Статья
08/26/2023

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

Синтаксис

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

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

[out] pacpStart

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

[out] pacpEnd

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

[out] pChange

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

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

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

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

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

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

Требования

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

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