Fungsi DwmGetColorizationColor (dwmapi.h)

Artikel
08/23/2023

Mengambil warna saat ini yang digunakan untuk komposisi kaca Desktop Window Manager (DWM). Nilai ini didasarkan pada skema warna saat ini dan dapat dimodifikasi oleh pengguna. Aplikasi dapat mendengarkan perubahan warna dengan menangani pemberitahuan WM_DWMCOLORIZATIONCOLORCHANGED .

Sintaks

HRESULT DwmGetColorizationColor(
  [out] DWORD *pcrColorization,
  [out] BOOL  *pfOpaqueBlend
);

Parameter

[out] pcrColorization

Penunjuk ke nilai yang, ketika fungsi ini berhasil dikembalikan, menerima warna saat ini yang digunakan untuk komposisi kaca. Format warna nilai adalah 0xAARRGGBB.

[out] pfOpaqueBlend

Penunjuk ke nilai yang, ketika fungsi ini berhasil dikembalikan, menunjukkan apakah warna adalah campuran buram. TRUE jika warna adalah campuran buram; jika tidak, FALSE.

Mengembalikan nilai

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

Keterangan

Nilai yang diarahkan oleh pcrColorization dalam format 0xAARRGGBB. Banyak API Microsoft Win32, seperti COLORREF, menggunakan format 0x00BBGGRR. Berhati-hatilah untuk memastikan bahwa warna yang dimaksudkan digunakan.

Contoh

Contoh kode berikut menunjukkan handel pemberitahuan WM_DWMCOLORIZATIONCOLORCHANGED . Jika pemberitahuan pewarnaan diterima, kode ini mengambil nilai warna baru.


...
DWORD color = 0;
BOOL opaque = FALSE;
  
HRESULT hr = DwmGetColorizationColor(&color, &opaque);
if (SUCCEEDED(hr))
{
  // Update the application to use the new color.
}
...

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	dwmapi.h
Pustaka	Dwmapi.lib
DLL	Dwmapi.dll

Bagikan melalui