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 應用程式中使用時，桌面壓克力需要 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