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

  • Статья

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

Синтаксис

HRESULT InsertTextAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  const WCHAR  *pchText,
  [in]  LONG         cch,
  [out] ITfRange     **ppRange
);

Параметры

[in] ec

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

[in] dwFlags

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

Значение Значение
TF_IAS_NOQUERY
 ppRange имеет значение NULL. Этот флаг нельзя сочетать с флагом TF_IAS_QUERYONLY.
TF_IAS_QUERYONLY
 Контекст не изменяется, но параметр ppRange задается так, как если бы вставка была выполнена. Достаточно доступа только для чтения. Если этот флаг не установлен, ec должен иметь доступ на чтение и запись. Этот флаг нельзя сочетать с флагом TF_IAS_NOQUERY.
TF_IAS_NO_DEFAULT_COMPOSITION
 Руководитель не создаст композицию по умолчанию, если она требуется. Вызывающий объект должен создать объект композиции, который охватывает вставленный текст, прежде чем освобождать блокировку контекста.

[in] pchText

Указывает вставляемый текст.

[in] cch

Указывает количество символов текста в pchText.

[out] ppRange

Получает позицию вставленного объекта.

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

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

Значение Описание
S_OK
 Метод выполнен успешно.
TF_E_NOLOCK
 Служба текста не имеет блокировки документа
TF_E_DISCONNECTED
 Объект контекста не находится в стеке документов.
TS_E_NOSELECTION
 Контекст не имеет выбора.
TS_E_READONLY
 Выделение доступно только для чтения.

Комментарии

Чтобы вставить объект IDataObject вместо текста, используйте ITfInsertAtSelection::InsertEmbeddedAtSelection.

Требования

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

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

Idataobject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfInsertAtSelection

ITfInsertAtSelection::InsertEmbeddedAtSelection