BackdropMaterial 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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는 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 콘텐츠의 루트 또는 배경에 배경 자료를 적용합니다.
ApplyToRootOrPageBackground 배경 재질이 적용되는지 여부를 나타내는 부울 값입니다. |
속성
ApplyToRootOrPageBackgroundProperty |
XAML 연결 속성을 식별합니다 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조). |
연결된 속성
ApplyToRootOrPageBackground |
XAML 콘텐츠의 루트 또는 배경에 배경 자료를 적용합니다. 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조). |
메서드
GetApplyToRootOrPageBackground(Control) |
대상 요소에 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조). |
SetApplyToRootOrPageBackground(Control, Boolean) |
대상 요소에 이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조). |
적용 대상
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기