다음을 통해 공유

ISystemBackdropController 인터페이스

  • 참조

정의

네임스페이스:
Microsoft.UI.Composition.SystemBackdrops
편집

시스템 배경 컨트롤러를 창에 연결하는 메서드를 제공합니다.

public interface class ISystemBackdropController : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1446172524, 2932, 23378, 170, 51, 128, 38, 32, 104, 174, 178)]
struct ISystemBackdropController : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.Guid(1446172524, 2932, 23378, 170, 51, 128, 38, 32, 104, 174, 178)]
public interface ISystemBackdropController : System.IDisposable
Public Interface ISystemBackdropController
Implements IDisposable
파생
특성
ContractVersionAttribute GuidAttribute
구현
IClosable IDisposable

예제

이 예제에서는 C++/WinRT를 사용하여 Win32 앱 창에서 새 Windows 11 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);
}

설명

시스템 배경은 기본적으로 아크릴 또는 Mica와 같은 UI 자료를 정의하는 CompositionBrush입니다. 이 브러시는 시스템 작성기에서 그려집니다. 시스템 배경 컨트롤러는 시스템 배경 재질의 렌더링과 지정된 재질에 대한 시스템 정책 처리를 모두 캡슐화하는 개체입니다. 각 재질에는 자체 컨트롤러가 있습니다.

해당 ISystemBackdropController 을 만들고 컨트롤러의 SetTarget 메서드에 창 및 CompositionTarget을 제공하여 콘텐츠 뒷면에 재질을 그릴 수 있습니다. 성공하고 를 반환true하는 경우 SetTarget 컨트롤러는 대체 렌더링 및 모든 시스템 정책을 포함하여 모든 재질 처리를 처리합니다. 실패하고 를 반환false하는 경우 SetTarget 컨트롤러가 원하는 재질을 시스템 배경으로 설정할 수 없으며 가 변경되지 않음을 CompositionTarget의미합니다.

재질은 Windows.UI.Composition API를 사용하여 그려지므로 나머지 앱 콘텐츠 바로 뒤에 재질을 그릴 CompositionTarget 이 필요합니다. 투명도가 있는 모든 앱 콘텐츠는 선택한 자료를 통해 표시됩니다.

메서드

Dispose()

관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.
SetTarget(CoreWindow, CompositionTarget)

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

시스템 배경 컨트롤러를 지정된 WindowId를 HWND 사용하여 또는 AppWindow 에 연결합니다.

적용 대상