ITfRange::CompareEnd-Methode (msctf.h)

Artikel
08/24/2023

Die ITfRange::CompareEnd-Methode vergleicht die Endankerposition dieses Textbereichs mit einem Anker in einem anderen Bereich.

Syntax

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

Parameter

[in] ec

Bearbeiten Sie das cookie, das von ITfDocumentMgr::CreateContext oder ITfEditSession::D oEditSession abgerufen wurde.

[in] pWith

Zeiger auf einen angegebenen Bereich, in dem ein Anker mit diesem Bereichsendanker verglichen werden soll.

[in] aPos

Enumerationselement, das angibt, welcher Anker des angegebenen pWith-Bereichs mit diesem Bereichsendanker verglichen werden soll.

Wert	Bedeutung
TF_ANCHOR_START	Vergleichen Sie diesen Bereichsendanker mit dem angegebenen Bereichsstartanker.
TF_ANCHOR_END	Vergleichen Sie diesen Bereichsendanker mit dem angegebenen Bereichsendanker.

[out] plResult

Zeiger auf das Ergebnis des Vergleichs zwischen diesem Bereichsendanker und dem Anker des angegebenen pWith-Bereichs .

Wert	Bedeutung
-1	Dieser Endanker befindet sich hinter dem Anker des angegebenen Bereichs (Position dieser Endankerposition < des Ankers des angegebenen Bereichs).
0	Dieser Endanker befindet sich an der gleichen Position wie der Anker des angegebenen Bereichs.
+1	Dieser Endanker liegt vor dem Anker des angegebenen Bereichs (Position dieser Endankerposition > des Ankers des angegebenen Bereichs).

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
TF_E_NOLOCK	Der Wert des ec-Parameters ist ein ungültiges Cookie, oder der Aufrufer verfügt nicht über eine schreibgeschützte Sperre.

Hinweise

Diese Methode gibt nie 0 zurück, es sei denn, die beiden Anker befinden sich in einer einzelnen Region. Wenn der Aufrufer nur Informationen dazu benötigt, ob die beiden Anker am gleichen Ort positioniert sind, ist ITfRange::IsEqualEnd effizienter.

Diese Methode ist identisch mit ITfRange::CompareStart, mit der Ausnahme, dass der Endanker dieses Bereichs mit einem Anker eines anderen angegebenen Bereichs verglichen wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional