Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

UIElement.Clip Property


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
© 2017 Microsoft