BackdropMaterial Klasse

Definition

Namespace:

Microsoft.UI.Xaml.Controls

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

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe 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

Tipp

Weitere Informationen, Entwurfsleitfäden und Codebeispiele finden Sie unter Mica.

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

Wenn sie bereits installiert sind, öffnen Sie sie, indem Sie auf die folgenden Links klicken: WinUI 3-Katalog oder WinUI 2-Katalog.

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

Sie können auch den Quellcode für beide von GitHub abrufen (verwenden Sie denmain-Branch für WinUI 3 und den Branchwinui2 für WinUI 2).

Hinweise

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

Mit BackdropMaterial der -Klasse können Sie ein Hintergrundmaterial( Mica) auf das Kompositionsziel Ihrer Anwendung anwenden. Designänderungen, Downlevelversionen und Gerätestatus werden automatisch unterstützt, indem bei Bedarf ein neutraler XAML-Pinsel festgelegt wird.

Achtung

Wenn Sie das Hintergrundmaterial anwenden, legen Sie nicht auch die Background Eigenschaft auf dem Ui-Inhalt fest. Der Hintergrund muss transparent sein, damit sich das Hintergrundmaterial durchschaut.

XAML angefügte 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 äquivalente Get - und Set-Vorgänge für Code verfügbar zu machen, verfügt jede angefügte XAML-Eigenschaft über ein Paar von Get- und Set-Accessormethoden. Eine andere Möglichkeit zum Abrufen oder Festlegen des Werts im Code besteht darin, das Abhängigkeitseigenschaftssystem zu verwenden, entweder GetValue oder SetValue aufzurufen und das Bezeichnerfeld als Abhängigkeitseigenschaftsbezeichner zu übergeben.

Angefügte Eigenschaft

Beschreibung

ApplyToRootOrPageBackground

Wendet das Hintergrundmaterial auf den Stamm oder Hintergrund des XAML-Inhalts an. Typ: Bool Bezeichnerfeld: ApplyToRootOrPageBackgroundProperty Accessormethoden: 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

Gibt die BackdropMaterial.ApplyToRootOrPageBackground angefügte XAML-Eigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

Angefügte Eigenschaften

ApplyToRootOrPageBackground

Wendet das Hintergrundmaterial auf den Stamm oder Hintergrund des XAML-Inhalts an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

Methoden

GetApplyToRootOrPageBackground(Control)	Ruft den Wert der BackdropMaterial.ApplyToRootOrPageBackground angefügten XAML-Eigenschaft für das Zielelement ab. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
SetApplyToRootOrPageBackground(Control, Boolean)	Legt den Wert der BackdropMaterial.ApplyToRootOrPageBackground angefügten XAML-Eigenschaft für ein Zielelement fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

Weitere Informationen

• Mica