Método ITfRange::CompareEnd (msctf.h)

Artículo
03/08/2023

El método ITfRange::CompareEnd compara la posición del delimitador final de este intervalo de texto con un delimitador en otro intervalo.

Sintaxis

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

Parámetros

[in] ec

Edite la cookie obtenida de ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] pWith

Puntero a un intervalo especificado en el que se va a comparar un delimitador con este delimitador final de intervalo.

[in] aPos

Elemento de enumeración que indica el delimitador del intervalo pWith especificado que se va a comparar con este delimitador final del intervalo.

Valor	Significado
TF_ANCHOR_START	Compare este delimitador final del intervalo con el delimitador de inicio del intervalo especificado.
TF_ANCHOR_END	Compare este delimitador final de intervalo con el delimitador de extremo del intervalo especificado.

[out] plResult

Puntero al resultado de la comparación entre este delimitador final de intervalo y el delimitador del intervalo pWith especificado.

Valor	Significado
-1	Este delimitador final está detrás del delimitador del intervalo especificado (posición de este delimitador < final del delimitador del intervalo especificado).
0	Este delimitador final está en la misma posición que el delimitador del intervalo especificado.
+1	Este delimitador final está por delante del delimitador del intervalo especificado (posición de este delimitador > final del delimitador del intervalo especificado).

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_FAIL	Se ha producido un error no especificado.
E_INVALIDARG	Uno o varios parámetros no son válidos.
TF_E_NOLOCK	El valor del parámetro ec es una cookie no válida o el autor de la llamada no tiene un bloqueo de solo lectura.

Comentarios

Este método nunca devolverá 0 a menos que los dos delimitadores estén en una sola región. Si el autor de la llamada solo requiere información sobre si los dos delimitadores se colocan en la misma ubicación, ITfRange::IsEqualEnd es más eficaz.

Este método es idéntico a ITfRange::CompareStart, salvo que el delimitador final de este rango se compara con un delimitador de otro intervalo especificado.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional