BackdropMaterial Kelas

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Kelas pembantu untuk menerapkan materi latar belakang ke akar konten XAML.

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

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

DependencyObject

BackdropMaterial

Atribut

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Contoh

Tip

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

Aplikasi Galeri WinUI 3 dan Galeri WinUI 2 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 latar belakang adalah Bahan yang dibuat dari sumber piksel yang diambil dari area di belakang konten XAML.

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

Perhatian

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

Properti terlampir XAML

BackdropMaterial adalah kelas layanan host untuk ApplyToRootOrPageBackgroundproperti terlampir XAML.

Untuk mendukung akses prosesor XAML ke properti terlampir, dan juga untuk mengekspos operasi dapatkan dan atur yang setara ke kode, setiap properti terlampir 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 meneruskan bidang pengidentifikasi sebagai pengidentifikasi properti dependensi.

Properti terlampir

Deskripsi

ApplyToRootOrPageBackground

Menerapkan materi latar belakang ke akar atau latar belakang konten XAML. Jenis: Bool Bidang pengidentifikasi: ApplyToRootOrPageBackgroundProperty Metode aksesor: GetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control), SetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control,System.Boolean) Properti ApplyToRootOrPageBackground adalah nilai Boolean yang menunjukkan apakah bahan latar belakang diterapkan.

Properti

ApplyToRootOrPageBackgroundProperty

BackdropMaterial.ApplyToRootOrPageBackground Mengidentifikasi properti terlampir XAML. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Properti yang Terlampir

ApplyToRootOrPageBackground

Menerapkan materi latar belakang ke akar atau latar belakang konten XAML. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Metode

GetApplyToRootOrPageBackground(Control)	Mendapatkan nilai BackdropMaterial.ApplyToRootOrPageBackground properti terlampir XAML untuk elemen target. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
SetApplyToRootOrPageBackground(Control, Boolean)	Menetapkan nilai BackdropMaterial.ApplyToRootOrPageBackground properti terlampir XAML untuk elemen target. Dokumentasi ini berlaku untuk WinUI 2 untuk UWP (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Lihat juga

• Mika