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

Artículo
08/24/2023

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

Sintaxis

HRESULT CompareStart(
  [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 de inicio del intervalo.

[in] aPos

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

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

[out] plResult

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

Valor	Significado
-1	Este delimitador de inicio está detrás del delimitador del intervalo especificado (posición de este delimitador < inicial del delimitador especificado).
0	Este delimitador inicial está en la misma posición que el delimitador del intervalo especificado.
+1	Este delimitador inicial está por delante del delimitador del intervalo especificado (posición de este delimitador > inicial del delimitador 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 anclajes se colocan en la misma ubicación, ITfRange::IsEqualStart es más eficaz.

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