BackdropMaterial Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
-
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 ApplyToRootOrPageBackground
angefü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.
ApplyToRootOrPageBackground Eigenschaft ist ein boolescher Wert, der angibt, ob das Hintergrundmaterial angewendet wird. |
Eigenschaften
ApplyToRootOrPageBackgroundProperty |
Gibt die 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 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 Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces). |
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für