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

Статья
08/24/2023

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

Синтаксис

HRESULT CompareStart(
  [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::IsEqualStart является более эффективным.

Требования


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