Fungsi GetThemeBackgroundContentRect (uxtheme.h)

Mengambil ukuran area konten untuk latar belakang yang ditentukan oleh gaya visual.

Sintaks

HRESULT GetThemeBackgroundContentRect(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pBoundingRect,
  [out] LPRECT  pContentRect
);

Parameter

[in] hTheme

Jenis: HTHEME

Menangani 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 int tipe yang menentukan bagian yang berisi area konten. Lihat Bagian dan Negara Bagian.

[in] iStateId

Jenis: int

Nilai int jenis yang menentukan status bagian yang berisi area konten. Lihat Bagian dan Negara Bagian.

[in] pBoundingRect

Jenis: LPCRECT

Penunjuk ke struktur RECT yang berisi persegi panjang latar belakang total, dalam koordinat logis. Ini adalah area di dalam batas atau margin.

[out] pContentRect

Jenis: LPRECT

Penunjuk ke struktur RECT yang menerima persegi panjang latar belakang area konten, dalam koordinat logis. Persegi panjang ini dihitung agar pas dengan area konten.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Gaya visual dapat menentukan area konten dalam setiap gambar latar belakang. Ini adalah area di mana konten seperti teks dan ikon dapat ditempatkan tanpa menimpa batas latar belakang.

Contoh

Saat menerapkan tema ke seluruh area klien jendela, Anda dapat memanggil GetClientRect untuk mengambil area ini di RECT, yang dapat diteruskan melalui pointer sebagai parameter pContentRect ke GetThemeBackgroundContentRect seperti dalam contoh berikut.

DWORD resultFlags = GetThemeAppProperties();
bool ctrlsAreThemed = ((resultFlags & STAP_ALLOW_CONTROLS) != 0);

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

GetThemeBackgroundExtent

Pengidentifikasi Properti

Referensi