ISystemBackdropController Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.IDisposablePublic Interface ISystemBackdropController
Implements IDisposable- Derivado
- Atributos
- Implementaciones
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 |
| SetTarget(WindowId, CompositionTarget) |
Conecta un controlador de fondo del sistema a o |