UIElement.Clip 屬性

定義

命名空間:

System.Windows

組件:

PresentationCore.dll

取得或設定用來定義項目內容外框的幾何。 這是相依性屬性。

C#

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

屬性值

Geometry

用於裁剪區域大小的幾何。 預設值為 null Geometry。

範例

此範例示範如何定義架構元素 Clip 的區域。 若要定義剪輯，請使用 Geometry (例如， EllipseGeometry 設定元素的 Clip 屬性。 只有幾何區域內的區域才會顯示。

下列範例顯示 Image 沒有已定義剪輯區域的元素。 因為未定義剪輯區域，所以會顯示整個影像。

XAML

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

沒有剪輯區域的影像

在下一個範例中，會建立相同的 Image，但有已定義的剪輯區域。 只會顯示區域內影像的 EllipseGeometry 一部分。

XAML

<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 橢圓形剪輯區域。 將 PointAnimation 橢圓形幾何的 Center 屬性從 (0、 0) 動畫顯示至 (200， 150) 。 動畫會在載入影像後開始播放，並無限期重複。

XAML

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

如需完整範例，請參閱 剪輯區域範例。

備註

幾何外部的專案會在轉譯的版面配置中以視覺化方式裁剪。 幾何不需要是矩形。

相依性屬性資訊

識別碼欄位	ClipProperty
中繼資料屬性設定為 true	無

適用於

另請參閱

• ClipToBounds