UIElement.Clip 속성

정의

네임스페이스:

System.Windows

어셈블리:

PresentationCore.dll

요소 내용의 윤곽선을 정의하는 데 사용되는 기하 도형을 가져오거나 설정합니다. 이 속성은 종속성 속성입니다.

public:
 property System::Windows::Media::Geometry ^ Clip { System::Windows::Media::Geometry ^ get(); void set(System::Windows::Media::Geometry ^ value); };

public System.Windows.Media.Geometry Clip { get; set; }

member this.Clip : System.Windows.Media.Geometry with get, set

Public Property Clip As Geometry

속성 값

Geometry

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

예제

이 예제에서는 프레임워크 요소의 Clip 영역을 정의하는 방법을 보여줍니다. 클립을 정의하려면 요소의 Geometry 속성을 설정하는 경우와 같이 EllipseGeometry 클립을 사용합니다 Clip . 기하 도형 영역 내에 있는 영역만 표시됩니다.

다음 예제에서는 정의된 클립 영역이 없는 요소를 보여줍니다 Image . 클립 영역이 정의되지 않으므로 전체 이미지가 표시됩니다.

<Image Source="sampleImages\Waterlilies.jpg" 
  Width="200" Height="150" HorizontalAlignment="Left" />

. 클립 영역이 없는 이미지

다음 예제에서는 정의된 클립 영역이 있다는 점을 제외하고 동일한 이미지가 만들어집니다. 영역 EllipseGeometry 내에 있는 이미지의 일부만 표시됩니다.

<Image 
  Source="sampleImages\Waterlilies.jpg" 
  Width="200" Height="150" HorizontalAlignment="Left">
  <Image.Clip>
    <EllipseGeometry
      RadiusX="100"
      RadiusY="75"
      Center="100,75"/>
  </Image.Clip>
</Image>

다음 예제에서는 프레임워크 요소의 Clip 영역에 애니메이션 효과를 적용하는 방법을 보여 있습니다. 이 예제에서는 EllipseGeometry 요소에 대한 Image 타원형 클립 영역을 정의하는 데 사용됩니다. A PointAnimation 는 타원 기하 도형의 Center 속성에 (0, 0)에서 (200, 150)로 애니메이션 효과를 줍니다. 이미지가 로드된 후 애니메이션이 재생되기 시작하고 무기한 반복됩니다.

<Image
  Source="sampleImages\Waterlilies.jpg" 
  Width="200" Height="150" HorizontalAlignment="Left">
  <Image.Clip>
    <EllipseGeometry x:Name="MyEllipseGeometry1"
      RadiusX="100"
      RadiusY="75"
      Center="100,75"/>
  </Image.Clip>
  <Image.Triggers>
    <EventTrigger RoutedEvent="Image.Loaded">
      <BeginStoryboard>
        <Storyboard>
          <PointAnimation 
            Storyboard.TargetName="MyEllipseGeometry1" 
            Storyboard.TargetProperty="(EllipseGeometry.Center)"
            From="0,0" To="200,150" Duration="0:0:3" RepeatBehavior="Forever" 
            AutoReverse="True" />
          </Storyboard>
      </BeginStoryboard>
    </EventTrigger>
  </Image.Triggers>
</Image>

설명

기하 도형 외부의 요소는 렌더링된 레이아웃에서 시각적으로 잘립니다. 기하 도형은 직사각형일 필요가 없습니다.

종속성 속성 정보

Item	가치
식별자 필드	ClipProperty
메타데이터 속성이 다음으로 설정됩니다. true	없음

추가 정보

• ClipToBounds