Freigeben über

ISystemBackdropController.SetTarget Methode

  • Referenz

Definition

Namespace:
Microsoft.UI.Composition.SystemBackdrops

Überlädt

SetTarget(WindowId, CompositionTarget)

Verbindet einen Systemhintergrundcontroller mit einem HWND oder AppWindow mit der angegebenen WindowId.
SetTarget(CoreWindow, CompositionTarget)

Verbindet einen Systemhintergrundcontroller mit dem angegebenen CoreWindow.

SetTarget(WindowId, CompositionTarget)

Bearbeiten

Verbindet einen Systemhintergrundcontroller mit einem HWND oder AppWindow mit der angegebenen WindowId.

public:
 bool SetTarget(WindowId windowId, CompositionTarget ^ desktopWindowTarget);
/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("SetTargetWithWindowId")]
bool SetTarget(WindowId const& windowId, CompositionTarget const& desktopWindowTarget);
[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("SetTargetWithWindowId")]
public bool SetTarget(WindowId windowId, CompositionTarget desktopWindowTarget);
function setTarget(windowId, desktopWindowTarget)
Public Function SetTarget (windowId As WindowId, desktopWindowTarget As CompositionTarget) As Boolean

Parameter

windowId
WindowId

Der Bezeichner für den HWND oder AppWindow, mit dem eine Verbindung hergestellt werden soll.

desktopWindowTarget
CompositionTarget

Das Kompositionsziel, mit dem eine Verbindung hergestellt werden soll.

Gibt zurück

Boolean

bool

true , wenn der Controller das Material als Systemhintergrund einrichten konnte; falseandernfalls .

Attribute
DefaultOverloadAttribute OverloadAttribute

Beispiele

In diesem Beispiel wird gezeigt, wie Sie das 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

Verwenden Sie diese Methode, um eine ISystemBackdropController Verbindung mit einem Win32 HWND - oder AppWindow-Objekt herzustellen.

Diese Methode muss in einem Thread mit einem DispatcherQueue aufgerufen werden.

Bei Verwendung in einer Win32-Anwendung erfordert Desktopacryl, dass das DWM-Fensterattribute DWMWA_USE_HOSTBACKDROPBRUSH auf der obersten Ebene hWnd festgelegt werden muss, um zu funktionieren.

Weitere Informationen

Gilt für:

SetTarget(CoreWindow, CompositionTarget)

Bearbeiten

Verbindet einen Systemhintergrundcontroller mit dem angegebenen CoreWindow.

public:
 bool SetTarget(CoreWindow ^ coreWindow, CompositionTarget ^ compositionTarget);
/// [Windows.Foundation.Metadata.Overload("SetTargetWithCoreWindow")]
bool SetTarget(CoreWindow const& coreWindow, CompositionTarget const& compositionTarget);
[Windows.Foundation.Metadata.Overload("SetTargetWithCoreWindow")]
public bool SetTarget(CoreWindow coreWindow, CompositionTarget compositionTarget);
function setTarget(coreWindow, compositionTarget)
Public Function SetTarget (coreWindow As CoreWindow, compositionTarget As CompositionTarget) As Boolean

Parameter

coreWindow
CoreWindow

Die , mit der CoreWindow eine Verbindung hergestellt werden soll.

compositionTarget
CompositionTarget

Das Kompositionsziel, mit dem eine Verbindung hergestellt werden soll.

Gibt zurück

Boolean

bool

true , wenn der Controller das Material als Systemhintergrund einrichten konnte; falseandernfalls .

Attribute
OverloadAttribute

Hinweise

Verwenden Sie diese Methode, um eine ISystemBackdropController Verbindung mit einem CoreWindow herzustellen.

Diese Methode muss in einem Thread mit einem DispatcherQueue aufgerufen werden.

Gilt für: