ISystemBackdropController 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.
Stellt Methoden zum Verbinden eines Systemhintergrundcontrollers mit einem Fenster bereit.
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- Abgeleitet
- Attribute
- Implementiert
Beispiele
In diesem Beispiel wird gezeigt, wie Sie das neue Windows 11 Mica-Material in einem Win32-App-Fenster mit C++/WinRT zeichnen.
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);
}
Hinweise
Eine Systemkulisse ist im Wesentlichen eine CompositionBrush , die ein UI-Material wie Acryl oder Glimmer definiert. Dieser Pinsel wird vom Systemkompositor gezeichnet. Ein Systemhintergrundcontroller ist ein Objekt, das sowohl das Rendering des Systemhintergrundmaterials als auch die Handhabung der Systemrichtlinie für das angegebene Material kapselt. Jedes Material verfügt über einen eigenen Controller.
Sie können ein Material auf der Rückseite Ihres Inhalts zeichnen, indem Sie das entsprechende ISystemBackdropController Fenster und CompositionTarget für die SetTarget-Methode des Controllers erstellen. Wenn SetTarget dies erfolgreich ist und zurückgegeben wird true, übernimmt der Controller die gesamte Materialverarbeitung, einschließlich Fallbackrendering und aller Systemrichtlinien. Wenn SetTarget ein Fehler auftritt und zurückgegeben falsewird, bedeutet dies, dass der Controller das gewünschte Material nicht als Systemhintergrund einrichten konnte und keine Änderungen am CompositionTargetvorgenommen wurden.
Materialien werden mithilfe der Windows.UI.Composition-APIs gezeichnet. Daher ist ein CompositionTarget erforderlich, für das das Material ganz hinten hinter dem restlichen App-Inhalt gezeichnet wird. Alle App-Inhalte, die Transparenz aufweisen, werden dem ausgewählten Material angezeigt.
Methoden
| Dispose() |
Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. |
| SetTarget(CoreWindow, CompositionTarget) |
Verbindet einen Systemhintergrundcontroller mit dem angegebenen |
| SetTarget(WindowId, CompositionTarget) |
Verbindet einen Systemhintergrundcontroller mit einem |