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

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

Синтаксис

HRESULT QueryInsert(
  [in]  LONG  acpTestStart,
  [in]  LONG  acpTestEnd,
  [in]  ULONG cch,
  [out] LONG  *pacpResultStart,
  [out] LONG  *pacpResultEnd
);

Параметры

[in] acpTestStart

Начальная позиция символа приложения для вставленного текста.

[in] acpTestEnd

Конечная позиция символа приложения для вставленного текста. Это значение равно acpTextStart , если текст вставляется в точке вместо замены выделенного текста.

[in] cch

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

[out] pacpResultStart

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

[out] pacpResultEnd

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

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

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

Значение	Описание
S_OK	Метод выполнен успешно.
E_FAIL	Произошла неизвестная ошибка.
E_INVALIDARG	Недопустимые параметры acpTestStart или acpTestEnd .

Комментарии

Значения pacpResultStart и pacpResultEnd зависят от того, как приложение вставляет текст в документ. Если pacpResultStart и pacpResultEnd совпадают с acpTextStart, курсор находится в начале вставленного текста после вставки. Если pacpResultStart и pacpResultEnd совпадают с acpTextEnd, курсор находится в конце вставленного текста после вставки. Если разница между pacpResultStart и pacpResultEnd равна длине вставленного текста, вставленный текст выделяется после вставки.

Требования

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