UIElement.Clip Propiedad

Definición

Obtiene o establece el objeto RectangleGeometry usado para definir el esquema del contenido de un UIElement.

public:
 property RectangleGeometry ^ Clip { RectangleGeometry ^ get(); void set(RectangleGeometry ^ value); };
RectangleGeometry Clip();

void Clip(RectangleGeometry value);
public RectangleGeometry Clip { get; set; }
var rectangleGeometry = uIElement.clip;
uIElement.clip = rectangleGeometry;
Public Property Clip As RectangleGeometry
<uiElement>
  <uiElement.Clip>
    rectangleGeometry
  </uiElement.Clip>
</uiElement>

Valor de propiedad

Geometría del rectángulo que se va a usar para ajustar el tamaño del área de recorte. El valor predeterminado es NULL (sin recorte).

Ejemplos

Este ejemplo es un marcado XAML simple que especifica un Clip mediante un RectangleGeometry insertado que especifica sus dimensiones a través de una sintaxis de atributo.

<Canvas>
    <Image Source="Images/Water_lilies.jpg" Width="200" Height="150">
        <Image.Clip>
            <RectangleGeometry Rect="100 75 50 50"/>
        </Image.Clip>
    </Image>
</Canvas>

Comentarios

La geometría de recorte para UIElement.Clip en la API de Windows Runtime debe ser RectangleGeometry. No se puede especificar una geometría no rectangular.

El área recortada es el "exterior" de la geometría. En otras palabras, el contenido que se muestra (no recortado) es el área del rectángulo que se dibuja con Fill si la geometría se usó como datos para una ruta de acceso en lugar de para el recorte. El área recortada es cualquier área que caiga fuera del rectángulo. El área recortada no es comprobable.

Se aplica a