BackdropMaterial 클래스

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

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>

상속

DependencyObject

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는 main 분기, WinUI 2는 winui2 분기 사용).

설명

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

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

주의

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

XAML 연결 속성

BackdropMaterial는 XAML 연결 속성의 ApplyToRootOrPageBackground 호스트 서비스 클래스입니다.

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

연결된 속성	Description
ApplyToRootOrPageBackground	XAML 콘텐츠의 루트 또는 배경에 배경 자료를 적용합니다. 형식: Bool 식별자 필드: ApplyToRootOrPageBackgroundProperty 접근자 메서드: GetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control), SetApplyToRootOrPageBackground(Windows.UI.Xaml.Controls.Control,System.Boolean) 속성은 ApplyToRootOrPageBackground 배경 재질이 적용되는지 여부를 나타내는 부울 값입니다.

속성

ApplyToRootOrPageBackgroundProperty

XAML 연결 속성을 식별합니다 BackdropMaterial.ApplyToRootOrPageBackground . 이 설명서는 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 네임스페이스 참조).

추가 정보

• Mica