Метод ITfInsertAtSelection::InsertEmbeddedAtSelection (msctf.h)

Статья
08/24/2023

Метод ITfInsertAtSelection::InsertEmbeddedAtSelection вставляет объект IDataObject в точку выделения или вставки.

Синтаксис

HRESULT InsertEmbeddedAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  IDataObject  *pDataObject,
  [out] ITfRange     **ppRange
);

Параметры

[in] ec

Определяет контекст редактирования. Он получен из ITfDocumentMgr::CreateContext или ITfEditSession::D oEditSession.

[in] dwFlags

Битовое поле с одним из следующих значений:

TF_IAS_NOQUERY

Параметр ppRange имеет значение NULL при выходе.

TF_IAS_QUERYONLY

Контекст не изменяется, но параметр ppRange задается так, как если бы произошла вставка. Достаточно доступа только для чтения. Если этот флаг не задан, параметр ec должен иметь доступ на чтение и запись.

TF_IAS_NO_DEFAULT_COMPOSITION

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

[in] pDataObject

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

[out] ppRange

Положение вставленного объекта. Необязательный элемент.

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

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

Значение	Описание
S_OK	Метод выполнен успешно.
TF_E_NOLOCK	Параметр ec является недопустимым файлом cookie редактирования.
TF_E_DISCONNECTED	Объект контекста не находится в стеке документов.
TS_E_NOSELECTION	Контекст не имеет выбора.
TS_E_READONLY	Выделение доступно только для чтения.
TF_E_FORMAT	Владелец контекста не может обрабатывать объекты типа, предоставленного параметром pDataObject .

Требования


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