Fungsi DrawThemeBackground (uxtheme.h)

Menggambar batas dan mengisi yang ditentukan oleh gaya visual untuk bagian kontrol yang ditentukan.

Sintaks

HRESULT DrawThemeBackground(
  [in] HTHEME  hTheme,
  [in] HDC     hdc,
  [in] int     iPartId,
  [in] int     iStateId,
  [in] LPCRECT pRect,
  [in] LPCRECT pClipRect
);

Parameter

[in] hTheme

Jenis: HTHEME

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

[in] hdc

Jenis: HDC

HDC digunakan untuk menggambar gambar latar belakang yang ditentukan tema.

[in] iPartId

Jenis: int

Nilai tipe int yang menentukan bagian yang akan digambar. Lihat Bagian dan Status.

[in] iStateId

Jenis: int

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

[in] pRect

Jenis: const RECT*

Penunjuk ke struktur RECT yang berisi persegi panjang, dalam koordinat logis, di mana gambar latar belakang digambar.

[in] pClipRect

Jenis: const RECT*

Penunjuk ke struktur RECT yang berisi persegi panjang kliping. Parameter ini dapat diatur ke NULL.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Operasi menggambar diskalakan agar pas dan tidak melebihi persegi panjang yang ditentukan dalam pRect. Aplikasi Anda tidak boleh menggambar di luar persegi panjang yang ditentukan oleh pClipRect.

Contoh

Sebelum memanggil DrawThemeBackground untuk menggambar gambar latar belakang untuk jendela, Anda dapat memanggil IsThemeBackgroundPartiallyTransparent. Metode ini menentukan apakah DrawThemeParentBackground harus dipanggil untuk menggambar latar belakang di belakang kontrol turunan yang sebagian transparan atau alpha-blended, dan ditunjukkan dalam contoh berikut.

if (_hTheme)
{
  if (IsThemeBackgroundPartiallyTransparent(_hTheme, BP_PUSHBUTTON, _iStateId))
  {
    DrawThemeParentBackground(_hwnd, hdcPaint, prcPaint);
  }

  DrawThemeBackground(_hTheme,
                    hdcPaint,
                    BP_PUSHBUTTON,
                    _iStateId,
                    &rcClient,
                    prcPaint);
}

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