ISystemBackdropController Interfaz

Definición

Espacio de nombres:

Microsoft.UI.Composition.SystemBackdrops

Proporciona métodos para conectar un controlador de fondo del sistema a una ventana.

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

Implementaciones

IClosable IDisposable

Ejemplos

En este ejemplo se muestra cómo dibujar el nuevo material de Windows 11 Mica en una ventana de la aplicación Win32 mediante 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);
}

Comentarios

Un fondo del sistema es esencialmente un CompositionBrush que define un material de interfaz de usuario como Acrylic o Mica. Este pincel lo dibuja el compositor del sistema. Un controlador de fondo del sistema es un objeto que encapsula tanto la representación del material de fondo del sistema como el control de la directiva del sistema para el material dado. Cada material tiene su propio controlador.

Puede dibujar un material en la parte posterior del contenido creando el correspondiente ISystemBackdropController y proporcionando la ventana y CompositionTarget al método SetTarget del controlador. Si SetTarget se ejecuta correctamente y devuelve true, el controlador se encarga de todo el control de materiales, incluida la representación de reserva y todas las directivas del sistema. Si SetTarget se produce un error y devuelve false, significa que el controlador no pudo configurar el material deseado como fondo del sistema y no se han realizado cambios en .CompositionTarget

Los materiales se dibujan mediante las API Windows.UI.Composition , por lo que se requiere compositionTarget en el que el material se dibujará en el fondo detrás del resto del contenido de la aplicación. Cualquier contenido de la aplicación que tenga transparencia se mostrará a través del material elegido.

Métodos

Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.
SetTarget(CoreWindow, CompositionTarget)	Conecta un controlador de fondo del sistema al especificado CoreWindow.
SetTarget(WindowId, CompositionTarget)	Conecta un controlador de fondo del sistema a o HWNDAppWindow con el WindowId especificado.