IAnchor::Compare-Methode (textstor.h)

Artikel
03/02/2024

Die IAnchor::Compare-Methode vergleicht die relative Position von zwei Ankern innerhalb eines Textstreams.

Syntax

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

Parameter

[in] paWith

Ein Ankerobjekt, das mit dem primären Anker verglichen werden soll. Wird verwendet, um die relative Position der beiden Anker zu bestimmen.

[out] plResult

Ergebnis des Vergleichs der Positionen der beiden Anker.

Wert	Bedeutung
-1	Der primäre Anker befindet sich früher im Textstream als paWith.
0	Der primäre Anker wird an der gleichen Stelle wie paWith positioniert.
+1	Der primäre Anker wird später im Textstream als paWith positioniert.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_FAIL	paWith ist ungültig.
E_INVALIDARG	plResult ist ungültig.

Hinweise

Der Wert 0 wird nur für *plResult zurückgegeben, wenn sich die beiden Anker in einer einzelnen Region befinden. Ankerpositionen umfassen die Zwischenräume zwischen Regionen. Wenn Sie nur ermitteln müssen, ob sich die beiden Anker an derselben Stelle befinden, ist IAnchor::IsEqual effizienter.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	textstor.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

Freigeben über