Metode ITextStoreACP::GetACPFromPoint (textstor.h)
Metode ITextStoreACP::GetACPFromPoint mengonversi titik dalam koordinat layar ke posisi karakter aplikasi.
Sintaks
HRESULT GetACPFromPoint(
[in] TsViewCookie vcView,
[in] const POINT *ptScreen,
[in] DWORD dwFlags,
[out] LONG *pacp
);
Parameter
[in] vcView
Menentukan tampilan konteks.
[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. Bendera bit lainnya untuk parameter ini adalah sebagai berikut.
Bendera bit dapat digabungkan.
[out] pacp
Menerima posisi karakter yang sesuai dengan koordinat layar titik.
Menampilkan nilai
Metode ini dapat mengembalikan salah satu nilai ini.
Nilai | Deskripsi |
---|---|
|
Metode berhasil. |
|
Parameter ptScreen tidak berada dalam kotak pembatas karakter apa pun. |
|
Aplikasi belum menghitung tata letak teks. |
Keterangan
Koordinat layar titik 1 menyebabkan parameter pacp menjadi 0 secara default atau jika parameter dwFlags diatur ke GXFPF_NEAREST karena koordinat layar titik 1 berada di dalam kotak pembatas karakter posisi karakter 0. Jika parameter dwFlags diatur ke GXFPF_ROUND_NEAREST untuk titik 1, parameter pacp adalah 1 karena koordinat layar titik 1 paling dekat dengan posisi rentang 1. Posisi rentang 1 adalah posisi rentang awal posisi karakter 1.Untuk koordinat layar titik 2, metode mengembalikan TF_E_INVALIDPOINT secara default atau jika parameter dwFlags diatur ke GXFPF_NEAREST karena koordinat layar titik 2 berada di luar kotak pembatas karakter. Jika parameter dwFlags diatur ke GXFPF_ROUND_NEAREST, maka koordinat layar titik 2 menyebabkan parameter pacp menjadi 1, karena posisi karakter terdekat dengan koordinat layar titik 2 adalah posisi karakter 1.
Poin 1
- Default-- pacp = 0 --Titik koordinat layar berada di dalam kotak pembatas karakter Posisi Karakter 0.
- -- GXFPF_ROUND_NEARESTpacp = 1 --Koordinat layar titik paling dekat dengan Posisi Rentang 1 yang merupakan posisi rentang awal Posisi Karakter 1.
- -- GXFPF_NEARESTpacp = 0 --Perilaku default terjadi karena titik berada dalam kotak pembatas karakter dari Posisi Karakter 0.
- 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
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | textstor.h |
DLL | Msctf.dll |
Redistribusi | TSF 1.0 di Windows 2000 Professional |
Lihat juga
ITfContextOwner::GetACPFromPoint