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 un elemento de marco Clip región.This example shows how to define a framework element's Clip region. Para definir un clip, utilice un Geometry (por ejemplo, un EllipseGeometry para establecer el elemento Clip propiedad.To define a clip, use a Geometry (for example, an EllipseGeometry to set the element's Clip property. Solo el área que está dentro de la región de la geometría será visible.Only the area that is within the region of the geometry will be visible.

El ejemplo siguiente se muestra un Image elemento sin una región de recorte definida.The following example shows an Image element without a defined clip region. Como no se define 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 con ninguna región de recorteImage with No Clip Region

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

Objeto recortadoA clipped object
Imagen con una región de recorte elípticoImage with an Elliptical Clip Region

El ejemplo siguiente muestra cómo animar un elemento de marco Clip región.The following example shows how animate a framework element's Clip region. En este ejemplo, un EllipseGeometry se utiliza 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 anima la geometría de elipse Center propiedad desde (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 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, vea el Clip Region Sample.For the full sample, see the Clip Region Sample.

Comentarios

Elementos que estén 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. La geometría no tiene que ser rectangular.The geometry does not have to be rectangular.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field ClipProperty
Establecen las propiedades de metadatos en trueMetadata properties set to true NingunaNone

Se aplica a

Consulte también: