METODE IDWriteTextLayout::HitTestTextPosition (dwrite.h)

Aplikasi memanggil fungsi ini untuk mendapatkan lokasi piksel relatif terhadap kiri atas kotak tata letak mengingat posisi teks dan sisi logis posisi. Fungsi ini biasanya digunakan sebagai bagian dari penempatan tanda sisipan teks di mana tanda sisipan digambar di lokasi yang sesuai dengan posisi pengeditan teks saat ini. Ini juga dapat digunakan sebagai cara untuk secara terprogram mendapatkan geometri posisi teks tertentu dalam otomatisasi UI.

Sintaks

HRESULT HitTestTextPosition(
        UINT32                  textPosition,
        BOOL                    isTrailingHit,
  [out] FLOAT                   *pointX,
  [out] FLOAT                   *pointY,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

Parameter

textPosition

Jenis: UINT32

Posisi teks yang digunakan untuk mendapatkan lokasi piksel.

isTrailingHit

Jenis: BOOL

Bendera Boolean yang menunjukkan apakah lokasi piksel berada di sisi depan atau di sisi berikutnya dari posisi teks yang ditentukan.

[out] pointX

Jenis: FLOAT*

Saat metode ini kembali, berisi lokasi piksel output X, relatif terhadap lokasi kiri atas kotak tata letak.

[out] pointY

Jenis: FLOAT*

Saat metode ini kembali, berisi lokasi piksel output Y, relatif terhadap lokasi kiri atas kotak tata letak.

[out] hitTestMetrics

Jenis: DWRITE_HIT_TEST_METRICS*

Ketika metode ini kembali, berisi geometri output yang sepenuhnya mencakup posisi teks yang ditentukan.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini 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