AcrylicBrush 클래스

정의

네임스페이스:

Windows.UI.Xaml.Media

흐림 효과와 노이즈 텍스처 등 여러 효과를 사용하는 반투명 재질로 영역을 그립니다.

UWP용 WinUI 2 API와 동등한 : microsoft.UI.Xaml.Media.AcrylicBrush (Windows 앱 SDKWinUI의 경우Windows 앱 SDK 네임스페이스 참조).

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AcrylicBrush : XamlCompositionBrushBase

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class AcrylicBrush : XamlCompositionBrushBase

function AcrylicBrush()

Public Class AcrylicBrush
Inherits XamlCompositionBrushBase

상속

Object IInspectable DependencyObject Brush XamlCompositionBrushBase AcrylicBrush

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 Fall Creators Update (10.0.16299.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v5.0에서 도입되었습니다.)

예제

팁

자세한 내용, 디자인 지침 및 코드 예제는 아크릴 재질참조하세요.

WinUI 2 갤러리 앱을 설치한 경우 여기를 클릭하여 앱을 열고 작동 중인 아크릴을.

• WinUI 2 갤러리 앱(Microsoft Store) 가져오기
• 소스 코드 가져오기(GitHub)

아크릴 브러시를 추가하려면 어둡고 밝은 테마와 고대비 테마에 대한 세 가지 리소스를 정의합니다. 고대비에서는 어둡고 밝은 AcrylicBrush와 동일한 x:Key SolidColorBrush를 사용하는 것이 좋습니다.

메모

TintLuminosityOpacity 값을 지정하지 않으면 시스템에서 TintColor 및 TintOpacity에 따라 해당 값을 자동으로 조정합니다.

<ResourceDictionary.ThemeDictionaries>
    <ResourceDictionary x:Key="Default">
        <AcrylicBrush x:Key="MyAcrylicBrush"
            BackgroundSource="HostBackdrop"
            TintColor="#FFFF0000"
            TintOpacity="0.8"
            TintLuminosityOpacity="0.5"
            FallbackColor="#FF7F0000"/>
    </ResourceDictionary>

    <ResourceDictionary x:Key="HighContrast">
        <SolidColorBrush x:Key="MyAcrylicBrush"
            Color="{ThemeResource SystemColorWindowColor}"/>
    </ResourceDictionary>

    <ResourceDictionary x:Key="Light">
        <AcrylicBrush x:Key="MyAcrylicBrush"
            BackgroundSource="HostBackdrop"
            TintColor="#FFFF0000"
            TintOpacity="0.8"
            TintLuminosityOpacity="0.5"
            FallbackColor="#FFFF7F7F"/>
    </ResourceDictionary>
</ResourceDictionary.ThemeDictionaries>

이 예제에서는 코드에서 AcrylicBrush를 만드는 방법을 보여줍니다. 앱이 여러 OS 대상을 지원하는 경우 이 API를 사용하기 전에 사용자의 컴퓨터에서 사용할 수 있는지 확인해야 합니다.

if (Windows.Foundation.Metadata.ApiInformation.IsTypePresent("Windows.UI.Xaml.Media.AcrylicBrush"))
{
    Windows.UI.Xaml.Media.AcrylicBrush myBrush = new Windows.UI.Xaml.Media.AcrylicBrush();
    myBrush.BackgroundSource = Windows.UI.Xaml.Media.AcrylicBackgroundSource.HostBackdrop;
    myBrush.TintColor = Color.FromArgb(255, 202, 24, 37);
    myBrush.FallbackColor = Color.FromArgb(255, 202, 24, 37);
    myBrush.TintOpacity = 0.6;

    grid.Fill = myBrush;
}
else
{
    SolidColorBrush myBrush = new SolidColorBrush(Color.FromArgb(255, 202, 24, 37));

    grid.Fill = myBrush;
}

설명

버전 기록

Windows 버전	SDK 버전	추가된 값
1903	18362	TintLuminosityOpacity

생성자

AcrylicBrush()

AcrylicBrush 클래스의 새 인스턴스를 초기화합니다. UWP용 WinUI 2 API에 해당하는: Microsoft.UI.Xaml.Media.AcrylicBrush.-ctor(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스참조).

속성

AlwaysUseFallback	브러시가 단색 대체 색으로 강제 적용되는지 여부를 지정하는 값을 가져오거나 설정합니다. UWP용 WinUI 2 API와 동등한 : Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallback (Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스참조).
AlwaysUseFallbackProperty	AlwaysUseFallback 종속성 속성을 식별합니다. UWP용 동등한 WinUI 2 API: Microsoft.UI.Xaml.Media.AcrylicBrush.AlwaysUseFallbackProperty(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스참조).
BackgroundSource	앱 콘텐츠의 브러시 샘플 또는 앱 창 뒤의 콘텐츠에서 브러시 샘플을 지정하는 값을 가져오거나 설정합니다. UWP용 WinUI 2 API와 동등한 : Microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSource (Windows 앱 SDKWinUI의 경우 windows 앱 SDK 네임스페이스참조).
BackgroundSourceProperty	BackgroundSource 종속성 속성을 식별합니다. UWP용 WinUI 2 API와 동등한 : microsoft.UI.Xaml.Media.AcrylicBrush.BackgroundSourceProperty (Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스참조).
CompositionBrush	이 XAML 브러시에서 사용하는 CompositionBrush 가져오거나 설정합니다. (다음에서 상속됨 XamlCompositionBrushBase)
Dispatcher	이 개체가 연결된 CoreDispatcher 가져옵니다. CoreDispatcher 코드가 비 UI 스레드에서 시작된 경우에도 UI 스레드의 DependencyObject 액세스할 수 있는 기능을 나타냅니다. (다음에서 상속됨 DependencyObject)
FallbackColor	CompositionBrush 렌더링할 수 없는 경우 렌더링에 사용할 색입니다. (다음에서 상속됨 XamlCompositionBrushBase)
Opacity	Brush불투명도를 가져오거나 설정합니다. (다음에서 상속됨 Brush)
RelativeTransform	상대 좌표를 사용하여 브러시에 적용되는 변환을 가져오거나 설정합니다. (다음에서 상속됨 Brush)
TintColor	반투명 아크릴 재질의 색 색조를 가져오거나 설정합니다. UWP용 WinUI 2 API와 동등한 : microsoft.UI.Xaml.Media.AcrylicBrush.TintColor (Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스참조).
TintColorProperty	TintColor 종속성 속성을 식별합니다. UWP용 WinUI 2 API와 동등한 : microsoft.UI.Xaml.Media.AcrylicBrush.TintColorProperty (Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스참조).
TintLuminosityOpacity	TintColor와 아크릴 표면 뒤의 기본 픽셀 사이의 밝기 양을 가져오거나 설정합니다. UWP용 동등한 WinUI 2 API: microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacity (Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스참조).
TintLuminosityOpacityProperty	TintLuminosityOpacity 종속성 속성을 식별합니다. UWP용 WinUI 2 API와 동등한 : microsoft.UI.Xaml.Media.AcrylicBrush.TintLuminosityOpacityProperty (Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스참조).
TintOpacity	색 색조의 불투명도를 가져오거나 설정합니다. UWP용 WinUI 2 API와 동등한 : microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacity (Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스참조).
TintOpacityProperty	TintOpacity 종속성 속성을 식별합니다. UWP용 동등한 WinUI 2 API: microsoft.UI.Xaml.Media.AcrylicBrush.TintOpacityProperty (Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스참조).
TintTransitionDuration	TintColor가 변경되면 사용되는 자동 전환 애니메이션의 길이를 가져오거나 설정합니다. UWP용 WinUI 2 API와 동등한 : microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDuration (Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스참조).
TintTransitionDurationProperty	TintTransitionDuration 종속성 속성을 식별합니다. UWP용 동등한 WinUI 2 API: microsoft.UI.Xaml.Media.AcrylicBrush.TintTransitionDurationProperty (Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스참조).
Transform	브러시에 적용되는 변환을 가져오거나 설정합니다. (다음에서 상속됨 Brush)

메서드

ClearValue(DependencyProperty)	종속성 속성의 로컬 값을 지웁니다. (다음에서 상속됨 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	애니메이션이 활성화되지 않은 경우 적용되는 종속성 속성에 대해 설정된 기본 값을 반환합니다. (다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)	DependencyObject종속성 속성의 현재 유효 값을 반환합니다. (다음에서 상속됨 DependencyObject)
OnConnected()	요소를 그리기 위해 화면에서 브러시를 처음 사용할 때 호출됩니다. 파생 클래스에서 구현되는 경우 CompositionBrush 인스턴스를 만들고 CompositionBrush 속성을 설정하여 프레임워크에 제공할 수 있습니다. OnDisconnected 브러시가 더 이상 요소를 그리는 데 사용되지 않을 때 호출됩니다. (다음에서 상속됨 XamlCompositionBrushBase)
OnDisconnected()	브러시가 더 이상 요소를 그리는 데 사용되지 않을 때 호출됩니다. 파생 클래스에서 구현되는 경우 퇴비 브러시 및 기타 컴퍼지션 리소스를 안전하게 삭제할 수 있습니다. 연결이 끊긴 후 나중에 브러시를 사용하여 요소를 그리는 경우 OnConnected 다시 호출됩니다. (다음에서 상속됨 XamlCompositionBrushBase)
PopulatePropertyInfo(String, AnimationPropertyInfo)	애니메이션 효과를 적용할 수 있는 속성을 정의합니다. (다음에서 상속됨 Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	파생 클래스에서 재정의되는 경우 애니메이션 효과를 적용할 수 있는 속성을 정의합니다. (다음에서 상속됨 Brush)
ReadLocalValue(DependencyProperty)	로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. (다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	이 DependencyObject 인스턴스에서 특정 DependencyProperty 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. (다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject종속성 속성의 로컬 값을 설정합니다. (다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback호출하여 이전에 등록된 변경 알림을 취소합니다. (다음에서 상속됨 DependencyObject)

추가 정보

• 아크릴 재질 개요