ISystemBackdropControllerWithTargets Schnittstelle

Referenz

Definition

Namespace:: Microsoft.UI.Composition.SystemBackdrops

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Erweitert die ISystemBackdropController-Schnittstelle um die Möglichkeit, Systemhintergrundziele, deren Konfiguration und Zustandsänderungen zu verwalten.

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

Abgeleitet: Microsoft.UI.Composition.SystemBackdrops.DesktopAcrylicController

Microsoft.UI.Composition.SystemBackdrops.MicaController

Attribute: ContractVersionAttribute GuidAttribute

Implementiert: ISystemBackdropController IClosable IDisposable

Hinweise

Ein Systemhintergrund ist im Wesentlichen ein CompositionBrush , der ein Ui-Material wie Acryl oder Mica definiert. Dieser Pinsel wird vom Systemkompositor gezeichnet. Ein Systemhintergrundcontroller ist ein Objekt, das sowohl das Rendern des Systemhintergrundmaterials als auch die Behandlung der Systemrichtlinie für das angegebene Material kapselt. Jedes Material verfügt über einen eigenen Controller.

Die ISystemBackdropControllerWithTargets Schnittstelle bietet eine präzisere Steuerung der ICompositionSupportsSystemBackdrop-Ziele . Ziele können jederzeit hinzugefügt und entfernt werden. Alle Ziele müssen denselben Compositor verwenden. Das Hinzufügen eines Ziels, das eine andere Compositor erwartet, führt dazu, dass eine Ungültige Argument-Ausnahme ausgelöst wird, und das neue Ziel wird nicht hinzugefügt.

Die ISystemBackdropController-Schnittstelle bietet keinen Mechanismus zum Bereitstellen appspezifischer Materialrichtlinieninformationen und erfordert stattdessen das Anwendungsfensterobjekt. Im Gegensatz dazu erfordert die ISystemBackdropControllerWithTargets -Schnittstelle ein SystemBackdropConfiguration-Objekt , mit dem Sie Ihre eigene app-spezifische Materialrichtlinie angeben können.

Ein Systemhintergrundcontroller rendert ein Material nur, wenn ein SystemBackdropConfiguration -Objekt zusammen mit mindestens einem Ziel bereitgestellt wurde. Andernfalls wird nichts gerendert. Wenn Sie ein Ziel entfernen, wird das Rendern des Materials beendet. Wenn Sie alle Ziele entfernen, wird der Controller deaktiviert, bis mindestens ein Ziel hinzugefügt wird.

Eigenschaften

State

Ruft den aktuellen Zustand des Systemhintergrundcontrollers ab.

Methoden

AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	Fügt das angegebene Systemhintergrundziel hinzu, auf dem das Material gezeichnet werden soll.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
RemoveAllSystemBackdropTargets()	Entfernt alle Systemhintergrundziele.
RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	Entfernt das angegebene Systemhintergrundziel.
SetSystemBackdropConfiguration(SystemBackdropConfiguration)	Legt die app-spezifischen Richtlinien fest, die auf den Systemhintergrundcontroller angewendet werden sollen.
SetTarget(CoreWindow, CompositionTarget)	Verbindet einen Systemhintergrundcontroller mit dem angegebenen `CoreWindow`. (Geerbt von ISystemBackdropController)
SetTarget(WindowId, CompositionTarget)	Verbindet einen Systemhintergrundcontroller mit einem `HWND` oder `AppWindow` mit der angegebenen WindowId. (Geerbt von ISystemBackdropController)

Ereignisse

StateChanged

Tritt auf, wenn sich der Zustand des Systemhintergrunds geändert hat.

Gilt für:

Freigeben über