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>

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

注釈

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

依存プロパティ情報

適用対象

こちらもご覧ください

• ClipToBounds