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
Referensi