Compartilhar via


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

O método IAnchor::IsEqual avalia duas âncoras dentro de um fluxo de texto e retorna um valor booliano que especifica a igualdade ou a desigualdade das posições de âncora.

Sintaxe

HRESULT IsEqual(
  [in]  IAnchor *paWith,
  [out] BOOL    *pfEqual
);

Parâmetros

[in] paWith

Especifica uma âncora a ser comparada com a âncora primária. Usado para determinar a igualdade das duas posições de âncora.

[out] pfEqual

Um valor booliano que especifica se as duas âncoras estão posicionadas no mesmo local. Se definido como TRUE, as duas âncoras ocuparão o mesmo local. Se definido como FALSE, as duas âncoras não ocuparão o mesmo local.

Retornar valor

Esse método pode retornar um desses valores.

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

Comentários

As âncoras são sempre posicionadas entre caracteres ou regiões. Quando duas âncoras estão entre os mesmos caracteres, estando no mesmo deslocamento dentro do fluxo de texto e dentro da mesma região, IAnchor::IsEqual retorna TRUE. Caso contrário, retornará FALSE.

IAnchor::Compare incorpora a mesma funcionalidade que IAnchor::IsEqual. No entanto, como IAnchor::IsEqual é mais específico, ele pode ter uma implementação mais eficiente no servidor.

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::Compare