ISystemBackdropController.SetTarget 方法

定义

重载

SetTarget(WindowId, CompositionTarget)

使用指定的 WindowId 将系统背景控制器连接到 HWNDAppWindow

SetTarget(CoreWindow, CompositionTarget)

将系统背景控制器连接到指定的 CoreWindow

SetTarget(WindowId, CompositionTarget)

使用指定的 WindowId 将系统背景控制器连接到 HWNDAppWindow

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

参数

windowId
WindowId

要连接到的 HWND 或 AppWindow 的标识符。

desktopWindowTarget
CompositionTarget

要连接到的合成目标。

返回

Boolean

bool

true 如果控制器能够将材料设置为系统背景,则为 ;否则为 false

属性

示例

此示例演示如何使用 C++/WinRT 在 Win32 应用窗口中绘制 Mica 材料。

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);
}

注解

使用此方法将 连接到 ISystemBackdropController Win32 HWNDAppWindow

必须在具有 DispatcherQueue 的线程上调用此方法。

在 Win32 应用程序中使用时,桌面亚克力要求在顶层hWnd设置 DWM 窗口属性DWMWA_USE_HOSTBACKDROPBRUSH才能正常工作。

另请参阅

适用于

SetTarget(CoreWindow, CompositionTarget)

将系统背景控制器连接到指定的 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

参数

coreWindow
CoreWindow

CoreWindow要连接到的 。

compositionTarget
CompositionTarget

要连接到的合成目标。

返回

Boolean

bool

true 如果控制器能够将材料设置为系统背景,则为 ;否则为 false

属性

注解

使用此方法将 连接到 ISystemBackdropControllerCoreWindow

必须在具有 DispatcherQueue 的线程上调用此方法。

适用于