UIElement.Clip プロパティ


要素内容の輪郭の定義に使用するジオメトリを取得または設定します。Gets or sets the geometry used to define the outline of the contents of an element. これは依存関係プロパティです。This is a dependency property.

 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


クリッピング領域のサイズ設定に使用するジオメトリ。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 (たとえば、要素の Clip プロパティを設定する EllipseGeometry を使用します。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.

  Width="200" Height="150" HorizontalAlignment="Left">

クリップオブジェクトA clipped object
楕円のクリップ領域を含むイメージImage with an Elliptical Clip Region

次の例は、フレームワーク要素の Clip 領域をアニメーション化する方法を示しています。The following example shows how animate a framework element's Clip region. この例では、Image 要素の楕円クリップ領域を定義するために EllipseGeometry が使用されています。In this example, an EllipseGeometry is used to define an elliptical clip region for an Image element. 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.

  Width="200" Height="150" HorizontalAlignment="Left">
    <EllipseGeometry x:Name="MyEllipseGeometry1"
    <EventTrigger RoutedEvent="Image.Loaded">
            From="0,0" To="200,150" Duration="0:0:3" RepeatBehavior="Forever" 
            AutoReverse="True" />

完全なサンプルについては、クリップ領域のサンプルを参照してください。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
メタデータプロパティが true に設定されるMetadata properties set to true NoneNone