ISystemBackdropControllerWithTargets Interfaz

Definición

Espacio de nombres:

Microsoft.UI.Composition.SystemBackdrops

Extiende la interfaz ISystemBackdropController con la capacidad de administrar destinos de fondo del sistema, su configuración y cambios 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

Implementaciones

ISystemBackdropController IClosable IDisposable

Comentarios

Un fondo del sistema es básicamente un CompositionBrush que define un material de interfaz de usuario como Acrylic o Mica. El compositor del sistema dibuja este pincel. Un controlador de fondo del sistema es un objeto que encapsula tanto la representación del material de fondo del sistema como el manejo de la directiva del sistema para el material dado. Cada material tiene su propio controlador.

La ISystemBackdropControllerWithTargets interfaz proporciona un control más granular de los destinos ICompositionSupportsSystemBackdrop . Los destinos se pueden agregar y quitar en cualquier momento. Todos los destinos deben compartir el mismo compositor. Si se agrega un destino que espera otro Compositor , se producirá una excepción de argumento no válida y no se agregará el nuevo destino.

La interfaz ISystemBackdropController no proporciona un mecanismo para proporcionar información de directiva de material específica de la aplicación y, en su lugar, requiere el objeto de ventana de la aplicación. En cambio, la ISystemBackdropControllerWithTargets interfaz requiere un objeto SystemBackdropConfiguration que le permite especificar su propia directiva de material específica de la aplicación.

Un controlador de fondo del sistema solo representará un material si se ha proporcionado un SystemBackdropConfiguration objeto junto con al menos un destino. Si no es así, no representará nada. Quitar un destino hará que deje de representar el material. Al quitar todos los destinos, se deshabilitará el controlador hasta que se agregue al menos un destino.

Propiedades

State

Obtiene el estado actual del controlador de fondo del sistema.

Métodos

AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	Agrega el destino de fondo del sistema especificado en el que dibujar el material.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.
RemoveAllSystemBackdropTargets()	Quita todos los destinos en segundo plano del sistema.
RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	Quita el destino de fondo del sistema especificado.
SetSystemBackdropConfiguration(SystemBackdropConfiguration)	Establece las directivas específicas de la aplicación que se aplicarán al controlador de fondo del sistema.
SetTarget(CoreWindow, CompositionTarget)	Conecta un controlador de fondo del sistema al especificado CoreWindow. (Heredado de ISystemBackdropController)
SetTarget(WindowId, CompositionTarget)	Conecta un controlador de fondo del sistema a o HWNDAppWindow con el WindowId especificado. (Heredado de ISystemBackdropController)

Eventos

StateChanged

Se produce cuando el estado del fondo del sistema ha cambiado.