Brush 클래스

참조

정의

네임스페이스:: Windows.UI.Xaml.Media

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

편집

그래픽 개체를 그리는 데 사용할 개체를 정의합니다. Brush에서 파생되는 클래스는 영역이 그려지는 방법을 설명합니다.

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

public ref class Brush : DependencyObject

public ref class Brush : DependencyObject, IAnimationObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Brush : DependencyObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Brush : DependencyObject, IAnimationObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Brush : DependencyObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Brush : DependencyObject, IAnimationObject

Public Class Brush
Inherits DependencyObject

Public Class Brush
Inherits DependencyObject
Implements IAnimationObject

<object property="predefinedColorName"/>
- or -
<object property="#rgb"/>
- or -
<object property="#argb"/>
- or -
<object property="#rrggbb"/>
- or -
<object property="#aarrggbb"/>
- or -
<object property="sc#scR,scG,scB"/>
- or -
<object property="sc#scA,scR,scG,scB"/>

상속: Object IInspectable DependencyObject Brush

파생: Windows.UI.Xaml.Media.GradientBrush

Windows.UI.Xaml.Media.SolidColorBrush

Windows.UI.Xaml.Media.TileBrush

Windows.UI.Xaml.Media.XamlCompositionBrushBase

특성: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현: IAnimationObject

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

브러시로 표현되는 UI 그리기 개념에 대한 예제 및 추가 설명은 브러시 사용을 참조하세요.

XAML 리소스로 브러시

XAML(SolidColorBrush, LinearGradientBrush, ImageBrush)에서 선언할 수 있는 각 Brush 형식은 해당 브러시를 앱 전체에서 리소스로 다시 사용할 수 있도록 리소스로 정의하기 위한 것입니다. 브러시 형식에 대해 표시된 XAML 구문은 브러시를 리소스로 정의하는 데 적합합니다. 브러시를 리소스로 선언하는 경우 나중에 다른 UI 정의에서 해당 리소스를 참조하는 데 사용할 x:Key 특성 도 필요합니다. XAML 리소스 및 x:Key 특성을 사용하는 방법에 대한 자세한 내용은 ResourceDictionary 및 XAML 리소스 참조를 참조하세요.

브러시를 리소스로 선언하면 UI를 생성하는 데 필요한 런타임 개체 수를 줄일 수 있다는 장점이 있습니다. 이제 브러시는 개체 그래프의 여러 부분에 대한 값을 제공하는 공통 리소스로 공유됩니다.

Windows 런타임 XAML 컨트롤에 대한 기존 컨트롤 템플릿 정의를 살펴보면 템플릿에서 브러시 리소스를 광범위하게 사용하는 것을 볼 수 있습니다. 이러한 리소스의 대부분은 시스템 리소스이며 { StaticResource} 태그 확장 이 아닌 리소스 참조에 {ThemeResource} 태그 확장을 사용합니다. 사용자 고유의 컨트롤 템플릿 XAML에서 시스템 리소스 브러시를 사용하는 방법에 대한 자세한 내용은 XAML 테마 리소스를 참조하세요.

브러시 파생 클래스

Brush는 UI 영역을 그리는 실용적인 브러시를 구현하거나 이러한 브러시에 대한 중간 기본 클래스인 여러 파생 클래스의 부모 클래스입니다.

GradientBrush: 에 대한 중간 기본 클래스입니다 LinearGradientBrush.
SolidColorBrush: 이것은 지금까지 가장 일반적으로 사용되는 브러시입니다.
TileBrush: 에 대한 중간 기본 클래스입니다 ImageBrush.

버전 기록

Windows 버전	SDK 버전	추가된 값
1809	17763	PopulatePropertyInfo
1809	17763	PopulatePropertyInfoOverride

생성자

Brush()

-derived 클래스에 대한 Brush기본 클래스 초기화 동작을 제공합니다.

속성

Dispatcher	이 개체가 CoreDispatcher 연결된 개체를 가져옵니다. 코드 CoreDispatcher 가 비 UI 스레드에서 시작되는 경우에도 UI 스레드에 액세스할 DependencyObject 수 있는 기능을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.Dispatcher(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
Opacity	Brush의 불투명도 수준을 가져오거나 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Brush.Opacity(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
OpacityProperty	Opacity 종속성 속성을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Brush.OpacityProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
RelativeTransform	상대 좌표를 사용하여 브러시에 적용되는 변형을 가져오거나 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Brush.RelativeTransform(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
RelativeTransformProperty	RelativeTransform 종속성 속성을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Brush.RelativeTransformProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Transform	브러시에 적용되는 변형을 가져오거나 설정합니다. UWP용 동등한 WinUI 2 API: Microsoft.UI.Xaml.Media.Brush.Transform(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
TransformProperty	Transform 종속성 속성을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Brush.TransformProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

메서드

ClearValue(DependencyProperty)	종속성 속성의 로컬 값을 지웁니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.ClearValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	애니메이션이 활성화되지 않은 경우에 적용되는 종속성 속성에 대해 설정된 기본 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.GetAnimationBaseValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)	에서 종속성 속성 DependencyObject의 현재 유효 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.GetValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	애니메이션 효과를 적용할 수 있는 속성을 정의합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Brush.PopulatePropertyInfo(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	파생 클래스에서 재정의되는 경우 애니메이션 효과를 적용할 수 있는 속성을 정의합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.Brush.PopulatePropertyInfoOverride(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ReadLocalValue(DependencyProperty)	로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.ReadLocalValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	이 DependencyObject 인스턴스의 특정 DependencyProperty 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.RegisterPropertyChangedCallback(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)	에 종속성 속성 DependencyObject의 로컬 값을 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.SetValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	를 호출 RegisterPropertyChangedCallback하여 이전에 등록한 변경 알림을 취소합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.UnregisterPropertyChangedCallback(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)

적용 대상