UIElement.Clip UIElement.Clip UIElement.Clip UIElement.Clip Property

Definición

Obtiene o establece la geometría usada para definir el contorno del contenido de un elemento.Gets or sets the geometry used to define the outline of the contents of an element. Es una propiedad de dependencia.This is a dependency property.

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

Valor de propiedad

Geometría que se usará para definir el tamaño del área de recorte.The geometry to be used for clipping area sizing. El valor predeterminado es una Geometry nula.The default is a null Geometry.

Ejemplos

En este ejemplo se muestra cómo definir la región de Clip un elemento de marco.This example shows how to define a framework element's Clip region. Para definir un clip, use Geometry (por ejemplo EllipseGeometry , para establecer la propiedad del Clip elemento).To define a clip, use a Geometry (for example, an EllipseGeometry to set the element's Clip property. Solo se verá el área que está dentro de la región de la geometría.Only the area that is within the region of the geometry will be visible.

En el ejemplo siguiente se Image muestra un elemento sin una región de recorte definida.The following example shows an Image element without a defined clip region. Dado que no se ha definido ninguna región de recorte, se muestra toda la imagen.Because no clip region is defined, the entire image is displayed.

<Image Source="sampleImages\Waterlilies.jpg" 
  Width="200" Height="150" HorizontalAlignment="Left" />

Un objeto antes de aplicar una región de recorteAn object before applying a clip region
Imagen sin región de recorteImage with No Clip Region

En el ejemplo siguiente, se crea una imagen idéntica, salvo que tiene una región de recorte definida.In the next example, an identical Image is created, except that it has a defined clip region. Solo se mostrará la parte de la imagen que se encuentra dentro EllipseGeometry del área.Only the part of the image that is within the area the EllipseGeometry will 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>

![Un objeto] recortado (~/add/media/mil-task-clip-region-ellispe.PNG "Un objeto") recortadoA clipped object
Imagen con una región de recorte elípticaImage with an Elliptical Clip Region

En el ejemplo siguiente se muestra cómo animar la Clip región de un elemento de marco.The following example shows how animate a framework element's Clip region. En este ejemplo, EllipseGeometry se usa para definir una región de recorte elíptica para un Image elemento.In this example, an EllipseGeometry is used to define an elliptical clip region for an Image element. Un PointAnimation objeto anima la Center propiedad de la geometría de elipse de (0,0) a (200, 150).A PointAnimation animates the ellipse geometry's Center property from (0, 0) to (200, 150). La animación comienza a reproducirse después de que la imagen se carga y se repite indefinidamente.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> 

Para obtener el ejemplo completo, consulte el ejemplo de la regiónde recorte.For the full sample, see the Clip Region Sample.

Comentarios

Los elementos que se encuentran fuera de la geometría se recortarán visualmente en el diseño representado.Elements outside the geometry will be visually clipped in the rendered layout. No es necesario que la geometría sea rectangular.The geometry does not have to be rectangular.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field ClipProperty
Propiedades de metadatos establecidas entrueMetadata properties set to true NingunaNone

Se aplica a

Consulte también: