BackdropMaterial Klasse

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Hilfsklasse, um ein Hintergrundmaterial auf den Stamm des XAML-Inhalts anzuwenden.

Diese Dokumentation bezieht sich auf WinUI 2 für UWP- (für WinUI- im Windows App SDK-finden Sie unter den Windows App SDK-Namespaces).

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>

Vererbung

DependencyObject

BackdropMaterial

Attribute

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

Beispiele

Trinkgeld

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Mica.

Die WinUI 3 Gallery und WinUI 2 Gallery Apps enthalten interaktive Beispiele für die meisten WinUI 3- und WinUI 2-Steuerelemente, -Features und -Funktionen.

Falls bereits installiert, öffnen Sie sie, indem Sie auf die folgenden Links klicken: WinUI 3 Gallery oder WinUI 2 Gallery.

Wenn sie nicht installiert sind, können Sie die WinUI 3 Gallery und den WinUI 2 Gallery aus dem Microsoft Store herunterladen.

Sie können sowohl den Quellcode für GitHub- abrufen (verwenden Sie die Haupt- Branch für WinUI 3 und den winui2- Branch für WinUI 2).

Hinweise

Ein Hintergrundmaterial ist ein Material aus einer Quelle von Pixeln erstellt, die aus einem Bereich hinter dem XAML-Inhalt stammen.

Mit der BackdropMaterial-Klasse können Sie ein Hintergrundmaterial Micaauf das Kompositionsziel Ihrer Anwendung anwenden. Es unterstützt automatisch Designänderungen, Versionen auf unterer Ebene und Gerätezustand, indem bei Bedarf ein neutralfarbiger XAML-Pinsel festgelegt wird.

Vorsicht

Wenn Sie das Hintergrundmaterial anwenden, legen Sie nicht auch die Background-Eigenschaft auf den UI-Inhalt fest. Der Hintergrund muss transparent sein, damit das Hintergrundmaterial durchscheint.

Angefügte XAML-Eigenschaften

BackdropMaterial ist die Hostdienstklasse für die ApplyToRootOrPageBackgroundangefügte XAML-Eigenschaft.

Um den XAML-Prozessorzugriff auf die angefügten Eigenschaften zu unterstützen und auch entsprechende abrufen und Vorgänge auf Code festlegen, verfügt jede angefügte XAML-Eigenschaft über ein Paar Get- und Set-Accessormethoden. Eine weitere Möglichkeit zum Abrufen oder Festlegen des Werts im Code besteht darin, das Abhängigkeitseigenschaftensystem zu verwenden, indem entweder GetValue- oder SetValue- aufgerufen und das Bezeichnerfeld als Abhängigkeitseigenschaftsbezeichner übergeben wird.

Angefügte Eigenschaft

Beschreibung

ApplyToRootOrPageBackground

Wendet das Hintergrundmaterial auf den Stamm- oder Hintergrund des XAML-Inhalts an. Typ: Bool Bezeichnerfeld: ApplyToRootOrPageBackgroundProperty Accessor-Methoden: GetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control), SetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control,System.Boolean) Die ApplyToRootOrPageBackground-Eigenschaft ist ein boolescher Wert, der angibt, ob das Hintergrundmaterial angewendet wird.

Eigenschaften

ApplyToRootOrPageBackgroundProperty

Identifies the BackdropMaterial.ApplyToRootOrPageBackground XAML attached property. Diese Dokumentation bezieht sich auf WinUI 2 für UWP- (für WinUI- im Windows App SDK-finden Sie unter den Windows App SDK-Namespaces).

Angefügte Eigenschaften

ApplyToRootOrPageBackground

Wendet das Hintergrundmaterial auf den Stamm- oder Hintergrund des XAML-Inhalts an. Diese Dokumentation bezieht sich auf WinUI 2 für UWP- (für WinUI- im Windows App SDK-finden Sie unter den Windows App SDK-Namespaces).

Methoden

GetApplyToRootOrPageBackground(Control)	Ruft den Wert der angefügten BackdropMaterial.ApplyToRootOrPageBackground XAML-Eigenschaft für das Zielelement ab. Diese Dokumentation bezieht sich auf WinUI 2 für UWP- (für WinUI- im Windows App SDK-finden Sie unter den Windows App SDK-Namespaces).
SetApplyToRootOrPageBackground(Control, Boolean)	Legt den Wert der angefügten XAML-Eigenschaft BackdropMaterial.ApplyToRootOrPageBackground für ein Zielelement fest. Diese Dokumentation bezieht sich auf WinUI 2 für UWP- (für WinUI- im Windows App SDK-finden Sie unter den Windows App SDK-Namespaces).

Weitere Informationen

• Mica