ISystemBackdropControllerWithTargets Schnittstelle
Definition
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.
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.IDisposablePublic Interface ISystemBackdropControllerWithTargets
Implements IDisposable, ISystemBackdropController- Abgeleitet
- Attribute
- Implementiert
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 |
| SetTarget(WindowId, CompositionTarget) |
Verbindet einen Systemhintergrundcontroller mit einem |
Ereignisse
| StateChanged |
Tritt auf, wenn sich der Zustand des Systemhintergrunds geändert hat. |