ITfRange::CompareEnd method (msctf.h)

Artikel
03/08/2023

Metode ITfRange::CompareEnd membandingkan posisi jangkar akhir dari rentang teks ini dengan jangkar dalam rentang lain.

Sintaks

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

Parameter

[in] ec

Edit cookie yang diperoleh dari ITfDocumentMgr::CreateContext atau ITfEditSession::D oEditSession.

[in] pWith

Penunjuk ke rentang tertentu di mana jangkar akan dibandingkan dengan jangkar akhir rentang ini.

[in] aPos

Elemen Enumerasi yang menunjukkan jangkar mana dari rentang pWith yang ditentukan untuk dibandingkan dengan jangkar akhir rentang ini.

Nilai	Makna
TF_ANCHOR_START	Bandingkan jangkar akhir rentang ini dengan jangkar mulai rentang yang ditentukan.
TF_ANCHOR_END	Bandingkan jangkar akhir rentang ini dengan jangkar akhir rentang yang ditentukan.

[out] plResult

Penunjuk ke hasil perbandingan antara jangkar akhir rentang ini dan jangkar rentang pWith yang ditentukan.

Nilai	Makna
-1	Jangkar akhir ini berada di belakang jangkar rentang yang ditentukan (posisi posisi jangkar < akhir jangkar jangkar dari rentang yang ditentukan).
0	Jangkar akhir ini berada pada posisi yang sama dengan jangkar rentang yang ditentukan.
+1	Jangkar akhir ini berada di depan jangkar rentang yang ditentukan (posisi posisi jangkar > akhir jangkar jangkar dari rentang yang ditentukan).

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.
TF_E_NOLOCK	Nilai parameter ec adalah cookie yang tidak valid, atau pemanggil tidak memiliki kunci baca-saja.

Keterangan

Metode ini tidak akan pernah mengembalikan 0 kecuali kedua jangkar berada dalam satu wilayah. Jika penelepon hanya memerlukan informasi tentang apakah kedua jangkar diposisikan di lokasi yang sama, ITfRange::IsEqualEnd lebih efisien.

Metode ini identik dengan ITfRange::CompareStart, kecuali bahwa jangkar akhir rentang ini dibandingkan dengan jangkar rentang lain yang ditentukan.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	msctf.h
DLL	Msctf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional