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

Artigo
08/24/2023

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

Sintaxe

HRESULT CompareStart(
  [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 a essa âncora inicial de intervalo.

[in] aPos

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

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

[out] plResult

Ponteiro para o resultado da comparação entre essa âncora inicial de intervalo e a âncora de intervalo pWith especificada.

Valor	Significado
-1	Essa âncora inicial está atrás da âncora do intervalo especificado (posição dessa posição de âncora < inicial da âncora do intervalo especificado).
0	Essa âncora inicial está na mesma posição que a âncora do intervalo especificado.
+1	Essa âncora inicial está à frente da âncora do intervalo especificado (posição dessa posição de âncora > inicial 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::IsEqualStart será mais eficiente.

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