BackdropMaterial Classe

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml.Controls
Modifica

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

Questa documentazione si applica a WinUI 2 per UWP (per WinUI in Windows App SDK, vedere gli spazi dei nomi di 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>
Ereditarietà
DependencyObject
BackdropMaterial
Attributi
Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Esempio

Mancia

Per altre info, indicazioni sulla progettazione ed esempi di codice, vedi Mica.

Le della raccolta winUI 3 e raccolta winUI 2 includono esempi interattivi della maggior parte dei controlli, delle funzionalità e delle funzionalità di WinUI 3 e WinUI 2.

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

Se non sono installati, è possibile scaricare il winUI 3 Gallery e il winUI 2 Gallery da Microsoft Store.

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

Commenti

Un materiale di sfondo è un Material creato da un'origine di pixel ricavata da un'area dietro il contenuto XAML.

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

Cautela

Quando si applica il materiale di sfondo, non impostare anche la proprietà Background sul contenuto dell'interfaccia utente. Lo sfondo deve essere trasparente in modo che il materiale di sfondo venga mostrato attraverso.

Proprietà associate XAML

BackdropMaterial è la classe del servizio host per la proprietà associata XAML ApplyToRootOrPageBackground.

Per supportare l'accesso al processore XAML alle proprietà associate e anche per esporre equivalenti ottenere e impostare operazioni sul codice, ogni proprietà associata XAML ha una coppia di metodi della funzione di accesso Get e Set. Un altro modo per ottenere o impostare il valore nel codice consiste nell'usare il sistema di 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. La proprietà ApplyToRootOrPageBackground è un valore booleano che indica se viene applicato il materiale di sfondo.

Proprietà

ApplyToRootOrPageBackgroundProperty

Identifica il BackdropMaterial.ApplyToRootOrPageBackground proprietà associata XAML.

Questa documentazione si applica a WinUI 2 per UWP (per WinUI in Windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).

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 in Windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).

Metodi

GetApplyToRootOrPageBackground(Control)

Ottiene il valore della proprietà associata XAML BackdropMaterial.ApplyToRootOrPageBackground per l'elemento di destinazione.

Questa documentazione si applica a WinUI 2 per UWP (per WinUI in Windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).
SetApplyToRootOrPageBackground(Control, Boolean)

Imposta il valore della proprietà associata xaml BackdropMaterial.ApplyToRootOrPageBackground per un elemento di destinazione.

Questa documentazione si applica a WinUI 2 per UWP (per WinUI in Windows App SDK, vedere gli spazi dei nomi di Windows App SDK ).

Si applica a

Vedi anche