DesktopAcrylicController.SetTarget 方法

定义

命名空间:

Microsoft.UI.Composition.SystemBackdrops

重载

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

SetTarget(WindowId, CompositionTarget)

将此系统背景控制器连接到HWND具有指定 WindowId 的 或 AppWindow 。

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

参数

windowId

WindowId

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

desktopWindowTarget

CompositionTarget

要连接到的合成目标。

返回

Boolean

bool

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

实现

SetTarget(WindowId, CompositionTarget)

属性

DefaultOverloadAttribute OverloadAttribute

示例

此示例演示如何使用 C++/WinRT 在 Win32 应用窗口中绘制桌面亚克力材料。

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

注解

使用此方法将 连接到 DesktopAcrylicController Win32 HWND 或 AppWindow。

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

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

另请参阅

• 管理应用窗口

SetTarget(CoreWindow, CompositionTarget)

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

参数

coreWindow

CoreWindow

要 CoreWindow 连接到的 。

compositionTarget

CompositionTarget

要连接到的合成目标。

返回

Boolean

bool

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

实现

SetTarget(CoreWindow, CompositionTarget)

属性

OverloadAttribute

注解

使用此方法将 连接到 DesktopAcrylicControllerCoreWindow。

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