Bagikan melalui


BackdropMaterial Kelas

Definisi

Kelas pembantu untuk menerapkan materi backdrop ke akar konten XAML.

Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI diSDK Aplikasi Windows , lihat namespace Windows App SDK).

public ref class BackdropMaterial : DependencyObject
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BackdropMaterial : DependencyObject
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class BackdropMaterial : DependencyObject
Public Class BackdropMaterial
Inherits DependencyObject
<Page muxc:BackdropMaterial.ApplyToRootOrPageBackground="True">
    pageContent
</Page>
-or-
<Frame muxc:BackdropMaterial.ApplyToRootOrPageBackground="True">
    appContent
</Frame>
Warisan
BackdropMaterial
Atribut
Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Contoh

Ujung

Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat Mica.

WinUI 3 Gallery dan WinUI 2 Gallery aplikasi mencakup contoh interaktif sebagian besar kontrol, fitur, dan fungsi WinUI 3 dan WinUI 2.

Jika sudah diinstal, buka dengan mengklik tautan berikut: Galeri WinUI 3 atau galeri WinUI 2.

Jika tidak diinstal, Anda dapat mengunduh Galeri WinUI 3 dan Galeri WinUI 2 dari Microsoft Store.

Anda juga bisa mendapatkan kode sumber untuk keduanya dari GitHub (gunakan cabang utama untuk WinUI 3 dan cabang winui2 untuk WinUI 2).

Keterangan

Bahan backdrop adalah Material yang dibuat dari sumber piksel yang diambil dari area di belakang konten XAML.

Kelas BackdropMaterial memungkinkan Anda menerapkan bahan backdrop, Mica, ke target komposisi aplikasi Anda. Ini secara otomatis mendukung perubahan tema, versi tingkat bawah, dan status perangkat, dengan mengatur sikat XAML berwarna netral bila perlu.

Hati

Saat Anda menerapkan materi backdrop, jangan juga mengatur properti Background pada konten UI. Latar belakang harus transparan sehingga bahan latar belakang menunjukkan melalui.

Properti terlampir XAML

BackdropMaterial adalah kelas layanan host untuk properti terpasang XAML ApplyToRootOrPageBackground.

Untuk mendukung akses prosesor XAML ke properti terlampir, dan juga untuk mengekspos yang setara mendapatkan dan mengatur operasi ke kode, setiap properti terpasang XAML memiliki sepasang metode aksesor Get and Set. Cara lain untuk mendapatkan atau mengatur nilai dalam kode adalah dengan menggunakan sistem properti dependensi, memanggil GetValue atau SetValue dan melewati bidang pengidentifikasi sebagai pengidentifikasi properti dependensi.

Properti terlampir Deskripsi
ApplyToRootOrPageBackground Menerapkan materi backdrop ke akar atau latar belakang konten XAML. Properti ApplyToRootOrPageBackground adalah nilai Boolean yang menunjukkan apakah materi backdrop diterapkan.

Properti

ApplyToRootOrPageBackgroundProperty

Mengidentifikasi properti terlampir XAML BackdropMaterial.ApplyToRootOrPageBackground.

Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI diSDK Aplikasi Windows , lihat namespace Windows App SDK).

Properti yang Terlampir

ApplyToRootOrPageBackground

Menerapkan materi backdrop ke akar atau latar belakang konten XAML.

Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI diSDK Aplikasi Windows , lihat namespace Windows App SDK).

Metode

GetApplyToRootOrPageBackground(Control)

Mendapatkan nilai properti terlampir XAML BackdropMaterial.ApplyToRootOrPageBackground untuk elemen target.

Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI diSDK Aplikasi Windows , lihat namespace Windows App SDK).

SetApplyToRootOrPageBackground(Control, Boolean)

Mengatur nilai properti terlampir XAML BackdropMaterial.ApplyToRootOrPageBackground untuk elemen target.

Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI diSDK Aplikasi Windows , lihat namespace Windows App SDK).

Berlaku untuk

Lihat juga