Enumerasi DWMWINDOWATTRIBUTE (dwmapi.h)
Opsi yang digunakan oleh fungsi DwmGetWindowAttribute dan DwmSetWindowAttribute .
Sintaks
typedef enum DWMWINDOWATTRIBUTE {
DWMWA_NCRENDERING_ENABLED,
DWMWA_NCRENDERING_POLICY,
DWMWA_TRANSITIONS_FORCEDISABLED,
DWMWA_ALLOW_NCPAINT,
DWMWA_CAPTION_BUTTON_BOUNDS,
DWMWA_NONCLIENT_RTL_LAYOUT,
DWMWA_FORCE_ICONIC_REPRESENTATION,
DWMWA_FLIP3D_POLICY,
DWMWA_EXTENDED_FRAME_BOUNDS,
DWMWA_HAS_ICONIC_BITMAP,
DWMWA_DISALLOW_PEEK,
DWMWA_EXCLUDED_FROM_PEEK,
DWMWA_CLOAK,
DWMWA_CLOAKED,
DWMWA_FREEZE_REPRESENTATION,
DWMWA_PASSIVE_UPDATE_MODE,
DWMWA_USE_HOSTBACKDROPBRUSH,
DWMWA_USE_IMMERSIVE_DARK_MODE = 20,
DWMWA_WINDOW_CORNER_PREFERENCE = 33,
DWMWA_BORDER_COLOR,
DWMWA_CAPTION_COLOR,
DWMWA_TEXT_COLOR,
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS,
DWMWA_SYSTEMBACKDROP_TYPE,
DWMWA_LAST
} ;
Konstanta
DWMWA_NCRENDERING_ENABLEDGunakan dengan DwmGetWindowAttribute. Menemukan apakah penyajian non-klien diaktifkan. Nilai yang diambil berjenis BOOL. TRUE jika penyajian non-klien diaktifkan; jika tidak, FALSE. |
DWMWA_NCRENDERING_POLICYGunakan dengan DwmSetWindowAttribute. Menetapkan kebijakan penyajian non-klien. Parameter pvAttribute menunjuk ke nilai dari enumerasi DWMNCRENDERINGPOLICY . |
DWMWA_TRANSITIONS_FORCEDISABLEDGunakan dengan DwmSetWindowAttribute. Mengaktifkan atau menonaktifkan transisi DWM secara paksa. Parameter pvAttribute menunjuk ke nilai jenis BOOL. TRUE untuk menonaktifkan transisi, atau FALSE untuk mengaktifkan transisi. |
DWMWA_ALLOW_NCPAINTGunakan dengan DwmSetWindowAttribute. Memungkinkan konten yang dirender di area non-klien agar terlihat pada bingkai yang digambar oleh DWM. Parameter pvAttribute menunjuk ke nilai jenis BOOL. TRUE untuk mengaktifkan konten yang dirender di area non-klien agar terlihat pada bingkai; jika tidak, FALSE. |
DWMWA_CAPTION_BUTTON_BOUNDSGunakan dengan DwmGetWindowAttribute. Mengambil batas area tombol caption di ruang relatif jendela. Nilai yang diambil berjenis RECT. Jika jendela diminimalkan atau tidak terlihat oleh pengguna, maka nilai RECT yang diambil tidak terdefinisi. Anda harus memeriksa apakah RECT yang diambil berisi batas yang dapat Anda kerjakan, dan jika tidak, Anda dapat menyimpulkan bahwa jendela diminimalkan atau tidak terlihat. |
DWMWA_NONCLIENT_RTL_LAYOUTGunakan dengan DwmSetWindowAttribute. Menentukan apakah konten non-klien dicerminkan dari kanan ke kiri (RTL). Parameter pvAttribute menunjuk ke nilai jenis BOOL. TRUE jika konten non-klien dicerminkan dari kanan ke kiri (RTL) ; jika tidak, FALSE. |
DWMWA_FORCE_ICONIC_REPRESENTATIONGunakan dengan DwmSetWindowAttribute. Memaksa jendela untuk menampilkan gambar mini ikonik atau representasi cuplikan (bitmap statis), bahkan jika representasi langsung atau rekam jepret jendela tersedia. Nilai ini biasanya diatur selama pembuatan jendela, dan tidak berubah sepanjang masa pakai jendela. Namun, beberapa skenario mungkin mengharuskan nilai berubah dari waktu ke waktu. Parameter pvAttribute menunjuk ke nilai jenis BOOL. TRUE untuk memerlukan gambar mini ikonik atau representasi intip; jika tidak, FALSE. |
DWMWA_FLIP3D_POLICYGunakan dengan DwmSetWindowAttribute. Mengatur bagaimana Flip3D memperlakukan jendela. Parameter pvAttribute menunjuk ke nilai dari enumerasi DWMFLIP3DWINDOWPOLICY . |
DWMWA_EXTENDED_FRAME_BOUNDSGunakan dengan DwmGetWindowAttribute. Mengambil persegi panjang batas bingkai yang diperluas di ruang layar. Nilai yang diambil berjenis RECT. |
DWMWA_HAS_ICONIC_BITMAPGunakan dengan DwmSetWindowAttribute. Jendela akan menyediakan bitmap untuk digunakan oleh DWM sebagai gambar mini ikonik atau representasi intip (bitmap statis) untuk jendela. DWMWA_HAS_ICONIC_BITMAP dapat ditentukan dengan DWMWA_FORCE_ICONIC_REPRESENTATION. DWMWA_HAS_ICONIC_BITMAP biasanya diatur selama pembuatan jendela dan tidak berubah sepanjang masa pakai jendela. Namun, beberapa skenario mungkin mengharuskan nilai berubah dari waktu ke waktu. Parameter pvAttribute menunjuk ke nilai jenis BOOL. TRUE untuk memberi tahu DWM bahwa jendela akan memberikan gambar mini ikonik atau representasi intip; jika tidak, FALSE. Windows Vista dan yang lebih lama: Nilai ini tidak didukung. |
DWMWA_DISALLOW_PEEKGunakan dengan DwmSetWindowAttribute. Jangan perlihatkan pratinjau cuplikan untuk jendela. Tampilan cuplikan memperlihatkan pratinjau jendela berukuran penuh saat mouse mengarahkan kursor ke gambar mini jendela di taskbar. Jika atribut ini diatur, arahkan kursor ke penunjuk mouse di atas gambar mini jendela menutup cuplikan (jika jendela lain dalam grup memiliki pratinjau cuplikan yang ditampilkan). Parameter pvAttribute menunjuk ke nilai jenis BOOL. TRUE untuk mencegah fungsionalitas intip, atau FALSE untuk mengizinkannya. Windows Vista dan yang lebih lama: Nilai ini tidak didukung. |
DWMWA_EXCLUDED_FROM_PEEKGunakan dengan DwmSetWindowAttribute. Mencegah jendela memudar ke lembar kaca saat cuplikan dipanggil. Parameter pvAttribute menunjuk ke nilai jenis BOOL. TRUE untuk mencegah jendela memudar selama cuplikan jendela lain, atau FALSE untuk perilaku normal. Windows Vista dan yang lebih lama: Nilai ini tidak didukung. |
DWMWA_CLOAKGunakan dengan DwmSetWindowAttribute. Menyelubungi jendela sehingga tidak terlihat oleh pengguna. Jendela masih terdiri dari DWM. Menggunakan dengan DirectComposition: Gunakan bendera DWMWA_CLOAK untuk menutup jendela anak berlapis saat menganimasikan representasi konten jendela melalui visual DirectComposition yang telah dikaitkan dengan jendela anak berlapis. Untuk detail selengkapnya tentang kasus penggunaan ini, lihat Cara menganimasikan bitmap jendela anak berlapis. Windows 7 dan yang lebih lama: Nilai ini tidak didukung. |
DWMWA_CLOAKEDGunakan dengan DwmGetWindowAttribute. Jika jendela diselubungi, berikan salah satu nilai berikut yang menjelaskan alasannya. DWM_CLOAKED_APP (0x00000001 nilai). Jendela diselubungi oleh aplikasi pemiliknya. DWM_CLOAKED_SHELL (0x00000002 nilai). Jendela diselubungi oleh Shell. DWM_CLOAKED_INHERITED (0x00000004 nilai). Nilai cloak diwarisi dari jendela pemiliknya. Windows 7 dan yang lebih lama: Nilai ini tidak didukung. |
DWMWA_FREEZE_REPRESENTATIONGunakan dengan DwmSetWindowAttribute. Bekukan gambar mini jendela dengan visualnya saat ini. Jangan lakukan pembaruan langsung lebih lanjut pada gambar mini agar sesuai dengan konten jendela. Windows 7 dan yang lebih lama: Nilai ini tidak didukung. |
DWMWA_USE_HOSTBACKDROPBRUSHGunakan dengan DwmSetWindowAttribute. Memungkinkan jendela non-UWP untuk menggunakan kuas backdrop host. Jika bendera ini diatur, maka aplikasi Win32 yang memanggil Windows::UI::Composition API dapat membangun efek transparansi menggunakan kuas backdrop host (lihat Compositor.CreateHostBackdropBrush). Parameter pvAttribute menunjuk ke nilai jenis BOOL. TRUE untuk mengaktifkan kuas backdrop host untuk jendela, atau FALSE untuk menonaktifkannya. Nilai ini didukung dimulai dengan Windows 11 Build 22000. |
DWMWA_USE_IMMERSIVE_DARK_MODEGunakan dengan DwmSetWindowAttribute. Memungkinkan bingkai jendela untuk jendela ini digambar dalam warna mode gelap ketika pengaturan sistem mode gelap diaktifkan. Untuk alasan kompatibilitas, semua jendela default ke mode terang terlepas dari pengaturan sistem. Parameter pvAttribute menunjuk ke nilai jenis BOOL. TRUE untuk menghormati mode gelap untuk jendela, FALSE untuk selalu menggunakan mode cahaya. Nilai ini didukung dimulai dengan Windows 11 Build 22000. |
DWMWA_WINDOW_CORNER_PREFERENCEGunakan dengan DwmSetWindowAttribute. Menentukan preferensi sudut bulat untuk jendela. Parameter pvAttribute menunjuk ke nilai jenis DWM_WINDOW_CORNER_PREFERENCE. Nilai ini didukung dimulai dengan Windows 11 Build 22000. |
DWMWA_BORDER_COLORGunakan dengan DwmSetWindowAttribute. Menentukan warna batas jendela. Parameter pvAttribute menunjuk ke nilai jenis COLORREF. Aplikasi ini bertanggung jawab untuk mengubah warna batas sesuai dengan perubahan status, seperti perubahan aktivasi jendela. Menentukan DWMWA_COLOR_NONE (nilai 0xFFFFFFFE) untuk warna akan menekan gambar batas jendela. Ini memungkinkan untuk memiliki jendela bulat tanpa batas. Menentukan DWMWA_COLOR_DEFAULT (nilai 0xFFFFFFFF) untuk warna akan mengatur ulang jendela kembali menggunakan perilaku default sistem untuk warna batas. Nilai ini didukung dimulai dengan Windows 11 Build 22000. |
DWMWA_CAPTION_COLORGunakan dengan DwmSetWindowAttribute. Menentukan warna caption. Parameter pvAttribute menunjuk ke nilai jenis COLORREF. Menentukan DWMWA_COLOR_DEFAULT (nilai 0xFFFFFFFF) untuk warna akan mengatur ulang jendela kembali ke menggunakan perilaku default sistem untuk warna caption. Nilai ini didukung dimulai dengan Windows 11 Build 22000. |
DWMWA_TEXT_COLORGunakan dengan DwmSetWindowAttribute. Menentukan warna teks caption. Parameter pvAttribute menunjuk ke nilai jenis COLORREF. Menentukan DWMWA_COLOR_DEFAULT (nilai 0xFFFFFFFF) untuk warna akan mengatur ulang jendela kembali menggunakan perilaku default sistem untuk warna teks caption. Nilai ini didukung dimulai dengan Windows 11 Build 22000. |
DWMWA_VISIBLE_FRAME_BORDER_THICKNESSGunakan dengan DwmGetWindowAttribute. Mengambil lebar batas luar yang akan digambar DWM di sekitar jendela ini. Nilainya dapat bervariasi tergantung pada DPI jendela. Parameter pvAttribute menunjuk ke nilai jenis UINT. Nilai ini didukung dimulai dengan Windows 11 Build 22000. |
DWMWA_SYSTEMBACKDROP_TYPEGunakan dengan DwmGetWindowAttribute atau DwmSetWindowAttribute. Mengambil atau menentukan bahan latar belakang jendela yang digambar sistem, termasuk di belakang area non-klien. Parameter pvAttribute menunjuk ke nilai jenis DWM_SYSTEMBACKDROP_TYPE. Nilai ini didukung dimulai dengan Windows 11 Build 22621. |
DWMWA_LASTNilai DWMWINDOWATTRIBUTE maksimum yang diakui, digunakan untuk tujuan validasi. |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Header | dwmapi.h |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk