BackdropMaterial Classe

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Classe auxiliar para aplicar um material de pano de fundo à raiz do conteúdo XAML.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo 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>

Herança

DependencyObject

BackdropMaterial

Atributos

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

Exemplos

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte Mica.

Os aplicativos da Galeria do WinUI 3 e da Galeria do WinUI 2 incluem exemplos interativos da maioria dos controles, recursos e funcionalidade do WinUI 3 e do WinUI 2.

Se já estiverem instalado, abra-os clicando nos seguintes links: Galeria do WinUI 3 ou Galeria do WinUI 2.

Se eles não estiverem instalados, você poderá baixar a Galeria do WinUI 3 e a Galeria do WinUI 2 da Microsoft Store.

Você também pode obter o código-fonte para ambos do GitHub (use o branch main para WinUI 3 e o branch winui2 para WinUI 2).

Comentários

Um material de pano de fundo é um Material criado a partir de uma fonte de pixels tirada de uma área por trás do conteúdo XAML.

A BackdropMaterial classe permite aplicar um material de pano de fundo, Mica, ao destino de composição do aplicativo. Ele dá suporte automaticamente a alterações de tema, versões de nível inferior e estado do dispositivo, definindo um pincel XAML de cor neutra quando necessário.

Cuidado

Ao aplicar o material de pano de fundo, não defina também a Background propriedade no conteúdo da interface do usuário. A tela de fundo deve ser transparente para que o material de pano de fundo seja exibido.

Propriedades anexadas XAML

BackdropMaterial é a classe de serviço host para a ApplyToRootOrPageBackgroundpropriedade anexada XAML.

Para dar suporte ao acesso do processador XAML às propriedades anexadas e também para expor operações equivalentes get e set ao código, cada propriedade anexada XAML tem um par de métodos de acessador Get e Set. Outra maneira de obter ou definir o valor no código é usar o sistema de propriedades de dependência, chamando GetValue ou SetValue e passando o campo identificador como o identificador de propriedade de dependência.

Propriedade anexada

Descrição

ApplyToRootOrPageBackground

Aplica o material de pano de fundo à raiz ou à tela de fundo do conteúdo XAML. Tipo: Bool Campo Identificador: ApplyToRootOrPageBackgroundProperty Métodos do acessador: GetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control), SetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control,System.Boolean) A ApplyToRootOrPageBackground propriedade é um valor booliano que indica se o material de pano de fundo é aplicado.

Propriedades

ApplyToRootOrPageBackgroundProperty

Identifica a BackdropMaterial.ApplyToRootOrPageBackground propriedade anexada XAML. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Propriedades Anexadas

ApplyToRootOrPageBackground

Aplica o material de pano de fundo à raiz ou à tela de fundo do conteúdo XAML. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Métodos

GetApplyToRootOrPageBackground(Control)	Obtém o valor da BackdropMaterial.ApplyToRootOrPageBackground propriedade anexada XAML para o elemento de destino. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
SetApplyToRootOrPageBackground(Control, Boolean)	Define o valor da BackdropMaterial.ApplyToRootOrPageBackground propriedade anexada XAML para um elemento de destino. Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Confira também

• Mica