UIElement.Clip プロパティ

定義

要素内容の輪郭の定義に使用するジオメトリを取得または設定します。 これは依存関係プロパティです。

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

プロパティ値

クリッピング領域のサイズ設定に使用するジオメトリ。 既定値は null Geometry です。

この例では、フレームワーク要素 Clip の領域を定義する方法を示します。 クリップを定義するには、 (たとえば、 をEllipseGeometry使用Geometryして要素の Clip プロパティを設定します。 ジオメトリの領域内にある領域のみが表示されます。

次の例は、クリップ領域が Image 定義されていない要素を示しています。 クリップ領域が定義されていないため、画像全体が表示されます。

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

クリップ領域を適用する前の
クリップ領域のない画像

次の例では、定義されたクリップ領域を持つ点を除き、同じ Image が作成されます。 の領域内 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 定義します。 は 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>

完全なサンプルについては、「 クリップ領域のサンプル」を参照してください。

注釈

ジオメトリ外の要素は、レンダリングされたレイアウトで視覚的にクリップされます。 ジオメトリは四角形である必要はありません。

依存プロパティ情報

識別子フィールド ClipProperty
に設定されたメタデータ プロパティ true なし

適用対象

こちらもご覧ください