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

Статья
08/24/2023

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

Синтаксис

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	Выделение доступно только для чтения.

Требования

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