UIElement.Clip Propriedade

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 da propriedade

A geometria do retângulo a ser usada para dimensionamento de área de recorte. O valor padrão é null (sem recorte).

Exemplos

Este exemplo é uma marcação XAML simples que especifica um Clip usando um RectangleGeometry embutido que especifica suas dimensões por meio de uma sintaxe 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>

Comentários

A geometria de recorte na UIElement.Clip API de Windows Runtime deve ser um RectangleGeometry. Não é possível especificar uma geometria não retangular.

A área recortada é a parte externa da geometria. Em outras palavras, o conteúdo mostrado (não recortado) é a área do retângulo desenhado com Preenchimento se a geometria foi usada como dados para um Caminho em vez de para recorte. A área recortada é qualquer área que cai fora do retângulo. A área recortada não é testável por clique.