UIElement.Clip Property

정의

요소 내용의 윤곽선을 정의하는 데 사용할 기하 도형을 가져오거나 설정합니다. Gets or sets the geometry used to define the outline of the contents of an element. 이 속성은 종속성 속성입니다. This is a dependency property.

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

클리핑 영역 크기 조정에 사용할 기하 도형입니다. The geometry to be used for clipping area sizing. 기본값은 null Geometry입니다. The default is a null Geometry.

예제

프레임 워크 요소를 정의 하는 방법을 보여 주는이 예제 Clip 지역입니다.This example shows how to define a framework element's Clip region. 클립을 정의 하려면 사용을 Geometry (예를 들어를 EllipseGeometry 요소를 설정 하려면 Clip 속성입니다.To define a clip, use a Geometry (for example, an EllipseGeometry to set the element's Clip property. 기 하 도형 영역 내에 있는 영역에만 표시 됩니다.Only the area that is within the region of the geometry will be visible.

다음 예제와 Image 정의 된 클립 영역이 없는 요소입니다.The following example shows an Image element without a defined clip region. 클립 영역이 없는 정의 되어 있으므로 전체 이미지가 표시 됩니다.Because no clip region is defined, the entire image is displayed.

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

클립 영역을 적용 하기 전에 개체An object before applying a clip region
클립 영역이 없는 이미지Image with No Clip Region

다음 예제에서는 정의 된 클립 영역이 있는 점을 제외 하 고 동일한 이미지 생성 됩니다.In the next example, an identical Image is created, except that it has a defined clip region. 영역 내에 있는 이미지의 일부만 여 EllipseGeometry 표시 됩니다.Only the part of the image that is within the area the EllipseGeometry will be displayed.

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

클리핑된 개체A clipped object
타원형 클립 영역을 사용 하 여 이미지Image with an Elliptical Clip Region

다음 예제에서는 어떻게 애니메이션 프레임 워크 요소의 Clip 지역입니다.The following example shows how animate a framework element's Clip region. 이 예는 EllipseGeometry 타원형 클립 영역에 대 한 정의 하는 데 사용 되는 Image 요소.In this example, an EllipseGeometry is used to define an elliptical clip region for an Image element. A PointAnimation 타원 기 하 도형의 애니메이션 Center 속성 (0, 0)를 (200, 150).A PointAnimation animates the ellipse geometry's Center property from (0, 0) to (200, 150). 애니메이션은 이미지를 로드 하 고 무한 반복 후 재생을 시작 합니다.The animation starts playing after the image is loaded and repeats indefinitely.

<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> 

전체 샘플을 참조 하세요. 합니다 클립 영역 샘플합니다.For the full sample, see the Clip Region Sample.

설명

기 하 도형 외부 요소는 렌더링 된 레이아웃에서 시각적으로 잘립니다.Elements outside the geometry will be visually clipped in the rendered layout. 기 하 도형 사각형 될 필요가 없습니다.The geometry does not have to be rectangular.

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field ClipProperty
메타 데이터 속성 설정 trueMetadata properties set to true 없음None

적용 대상

추가 정보