Geometry 클래스

참조

정의

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

중요

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

편집

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

public ref class Geometry : 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 Geometry : 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 Geometry : DependencyObject

Public Class Geometry
Inherits DependencyObject

상속: Object Platform::Object IInspectable DependencyObject Geometry

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

Windows.UI.Xaml.Media.GeometryGroup

Windows.UI.Xaml.Media.LineGeometry

Windows.UI.Xaml.Media.PathGeometry

Windows.UI.Xaml.Media.RectangleGeometry

특성: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

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

설명

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

기하 도형은 "단순" 또는 "복합"으로 개념화할 수 있습니다. EllipseGeometry, LineGeometry 및 RectangleGeometry 는 기본 좌표 또는 차원 속성을 사용하여 기하 도형을 하나의 요소로 지정하는 간단한 기하 도형입니다. GeometryGroup 및 PathGeometry 는 복잡한 기하 도형입니다. 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는 다양한 범주의 실제 기하 도형을 정의하는 여러 파생 클래스의 부모 클래스입니다.

EllipseGeometry
GeometryGroup - 여러 기하 도형을 자식으로 지정하는 데 사용할 수 있습니다.
LineGeometry
PathGeometry - 다른 "단순" 기하 도형 형식으로 표현할 수 없는 모든 기하 도형에 이 형식을 사용합니다.
RectangleGeometry

속성

Bounds	Geometry의 축 맞춤 경계 상자를 지정하는 Rect를 가져옵니다.
Dispatcher	이 개체가 연결된 CoreDispatcher 를 가져옵니다. CoreDispatcher는 코드가 비 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)

적용 대상