Metode ITfContextView::GetRangeFromPoint (msctf.h)

Metode ITfContextView::GetRangeFromPoint mengonversi titik, dalam koordinat layar, ke rentang teks kosong yang diposisikan di lokasi yang sesuai.

Sintaks

HRESULT GetRangeFromPoint(
  [in]  TfEditCookie ec,
  [in]  const POINT  *ppt,
  [in]  DWORD        dwFlags,
  [out] ITfRange     **ppRange
);

Parameter

[in] ec

Menentukan cookie edit dengan akses baca-saja.

[in] ppt

Menentukan titik dalam koordinat layar.

[in] dwFlags

Menentukan posisi rentang yang akan dikembalikan berdasarkan koordinat layar dari titik ke kotak pembatas karakter. Secara default, posisi rentang yang dikembalikan adalah kotak pembatas karakter yang berisi koordinat layar titik. Jika titik berada di luar kotak pembatas karakter, metode mengembalikan NULL atau TF_E_INVALIDPOINT. Bendera bit lain untuk parameter ini adalah sebagai berikut.

Bendera bit dapat digabungkan.

Nilai	Makna
GXFPF_ROUND_NEAREST	Jika koordinat layar titik terkandung dalam kotak pembatas karakter, posisi rentang yang dikembalikan adalah tepi pembatas yang paling dekat dengan koordinat layar titik.
GXFPF_NEAREST	Jika koordinat layar titik tidak terkandung dalam kotak pembatas karakter, posisi rentang terdekat dikembalikan.

[out] ppRange

Menerima penunjuk ke antarmuka ITfRange.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
TF_E_INVALIDPOINT	Parameter pptScreen tidak mencakup teks dokumen apa pun.
TF_E_NOLAYOUT	Aplikasi belum menghitung tata letak teks.
TF_E_NOLOCK	Cookie edit yang ditentukan tidak valid.

Keterangan

Secara default, metode akan mengembalikan rentang yang diposisikan pada 0 untuk titik 1 dan TF_E_INVALIDPOINT untuk titik 2. Jika parameter dwFlags diatur ke GXFPF_ROUND_NEAREST, metode mengembalikan posisi rentang 1 untuk titik 1. Jika parameter dwFlags diatur ke GXFPF_NEAREST maka metode mengembalikan posisi rentang 2 untuk titik 2.

Persyaratan

Persyaratan	Nilai
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

Lihat juga

GXFPF_NEAREST

GXFPF_ROUND_NEAREST

ITfContextView

TF_E_INVALIDPOINT