ISystemBackdropController.SetTarget 方法

参考

定义

命名空间:: Microsoft.UI.Composition.SystemBackdrops

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

SetTarget(WindowId, CompositionTarget)	使用指定的 WindowId 将系统背景控制器连接到 `HWND` 或 `AppWindow` 。
SetTarget(CoreWindow, CompositionTarget)	将系统背景控制器连接到指定的 `CoreWindow`。

SetTarget(WindowId, CompositionTarget)

编辑

使用指定的 WindowId 将系统背景控制器连接到 HWND 或 AppWindow 。

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。

属性: DefaultOverloadAttribute OverloadAttribute

示例

此示例演示如何使用 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 HWND 或 AppWindow。

必须在具有 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