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

Artigo
08/24/2023

O método ITfRange::CompareEnd compara a posição da âncora final desse intervalo de texto com uma âncora em outro intervalo.

Sintaxe

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

Parâmetros

[in] ec

Edite o cookie obtido de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] pWith

Ponteiro para um intervalo especificado no qual uma âncora deve ser comparada com essa âncora final de intervalo.

[in] aPos

Elemento de enumeração que indica qual âncora do intervalo pWith especificado deve ser comparada com essa âncora final de intervalo.

Valor	Significado
TF_ANCHOR_START	Compare essa âncora final de intervalo com a âncora inicial do intervalo especificada.
TF_ANCHOR_END	Compare essa âncora final de intervalo com a âncora final de intervalo especificada.

[out] plResult

Ponteiro para o resultado da comparação entre essa âncora final de intervalo e a âncora do intervalo pWith especificado.

Valor	Significado
-1	Essa âncora final está atrás da âncora do intervalo especificado (posição dessa posição de âncora < final da âncora do intervalo especificado).
0	Essa âncora final está na mesma posição que a âncora do intervalo especificado.
+1	Essa âncora final está à frente da âncora do intervalo especificado (posição dessa posição de âncora > final da âncora do intervalo especificado).

Valor retornado

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_FAIL	Ocorreu um erro não especificado.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
TF_E_NOLOCK	O valor do parâmetro ec é um cookie inválido ou o chamador não tem um bloqueio somente leitura.

Comentários

Esse método nunca retornará 0, a menos que as duas âncoras estejam em uma única região. Se o chamador exigir apenas informações sobre se as duas âncoras estão posicionadas no mesmo local, ITfRange::IsEqualEnd será mais eficiente.

Esse método é idêntico a ITfRange::CompareStart, exceto que a âncora final desse intervalo é comparada a uma âncora de outro intervalo especificado.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional