Gets or sets the geometry used to define the outline of the contents of an element. This is a dependency property.
Assembly: PresentationCore (in PresentationCore.dll)
This example shows how to define a framework element's region. To define a clip, use a Geometry (for example, an EllipseGeometry to set the element's property. Only the area that is within the region of the geometry will be visible.
The following example shows an Image element without a defined clip region. Because no clip region is defined, the entire image is displayed.
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 EllipseGeometry will be displayed.
The following example shows how animate a framework element's 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.
<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>
For the full sample, see the Clip Region Sample.
Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)