ISystemBackdropControllerWithTargets 인터페이스

정의

네임스페이스:

Microsoft.UI.Composition.SystemBackdrops

시스템 배경 대상, 해당 구성 및 상태 변경을 관리하는 기능을 사용하여 ISystemBackdropController 인터페이스를 확장합니다.

public interface class ISystemBackdropControllerWithTargets : ISystemBackdropController, IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65537)]
/// [Windows.Foundation.Metadata.Guid(2622946940, 39147, 24457, 173, 151, 218, 213, 127, 195, 12, 140)]
struct ISystemBackdropControllerWithTargets : ISystemBackdropController, IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65537)]
[Windows.Foundation.Metadata.Guid(2622946940, 39147, 24457, 173, 151, 218, 213, 127, 195, 12, 140)]
public interface ISystemBackdropControllerWithTargets : ISystemBackdropController, System.IDisposable

Public Interface ISystemBackdropControllerWithTargets
Implements IDisposable, ISystemBackdropController

파생

Microsoft.UI.Composition.SystemBackdrops.DesktopAcrylicController

Microsoft.UI.Composition.SystemBackdrops.MicaController

특성

ContractVersionAttribute GuidAttribute

구현

ISystemBackdropController IClosable IDisposable

설명

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

인터페이스는 ISystemBackdropControllerWithTargetsICompositionSupportsSystemBackdrop 대상을 보다 세부적으로 제어합니다. 대상은 언제든지 추가 및 제거될 수 있습니다. 모든 대상은 동일한 Compositor를 공유해야 합니다. 다른 Compositor 것으로 예상되는 대상을 추가하면 잘못된 인수 예외가 throw되고 새 대상이 추가되지 않습니다.

ISystemBackdropController 인터페이스는 앱별 자료 정책 정보를 제공하는 메커니즘을 제공하지 않으며 대신 애플리케이션 창 개체가 필요합니다. 반면, 인터페이스에는 ISystemBackdropControllerWithTargets 고유한 앱별 재질 정책을 지정할 수 있는 SystemBackdropConfiguration 개체가 필요합니다.

시스템 배경 컨트롤러는 하나 이상의 대상과 함께 개체를 제공한 경우에만 재질을 SystemBackdropConfiguration 렌더링합니다. 그렇지 않은 경우 아무것도 렌더링하지 않습니다. 대상을 제거하면 재질 렌더링이 중지됩니다. 모든 대상을 제거하면 하나 이상의 대상이 추가될 때까지 컨트롤러가 비활성화됩니다.

속성

State

시스템 배경 컨트롤러의 현재 상태를 가져옵니다.

메서드

AddSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	재질을 그릴 지정된 시스템 배경 대상을 추가합니다.
Dispose()	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.
RemoveAllSystemBackdropTargets()	모든 시스템 백그라운드 대상을 제거합니다.
RemoveSystemBackdropTarget(ICompositionSupportsSystemBackdrop)	지정된 시스템 백그라운드 대상을 제거합니다.
SetSystemBackdropConfiguration(SystemBackdropConfiguration)	시스템 배경 컨트롤러에 적용할 앱별 정책을 설정합니다.
SetTarget(CoreWindow, CompositionTarget)	시스템 배경 컨트롤러를 지정된 CoreWindow에 연결합니다. (다음에서 상속됨 ISystemBackdropController)
SetTarget(WindowId, CompositionTarget)	시스템 배경 컨트롤러를 또는 AppWindow 에 지정한 HWNDWindowId와 연결합니다. (다음에서 상속됨 ISystemBackdropController)

이벤트

StateChanged

시스템 배경의 상태가 변경된 경우에 발생합니다.