Exportar (0) Imprimir
Expandir todo
Expandir Minimizar
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

UIElement.Clip (Propiedad)

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

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

public Geometry Clip { get; set; }

Valor de propiedad

Tipo: System.Windows.Media.Geometry
Geometría que se usa para el ajuste de tamaño del área de recorte. El valor predeterminado es un objeto Geometry null.

Campo de identificador

ClipProperty

Propiedades de metadatos establecidas en true.

Ninguno

Los elementos que están fuera de la geometría se recortarán visualmente en el diseño representado. La geometría no tiene por qué ser rectangular.

En este ejemplo se muestra cómo definir la zona de recorte (Clip) de un elemento de marco. Para definir un recorte, utilice una Geometry (por ejemplo, EllipseGeometry) para establecer la propiedad Clip del elemento. Únicamente el área que se encuentre dentro de la zona de la geometría quedará visible.

En el ejemplo siguiente se muestra un elemento Image sin una zona de recorte definida. Al no haber ninguna zona de recorte, se muestra la imagen completa.


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


Imagen sin zona de recorte

Objeto antes de aplicar una región de recorte

En el ejemplo siguiente, se crea una imagen idéntica pero con una zona de recorte definida. Únicamente se muestra la parte de la imagen que está dentro del área de EllipseGeometry.


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


Imagen con una zona de recorte elíptica

Objeto recortado

En el ejemplo siguiente se muestra cómo animar la región Clip de un elemento de marco. En este ejemplo, se utiliza un elemento EllipseGeometry para definir una zona de recorte elíptica para un elemento Image. Un objeto PointAnimation anima la propiedad Center de la geometría de elipse desde (0, 0) hasta (200, 150). La animación comienza a reproducirse después de que se carga la imagen, y se repite indefinidamente.


<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 Clip Region Sample.

.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft