ISystemBackdropController.SetTarget 메서드

정의

네임스페이스:

Microsoft.UI.Composition.SystemBackdrops

오버로드

SetTarget(WindowId, CompositionTarget)	시스템 배경 컨트롤러를 또는 AppWindow 에 지정한 HWNDWindowId와 연결합니다.
SetTarget(CoreWindow, CompositionTarget)	시스템 배경 컨트롤러를 지정된 CoreWindow에 연결합니다.

SetTarget(WindowId, CompositionTarget)

시스템 배경 컨트롤러를 또는 AppWindow 에 지정한 HWNDWindowId와 연결합니다.

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

설명

이 메서드를 사용하여 를 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

연결할 컴퍼지션 대상입니다.

반환

Boolean

bool

true 컨트롤러가 재질을 시스템 배경으로 설정할 수 있으면 이고, 그렇지 않으면 입니다 false.

특성

OverloadAttribute

설명

이 메서드를 사용하여 를 CoreWindow에 연결 ISystemBackdropController 합니다.

이 메서드는 DispatcherQueue가 있는 스레드에서 호출해야 합니다.