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

プロパティ値

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 ます。 は、 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 None

適用対象

こちらもご覧ください