BackdropMaterial Clase

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

Clase auxiliar para aplicar un material de fondo a la raíz del contenido XAML.

Esta documentación se aplica a WinUI 2 para para UWP (para WinUI en lade Windows App SDK de , consulta los espacios de nombres de 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>

Herencia

DependencyObject

BackdropMaterial

Atributos

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

Ejemplos

Propina

Para obtener más información, instrucciones de diseño y ejemplos de código, consulte Mica.

Las de la Galería de WinUI 3 de y galería de WinUI 2 incluyen ejemplos interactivos de la mayoría de los controles, características y funcionalidades de WinUI 3 y WinUI 2.

Si ya está instalado, ábralos haciendo clic en los vínculos siguientes: Galería de WinUI 3 o Galería de WinUI 2.

Si no están instalados, puedes descargar el galería de WinUI 3 y la galería de WinUI 2 de desde Microsoft Store.

También puede obtener el código fuente de de GitHub (use la rama principal de para WinUI 3 y la rama winui2 para WinUI 2).

Comentarios

Un material de fondo es un Material creado a partir de una fuente de píxeles tomados de un área detrás del contenido XAML.

La clase BackdropMaterial le permite aplicar un material de fondo, Mica, al destino de composición de la aplicación. Admite automáticamente los cambios de tema, las versiones de nivel descendente y el estado del dispositivo estableciendo un pincel XAML de color neutro cuando sea necesario.

Cautela

Al aplicar el material de fondo, no establezca también la propiedad Background en el contenido de la interfaz de usuario. El fondo debe ser transparente para que el material de fondo se muestre.

Propiedades adjuntas xaml

BackdropMaterial es la clase de servicio host para la propiedad adjunta XAML ApplyToRootOrPageBackground.

Para admitir el acceso del procesador XAML a las propiedades adjuntas y también para exponer equivalentes obtener y establecer operaciones de en código, cada propiedad adjunta XAML tiene un par de métodos de descriptor de acceso Get y Set. Otra manera de obtener o establecer el valor en el código es usar el sistema de propiedades de dependencia, llamando a GetValue o SetValue y pasando el campo de identificador como identificador de propiedad de dependencia.

Propiedad adjunta

Descripción

ApplyToRootOrPageBackground

Aplica el material de fondo a la raíz o el fondo del contenido XAML. Tipo: Bool Campo identificador: ApplyToRootOrPageBackgroundProperty Métodos de descriptor de acceso: GetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control), SetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control,System.Boolean) La propiedad ApplyToRootOrPageBackground es un valor booleano que indica si se aplica el material de fondo.

Propiedades

ApplyToRootOrPageBackgroundProperty

Identifica la propiedad adjunta XAML BackdropMaterial.ApplyToRootOrPageBackground. Esta documentación se aplica a WinUI 2 para para UWP (para WinUI en lade Windows App SDK de , consulta los espacios de nombres de Windows App SDK ).

Propiedades adjuntas

ApplyToRootOrPageBackground

Aplica el material de fondo a la raíz o el fondo del contenido XAML. Esta documentación se aplica a WinUI 2 para para UWP (para WinUI en lade Windows App SDK de , consulta los espacios de nombres de Windows App SDK ).

Métodos

GetApplyToRootOrPageBackground(Control)	Obtiene el valor de la propiedad adjunta XAML BackdropMaterial.ApplyToRootOrPageBackground para el elemento de destino. Esta documentación se aplica a WinUI 2 para para UWP (para WinUI en lade Windows App SDK de , consulta los espacios de nombres de Windows App SDK ).
SetApplyToRootOrPageBackground(Control, Boolean)	Establece el valor de la propiedad adjunta XAML BackdropMaterial.ApplyToRootOrPageBackground para un elemento de destino. Esta documentación se aplica a WinUI 2 para para UWP (para WinUI en lade Windows App SDK de , consulta los espacios de nombres de Windows App SDK ).

Consulte también

• Mica