Fungsi HitTestThemeBackground (uxtheme.h)

Mengambil kode uji hit untuk titik di latar belakang yang ditentukan oleh gaya visual.

Sintaks

HRESULT HitTestThemeBackground(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  DWORD   dwOptions,
  [in]  LPCRECT pRect,
  [in]  HRGN    hrgn,
  [in]  POINT   ptTest,
  [out] WORD    *pwHitTestCode
);

Parameter

[in] hTheme

Jenis: HTHEME

Menangani ke data tema yang ditentukan jendela. Gunakan OpenThemeData untuk membuat HTHEME.

[in] hdc

Jenis: HDC

HDC untuk digunakan saat menggambar. Parameter ini dapat diatur ke NULL.

[in] iPartId

Jenis: int

Nilai jenis int yang menentukan bagian . Lihat Bagian dan Status.

[in] iStateId

Jenis: int

Nilai tipe int yang menentukan status bagian. Lihat Bagian dan Status.

[in] dwOptions

Jenis: DWORD

DWORD yang menentukan opsi uji hit. Lihat Tekan Opsi Pengujian untuk daftar opsi.

[in] pRect

Jenis: LPCRECT

Penunjuk ke struktur RECT yang berisi, dalam koordinat logis, persegi panjang yang mengikat latar belakang.

[in] hrgn

Jenis: HRGN

Tangani ke wilayah yang dapat digunakan untuk menentukan batas area pengujian hit. Parameter ini dapat diatur ke NULL.

[in] ptTest

Jenis: TITIK

Struktur POINT yang berisi koordinat titik.

[out] pwHitTestCode

Jenis: WORD*

WORD yang menerima kode uji hit yang menunjukkan apakah titik di ptTest berada di area latar belakang yang dibatasi oleh pRect atau hrgn. Lihat Nilai Uji Pengembalian untuk daftar nilai yang dikembalikan.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Nilai dalam ptTest dan pRect harus berada dalam sistem koordinat yang sama, seperti klien atau layar. Jika parameter hrgn digunakan, parameter harus ditentukan dalam koordinat yang sama dengan pRect dan ptTest.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	uxtheme.h
Pustaka	UxTheme.lib
DLL	UxTheme.dll

Lihat juga

Pengidentifikasi Properti