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

Метод ITextStoreAnchor::QueryInsert определяет, допустимы ли указанные начальные и конечные привязки. Используйте этот метод для изменения документа перед его выполнением. Метод не должен возвращать значения за пределами диапазона документа.

Синтаксис

HRESULT QueryInsert(
  [in]  IAnchor *paTestStart,
  [in]  IAnchor *paTestEnd,
  [in]  ULONG   cch,
  [out] IAnchor **ppaResultStart,
  [out] IAnchor **ppaResultEnd
);

Параметры

[in] paTestStart

Получает указатель на начальную привязку для вставленного текста.

[in] paTestEnd

Получает указатель на конце привязки для вставленного текста. Это аналогично paTestStart , если текст вставляется в точке вместо замены выделенного текста.

[in] cch

Длина замещающего текста.

[out] ppaResultStart

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

[out] ppaResultEnd

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

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

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

Значение	Описание
S_OK	Метод выполнен успешно.
E_FAIL	Произошла неизвестная ошибка.
E_INVALIDARG	Недопустимые параметры paTestStart или paTestEnd .
E_OUTOFMEMORY	Попытка создать экземпляр привязок ppaResultStart и (или) ppaResultEnd завершилась сбоем.

Комментарии

Значения ppaResultStart и ppaResultEnd зависят от того, как приложение вставляет текст в документ. Если ppaResultStart и ppaResultEnd совпадают с paTestStart, курсор находится в начале вставленного текста после вставки. Если ppaResultStart и ppaResultEnd совпадают с paTextEnd, курсор находится в конце вставленного текста после вставки.

Требования

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