DesktopAcrylicController.SetTarget 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
SetTarget(WindowId, CompositionTarget) |
将此系统背景控制器连接到 |
SetTarget(CoreWindow, CompositionTarget) |
将此系统背景控制器连接到指定的 |
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
。
实现
- 属性
示例
此示例演示如何使用 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
。
实现
- 属性
注解
使用此方法将 连接到 DesktopAcrylicController
CoreWindow。
必须在具有 DispatcherQueue 的线程上调用此方法。