UIElement.Clip Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the geometry used to define the outline of the contents of an element. This is a dependency property.

Namespace:   System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)

public Geometry Clip { get; set; }

Property Value

Type: System.Windows.Media.Geometry

The geometry to be used for clipping area sizing. The default is a null Geometry.

Elements outside the geometry will be visually clipped in the rendered layout. The geometry does not have to be rectangular.

Identifier field


Metadata properties set to true


This example shows how to define a framework element'sClipregion. To define a clip, use a Geometry (for example, an EllipseGeometryto set the element's Clipproperty. Only the area that is within the region of the geometry will be visible.

The following example shows an Imageelement 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. Only the part of the image that is within the area the EllipseGeometrywill be displayed.

  Width="200" Height="150" HorizontalAlignment="Left">
A clipped object

Image with an Elliptical Clip Region

The following example shows how animate a framework element's Clip region. In this example, an EllipseGeometry is used to define an elliptical clip region for an Image element. 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.

.NET Framework
Available since 3.0
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top