Metodo ITfRange::CompareEnd (msctf.h)

Articolo
03/08/2023

Il metodo ITfRange::CompareEnd confronta la posizione di ancoraggio finale di questo intervallo di testo con un ancoraggio in un altro intervallo.

Sintassi

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

Parametri

[in] ec

Modificare il cookie ottenuto da ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] pWith

Puntatore a un intervallo specificato in cui deve essere confrontato un ancoraggio con l'ancoraggio finale dell'intervallo.

[in] aPos

Elemento di enumerazione che indica l'ancoraggio dell'intervallo pWith specificato da confrontare con l'ancoraggio finale dell'intervallo.

Valore	Significato
TF_ANCHOR_START	Confrontare l'ancoraggio finale dell'intervallo con l'ancoraggio iniziale dell'intervallo specificato.
TF_ANCHOR_END	Confrontare l'ancoraggio finale dell'intervallo con l'ancoraggio di fine intervallo specificato.

[out] plResult

Puntatore al risultato del confronto tra l'ancoraggio finale dell'intervallo e l'ancoraggio dell'intervallo pWith specificato.

Valore	Significato
-1	Questo ancoraggio finale si trova dietro l'ancoraggio dell'intervallo specificato (posizione di questa posizione di ancoraggio < finale dell'ancoraggio dell'intervallo specificato).
0	Questo ancoraggio finale si trova nella stessa posizione dell'ancoraggio dell'intervallo specificato.
+1	Questo ancoraggio finale è davanti all'ancoraggio dell'intervallo specificato (posizione di questa posizione di ancoraggio > finale dell'ancoraggio dell'intervallo specificato).

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_FAIL	Si è verificato un errore non specificato.
E_INVALIDARG	Uno o più parametri non sono validi.
TF_E_NOLOCK	Il valore del parametro ec è un cookie non valido oppure il chiamante non dispone di un blocco di sola lettura.

Commenti

Questo metodo non restituirà mai 0 a meno che i due ancoraggi non si trovino in una singola area. Se il chiamante richiede solo informazioni su se i due ancoraggi sono posizionati nella stessa posizione, ITfRange::IsEqualEnd è più efficiente.

Questo metodo è identico a ITfRange::CompareStart, ad eccezione del fatto che l'ancoraggio finale di questo intervallo viene confrontato con un ancoraggio di un altro intervallo specificato.

Requisiti


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional