ISystemBackdropController.SetTarget 方法

定義

命名空間:

Microsoft.UI.Composition.SystemBackdrops

多載

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 應用程式中使用時，桌面壓克力需要 DWM 視窗屬性 DWMWA_USE_HOSTBACKDROPBRUSH 設定在最上層 hWnd 才能運作。

另請參閱

• 管理應用程式視窗

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 。

屬性

OverloadAttribute

備註

使用此方法將 連接到 ISystemBackdropControllerCoreWindow。

這個方法必須在具有 DispatcherQueue的執行緒上呼叫。