Metode ITfContextOwner::GetACPFromPoint (msctf.h)

Metode ITfContextOwner::GetACPFromPoint mengonversi titik dalam koordinat layar ke posisi karakter aplikasi.

Sintaks

HRESULT GetACPFromPoint(
  [in]  const POINT *ptScreen,
  [in]  DWORD       dwFlags,
  [out] LONG        *pacp
);

Parameter

[in] ptScreen

Arahkan ke struktur POINT dengan koordinat layar titik.

[in] dwFlags

Menentukan posisi karakter yang akan dikembalikan berdasarkan koordinat layar titik relatif terhadap kotak pembatas karakter. Secara default, posisi karakter 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.

Jika bendera GXFPF_ROUND_NEAREST ditentukan untuk parameter ini dan koordinat layar titik terkandung dalam kotak pembatas karakter, posisi karakter yang dikembalikan adalah tepi pembatas yang paling dekat dengan koordinat layar titik.

Jika bendera GXFPF_NEAREST ditentukan untuk parameter ini dan koordinat layar titik tidak terkandung dalam kotak pembatas karakter, posisi karakter terdekat dikembalikan.

Bendera bit dapat digabungkan.

[out] pacp

Menerima posisi karakter yang sesuai dengan koordinat layar titik

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
TS_E_INVALIDPOINT	Parameter ptScreen tidak berada dalam kotak pembatas karakter apa pun.
TS_E_NOLAYOUT	Aplikasi belum menghitung tata letak teks.

Keterangan

Gunakan ilustrasi untuk menentukan posisi karakter yang dikembalikan berdasarkan bendera yang digunakan dalam parameter dwFlags .

Poin 1

• Default-- pacp = 0 --Koordinat layar titik berada di dalam kotak pembatas karakter Posisi Karakter 0.
• GXFPF_ROUND_NEAREST-- pacp = 1 --Koordinat layar titik paling dekat dengan Posisi Rentang 1 yang merupakan posisi rentang awal Posisi Karakter 1.
• GXFPF_NEAREST-- pacp = 0 --Perilaku default terjadi karena titik terletak di dalam kotak pembatas karakter Posisi Karakter 0.

Poin 2

• Default-- hr = TF_E_INVALIDPOINT --Koordinat layar titik berada di luar kotak pembatas karakter.
• GXFPF_ROUND_NEAREST-- hr = TF_E_INVALIDPOINT --Perilaku default terjadi karena koordinat layar titik berada di luar kotak pembatas karakter.
• GXFPF_NEAREST-- pacp = 1 --Posisi karakter terdekat dengan koordinat layar titik adalah Posisi Karakter 1.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	msctf.h
DLL	Msimtf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional

Lihat juga

ITextStoreACP::GetACPFromPoint

ITfContextOwner

ITfContextView::GetRangeFromPoint

TsViewCookie