Lenguaje

UIElement.Clip Propiedad

Definición

Obtiene o establece el rectánguloGeometry 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 recortar el tamaño del área. 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 de 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 cae fuera del rectángulo. El área recortada no es comprobable.

Se aplica a