BackdropMaterial Clase

Definición

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

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

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
BackdropMaterial
Atributos
Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Ejemplos

Sugerencia

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

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

Si ya se instalaron, haga clic en los vínculos siguientes para abrirlas: WinUI 3 Gallery o WinUI 2 Gallery.

Si no están instaladas, puede descargar WinUI 3 Gallery y WinUI 2 Gallery desde Microsoft Store.

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

Comentarios

Un material de fondo es un material creado a partir de un origen de píxeles tomado de un área detrás del contenido XAML.

La BackdropMaterial clase 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.

Precaución

Al aplicar el material de fondo, no establezca también la Background propiedad 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 ApplyToRootOrPageBackgroundpropiedad adjunta XAML.

Para admitir el acceso del procesador XAML a las propiedades adjuntas y también para exponer operaciones de obtención y establecimiento equivalentes en el 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, llamar a GetValue o SetValue y pasar el campo 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. La ApplyToRootOrPageBackground propiedad es un valor booleano que indica si se aplica el material de fondo.

Propiedades

ApplyToRootOrPageBackgroundProperty

Identifica la BackdropMaterial.ApplyToRootOrPageBackground propiedad adjunta XAML.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

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 UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Métodos

GetApplyToRootOrPageBackground(Control)

Obtiene el valor de la BackdropMaterial.ApplyToRootOrPageBackground propiedad adjunta XAML para el elemento de destino.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

SetApplyToRootOrPageBackground(Control, Boolean)

Establece el valor de la BackdropMaterial.ApplyToRootOrPageBackground propiedad adjunta XAML para un elemento de destino.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Se aplica a

Consulte también