ISystemBackdropController Interface

Definição

Namespace:

Microsoft.UI.Composition.SystemBackdrops

Fornece métodos para conectar um controlador de cenário do sistema a uma janela.

public interface class ISystemBackdropController : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1446172524, 2932, 23378, 170, 51, 128, 38, 32, 104, 174, 178)]
struct ISystemBackdropController : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.Guid(1446172524, 2932, 23378, 170, 51, 128, 38, 32, 104, 174, 178)]
public interface ISystemBackdropController : System.IDisposable

Public Interface ISystemBackdropController
Implements IDisposable

Derivado

Microsoft.UI.Composition.SystemBackdrops.DesktopAcrylicController

Microsoft.UI.Composition.SystemBackdrops.ISystemBackdropControllerWithTargets

Microsoft.UI.Composition.SystemBackdrops.MicaController

Atributos

ContractVersionAttribute GuidAttribute

Implementações

IClosable IDisposable

Exemplos

Este exemplo mostra como desenhar o novo material do Windows 11 Mica em uma janela do aplicativo Win32 usando C++/WinRT.

bool SetupBackdrop(winrt::Microsoft::UI::WindowId windowId, winrt::Windows::UI::Composition::CompositionTarget compositionTarget)
{
    winrt::Microsoft::UI::Composition::SystemBackdrops::MicaController micaController = winrt::MicaController();
    return micaController.SetTarget(windowId, compositionTarget);
}

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 tanto a renderização do material de pano de fundo do sistema quanto a manipulação da política do sistema para o material fornecido. Cada material tem seu próprio controlador.

Você pode desenhar um material na parte de trás do conteúdo criando o correspondente ISystemBackdropController e fornecendo sua janela e CompositionTarget para o método SetTarget do controlador. Se SetTarget for bem-sucedido e retornar true, o controlador cuidará de toda a manipulação de material, incluindo a renderização de fallback e todas as políticas do sistema. Se SetTarget falhar e retornar false, isso significa que o controlador não pôde configurar o material desejado como um pano de fundo do sistema e nenhuma alteração foi feita no CompositionTarget.

Os materiais são desenhados usando as APIs Windows.UI.Composition , portanto, um CompositionTarget é necessário no qual o material será desenhado na parte de trás do restante do conteúdo do aplicativo. Qualquer conteúdo de aplicativo que tenha transparência será exibido no material escolhido.

Métodos

Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.
SetTarget(CoreWindow, CompositionTarget)	Conecta um controlador de cenário do sistema ao especificado CoreWindow.
SetTarget(WindowId, CompositionTarget)	Conecta um controlador de cenário do sistema a um HWND ou AppWindow com o WindowId especificado.