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

Lihat juga

IDWriteTextLayout