METODE IDWriteTextLayout::HitTestPoint (dwrite.h)
Aplikasi memanggil fungsi ini melewati lokasi piksel tertentu yang relatif terhadap lokasi kiri atas kotak tata letak dan mendapatkan informasi tentang metrik uji hit koresponden dari string teks tempat uji klik telah terjadi. Ketika lokasi piksel yang ditentukan berada di luar string teks, fungsi mengatur nilai output *isInside ke FALSE.
Sintaks
HRESULT HitTestPoint(
FLOAT pointX,
FLOAT pointY,
[out] BOOL *isTrailingHit,
[out] BOOL *isInside,
[out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);
Parameter
pointX
Jenis: FLOAT
Lokasi piksel X untuk diuji, relatif terhadap lokasi kiri atas kotak tata letak.
pointY
Jenis: FLOAT
Lokasi piksel Y untuk hit-test, relatif terhadap lokasi kiri atas kotak tata letak.
[out] isTrailingHit
Jenis: BOOL*
Bendera output yang menunjukkan apakah lokasi hit-test berada di sisi depan atau di belakang karakter. Ketika nilai output *isInside diatur ke FALSE, nilai ini diatur sesuai dengan nilai hitTestMetrics-textPosition> output untuk mewakili tepi yang paling dekat dengan lokasi hit-test.
[out] isInside
Jenis: BOOL*
Bendera output yang menunjukkan apakah lokasi uji klik berada di dalam string teks. Saat FALSE, posisi terdekat tepi teks dikembalikan.
[out] hitTestMetrics
Jenis: DWRITE_HIT_TEST_METRICS*
Geometri output sepenuhnya mencakup lokasi hit-test. Ketika output *nilai isInside diatur ke FALSE, struktur ini mewakili geometri yang mengapit tepi yang paling dekat dengan lokasi hit-test.
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | dwrite.h |
Pustaka | Dwrite.lib |
DLL | Dwrite.dll |