UIElement.Clip 속성

정의

네임스페이스:

Windows.UI.Xaml

의 RectangleGeometry 내용 UIElement윤곽선을 정의하는 데 사용되는 값을 가져오거나 설정합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.UIElement.Clip(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

public:
 property RectangleGeometry ^ Clip { RectangleGeometry ^ get(); void set(RectangleGeometry ^ value); };

RectangleGeometry Clip();

void Clip(RectangleGeometry value);

public RectangleGeometry Clip { get; set; }

var rectangleGeometry = uIElement.clip;
uIElement.clip = rectangleGeometry;

Public Property Clip As RectangleGeometry

<uiElement>
  <uiElement.Clip>
    rectangleGeometry
  </uiElement.Clip>
</uiElement>

속성 값

RectangleGeometry

클리핑 영역 크기 조정에 사용할 사각형 기하 도형입니다. 기본값은 null 입니다(클리핑 없음).

예제

이 예제는 특성 구문을 통해 해당 차원을 지정하는 인라인 RectangleGeometry 을 사용하여 클립을 지정하는 간단한 XAML 태그입니다.

<Canvas>
    <Image Source="Images/Water_lilies.jpg" Width="200" Height="150">
        <Image.Clip>
            <RectangleGeometry Rect="100 75 50 50"/>
        </Image.Clip>
    </Image>
</Canvas>

설명

Windows 런타임 API의 UIElement.Clip에 대한 클리핑 기하 도형은 여야 RectangleGeometry합니다. Microsoft Silverlight와 같은 일부 XAML 프레임워크에서 허용되는 것처럼 사각형이 아닌 기하 도형은 지정할 수 없습니다.

잘린 영역은 기하 도형의 "외부"입니다. 즉, 표시된 내용(잘리지 않음)은 기하 도형이 클리핑이 아닌 데이터 Path 로 사용된 경우 그려지는 Fill 사각형 영역입니다. 잘린 영역은 사각형 외부에 있는 모든 영역입니다. 잘린 영역은 적중 테스트할 수 없습니다.