다음을 통해 공유


Geometry 클래스

정의

기하 도형 모양을 정의하는 개체에 대해 기본 클래스를 제공합니다. Geometry 개체는 영역을 클리핑하고 2차원 그래픽 데이터를 Path로 렌더링하기 위한 기하 도형 정의로 사용할 수 있습니다.

public ref class Geometry : DependencyObject
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Geometry : DependencyObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Geometry : DependencyObject
Public Class Geometry
Inherits DependencyObject
상속
Object Platform::Object IInspectable DependencyObject Geometry
파생
특성

설명

Geometry를 사용하는 속성의 경우 abstract 파생 형식을 XAML의 개체 요소로 지정하거나 코드에 대해 정의된 instance 지정해야 합니다. 자세한 내용은 EllipseGeometry, GeometryGroup, LineGeometry, PathGeometry 또는 RectangleGeometry에 대한 참조 페이지를 참조하세요.

기하 도형은 "단순" 또는 "복합"으로 개념화할 수 있습니다. EllipseGeometry, LineGeometryRectangleGeometry 는 기본 좌표 또는 차원 속성을 사용하여 기하 도형을 하나의 요소로 지정하는 간단한 기하 도형입니다. GeometryGroupPathGeometry 는 복잡한 기하 도형입니다. GeometryGroup 은 자식 개체로 보유하는 다른 기하 도형을 결합합니다. PathGeometry 는 중첩된 그림/세그먼트 경로 정의 요소 집합 또는 디자이너에서 일반적으로 출력하는 압축 문자열 구문을 사용하여 기하 도형의 복잡한 경로를 설명합니다.

기하 도형은 UIElement 자체가 아니며 렌더링 효과를 유발하기 위해 UIElement 의 일부 속성 값으로 제공되어야 하므로 자체 렌더링을 완전히 정의하지 않습니다. 일반적으로 Geometry는 경로 (일종의 셰이프)에 대한 데이터로 제공됩니다.

PathIcon.Data 속성은 Geometry를 사용합니다. 실제로 일반적으로 경로에 대한 압축 문자열 구문으로 표현된 Figures 속성 값을 사용하여 PathGeometry를 지정합니다.

GeometryCollection 은 Geometry 항목에 대한 강력한 형식의 컬렉션입니다. GeometryGroup.Children 속성은 GeometryCollection을 사용합니다.

기하 도형도형 비교

Shape 클래스에는 Geometry 및 파생 클래스에 없는 Fill, Stroke 및 기타 렌더링 속성이 있습니다. Shape 클래스는 FrameworkElement이므로 레이아웃 시스템에 참여합니다. 파생 클래스는 UIElement 자식을 지원하는 모든 요소의 콘텐츠로 사용할 수 있습니다. 반면 Geometry 클래스는 기하 도형을 그래픽 기본 형식으로 정의하기만 하면 자체적으로 렌더링할 수 없습니다. Geometry에서 사용하도록 설정된 기본 그래픽 기본 식이 정의로 유용한 사용자 지정 UI 요소 속성의 속성 형식으로 Geometry를 사용할 수 있습니다.

UIElement.Clip의 기하 도형

Windows 런타임 UIElement.Clip 속성에 대한 값을 제공하려면 Geometry 파생 형식이 아닌 RectangleGeometry를 사용해야 합니다. 다른 XAML 프레임워크에서 XAML 또는 코드를 포팅하는 경우 RectangleGeometry를 사용하도록 UIElement.Clip을 변경할 수 있는지 확인합니다. 그렇지 않은 경우 Z 순서 관계를 변경하고 "클리핑" 부분에 대한 알파 투명도가 있는 수정된 RenderTargetBitmap 원본이 있는 ImageBrush 오버레이와 같은 기술을 사용해야 할 수 있습니다.

기하 도형 파생 클래스

Geometry는 다양한 범주의 실제 기하 도형을 정의하는 여러 파생 클래스의 부모 클래스입니다.

속성

Bounds

Geometry의 축 맞춤 경계 상자를 지정하는 Rect를 가져옵니다.

Dispatcher

항상 Windows 앱 SDK 앱에서 를 반환 null 합니다. 대신 DispatcherQueue 를 사용합니다.

(다음에서 상속됨 DependencyObject)
DispatcherQueue

DispatcherQueue 이 개체가 연결된 을 가져옵니다. 는 DispatcherQueue 코드가 비 UI 스레드에 의해 시작되는 경우에도 UI 스레드에서 에 액세스할 DependencyObject 수 있는 기능을 나타냅니다.

(다음에서 상속됨 DependencyObject)
Empty

빈 geometry 개체를 가져옵니다.

StandardFlatteningTolerance

다각형 근사에 사용된 표준 허용 범위를 가져옵니다.

Transform

Geometry에 적용된 Transform 개체를 가져오거나 설정합니다.

TransformProperty

Transform 종속성 속성을 식별합니다.

메서드

ClearValue(DependencyProperty)

종속성 속성의 로컬 값을 지웁니다.

(다음에서 상속됨 DependencyObject)
GetAnimationBaseValue(DependencyProperty)

애니메이션이 활성화되지 않은 경우 적용되는 종속성 속성에 대해 설정된 모든 기본 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)

DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
ReadLocalValue(DependencyProperty)

로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다.

(다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

DependencyObject instance 특정 DependencyProperty의 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다.

(다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)

DependencyObject에서 종속성 속성의 로컬 값을 설정합니다.

(다음에서 상속됨 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

RegisterPropertyChangedCallback을 호출하여 이전에 등록된 변경 알림을 취소합니다.

(다음에서 상속됨 DependencyObject)

적용 대상

추가 정보