SystemBackdrop Classe

Definição

public ref class SystemBackdrop : DependencyObject

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SystemBackdrop : DependencyObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class SystemBackdrop : DependencyObject

Public Class SystemBackdrop
Inherits DependencyObject

Herança

Object Platform::Object IInspectable DependencyObject SystemBackdrop

Derivado

Microsoft.UI.Xaml.Media.DesktopAcrylicBackdrop

Microsoft.UI.Xaml.Media.MicaBackdrop

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemplos

Este exemplo mostra uma classe de pano de fundo do sistema personalizada implementada usando MicaController.

Chamar o método base OnTargetConnected inicializa o objeto de configuração padrão retornado por GetDefaultSystemBackdropConfiguration para refletir as alterações de ambiente que afetam essa SystemBackdrop instância (especificada por connectedTarget, XamlRoot).

Embora o exemplo nesta página não dê suporte a instâncias de compartilhamento MicaSystemBackdrop (por exemplo, Window1.SystemBackdrop = Window2.SystemBackdrop = myMicaSystemBackdrop), esse compartilhamento é possível e é compatível com os MicaBackdrop materiais internos e DesktopAcrylicBackdrop . Para implementar o compartilhamento em um material personalizado, vetorize o armazenamento ISystemBackdropController de suporte para manter uma instância separada para cada contexto de uso (por exemplo, por meio de um mapa com chave no connectedTarget). Observe que SystemBackdrop , da mesma forma, vetoriza os objetos de configuração padrão associados retornados por GetDefaultSystemBackdropConfiguration, garantindo que a configuração reflita cada contexto de uso quando SystemBackdrop é compartilhada.

<Window
    ... >
    <Window.SystemBackdrop>
        <local:MicaSystemBackdrop/>
    </Window.SystemBackdrop>

    <!-- XAML content -->

</Window>

public class MicaSystemBackdrop : SystemBackdrop
{
    MicaController micaController;

    protected override void OnTargetConnected(ICompositionSupportsSystemBackdrop connectedTarget, XamlRoot xamlRoot)
    {
        // Call the base method to initialize the default configuration object.
        base.OnTargetConnected(connectedTarget, xamlRoot);

        // This example does not support sharing MicaSystemBackdrop instances.
        if (micaController is not null)
        {
            throw new Exception("This controller cannot be shared");
        }

        micaController = new MicaController();
        // Set configuration.
        SystemBackdropConfiguration defaultConfig = GetDefaultSystemBackdropConfiguration(connectedTarget, xamlRoot);
        micaController.SetSystemBackdropConfiguration(defaultConfig);
        // Add target.
        micaController.AddSystemBackdropTarget(connectedTarget);
    }

    protected override void OnTargetDisconnected(ICompositionSupportsSystemBackdrop disconnectedTarget)
    {
        base.OnTargetDisconnected(disconnectedTarget);

        micaController.RemoveSystemBackdropTarget(disconnectedTarget);
        micaController = null;
    }
}

Comentários

Use essa classe para criar um cenário de sistema personalizado. Você não cria essa classe diretamente (observe o construtor protegido). Em vez disso, subclasse-a para adicionar seu suporte personalizado. Você também pode usar uma das classes derivadas internas, MicaBackdrop e DesktopAcrylicBackdrop.

Geralmente, o material personalizado substitui OnTargetConnected para criar e configurar um ISystemBackdropController de suporte, que gerenciará o CompositionBrush usado para preencher a região de pano de fundo. A renderização de pixel final do pincel é afetada por:

• o ambiente/conjunto de políticas por meio de SystemBackdropConfiguration
• os parâmetros de aparência do material, expostos por meio de propriedades gerais como ISystemBackdropControllerWithTargets.State (Active/Fallback/HighContrast) e propriedades específicas do material, como MicaController.Kind ().Base/BaseAlt

Os controladores internos (MicaController e DesktopAcrylicController) dão suporte aos seguintes parâmetros para personalizar sua aparência: FallbackColor, LuminosityOpacity, TintColore TintOpacity. Os cenários internos do sistema (MicaBackdrop e DesktopAcrylicBackdrop) não expõem FallbackColor nem as propriedades de personalização de material (TintOpacityetc. Em vez disso, eles dependem das configurações padrão de Claro/Escuro do subjacente MicaController e DesktopAcrylicControllerdo . Para personalizar essas propriedades, crie uma classe de material personalizada que deriva SystemBackdrop de e exponha as propriedades desejadas.

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

• Material de Mica
• Material acrílico