Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Propiedad UIElement.Clip

 

Obtiene o establece la geometría usada para definir el contorno del contenido de un elemento. Es una propiedad de dependencia.

Espacio de nombres:   System.Windows
Ensamblado:  PresentationCore (en PresentationCore.dll)

public Geometry Clip { get; set; }

Valor de propiedad

Type: System.Windows.Media.Geometry

Geometría que se usará para definir el tamaño del área de recorte. El valor predeterminado es una Geometry nula.

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

Identifier field

ClipProperty

Metadata properties set to true

None

This example shows how to define a framework element'sP:System.Windows.UIElement.Clipregion. To define a clip, use a T:System.Windows.Media.Geometry (for example, an T:System.Windows.Media.EllipseGeometryto set the element's P:System.Windows.UIElement.Clipproperty. Only the area that is within the region of the geometry will be visible.

The following example shows an T:System.Windows.Controls.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" />
Objeto antes de aplicar una región de recorte

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 T:System.Windows.Media.EllipseGeometrywill be displayed.

<Image 
  Source="sampleImages\Waterlilies.jpg" 
  Width="200" Height="150" HorizontalAlignment="Left">
  <Image.Clip>
    <EllipseGeometry
      RadiusX="100"
      RadiusY="75"
      Center="100,75"/>
  </Image.Clip>
</Image>
Objeto recortado

Image with an Elliptical Clip Region

The following example shows how animate a framework element's P:System.Windows.UIElement.Clip region. In this example, an T:System.Windows.Media.EllipseGeometry is used to define an elliptical clip region for an T:System.Windows.Controls.Image element. A T:System.Windows.Media.Animation.PointAnimation animates the ellipse geometry's P:System.Windows.Media.EllipseGeometry.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.

.NET Framework
Disponible desde 3.0
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Volver al principio
Mostrar: