ITfRange::CompareStart-Methode (msctf.h)

Artikel
08/24/2023

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

Syntax

HRESULT CompareStart(
  [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 Bereichsstartanker verglichen werden soll.

[in] aPos

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

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

[out] plResult

Zeiger auf das Ergebnis des Vergleichs zwischen diesem Bereichsstartanker und dem angegebenen pWith-Bereichsanker.

Wert	Bedeutung
-1	Dieser Startanker befindet sich hinter dem Anker des angegebenen Bereichs (Position dieser Startankerposition < des Ankers des angegebenen Bereichs).
0	Dieser Startanker befindet sich an derselben Position wie der Anker des angegebenen Bereichs.
+1	Dieser Startanker liegt vor dem Anker des angegebenen Bereichs (Position dieser Startankerposition > 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::IsEqualStart effizienter.

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