다음을 통해 공유


BackdropMaterial 클래스

정의

XAML 콘텐츠의 루트에 배경 자료를 적용하는 도우미 클래스입니다.

이 설명서는 UWP용 WinUI 2 적용됩니다(Windows 앱 SDKWinUI 경우 Windows 앱 SDK 네임스페이스참조).

public ref class BackdropMaterial : DependencyObject
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BackdropMaterial : DependencyObject
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class BackdropMaterial : DependencyObject
Public Class BackdropMaterial
Inherits DependencyObject
<Page muxc:BackdropMaterial.ApplyToRootOrPageBackground="True">
    pageContent
</Page>
-or-
<Frame muxc:BackdropMaterial.ApplyToRootOrPageBackground="True">
    appContent
</Frame>
상속
BackdropMaterial
특성
Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

예제

자세한 정보, 디자인 지침 및 코드 예제는 Mica참조하세요.

WinUI 3 갤러리WinUI 2 갤러리 앱에는 대부분의 WinUI 3 및 WinUI 2 컨트롤, 기능 및 기능의 대화형 예제가 포함됩니다.

이미 설치된 경우 WinUI 3 갤러리 또는 winUI 2 갤러리링크를 클릭하여 엽니다.

설치되지 않은 경우 Microsoft Store에서 WinUI 3 갤러리WinUI 2 갤러리 다운로드할 수 있습니다.

GitHub 모두에 대한 소스 코드를 가져올 수도 있습니다(WinUI 3의 경우 분기 및 WinUI 2의 경우 winui2 분기 사용).

설명

배경 재질은 XAML 콘텐츠 뒤의 영역에서 가져온 픽셀 원본에서 만든 재질.

클래스를 사용하면 Mica배경 자료를 애플리케이션의 컴퍼지션 대상에 적용할 수 있습니다. 필요한 경우 중립 색 XAML 브러시를 설정하여 테마 변경, 하위 수준 버전 및 디바이스 상태를 자동으로 지원합니다.

주의

배경 자료를 적용하는 경우 UI 콘텐츠에 Background 속성도 설정하지 마세요. 배경 재질이 표시되도록 배경이 투명해야 합니다.

XAML 연결된 속성

BackdropMaterial ApplyToRootOrPageBackground XAML 연결된 속성대한 호스트 서비스 클래스입니다.

연결된 속성에 대한 XAML 프로세서 액세스를 지원하고 동일한 가져오기 및 작업을 코드로 설정하기 위해 연결된 각 XAML 속성에는 Get 및 Set 접근자 메서드 쌍이 있습니다. 코드에서 값을 얻거나 설정하는 또 다른 방법은 GetValue 또는 SetValue 호출하고 식별자 필드를 종속성 속성 식별자로 전달하는 종속성 속성 시스템을 사용하는 것입니다.

연결된 속성 묘사
ApplyToRootOrPageBackground 배경 자료를 XAML 콘텐츠의 루트 또는 배경에 적용합니다. ApplyToRootOrPageBackground 속성은 배경 재질이 적용되는지 여부를 나타내는 부울 값입니다.

속성

ApplyToRootOrPageBackgroundProperty

BackdropMaterial.ApplyToRootOrPageBackground XAML 연결 속성을 식별합니다.

이 설명서는 UWP용 WinUI 2 적용됩니다(Windows 앱 SDKWinUI 경우 Windows 앱 SDK 네임스페이스참조).

연결된 속성

ApplyToRootOrPageBackground

배경 자료를 XAML 콘텐츠의 루트 또는 배경에 적용합니다.

이 설명서는 UWP용 WinUI 2 적용됩니다(Windows 앱 SDKWinUI 경우 Windows 앱 SDK 네임스페이스참조).

메서드

GetApplyToRootOrPageBackground(Control)

대상 요소에 대한 BackdropMaterial.ApplyToRootOrPageBackground XAML 연결된 속성의 값을 가져옵니다.

이 설명서는 UWP용 WinUI 2 적용됩니다(Windows 앱 SDKWinUI 경우 Windows 앱 SDK 네임스페이스참조).

SetApplyToRootOrPageBackground(Control, Boolean)

대상 요소에 대한 BackdropMaterial.ApplyToRootOrPageBackground XAML 연결 속성의 값을 설정합니다.

이 설명서는 UWP용 WinUI 2 적용됩니다(Windows 앱 SDKWinUI 경우 Windows 앱 SDK 네임스페이스참조).

적용 대상

추가 정보