BackdropMaterial Classe

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Classe Helper per applicare un materiale di sfondo alla radice del contenuto XAML.

Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di 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>

Ereditarietà

DependencyObject

BackdropMaterial

Attributi

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

Esempio

Suggerimento

Per altre informazioni, indicazioni sulla progettazione ed esempi di codice, vedere Mica.

Le app WinUI 3 Gallery e WinUI 2 Gallery includono esempi interattivi della maggior parte dei controlli WinUI 3 e WinUI 2, delle funzionalità e delle funzionalità.

Se è già installato, aprirli facendo clic sui collegamenti seguenti: WinUI 3 Gallery o WinUI 2 Gallery.

Se non sono installati, è possibile scaricare la raccolta WinUI 3 e la raccolta WinUI 2 da Microsoft Store.

È anche possibile ottenere il codice sorgente per GitHub (usare il ramo principale per WinUI 3 e il ramo winui2 per WinUI 2).

Commenti

Un materiale di sfondo è un materiale creato da una fonte di pixel ricavati da un'area dietro il contenuto XAML.

La BackdropMaterial classe consente di applicare un materiale di sfondo, Mica, alla destinazione di composizione dell'applicazione. Supporta automaticamente le modifiche dei temi, le versioni a livello inferiore e lo stato del dispositivo impostando un pennello XAML a colori neutrali quando necessario.

Attenzione

Quando si applica il materiale di sfondo, non impostare anche la Background proprietà sul contenuto dell'interfaccia utente. Lo sfondo deve essere trasparente, quindi il materiale dello sfondo mostra attraverso.

Proprietà associate XAML

BackdropMaterial è la classe di servizio host per la ApplyToRootOrPageBackgroundproprietà associata XAML.

Per supportare l'accesso al processore XAML alle proprietà associate e anche per esporre operazioni di get e set equivalenti al codice, ogni proprietà associata XAML ha una coppia di metodi di accesso Get e Set. Un altro modo per ottenere o impostare il valore nel codice consiste nell'usare il sistema delle proprietà di dipendenza, chiamando GetValue o SetValue e passando il campo identificatore come identificatore della proprietà di dipendenza.

Proprietà associata

Descrizione

ApplyToRootOrPageBackground

Applica il materiale di sfondo alla radice o allo sfondo del contenuto XAML. Tipo: Bool Campo Identificatore: ApplyToRootOrPageBackgroundProperty Metodi di accesso: GetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control), SetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control,System.Boolean) La ApplyToRootOrPageBackground proprietà è un valore booleano che indica se viene applicato il materiale di sfondo.

Proprietà

ApplyToRootOrPageBackgroundProperty

Identifica la BackdropMaterial.ApplyToRootOrPageBackground proprietà associata XAML. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

Proprietà associate

ApplyToRootOrPageBackground

Applica il materiale di sfondo alla radice o allo sfondo del contenuto XAML. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

Metodi

GetApplyToRootOrPageBackground(Control)	Ottiene il valore della BackdropMaterial.ApplyToRootOrPageBackground proprietà associata XAML per l'elemento di destinazione. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
SetApplyToRootOrPageBackground(Control, Boolean)	Imposta il valore della BackdropMaterial.ApplyToRootOrPageBackground proprietà associata XAML per un elemento di destinazione. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

Vedi anche

• Mica