Metode ITextStoreAnchor::GetAnchorFromPoint (textstor.h)

Metode ITextStoreAnchor::GetAnchorFromPoint mengonversi titik dalam koordinat layar menjadi jangkar yang diposisikan di lokasi yang sesuai.

Sintaks

HRESULT GetAnchorFromPoint(
  [in]  TsViewCookie vcView,
  [in]  const POINT  *ptScreen,
  [in]  DWORD        dwFlags,
  [out] IAnchor      **ppaSite
);

Parameter

[in] vcView

Menentukan tampilan konteks.

[in] ptScreen

Penunjuk ke struktur POINT dengan koordinat layar titik.

[in] dwFlags

Menentukan posisi jangkar untuk dikembalikan berdasarkan koordinat layar titik relatif terhadap kotak pembatas karakter. Secara default, posisi jangkar 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, jangkar dikembalikan di tepi pembatas yang paling dekat dengan koordinat layar titik.
GXFPF_NEAREST	Jika koordinat layar titik tidak terkandung dalam kotak pembatas karakter, jangkar pada posisi karakter terdekat dikembalikan.

[out] ppaSite

Penunjuk ke objek jangkar di lokasi yang sesuai dengan koordinat layar ptScreen.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_FAIL	Metode gagal.
E_INVALIDARG	Satu atau beberapa parameter input tidak valid.
E_OUTOFMEMORY	Upaya untuk membuat instans jangkar di lokasi yang ditentukan gagal.
TS_E_INVALIDPOINT	Parameter ptScreen tidak berada dalam kotak pembatas karakter apa pun.
TS_E_NOLAYOUT	Aplikasi belum menghitung tata letak teks.

Keterangan

Koordinat layar titik 1 menyebabkan offset (posisi karakter) jangkar ppaSite 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, offset jangkar 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 offset jangkar menjadi 1, karena posisi karakter terdekat dengan koordinat layar titik 2 adalah posisi karakter 1.

Poin 1

• Default-- offset jangkar = 0 --Titik koordinat layar berada di dalam kotak pembatas karakter Posisi Karakter 0.
• -- GXFPF_ROUND_NEARESToffset jangkar = 1 --Koordinat layar titik paling dekat dengan Posisi Rentang 1 yang merupakan posisi rentang awal Posisi Karakter 1.
• -- GXFPF_NEARESToffset jangkar = 0 --Perilaku default terjadi karena titik berada dalam kotak pembatas karakter Posisi Karakter 0.

Poin 2

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

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	textstor.h
DLL	Msctf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional

Lihat juga

GXFPF_* Konstanta

ITextStoreAnchor

ITfContextView::GetRangeFromPoint

Nilai Pengembalian Manajer

TsViewCookie