BackdropMaterial Classe

  • Referência

Definição

Namespace:
Microsoft.UI.Xaml.Controls
Editar

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 nodo SDK do Aplicativo do Windows , consulte os namespaces do 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

Ponta

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 WinUI 2 incluem exemplos interativos da maioria dos controles, recursos e funcionalidades do WinUI 3 e WinUI 2.

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

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

Você também pode obter o código-fonte de do GitHub (use a ramificação de principal do para WinUI 3 e a ramificação de do winui2 para WinUI 2).

Comentários

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

A classe BackdropMaterial permite aplicar um material de cenário, 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 propriedade Background no conteúdo da interface do usuário. A tela de fundo deve ser transparente para que o material do pano de fundo seja exibido.

Propriedades anexadas ao XAML

BackdropMaterial é a classe de serviço de host para a propriedade anexada ApplyToRootOrPageBackgroundXAML.

Para dar suporte ao acesso do processador XAML às propriedades anexadas e também para expor equivalentes obter e definir operações 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 de identificador como o identificador da 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 propriedade ApplyToRootOrPageBackground é um valor booliano que indica se o material do cenário é aplicado.

Propriedades

ApplyToRootOrPageBackgroundProperty

Identifica a propriedade anexada BackdropMaterial.ApplyToRootOrPageBackground XAML.

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

Métodos

GetApplyToRootOrPageBackground(Control)

Obtém o valor da propriedade anexada XAML BackdropMaterial.ApplyToRootOrPageBackground para o elemento de destino.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI nodo SDK do Aplicativo do Windows , consulte os namespaces do SDK do aplicativo Windows).
SetApplyToRootOrPageBackground(Control, Boolean)

Define o valor da propriedade anexada XAML BackdropMaterial.ApplyToRootOrPageBackground para um elemento de destino.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI nodo SDK do Aplicativo do Windows , consulte os namespaces do SDK do aplicativo Windows).

Aplica-se a

Confira também