ITfRange::CompareStart method (msctf.h)

Artikel
08/24/2023

Metode ITfRange::CompareStart membandingkan posisi jangkar awal rentang teks ini dengan jangkar dalam rentang lain.

Sintaks

HRESULT CompareStart(
  [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 mulai rentang ini.

[in] aPos

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

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

[out] plResult

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

Nilai	Makna
-1	Jangkar mulai ini berada di belakang jangkar rentang yang ditentukan (posisi posisi jangkar < awal jangkar dari rentang yang ditentukan).
0	Jangkar mulai ini berada pada posisi yang sama dengan jangkar rentang yang ditentukan.
+1	Jangkar awal ini berada di depan jangkar rentang yang ditentukan (posisi posisi jangkar > awal 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::IsEqualStart lebih efisien.

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