DesktopAcrylicController.SetTarget Methode

Definition

Namespace:

Microsoft.UI.Composition.SystemBackdrops

Überlädt

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

SetTarget(WindowId, CompositionTarget)

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

public:
 virtual bool SetTarget(WindowId windowId, CompositionTarget ^ desktopWindowTarget) = SetTarget;

/// [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 in der Lage war, das Material als Systemkulisse einzurichten; falseandernfalls .

Implementiert

SetTarget(WindowId, CompositionTarget)

Attribute

DefaultOverloadAttribute OverloadAttribute

Beispiele

In diesem Beispiel wird gezeigt, wie Sie das Desktop Acryl-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::DesktopAcrylicController desktopAcrylicController = winrt::DesktopAcrylicController();
    return desktopAcrylicController.SetTarget(windowId, compositionTarget);
}

Hinweise

Verwenden Sie diese Methode, um eine DesktopAcrylicController 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 muss für Desktopacryl das DWM-Fensterattribute DWMWA_USE_HOSTBACKDROPBRUSH auf der obersten Ebene hWnd festgelegt werden, um zu funktionieren.

Weitere Informationen

• Verwalten von App-Fenstern

SetTarget(CoreWindow, CompositionTarget)

Verbindet diesen Systemhintergrundcontroller mit dem angegebenen CoreWindow.

public:
 virtual bool SetTarget(CoreWindow ^ coreWindow, CompositionTarget ^ compositionTarget) = SetTarget;

/// [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

Der CoreWindow , mit dem 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 in der Lage war, das Material als Systemkulisse einzurichten; falseandernfalls .

Implementiert

SetTarget(CoreWindow, CompositionTarget)

Attribute

OverloadAttribute

Hinweise

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

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