ISystemBackdropController.SetTarget メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
SetTarget(WindowId, CompositionTarget) |
指定した WindowId を持つ または |
SetTarget(CoreWindow, CompositionTarget) |
システム 背景コントローラーを指定した に接続します |
SetTarget(WindowId, CompositionTarget)
指定した WindowId を持つ または AppWindow
にHWND
システム 背景コントローラーを接続します。
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
接続先のコンポジション ターゲット。
戻り値
bool
true
コントローラがシステムの背景として材料を設定することができた場合;それ以外の場合は false
。
- 属性
例
この例では、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);
}
注釈
Win32 HWND
または AppWindow に をISystemBackdropController
接続するには、このメソッドを使用します。
このメソッドは、 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
接続先のコンポジション ターゲット。
戻り値
bool
true
コントローラがシステムの背景として材料を設定することができた場合;それ以外の場合は false
。
- 属性
注釈
CoreWindow に をISystemBackdropController
接続するには、このメソッドを使用します。
このメソッドは、 DispatcherQueue を使用してスレッドで呼び出す必要があります。