Метод ITfRange::CompareEnd (msctf.h)

Статья
08/24/2023

Метод ITfRange::CompareEnd сравнивает позицию конечной привязки этого диапазона текста с привязкой в другом диапазоне.

Синтаксис

HRESULT CompareEnd(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pWith,
  [in]  TfAnchor     aPos,
  [out] LONG         *plResult
);

Параметры

[in] ec

Измените файл cookie, полученный из ITfDocumentMgr::CreateContext или ITfEditSession::D oEditSession.

[in] pWith

Указатель на указанный диапазон, в котором привязка должна сравниваться с этой конечной привязкой диапазона.

[in] aPos

Элемент перечисления, указывающий, какая привязка указанного диапазона pWith будет сравниваться с этой конечной привязкой диапазона.

Значение	Значение
TF_ANCHOR_START	Сравните эту привязку конца диапазона с указанной начальной привязкой диапазона.
TF_ANCHOR_END	Сравните эту привязку конца диапазона с указанной конечной привязкой диапазона.

[out] plResult

Указатель на результат сравнения между этой конечной привязкой диапазона и привязкой указанного диапазона pWith .

Значение	Значение
-1	Эта конечная привязка находится за привязкой указанного диапазона (положение этой конечной привязки < привязки указанного диапазона).
0	Эта конечная привязка находится в той же позиции, что и привязка указанного диапазона.
+1	Эта конечная привязка опережает привязку указанного диапазона (положение этой конечной привязки > привязки указанного диапазона).

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

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

Значение	Описание
S_OK	Метод выполнен успешно.
E_FAIL	Произошла неизвестная ошибка.
E_INVALIDARG	Один или несколько параметров являются недопустимыми.
TF_E_NOLOCK	Значение параметра ec является недопустимым файлом cookie или вызывающий объект не имеет блокировки только для чтения.

Этот метод никогда не возвращает значение 0, если две привязки не находятся в одном регионе. Если вызывающей объекту требуются только сведения о том, расположены ли две привязки в одном расположении, ITfRange::IsEqualEnd является более эффективным.

Этот метод идентичен методу ITfRange::CompareStart, за исключением того, что конечная привязка этого диапазона сравнивается с привязкой другого указанного диапазона.

Требования


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