Método IAnchor::Compare (textstor.h)

O método IAnchor::Compare compara a posição relativa de duas âncoras em um fluxo de texto.

Sintaxe

HRESULT Compare(
  [in]  IAnchor *paWith,
  [out] LONG    *plResult
);

Parâmetros

[in] paWith

Um objeto de âncora a ser comparado com a âncora primária. Usado para determinar a posição relativa das duas âncoras.

[out] plResult

Resultado da comparação das posições das duas âncoras.

Valor	Significado
-1	A âncora primária é posicionada anteriormente no fluxo de texto do que paWith.
0	A âncora primária é posicionada no mesmo local que paWith.
+1	A âncora primária é posicionada posteriormente no fluxo de texto do que paWith.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_FAIL	paWith é inválido.
E_INVALIDARG	plResult é inválido.

Comentários

O valor 0 é retornado para *plResult somente quando as duas âncoras estão em uma única região. As posições de âncora incluem os espaços entre regiões. Se você só precisar determinar se as duas âncoras estão posicionadas no mesmo local, IAnchor::IsEqual é mais eficiente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	textstor.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional

Confira também

Âncoras

IAnchor

IAnchor::IsEqual

Regiões