Compartir a través de


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

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

Consulte también

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfRange::CompareStart

ITfRange::IsEqualEnd

Almacenes de texto

TfAnchor