ISystemBackdropControllerWithTargets Interface

Definição

Namespace:

Microsoft.UI.Composition.SystemBackdrops

Estende a interface ISystemBackdropController com a capacidade de gerenciar destinos de cenário do sistema, sua configuração e alterações de estado.

public interface class ISystemBackdropControllerWithTargets : ISystemBackdropController, IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65537)]
/// [Windows.Foundation.Metadata.Guid(2622946940, 39147, 24457, 173, 151, 218, 213, 127, 195, 12, 140)]
struct ISystemBackdropControllerWithTargets : ISystemBackdropController, IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65537)]
[Windows.Foundation.Metadata.Guid(2622946940, 39147, 24457, 173, 151, 218, 213, 127, 195, 12, 140)]
public interface ISystemBackdropControllerWithTargets : ISystemBackdropController, System.IDisposable

Public Interface ISystemBackdropControllerWithTargets
Implements IDisposable, ISystemBackdropController

Derivado

Microsoft.UI.Composition.SystemBackdrops.DesktopAcrylicController

Microsoft.UI.Composition.SystemBackdrops.MicaController

Atributos

ContractVersionAttribute GuidAttribute

Implementações

ISystemBackdropController IClosable IDisposable

Comentários

Um pano de fundo do sistema é essencialmente um CompositionBrush que define um material de interface do usuário , como Acrílico ou Mica. Esse pincel é desenhado pelo compositor do sistema. Um controlador de cenário do sistema é um objeto que encapsula a renderização do material de pano de fundo do sistema, bem como a manipulação da política do sistema para o material fornecido. Cada material tem seu próprio controlador.

A ISystemBackdropControllerWithTargets interface fornece um controle mais granular dos destinos ICompositionSupportsSystemBackdrop . Os destinos podem ser adicionados e removidos a qualquer momento. Todos os destinos devem compartilhar o mesmo Compositor. Adicionar um destino que espera um diferente Compositor fará com que uma exceção de argumento inválida seja gerada e o novo destino não será adicionado.

A interface ISystemBackdropController não fornece um mecanismo para que você forneça informações de política material específicas do aplicativo e, em vez disso, requer o objeto da janela do aplicativo. Por outro lado, a ISystemBackdropControllerWithTargets interface requer um objeto SystemBackdropConfiguration que permite especificar sua própria política de material específica do aplicativo.

Um controlador de cenário do sistema só renderizará um material se tiver sido fornecido um SystemBackdropConfiguration objeto junto com pelo menos um destino. Caso contrário, ele não renderizará nada. Remover um destino fará com que ele pare de renderizar o material. Remover todos os destinos desabilitará o controlador até que pelo menos um destino seja adicionado.

Propriedades

State

Obtém o estado atual do controlador de cenário do sistema.

Métodos

AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	Adiciona o destino de pano de fundo do sistema especificado no qual desenhar o material.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.
RemoveAllSystemBackdropTargets()	Remove todos os destinos em segundo plano do sistema.
RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	Remove o destino em segundo plano do sistema especificado.
SetSystemBackdropConfiguration(SystemBackdropConfiguration)	Define as políticas específicas do aplicativo a serem aplicadas ao controlador de cenário do sistema.
SetTarget(CoreWindow, CompositionTarget)	Conecta um controlador de cenário do sistema ao especificado CoreWindow. (Herdado de ISystemBackdropController)
SetTarget(WindowId, CompositionTarget)	Conecta um controlador de cenário do sistema a um HWND ou AppWindow com o WindowId especificado. (Herdado de ISystemBackdropController)

Eventos

StateChanged

Ocorre quando o estado do cenário do sistema foi alterado.